Loading

データローダを使用して商談チームを追加または削除するには？

公開日: Apr 2, 2026
説明
商談チームメンバーをユーザインターフェイス (UI) に追加すると、OpportunityTeamMember レコードと OpportunityShare レコードの両方が自動的に作成されます。商談共有レコードは、商談チームメンバーページでチームメンバーが追加されたときに選択された [商談のアクセス権] に基づいて作成されます。

API を介して OpportunityTeamMembers を挿入するときに、対応する OpportunityShare レコードのアクセスレベルを直接指定または設定することはできないため、それぞれを個別に挿入する必要があります。 API を使用してチームメンバーレコードを作成する際に使用する各オブジェクトについて説明します。

OpportunityTeamMember - このレコードには、ユーザと商談の実際の関連付けとその役割が保存されます。
OpportunityShare - このレコードは、商談へのユーザの実際のアクセス権を確立します。

API を介してチームメンバーを挿入する場合、そのアクセスは通常、必要最小限のデフォルトレベルの参照のみに設定されます。ユーザと商談 ID の一致する組み合わせを持つ既存の OpportunityShare レコードは、既存のアクセスレベルから「参照のみ」に更新され、その共有の理由も「Sales Team」を反映して更新されます。「取引先または商談チームメンバーのインポート時のアクセスレベルの指定」の記事で概説されているように、これにはいくつかの例外があります。

新しく挿入されたチームメンバーに対してより権限の大きいアクセスレベルを設定する場合は、OpportunityShare オブジェクトへの後続の Insert を実行して、必要なアクセスレベルを設定する必要があります。

注: チームメンバーのアクセスレベルがユーザインターフェースに適切に表示されるように、以下の 3 つの手順をすべて順番に実行する必要があります。
解決策
データローダを使用して商談チームメンバーを商談に追加するには:
 
1. 次の列を持つファイルを準備します:

OpportunityId: チームメンバーが追加される商談のレコード ID。
UserId: 商談チームに追加されるユーザの ID。
TeamMemberRole: この商談のこのユーザの商談チームの役割。 有効なチーム内の役割のリストを確認するには、[設定] | [カスタマイズ] | [商談] | [商談チーム] | [チーム内の役割] を参照します。
OpportunityAccessLevel: チームメンバー (または UserId) の商談アクセスレベル。 有効な値は「Read」または「Edit」です。この項目の「Read」または「Edit」では大文字と小文字が区別されることに注意してください。

 
2. ファイルが準備されたら、データローダを開き、商談チームメンバーのユーザに適切な OpportunityAccessLevel を設定するために商談の共有 (OpportunityShare) オブジェクトへの Insert 操作を実行することを選択します。商談の共有オブジェクトは、データローダの [Show all Salesforce objects] オプションを選択して [Browse...] をクリックすることで利用できるようになります。ファイルを選択して開き、 [Next] 、[OK] を順にクリックします。

- [Create or Edit a Map] ボタンを選択し、[ Auto-match Fields to Columns] を選択します。OpportunityAccessLevel 項目と OpportunityId 項目が自動的に対応付けられていることを確認し、UserId 列を Salesforce の UserOrGroupId 項目へ手動で対応付けます。

- success および error ファイルを保存するディレクトリを選択し、[Finish] をクリックします。

3. 同じファイルを使用して、データローダの [Show all Salesforce objects] オプションを選択して [Browse...] をクリックし、ファイルを選択することによって利用できる商談チームメンバー (OpportunityTeamMember) オブジェクトに 2 回目の Insert 操作を実行します。そして、ファイルを選択して開き、[Next]、[OK] を順にクリックします。
 
- [Create or Edit a Map] ボタンを選択し、[Auto-Match Fields to Columns] を選択します。OpportunityId、UserId、および TeamMemberRole 項目が正しく対応付けられていることを確認します。

- success および error ファイルを保存するディレクトリを選択し、[Finish] をクリックします。
 

注: 商談の共有レコードは、商談チームメンバーレコードの前に挿入する必要があります。これにより、既存の共有レコードが新しく作成されたチームメンバーに適切にリンクされます。 共有レコードがチームメンバーの後に挿入されると、ユーザインターフェイスのチームメンバーのアクセスレベルが共有レコードのアクセスレベルを正しく反映しないことがあります。

共有とチームメンバーレコードが正しい順序で挿入されると、それらは適切にリンクされ、共有レコードの後続の更新をユーザインターフェースを介して関連チームメンバーのアクセスレベルに適切に反映させることができます。


データローダを使用して商談チームメンバーを商談から削除するには:

1. 商談チームメンバー (OpportunityTeamMember) オブジェクトに対して、データローダを介して Export 操作を実行します。目的の商談チームメンバーレコードを選択的にエクスポートするためにフィルター条件を指定し、既存の商談チームメンバーレコードのバックアップを取得できていることを確認します。

2. ファイルの内容に問題がなければ、データローダを介し、商談チームメンバーの ID 列を対応付けて Delete 操作を実行します。

注: OpportunityTeamMember レコードを削除すると、OpportunityShare レコードも削除され、チームメンバーレコードはごみ箱に入れられません。


参考情報:
ナレッジ記事番号

000383667

 
読み込み中
Salesforce Help | Article