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

PartnerNetworkRecordConnection

Salesforce to Salesforce を使用する Salesforce 組織間で共有するレコードを表します。

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

create()、query()

特別なアクセスルール

Winter '21 以降、このオブジェクトにアクセスできるのは、認証された内部ユーザと外部ユーザのみとなります。

項目

項目 詳細
ConnectionId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort
説明
必須。レコードを共有している接続の ID。
EndDate
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
レコードの共有が終了した日付。
LocalRecordId
型
reference
プロパティ
Create、Filter、Group、Sort
説明
必須。共有レコードの ID。
ParentRecordId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort
説明
共有レコードの親レコードの ID。
PartnerRecordId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
接続の組織の共有レコードの ID。
RelatedRecords
型
string
プロパティ
Create、Filter、Nillable、Sort
説明
API 名によるカンマ区切り形式のリスト。親レコードによって共有される子レコードで使用されます。
SendClosedTasks
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort
説明
共有レコードに関連する完了した ToDo を送信します。
SendEmails
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort
説明
接続の担当者に、その担当者宛てにレコードを転送したことを通知するメールを送信します。レコードの新たな受信者だけがメール通知を受け取ります。
SendOpenTasks
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort
説明
共有レコードに関連する未完了の ToDo を送信します。
StartDate
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
共有レコードが受け取られた日付。
Status
型
picklist
プロパティ
Filter、Group、Nillable、Restricted picklist、Sort
説明
共有レコードの状況。次のいずれかの値になります。
  • Active (received)
  • Active (sent)
  • Connected
  • Inactive
  • Inactive (converted)
  • Inactive (deleted)
  • Pending (sent)

使用方法

PartnerNetworkRecordConnection を作成するとき、レコードを接続に転送します。

接続が登録されていないオブジェクトからレコードを送信すると、[無効なパートナーネットワーク状況] であることを伝えるエラーが通知されます。

メモ

PartnerNetworkRecordConnection を削除すると、レコードは接続と共有されなくなります。
  • レコードを共有するには、LocalRecordID 項目および ConnectionId 項目を使用します。
  • 親レコードの子を共有するには、LocalRecordID 項目、ConnectionId 項目および ParentRecordID 項目を使用します。
  • 親レコードの子およびその子レコードを共有するには、LocalRecordID 項目、ConnectionId 項目、ParentRecordID 項目、および RelatedRecords 項目を使用します。

組織が Salesforce to Salesforce を有効化していない場合、PartnerNetworkRecordConnection オブジェクトを使用できないため、API を介してそのオブジェクトにアクセスできません。

サンプルコード — Apex

次の例では、レコードの送信方法を示しています。

1List<PartnerNetworkConnection)> connMap = new List<PartnerNetworkConnection>(
2    [select Id, ConnectionStatus, ConnectionName from PartnerNetworkConnection
3        where ConnectionStatus = 'Accepted']
4);
5List<PartnerNetworkRecordConnection> PNRecordList = new List<PartnerNetworkRecordConnection>();
6for(PartnerNetworkConnection network : connMap) {    
7     PartnerNetworkRecordConnection newrecord = new PartnerNetworkRecordConnection();
8
9    newrecord.ConnectionId = network.Id;
10    newrecord.LocalRecordId = accountId;  
11    newrecord.RelatedRecords = 'Contact,Opportunity,Orders__c';
12    newrecord.SendClosedTasks = true;
13    newrecord.SendOpenTasks = true;
14    newrecord.SendEmails = true;   
15    PNRecordList.add(newrecord);
16}
17//One DML call for the entire list of new records
18insert PNRecordList;
19}

次の例では、レコードの共有方法を示しています。

1List<PartnerNetworkRecordConnection> recordConns = new List<PartnerNetworkRecordConnection>(
2    [select Id, Status, ConnectionId, LocalRecordId from PartnerNetworkRecordConnection
3        where LocalRecordId in :accounts]
4);
5
6List<PartnerNetworkRecordConnection> DeleteRecordList = new List<PartnerNetworkRecordConnection>();
7for(PartnerNetworkRecordConnection recordConn : recordConns) {
8        if(recordConn.Status.equalsignorecase('Sent')){ //account is connected - outbound
9           DeleteRecordList.add(recordConn);
10}
11delete DeleteRecordList;