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

Partner

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

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

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

特別なアクセスルール

API を使用してこのオブジェクトにアクセスするには、「すべてのデータの参照」権限が必要です。describeSObjects() コールおよび query() コールでは、Partner オブジェクトのすべての項目にアクセスできます。API を使用して、パートナーに対して update() やupsert() を実行することはできません。
カスタマーポータルユーザはこのオブジェクトにアクセスできません。

項目

項目	詳細
AccountFromId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明 OpportunityId が null の場合は必須です。2 つの取引先の間のパートナー関係における主 Account の ID。パートナーレコードを作成するときにこの項目を指定すると、各リレーションの方向に 1 つ (計 2 つ) の AccountPartner が作成されます。OpportunityId 項目を指定すると、この項目が指定できなくなります。
AccountToId	型 reference プロパティ Create、Filter、Group、Sort 説明必須。商談または取引先のいずれかに関連するパートナー取引先の ID。商談のパートナーまたは取引先パートナーを作成する場合、この項目を指定する必要があります。
IsDeleted	型 boolean プロパティ Defaulted on create、Filter 説明オブジェクトがごみ箱に移動したか (`true`)、否か (`false`) を示します。表示ラベルは Deleted です。
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 の場合は必須です。Account と Opportunity のパートナー関係における Opportunity の ID。レコードを作成するときにこの項目を指定すると、OpportunityPartner が作成されます。AccountFromId 項目を指定すると、この項目が指定できなくなります。
Role	型 picklist プロパティ Create、Filter、Group、Nillable、Sort 説明コンサルタントや流通業者など、関連する商談または取引先に対して持つ取引先の UserRole。

ロール

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

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

取引先と商談にパートナー関係を作成する場合 (パートナーオブジェクトを作成して 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 値に設定されます。