Partner

サポートされているコール

create()、delete()、describeSObjects()、getDeleted()、getUpdated()、query()、retrieve()

特別なアクセスルール

カスタマーポータルユーザーはこのオブジェクトにアクセスできません。

項目

項目	詳細
AccountFromId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明 OpportunityId が null の場合は必須。2 つの取引先の間のパートナー関係における主取引先の ID。パートナーレコードを作成するときにこの項目を指定すると、各リレーションの方向に 1 つ (計 2 つ) の AccountPartner レコードが作成されます。OpportunityId 項目を指定すると、この項目が指定できなくなります。これはリレーション項目です。リレーション名 AccountFrom リレーション種別 Lookup 参照先 Account
AccountToId	型 reference プロパティ Create、Filter、Group、Sort 説明必須。商談または取引先のいずれかに関連するパートナー取引先の ID。商談のパートナーまたは取引先パートナーレコードを作成する場合、この項目を指定する必要があります。これはリレーション項目です。リレーション名 AccountTo リレーション種別 Lookup 参照先 Account
IsPrimary	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明商談パートナーにのみ有効です。取引先が商談の主パートナーであるか (true)、否か (false) を示します。商談の 1 つの取引先だけを主としてマークできます。新しい商談パートナーの挿入時にこの項目を 1 (`true`) に設定すると、その商談に対する他の主パートナーのこの項目値は自動的に 0 (`false`) に設定されます。表示ラベルは [主パートナー] です。
OpportunityId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明 AccountFromId が null の場合は必須。取引先と商談のパートナー関係における商談の ID。レコードを作成するときにこの項目を指定すると、OpportunityPartner レコードが作成されます。AccountFromId 項目を指定した場合、この項目は指定できません。これはリレーション項目です。リレーション名 Opportunity リレーション種別 Lookup 参照先 Opportunity
ReversePartnerId	型 reference プロパティ Filter、Group、Nillable、Sort 説明パートナー関係の Account の ID。
Role	型 picklist プロパティ Create、Filter、Group、Nillable、Sort 説明コンサルタントや流通業者など、関連する商談または取引先に対して持つ取引先の UserRole。

ロール

Salesforce ユーザーインターフェースを使用して、システム管理者は有効なロール値と PartnerRole オブジェクトの対応する逆のロールを設定できます。リレーションの各取引先には、関連する取引先または商談に対する取引先のロールを指定する Role (「Consultant」、「Distributor」など) が割り当てられます。

取引先-商談間のパートナー関係の作成

取引先と商談間のパートナー関係を作成する場合 (Partner レコードを作成して OpportunityId 項目を指定する場合)、API は対応する値を使用して、OpportunityPartner レコードを自動的に作成します。

パートナー項目 AccountToId の値は、OpportunityPartner 項目 AccountToId の値に対応付けます。
2 つのレコードの OpportunityId 項目、Role 項目、IsPrimary 項目の値は同じです。
新しい OpportunityPartner の挿入時に IsPrimary 値を 1 (true) に設定すると、その商談に対する既存の主パートナーの IsPrimary 値は自動的に 0 (false) に設定されます。

この対応付けにより、API は、レコードとレコードのリレーションを効率的に管理できます。

取引先間のパートナー関係の作成

2 つの取引先間にパートナー関係を作成する場合 (Partner レコードを作成して AccountFromId を指定する場合)、API は自動的に 2 つの AccountPartner レコードを作成します。一方は主取引先から見た順方向の関係、もう一方はパートナー取引先から見た逆方向の関係となります。たとえば、「Acme, Inc.」を AccountFromId として、「Acme Consulting」を AccountToId としてパートナー関係を作成すると、API は自動的に次のような 2 つの AccountPartner レコードを作成します。

「Acme, Inc.」を AccountFromId、「Acme Consulting」を AccountToId とする順方向の AccountPartner。
「Acme Consulting」を AccountFromId、「Acme, Inc.」を AccountToId とする逆方向の AccountPartner。
逆方向の AccountPartner の Role 項目の値は、順方向の AccountPartner の Role 項目の値に関連付けられた PartnerRole レコードの ReverseRole 値に設定されます。

この対応付けにより、API は、レコードとレコードのリレーションを効率的に管理できます。

Salesforce プラットフォームのオブジェクトリファレンス

サポートされているコール

特別なアクセスルール

項目

ロール

取引先-商談間のパートナー関係の作成

取引先間のパートナー関係の作成

関連項目: