SalesforceのProcessInstanceでできること、使用方法を紹介

SalesforceのProcessInstanceでできること

SalesforceのProcessInstanceは、Salesforceが提供しているAPIの標準オブジェクトのひとつです。 ProcessInstanceと関連するオブジェクトを使用して、承認履歴のレポートを作成できます。

SalesforceのProcessInstanceと関連オブジェクト

Salesforceの標準オブジェクトには、5種類のProcessInstanceに関連するオブジェクトがあります。 ＜ProcessInstanceと関連オブジェクト＞ ・ProcessInstance エンドツーエンドの承認プロセスのインスタンスを指します。 ・ProcessInstanceHistory 承認プロセスに関連づけられた全ステップと未承認の申請を表示する、参照のみを行うオブジェクトです。 ・ProcessInstanceStep 承認プロセスの新しいステップ(作業項目)のクエリもしくは取得ができます。 ・ProcessInstanceNode 承認プロセスのインスタンスのステップを表示できます。プロセス定義のステップをさすProcessNodeと比較し、承認履歴を取得します。 ・ProcessInstanceWorkitem ユーザが保留している承認申請を表示できます。

SalesforceのProcessInstanceと関連オブジェクトの使用方法の例

ここでは、ProcessInstanceとProcessInstanceHistoryの使用方法を説明します。 この2種類のオブジェクトを使用して、ProcessInstanceStep、ProcessInstanceNode、ProcessInstanceWorkitemのレコードを参照したり、クエリすることができます。

SalesforceのProcessInstanceの使用方法

ProcessInstanceを使用して、承認プロセスの照会と取得ができます。 サポートされているコール：describeSObjects()、query()、retrieve()

ProcessInstanceStepレコードのステップを参照するサンプルコード

Salesforce上のProcessInstanceレコード個々に関連するすべてのProcessInstanceStepレコードの詳細を返す、SOQLクエリのサンプルを紹介します。 ネストされたクエリは、ProcessInstanceオブジェクトのProcessInstanceStepの子relationshipNameのStepsを参照します。

SELECT Id, (SELECT Id, StepStatus, Comments FROM Steps)
FROM ProcessInstance

ProcessInstanceWorkitemを参照するサンプルコード

Salesforce上のProcessInstanceレコード個々に関連するすべてのProcessInstanceWorkitemレコードの詳細を表示する、SOQLクエリのサンプルです。 ネストされたクエリはProcessInstanceオブジェクトのProcessInstanceWorkitemの子relationshipNameのWorkitemsを参照します。

SELECT Id, (SELECT Id, ActorId, ProcessInstanceId FROM Workitems)
FROM ProcessInstance

SalesforceのProcessInstanceHistoryの使用方法

承認プロセスに使用するSalesforceユーザインターフェースの関連リスト機能をコピーできます。 ProcessInstanceHistoryでは、ProcessInstanceStepオブジェクトとProcessInstanceWorkitemの統一された参照のみのビュー、ProcessInstanceHistoryの照会はできませんが、親のProcessInstanceオブジェクトからネストされたクエリにProcessInstanceHistoryを含んで照会できます。また、親オブジェクトの項目に対するセキュリティが重視されています。 サポートされているコール：describeSObjects()

ProcessInstanceHistoryを参照するサンプルコード

ProcessInstanceレコード個々に関連する、すべてのProcessInstanceHistoryレコードを返すサンプルです。 このサンプルでは、ネストされたクエリはStepsAndWorkitemsを参照し、Workitemsは、ProcessInstanceオブジェクトのProcessInstanceHistoryの子relationshipNameとなります。

SELECT Id, (SELECT Id, StepStatus, Comments FROM StepsAndWorkitems)
FROM ProcessInstance

SalesforceにおけるProcessInstance関連のロールアウト

Summer ’14のロールアウトにより、組織にリリースされたときに保留されていた、各承認プロセスインスタンスの一部の項目値が入力されない状況が解消されています。 Summer ’14のロールアウト後は、該当する値についても、承認プロセスの承認、却下、承認要求の再割り当てなどの処理が行われた後に入力されます。

SalesforceのProcessInstanceを活用した承認プロセス管理

今回は、SalesforceのProcessInstanceについて説明しました。 ProcessInstanceと関連オブジェクトを組み合わせて、Salesforceの承認プロセスの情報を取得できます。 ProcessInstanceの機能や使用方法を理解すれば、社内の承認プロセスを管理する機能を作成できます。]]>