レコードの所有者が変更されると実行できるアクションを表します。これらのオプションは、API バージョン 35.0 以降で使用できます。
項目
| options |
OwnerChangeOption[] |
update または upsert コールでレコード所有者を変更するときに実行する特定のアクションのフラグを表します。
|
OwnerChangeOption 項目
| execute |
boolean |
true の場合、type 項目で表されるアクションが実行されます。false の場合、type 項目で表されるアクションがスキップされます。
|
| type |
文字列の列挙 |
update または upsert コールでレコード所有者を変更するときに execute 項目で指定された値に応じて実行またはスキップするアクションを表します。次の型を使用できます。
- EnforceNewOwnerHasReadAccess
-
true の場合、レコードの新しい所有者に少なくともレコードへの参照アクセス権が必要です。API バージョン 36.0 以降で利用できます。
- KeepAccountTeam
-
true の場合、取引先所有者が変更されたときに取引先と共に取引先チームが保持されます。false の場合、取引先チームは削除されます。デフォルトは false です。取引先で API バージョン 45.0 以降で使用できます。
- KeepSalesTeam
-
true の場合、取引先所有者が変更されたときに商談と共に商談チームが保持されます。false の場合、商談チームは削除されます。デフォルトは false です。商談で API バージョン 45.0 以降で使用できます。
- KeepSalesTeamGrantCurrentOwnerReadWriteAccess
-
true の場合、所有者が変更された後に商談の以前の所有者の「参照・更新」アクセス権が保持されます。デフォルトは false です。KeepSalesTeam が true の場合のみ true に設定できます。商談で API バージョン 44.0 以降で使用できます。
- SendEmail
-
true の場合、メール通知は新しい所有者に送信されます。デフォルトは false です。
- TransferAllOwnedCases
-
true の場合、取引先所有者が所有するす��てのケース (オープンとクローズ) が新しい所有者に移行されます。デフォルトは false です。TransferAllOwnedCases が true の場合、TransferOwnedOpenCases も true である必要があります。取引先で API バージョン 45.0 以降で使用できます。
- TransferArticleOwnedPublishedVersion
-
true で、レコードがナレッジ記事の場合、現在のドラフトの言語に対応する記事所有者の公開バージョンが、現在のドラフトに加えて新しい所有者に移行されます。
- TransferArticleOwnedArchivedVersions
-
true で、レコードがナレッジ記事の場合、現在のドラフトの言語に対応する記事所有者のアーカイブ済みバージョンが、現在のドラフトに加えて新しい所有者に移行されます。
- TransferArticleAllVersions
-
true で、レコードがナレッジ記事の場合、現在のドラフトの言語に対応するすべての公開バージョンとアーカイブ済みバージョンが、現在のドラフトに加えて新しい所有者に移行されます。
- TransferContacts
-
true で、レコードが法人取引先の場合、取引先に関連付けられている取引先責任者が新しい所有者に移行されます。
- TransferContracts
-
true で、レコードが取引先の場合、取引先に関連付けられていて、取引先所有者が所有している契約が新しい所有者に移行されます。
- TransferNotesAndAttachments
-
true の場合、レコードのメモ、添付ファイル、および Google ドキュメントが新しいレコード所有者に移行されます。false の場合、元のレコード所有者が所有権を保持します。
- TransferOpenActivities
-
true の場合、レコードの活動予定が新しい所有者に移行されます。
- TransferOrders
-
true で、レコードが取引先の場合、取引先に関連付けられているスタンドアロンのドラフト注文と、取引先所有者が所有している移行済み契約に関連付けられているドラフト注文が新しい所有者に移行されます。
- TransferOtherOpenOpportunities
-
true で、レコードが取引先の場合、取引先に関連付けられていて、現在の所有者が所有していない進行中の商談が新しい所有者に移行されます。このオプションが実行される場合、TransferOwnedOpenOpportunities も実行されるよう設定する必要があります。デフォルトは false です。
- TransferOwnedClosedOpportunities
-
true で、レコードが取引先の場合、取引先所有者が所有している完了した商談が新しい所有者に移行されます。デフォルトは false です。API バージョン 45.0 以降で使用できます。
- TransferOwnedOpenCases
-
true で、レコードが取引先の場合、取引先所有者が所有しているオープンケースが新しい所有者に移行されます。デフォルトは false です。API バージョン 45.0 以降で使用できます。
- TransferOwnedOpenOpportunities
-
true で、レコードが取引先の場合、取引先に関連付けられていて、取引先所有者が所有している進行中の商談が新しい所有者に移行されます。
|
サンプルコード — Java
このサンプルでは、取引先と、取引先のメモ、商談、ToDo を作成し、取引先と共にメモ、商談、ToDo が新しい所有者に移行されるように所有者変更オプションを設定します。