Content last updated 2026-08-19

組織の関連付け

Zendesk 組織の関連付けに関するドキュメント

このガイドでは、GitLab で組織の関連付けを行う方法を説明します。

組織の関連付けを理解する

組織の関連付けとは

組織の関連付けとは、Zendesk ユーザーを組織に結び付けるプロセスです。

関連付けのプロセス

非常に一般化したプロセスは次のようになります。

graph TD;
  A--> B
  B-->|Yes| C
  B-->|No| D
  C--> I
  D-->|gitlab.com| E
  D-->|Self-Managed or GitLab Dedicated| F
  E--> I
  F--> G
  G--> H
  H--> I
  A(Set metadata on ticket)
  B{Is requester already associated?}
  C[Use app to associate new users]
  D{What product type is it?}
  E[Use auto association in app]
  F[Ask for proof of support entitlement]
  G[Locate info in cDot]
  H[Fill out info in app]
  I[Reply to ticket with appropriate macro and mark as solved]

ステップ 1: チケットにメタデータを設定する

続行する前に、チケットのメタデータが入力され、適切に設定されていることを確認する必要があります。通常のフォーム送信でほとんどのメタデータはカバーされます。そのため、特に注目すべきなのはチケットフィールド Support Ops Problem Type です（これを Manage my organization's contacts に設定する必要があります）。さらに、L&R Product Type と Subscription Email のフィールドに値があることを確認する必要があります（値がない場合は、顧客にこの情報を尋ねる必要があるかもしれません）。

入力後、チケットに更新を送信して保存されていることを確認します。

これを行ったら、ステップ 2に進みます

ステップ 2: 事前承認済みか確認する

ユーザーがすでに組織に関連付けられている場合、そのユーザーは組織のサポート連絡先を管理するための事前承認を受けている可能性があります。そのため、このプロセスははるかに簡単です。

  1. 組織に追加するメールアドレスのリストを、カンマ区切りで収集します
  2. Contact Management アプリを開きます
  3. Add users をクリックします
  4. メールアドレスのリストを入力ボックスに入力します
  5. Add users to org ボタンをクリックします
  6. アプリの出力で成功を確認します
  7. 変更が完了したことを顧客に返信して確認します（チケットのステータスを Solved に設定してください）

まだ関連付けられていない場合は、ステップ 3に進みます

ステップ 3: プロダクトタイプを判別する

ここからの手順はプロダクトタイプによって異なるため、プロダクトタイプを把握する必要があります。ユーザーがすでに必要な情報を提供している場合は、それを使用して次に実行する手順を判別します。

  • プロダクトタイプが GitLab.com の場合は、ステップ 4に進みます
  • プロダクトタイプが Self-Managed または GitLab Dedicated の場合は、ステップ 5に進みます

情報を提供していない場合は、ユーザーに利用資格の証明を求める返信をチケットに送ります。

ステップ 4: 自動関連付けを試行する

GitLab.com サブスクリプションを購入した組織の場合、プロセスははるかに簡単です。

  1. Contact Management アプリを開きます
  2. Associate .com requester ボタンをクリックします

これにより、ユーザーを自動関連付けできるかを確認するための各種チェックが実行されます。結果はアプリに表示されます。

関連付けられた場合は、変更が完了したことを顧客に返信して確認します（チケットのステータスを Solved に設定してください）。

関連付けに失敗した場合は、それがアプリの問題か、利用資格チェックに失敗したのかを判断します。

  • アプリの問題については、一般的な問題とトラブルシューティングを参照してください。
  • 利用資格チェックに失敗した場合は、最上位の有料名前空間のオーナーではないことを示すマクロで返信を送信します。

ステップ 5: 利用資格情報を求める

注記: 対象のユーザーは 会社 のメールアドレスを使用している必要があります。Gmail、Yahoo などの一般的なメールアドレスを使用している場合は、続行できません。

