この記事の目次
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 ProcessInstanceProcessInstanceWorkitemを参照するサンプルコード
Salesforce上のProcessInstanceレコード個々に関連するすべてのProcessInstanceWorkitemレコードの詳細を表示する、SOQLクエリのサンプルです。 ネストされたクエリはProcessInstanceオブジェクトのProcessInstanceWorkitemの子relationshipNameのWorkitemsを参照します。SELECT Id, (SELECT Id, ActorId, ProcessInstanceId FROM Workitems)
FROM ProcessInstanceSalesforceの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 ProcessInstanceSalesforceにおけるProcessInstance関連のロールアウト
Summer ’14のロールアウトにより、組織にリリースされたときに保留されていた、各承認プロセスインスタンスの一部の項目値が入力されない状況が解消されています。 Summer ’14のロールアウト後は、該当する値についても、承認プロセスの承認、却下、承認要求の再割り当てなどの処理が行われた後に入力されます。SalesforceのProcessInstanceを活用した承認プロセス管理
今回は、SalesforceのProcessInstanceについて説明しました。
ProcessInstanceと関連オブジェクトを組み合わせて、Salesforceの承認プロセスの情報を取得できます。
ProcessInstanceの機能や使用方法を理解すれば、社内の承認プロセスを管理する機能を作成できます。]]>
