この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Partner

2 つの Account レコードの間、または Opportunity レコードと Account レコードの間のパートナー関係を表します。

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

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

特別なアクセスルール

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

項目

項目 詳細
AccountFromId
reference
プロパティ
Create、Filter、Group、Nillable、Sort
説明
OpportunityId が null の場合は必須。2 つの取引先の間のパートナー関係における主取引先の ID。パートナーレコードを作成するときにこの項目を指定すると、各リレーションの方向に 1 つ (計 2 つ) の AccountPartner レコードが作成されます。OpportunityId 項目を指定すると、この項目が指定できなくなります。
AccountToId
reference
プロパティ
Create、Filter、Group、Sort
説明
必須。商談または取引先のいずれかに関連するパートナー取引先の ID。商談のパートナーまたは取引先パートナーレコードを作成する場合、この項目を指定する必要があります。
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 項目を指定した場合、この項目は指定できません。
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 は、レコードとレコードのリレーションを効率的に管理できます。