次に、利用資格情報を求める必要があります。Self-Managed および GitLab Dedicated のユーザーについては、これはさまざまな方法で提供される可能性があります。

  • リクエスターがサブスクリプションのライセンス ID を提供する
  • リクエスターがサブスクリプションのクラウドアクティベーションコードを提供する
  • リクエスターがサブスクリプションの生のライセンスファイルを提供する
  • リクエスターがライセンス使用量エクスポート CSV ファイルを提供する

提供されるものによって、次の手順が決まります。

  • ライセンス ID の場合は、ステップ 6に進みます
  • クラウドアクティベーションコードの場合は、ステップ 7に進みます
  • 生のライセンスファイルの場合は、ステップ 8に進みます
  • ライセンス使用量エクスポート CSV ファイルの場合は、ファイルを開いてライセンスキーの値を取得します。その後、ステップ 8に進みます

ステップ 6: ID からライセンスを特定する

ID からライセンスを特定するには、次のようにします。

  1. Okta 経由で Customers portal 管理パネルにログインします
  2. Licenses ページに移動します
  3. URL の末尾に /xxxx を追加します（xxxx はライセンス ID に置き換えます）

現在表示しているライセンスの ID をメモします（後でアプリに必要になります）。

注記: ライセンスがトライアルであると表示されている場合（Trial の値が Yes）、有効なライセンスではありません（ユーザーは利用資格チェックに失敗しています）。この場合は、トライアルであり、有効な有料サブスクリプションではないことをユーザーに伝えます。

このページから Zuora subscription name の値を取得し、ステップ 9に進みます。

ステップ 7: クラウドアクティベーションを特定する

クラウドアクティベーションを特定するには、次のようにします。

  1. Okta 経由で Customers portal 管理パネルにログインします
  2. URL を https://customers.gitlab.com/admin/cloud_activation?query=XXXX に変更します（XXXX はクラウドアクティベーションコードに置き換えます）
  3. 見つかったクラウドアクティベーションの表示ボタンをクリックします（円内の i のように見えます）。

現在表示しているクラウドアクティベーションの ID をメモします（後でメモに必要になります）。

注記: クラウドアクティベーションがトライアルであると表示されている場合（Trial の値が Yes）、有効なクラウドアクティベーションではありません（ユーザーは利用資格チェックに失敗しています）。この場合は、トライアルであり、有効な有料サブスクリプションではないことをユーザーに伝えます。

このページから Subscription name の値を取得し、ステップ 9に進みます。

ステップ 8: キーからライセンスを特定する

キーからライセンスを特定するには、次のようにします。

  1. Okta 経由で Customers portal 管理パネルにログインします
  2. Licenses ページに移動します
  3. Validate License をクリックします
  4. キーをテキストエリアに貼り付けます
  5. Validate ボタンをクリックします

このページからオブジェクトの id 属性の値をコピーし、ステップ 6に進みます。

ステップ 9: 注文を特定する

注文を特定するには（サブスクリプション名から）、次のようにします。

  1. Okta 経由で Customers portal 管理パネルにログインします
  2. Orders ページに移動します
  3. ページ右上の Add filter をクリックします
  4. Subscription name をクリックします
  5. Subscription name ボタンの右側のドロップダウンを Contains に変更します
  6. サブスクリプション名（前の手順でコピーしたもの）を入力ボックスに入力します
  7. キーボードの Enter または Return を押します
  8. 見つかった注文の表示ボタンをクリックします（円内の i のように見えます）

現在表示している注文の ID をメモします（後でアプリに必要になります）。

このページで Billing account までスクロールし、リンクをクリックして、ステップ 10に進みます。

ステップ 10: 請求アカウント情報を取得する

現在表示している請求アカウントの ID をメモします（後でアプリに必要になります）。

次の値をコピーします。

  • Salesforce account
  • Sold to

この時点で、ステップ 11に進むために必要な情報をすべて取得しています。

ステップ 11: アプリを使って関連付ける

