UserProvisioningRequest | Salesforce および Force.com のオブジェクトリファレンス

サードパーティサービスシステム (または別の Salesforce 組織) のユーザアカウントを作成、更新、または削除するための個々のプロビジョニング要求を表します。UserProvisioningRequest オブジェクトは、各ユーザおよびそのユーザが使用できる各接続アプリケーションの各プロビジョニングアクション (ユーザアカウントの作成、更新、削除など) に対して作成されます。たとえば、ユーザが 2 つの接続アプリケーションを使用する場合、そのユーザのアカウントを作成する 2 つの異なるサービスにプロビジョニング要求が送信され、Salesforce によって 2 つの UserProvisioningRequest オブジェクトが作成されます。

UserProvisioningRequest オブジェクトは、API バージョン 33.0 以降で使用できます。

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

create()、delete()、describeSObjects()、getDeleted()、getUpdated()、query()、retrieve()、undelete()、update()、upsert()

項目

項目	詳細
AppName	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明サービスプロバイダに関連付けられた接続アプリケーションの一意の名前。
ApprovalStatus	型 picklist プロパティ Create、Filter、Group、Restricted picklist、Sort、Update 説明現在の要求の承認状況。接続アプリケーションのユーザプロビジョニング設定で承認プロセスが有効になっていない場合、状況は `Not Required` です。承認プロセスが有効な場合、サポートされている値は次のとおりです。 `Required` — 関連付けられた接続アプリケーションのユーザプロビジョニング設定で承認プロセスが有効になっていますが、要求に対する応答がまだありません。 `Not Required` — 関連付けられた接続アプリケーションのユーザプロビジョニング設定で承認プロセスが有効になっていません。 `Approved` `Denied`
ConnectedAppId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明接続アプリケーションの 18 桁のアプリケーション ID。
ExternalUserId	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明対象システムのユーザの一意の識別子。
ManagerId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 SalesforceUserId 項目で指定されたユーザを管理するユーザの Salesforce ID。ユーザプロビジョニング要求に承認プロセスが設定されている場合、この値は要求の承認をマネージャに許可します。API バージョン 34.0 以降で利用できます。
Name	型 string プロパティ Autonumber、Defaulted on create、Filter、idLookup、Sort 説明このオブジェクトの一意の名前。
Operation	型 picklist プロパティ Create、Filter、Group、Restricted picklist、Sort、Update 説明プロビジョニング要求 (通常は User オブジェクトへの変更) に関連付けられたトリガによってコールされる Apex メソッド。サポートされている値は、次のとおりです。 `Create` `Read` `Update` `Deactivate` `Activate` `Freeze` `Unfreeze` `Reconcile` `Linking` たとえば、User オブジェクト項目 isActive が `false` に設定されている場合、UserProvisioningRequest オブジェクト Operation 項目値は `Deactivate` に設定されます。
OwnerId	型 reference プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明このオブジェクトを所有するグループまたはユーザの Salesforce ID。
SalesforceUserId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明要求を行うユーザの Salesforce ID。
ScheduleDate	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明この要求をサービスプロバイダに送信する日時。スケジュール設定はまだ実装されていません。現在、プロビジョニングの変更はサービスプロバイダに送信されるキューに直ちに入れられます。メモ
State	型 picklist プロパティ Create、Filter、Group、Restricted picklist、Sort、Update 説明この要求の状況。サポートされている値は、次のとおりです。 `New` `Requested` `Completed` `Failed` `Collecting` `Collected` `Analyzing` `Analyzed` `Committing` 調整プロセスが実行されていない限り、State は `New` から `Requested` に移行し、`Completed` または `Failed` に移行します。調整プロセス中の State 値の変更についての詳細は、「使用方法」を参照してください。
UserProvAccountId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明関連付けられた UserProvAccount オブジェクトの ID 値。
UserProvConfigId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明関連付けられた UserProvisioningConfig オブジェクトの ID 値。API バージョン 34.0 以降で利用できます。

使用方法

State 値は、サードパーティシステムのユーザと Salesforce ユーザを収集して比較するため、調整プロセス中 (Operation = Reconcile) に変更されます。通常、UserProvisioningRequest エントリが最初に作成されたときに、State 値は New になります。収集プロセスがトリガされると、State は Collecting に移行し、そのプロセスが完了すると State は Collected になります。分析プロセスがトリガされると、State は Analyzing に移行し、そのプロセスが完了すると State は Analyzed になります。プロセスで要求がコミットされると、State は Committing に移行し、プロパティが UserProvAccountStaging オブジェクトから UserProvAccount オブジェクトに移動します。プロパティが UserProvAccount オブジェクトに保存されると、State は Completed に移行します。

ただし、State は New で開始するとは限りません。たとえば、プログラムで UserProvAccountStaging エントリを挿入できます。サードパーティサービスのアカウントに対してこれらの行のリンクをトリガするプロセスが開始された場合、UserProvisioningRequest エントリは Analyzing State で開始する可能性があります。

また、State は現在有効なタスクから逆戻りすることはできません。たとえば、Analyzing State の成功時には Analyzed に進む必要があります。このプロセスが失敗した場合、State は Failed に変更される必要があります。特定の State の移行はプログラムでは実行できず、Salesforce によってトリガされる必要があります。

次の表に、各 State 値で発生することがある State の移行を示します。各行は現在の State 値に対応し、各列は発生しうる移行後の新しい State に対応します。

— この値への移行は許可されません。
— この値への移行は許可されます。
— Salesforce のみが State をこの値に移行できます。

	`New`	`Requested`	`Collecting`	`Collected`	`Analyzing`	`Analyzed`	`Committing`	`完了`	`Failed`
`New`
`Requested`
`Collecting`
`Collected`
`Analyzing`
`Analyzed`
`Committing`
`完了`
`Failed`