ここでは、Contact Management アプリを使ってユーザーを関連付けます。そのために、cDot から取得した情報の入力を求められます。

アプリはその情報を使って、ユーザーを関連付けられるか確認します。関連付けられない場合は、その理由が詳しく示されます。

ユーザーを関連付けられる場合、アプリは次の処理を行います。

  • 入力された cDot 情報を含む内部ノートを追加する
  • ユーザーを組織に関連付ける

関連付けられたユーザーを削除する

関連付けられたユーザーが、他の関連付けられたユーザーの削除を求めた場合は、Contact Management アプリを使って次のように行う必要があります。

  1. 組織から削除するメールアドレスのリストを収集します
  2. Contact Management アプリを開きます
  3. Remove users をクリックします
  4. 削除するユーザーを選択します（複数選択できます）
  5. Deassociate users ボタンをクリックします
  6. アプリの出力で成功を確認します
  7. 変更が完了したことを顧客に返信して確認します（チケットのステータスを Solved に設定してください）

一般的な問題とトラブルシューティング

これは必要に応じて項目が追加される継続的なセクションです。

自動関連付けの試行で組織を特定できない

Attempt Association アプリが正しい Salesforce アカウントまたは組織を特定できなかった場合は、手動で特定する必要があります。

これを行うには、次のようにします。

  1. GitLab Super App に移動します
  2. User Lookup をクリックします
  3. Search ボタンをクリックします
  4. Group memberships の下にある出力を確認します
  5. オーナーである最上位の有料名前空間を特定してコピーします
  6. Support Ops Super App に移動します
  7. Namespace Lookup をクリックします
  8. 入力フィールドに名前空間を貼り付けます
  9. Search ボタンをクリックします
  10. 出力を確認して、正しい Salesforce アカウントを特定します（Salesforce info の下）
  11. salesforce_id:xxx で Zendesk 検索を実行します（xxx は値に置き換えます）
  12. 見つかった組織を使って、ユーザーを手動で関連付けます

上記のいずれかが失敗した場合は、状況を示す内部メモを作成し、レビューのためにチケットを Customer Support Systems, Fullstack Engineer に割り当てます。

関連付けにより組織が 30 件の連絡先上限を超える

組織にさらにユーザーを追加すると 30 件の連絡先上限を超える場合は、問題を説明してユーザーに返信する必要があります。現在関連付けられているユーザーのリストを含め、ユーザーが確認できるようにしてください。

顧客から問題を修正するためにどの変更を行うべきか返信があったら、プロセスで通常行う手順に従って進めます。

組織が見つからない

Salesforce アカウントは見つかったものの組織が見つからない場合、GitLab が使用する同期メカニズムのいずれかで問題が発生している可能性があります。

  • Salesforce アカウントにサブスクリプションがない場合（またはサブスクリプションにプロダクト料金がない場合）、Zuora<>Salesforce sync で問題が発生している可能性があります。強制再同期で修正できる場合があります。これを行うには、次のようにします。
    1. Salesforce の Billing Account に移動します
    2. ページ右上の下向きの山形をクリックします（Edit および Clone ボタンの右側）
    3. Sync Data from ZBilling をクリックします
    4. 数分待ってから、Salesforce Account のサブスクリプションを再確認します
      • すべて修正されているように見える場合は、ZD<>SFDC sync が組織を作成するまで 1 〜 2 時間待つ必要があります。待機中に、発生した内容についての内部メモを追加し、自分自身に割り当ててから、1 〜 2 時間後にチケットを再確認します。
      • すべて修正されていないように見える場合は、以下の For anything else の箇条書きを使用します
  • その他の場合は、状況を示す内部メモを作成し、レビューのためにチケットを Customer Support Systems, Fullstack Engineer に割り当てます
最終更新 September 12, 2026: Merge pull request #526 from kyama0/translation/batch-2026-09-12-1 (a1f3c26a)
ページのソースコードを見る - ページの編集 - please contribute. Creative Commons License