バージョン 8.1.0 ibm openpages with...

IBM OpenPages with Watsonバージョン 8.1.0

OpenPages Business Process 作成者ガイド

IBM

注記本書および本書で紹介する製品をご使用になる前に、63 ページの『特記事項』に記載されている情報をお読みください。

iv IBM OpenPages with Watson バージョン 8.1.0 : OpenPages Business Process 作成者ガイド

本資料は IBM OpenPages with Watson バージョン 8.1.0 を対象として作成されており、その後のリリースも対象となる場合があります。お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示されたりする場合があります。原典：

IBM OpenPages with WatsonVersion 8.1.0OpenPages Business Process Author's Guide

発行：日本アイ・ビー・エム株式会社

担当：トランスレーション・サービス・センター

ライセンス資料 - IBM Corporation の所有財産。© Copyright IBM Corporation, 2016, 2019.

vi IBM OpenPages with Watson バージョン 8.1.0 : OpenPages Business Process 作成者ガイド

目次

注記......................................................................................................................iii

概要......................................................................................................................ix

第 1 章概説 ............................................................................................................1

第 2 章 OpenPages Platform Toolkit........................................................................3OpenPages Platform Toolkit 内のリソース................................................................................................. 3

第 3 章 OpenPages Solutions Toolkit.......................................................................5OpenPages Solutions Toolkit 内の各リソース............................................................................................ 5

第 4 章 OpenPages の統合サービス..........................................................................7OPAssociateChildren................................................................................................................................... 7OPAssociateParents.....................................................................................................................................7OPCopyObjects............................................................................................................................................ 7OPCreateObject........................................................................................................................................... 8OPDeleteObject............................................................................................................................................8OPDissociateChildren.................................................................................................................................. 8OPDissociateParents................................................................................................................................... 9OPExecuteReportFragment......................................................................................................................... 9OPGenericObjectQuery................................................................................................................................9OPGetBaseURL.......................................................................................................................................... 10OPGetChildAssociations............................................................................................................................10OPGetEnumeratedValues..........................................................................................................................10OPGetObject.............................................................................................................................................. 11OPGetParentAssociations......................................................................................................................... 11OPHierarchicalAssigneeQuery.................................................................................................................. 11OPHierarchicalQuery................................................................................................................................. 12OPLaunchChildProcesses..........................................................................................................................13OPLockObject.............................................................................................................................................13OPMakeAddNewLink................................................................................................................................. 14OPMakeDetailLink......................................................................................................................................14OPMakeDocumentLink.............................................................................................................................. 14OPMoveObjects..........................................................................................................................................15OPPerformRESTGet................................................................................................................................... 15OPUnlockObject.........................................................................................................................................16OPUpdateObject........................................................................................................................................ 16オブジェクト・フィールドによるチーム・フィルター............................................................................16

第 5 章プロセス・オーサリングの例....................................................................... 19OPObjectSelection クライアント・サイド・ヒューマン・サービスの使用............................................19フィールドの値に基づいたプロセス・タスクの割り当て........................................................................20Coach ページへのリッチ・テキスト・フィールドの追加........................................................................21Coach ページへの単一または複数の列挙フィールドの追加.................................................................... 22Coach ページへの従属選択リスト付きの列挙フィールドの追加.............................................................23Coach ページへの計算済みフィールドの追加.......................................................................................... 25Coach ページへの責任者フィールドの追加..............................................................................................26Coach ページでの OpenPages 詳細ページへのリンクの追加.................................................................. 28

vii

Coach ページでの Cognos レポートへのリンクの追加............................................................................ 29Coach ページへの添付ファイルの追加..................................................................................................... 30Coach ページでの添付ファイルのダウンロード.......................................................................................32統合サービスを使用した OpenPages オブジェクトの作成......................................................................34クライアント・サイド・ヒューマン・サービスを使用した OpenPages オブジェクトの更新...............36ローカリゼーション・リソースの使用..................................................................................................... 38基本階層型プロセスの定義........................................................................................................................40子プロセスの定義.................................................................................................................................40親プロセスの定義.................................................................................................................................41

拡張階層型プロセスの定義........................................................................................................................44OPLaunchChildProcesses を使用する親プロセスの定義....................................................................44子プロセスが完了するまで待機するように親プロセスを拡張........................................................... 46

子オブジェクトのリストの取得................................................................................................................ 51オブジェクトのロックとロック解除......................................................................................................... 52E メール通知の送信................................................................................................................................... 53実行中のプロセスの強制終了.................................................................................................................... 56

第 6 章エラー・メッセージと処理.......................................................................... 59統合サービスが発行するエラー・メッセージ.......................................................................................... 59クライアント・サイド・ヒューマン・サービスへのエラー処理の追加..................................................60

特記事項.............................................................................................................. 63

viii

概要IBM® Business Process Manager を使用して、IBM OpenPages® with Watson™ のニーズと要件を満たす自動ビジネス・プロセス・ソリューションを開発および実装できます。対象読者IBM OpenPages with Watson Business Process Author's Guideは、ビジネス・プロセスの作成者向けに記載されています。これらのユーザーは、ワークフロー・ソリューションを開発し、IBM OpenPages withWatson と IBM Business Process Manager との統合方法を理解します。IBM OpenPages with Watson の資料に関する次の重要な情報をご確認ください。IBM は、クラウドとオンプレミスの両方の IBM OpenPages with Watson デプロイメントに役立つ一連の資料を用意しています。IBM OpenPages with Watson の資料には、クラウドでは使用できない場合がある特定の機能や関数に関する説明があります。例えば、IBM OpenPages with Watson on Cloud には、IBMBusiness Process Manager との統合および特定の管理機能は含まれません。使用中の製品バージョンで利用可能な機能についてご質問がある場合は、IBM サポート・コミュニティーを通じて IBM OpenPages サポートにお問い合わせください。情報の入手方法製品資料 (各国語版の資料を含む) を Web で入手するには、IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter) にアクセスしてください。アクセシビリティー機能アクセシビリティー機能は、運動障害または視覚障害など身体に障害を持つユーザーが情報技術プロダクトを快適に使用できるようにサポートします。IBM OpenPages with Watson 資料にはアクセシビリティー機能が備わっています。 PDF 文書は補助的なものであるため、追加のアクセシビリティー機能はありません。将来の見通しに関する記述本資料は、製品の現行機能について説明するものです。現在利用できない項目への言及が含まれる場合もありますが、将来的に使用可能になることを示唆するものではありません。このような言及は、なんらかの資料、コード、または機能を提供するという誓約、保証、または法的義務ではありません。特性や機能の開発、公開、およびその時期に関しては、引き続き IBM が単独裁量権を有します。

https://www.ibm.com/mysupport

http://www.ibm.com/support/knowledgecenter

x IBM OpenPages with Watson バージョン 8.1.0 : OpenPages Business Process 作成者ガイド

第 1 章概説IBM OpenPages with Watson および IBM Business Process Manager の統合により、拡張レベルの GRC プロセス自動化にアクセスできます。IBM Business Process Manager は、スケーラブルで高度に構成できる業界最高レベルのプロセス自動化システムです。要件に合わせたワークフロー・ソリューションを開発できます。ユーザー・タスクのニーズを一意に満たす形式でオブジェクト情報を表示するカスタム Coach ページを構成することもできます。ビジネス・プロセスが Coach ページを呼び出したときに、ユーザーはそのビジネス・プロセスを続行するために情報を入力する必要があります。また、IBM OpenPages with Watson API に適合する一連の統合ツールキットを使用して、既存のデータと構成を活用できます。ユーザーは、ホーム・ページで組み込みの IBM BPM Process Portal を使用して作業することで、GRC プロセスを起動し、それに対して作業できます。ユーザーが「Process Portal」タブをクリックすると、システムによってネイティブの BPM Process Portal が開かれます。IBM OpenPages with Watson との統合を開始するには、IBM Business Process Manager を確実に理解しておく必要があります。IBM Business Process Manager の情報を検索するには、http://www.ibm.com/support/knowledgecenter/SSFPJS_8.5.7/com.ibm.wbpm.main.doc/kc-homepage-bpm.html (http://www.ibm.com/support/knowledgecenter/SSFPJS_8.5.7/com.ibm.wbpm.main.doc/kc-homepage-bpm.html) にアクセスしてください。

http://www.ibm.com/support/knowledgecenter/SSFPJS_8.5.7/com.ibm.wbpm.main.doc/kc-homepage-bpm.html

http://www.ibm.com/support/knowledgecenter/SSFPJS_8.5.7/com.ibm.wbpm.main.doc/kc-homepage-bpm.html

2 IBM OpenPages with Watson バージョン 8.1.0 : OpenPages Business Process 作成者ガイド

第 2 章 OpenPages Platform ToolkitOpenPages Platform Toolkit は、IBM OpenPages with Watson と IBM Business Process Manager の部品を統合するために使用します。

OpenPages Platform Toolkit 内のリソースOpenPages Platform Toolkit には、ビジネス・プロセスを定義し、ビジネス・プロセスと OpenPages との間の対話を構築するのに使用するリソースが含まれています。依存関係を使用することで、プロセス・アプリケーションを OpenPages Platform Toolkit にリンクできます。OpenPages Platform Toolkit は、OpenPages のリリースおよびフィックスパックで更新される標準ツールキットです。Toolkit の成果物を直接編集しないでください。OpenPages Platform Toolkit で使用できるリソースを、次の図に示します。

図 1. OpenPages Platform Toolkit

Ajax サービスAjax サービスは、Coach ビュー内から OpenPages と対話します。Coach ビュー内の Ajax サービスは、OpenPages への REST API 呼び出しを実行できます。例えば、ユーザーがドロップダウン・コントロールに OpenPages の値を取り込むようにするときに、Ajax サービスを使用できます。詳しくは、http://www.ibm.com/support/knowledgecenter/SSFPJS_8.5.0/com.ibm.wbpm.wle.editor.doc/develop/topics/tajaxservice.html (http://www.ibm.com/support/knowledgecenter/SSFPJS_8.5.0/com.ibm.wbpm.wle.editor.doc/develop/topics/tajaxservice.html) を参照してください。デプロイメント・サービスデプロイメント・サービスは、特定の機能を実行する呼び出しおよびスクリプトを追加します。これは、プロセス・アプリケーションが別の環境内のサーバーにデプロイされるときに行われます。ビジネス・オブジェクト統合サービスでは、入力および出力として、OPCurrency、OPCurrencyField、OPEnumValue、OPFieldDefinition、および OPObject の各ビジネス・オブジェクトを使用します。ビジネス・オブジェクトは、ビジネス・データに対する変数として使用できるカスタム・タイプです。このデータは、プロセスとそのサービスが使用できる必要があります。変数は、ビジネス・プロセス定義内のアクティビティー、または統合サービスやヒューマン・サービスなどのサービスのステップで使用されるビジネス・データを取り込みます。

http://www.ibm.com/support/knowledgecenter/SSFPJS_8.5.0/com.ibm.wbpm.wle.editor.doc/develop/topics/tajaxservice.html



クライアント・サイドのヒューマン・サービスヒューマン・サービスは、ユーザーの作業対象のタスクを作成するコンポーネントです。ヒューマン・サービスは、ユーザーに表示する画面データ、およびユーザーから取得するデータの説明である Coach コンポーネントの取り込み機能を提供します。クライアント・サイドのヒューマン・サービスには、ユーザーがビジネス・プロセスで作業する OpenPages オブジェクトを選択するときに使用されるOPObjectSelection が含まれています。OPObjectSelection の使用方法の例については、19 ページの『OPObjectSelection クライアント・サイド・ヒューマン・サービスの使用』を参照してください。OpenPagesホーム・ページにある「プロセス・ポータル」タブも、クライアント・サイドのヒューマン・サービスです。ユーザーはそれにアクセスして、ビジネス・プロセスの起動、タスクの要求、およびタスクでの作業を行います。統合サービス統合サービスは、OpenPages データと対話します。このサービスは、OpenPages をサポートするように設計および構築されています。詳細については、7 ページの『第 4 章 OpenPages の統合サービス』を参照してください。リソース・バンドル・グループリソース・バンドル・グループに含まれているのは、次のとおりです。• OPPlatformTexts は、OPObjectSelection が、OpenPages オブジェクトに関連付けられている UI 要素に対して使用します。ビジネス・プロセスで OPPlatformTexts を使用しないでください。

• OPSystemFieldLabels は、OPObjectSelection が、OpenPages オブジェクトに関連付けられているフィールド・ラベルに対して使用します。ビジネス・プロセスで OPSystemFieldLabels を使用しないでください。サーバー・ファイルおよび WebFile

サーバー・ファイルと WebFile は、自動的に生成されます。サーバー・ファイルには、ツールキットにデプロイされる Java™ コードが含まれています。WebFile には、Coach ページを設計するときに使用するイメージ・アイコンとスタイル・シートが含まれています。


第 3 章 OpenPages Solutions ToolkitOpenPages Solutions Toolkit は、IBM OpenPages with Watson と IBM Business Process Manager の部品を統合するために使用します。

OpenPages Solutions Toolkit 内の各リソースOpenPages Solutions Toolkit には、固有のオブジェクト・スキーマに基づいてビジネス・オブジェクトへのアクセスを提供するリソースが含まれています。すべてのビジネス・オブジェクト、ビジネス・オブジェクトのフィールド、およびフィールド間の関係にアクセスできます。フィールドのラベル、ロケール、および複数の言語でのアプリケーション・テキストにもアクセスできます。リソースは、IBM OpenPageswith Watson 内のオブジェクト・データにアクセスできるようにする Coach 画面とワークフロー・アクティビティーの構築に使用します。依存関係を使用することで、プロセス・アプリケーションを OpenPagesSolutions Toolkit にリンクできます。OpenPages Solutions Toolkit は、オブジェクト・スキーマに基づいて生成されます。そのため、OpenPagesの顧客ごとに固有の OpenPages Solutions Toolkit があります。データ・モデルを変更した場合、再生成する必要があります。OpenPages Platform Toolkit と同様、OpenPages Solution Toolkit は、OpenPages のリリースおよびフィックスパックで更新ができます。Toolkit の成果物を直接編集しないでください。OpenPages Solutions Toolkit で使用できるリソースを、次の図に示します。

図 2. OpenPages Solutions Toolkit

顧客のスキーマに基づいたカスタム・ビジネス・オブジェクト各顧客に固有の OpenPages ビジネス・オブジェクト名の先頭は、OP です。例えば、SOXRisk の OpenPagesオブジェクト・タイプは、IBM BPM では OPSOXRisk という名前になります。変数は、ビジネス・プロセス定義内のアクティビティー、または統合サービスやヒューマン・サービスなどのサービスのステップで使用されるビジネス・データを取り込みます。オブジェクトおよびフィールドのラベルリソース・バンドル・グループは、OpenPages 内のオブジェクト・テキストおよびアプリケーション・テキストのコピーにアクセスできるようにします。プロセス定義内のリソースにアクセスして、Coach ビューに表示するオブジェクト・ラベルとフィールド・ラベルの言語を制御できます。• OPObjectLabels を使用して、ローカライズされた、オブジェクト・タイプのラベルにアクセスします。単一のラベルと複数のラベルの両方が使用可能です。

• OPFieldLabels を使用して、ローカライズされたオブジェクト・フィールドのラベルにアクセスします。OpenPages データは、顧客ごとに固有です。アプリケーション・テキストアプリケーション・テキスト・データは、顧客ごとに固有です。プロセス定義内のこのリソースにアクセスして、Coach ビューに表示するアプリケーション・テキストの言語を制御できます。OPAppText* リソースを使用して、ローカライズされたカテゴリー別のアプリケーション・テキストにアクセスします。デフォルトではこの Toolkit には、 OPAppTextLabels、OPAppTextTitles、OPAppTextValidationMessages、および OPAppTextCustom が含まれています。必要に応じて、さらに多くのカテゴリーをコピーできます。op-bpm-tool.jar コマンド・ライン・ツールで -appTextCategories オプションを使用します。

これらのリソースの使用方法の例については、38 ページの『ローカリゼーション・リソースの使用』を参照してください。


第 4 章 OpenPages の統合サービスOpenPages Platform Toolkit には、OpenPages 内のデータにアクセスするためにビジネス・プロセスで使用できる統合サービスが含まれています。入力パラメーターと出力パラメーターは、特に記載されていない限り必須です。

OPAssociateChildrenOPAssociateChildren は、指定のオブジェクトと子を関連付けるために使用します。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。objectId - 親オブジェクトのオブジェクト ID または絶対パス。ストリング。children - 関連付けるオブジェクトの ID または絶対パスのリスト。ストリングのリスト。

出力パラメーターなし

OPAssociateParentsOPAssociateParents は、指定のオブジェクトと親を関連付けるために使用します。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。objectId - 子オブジェクトのオブジェクト ID または絶対パス。ストリング。parents - 関連付けるオブジェクトの ID または絶対パスのリスト。ストリングのリスト。


OPCopyObjectsOPCopyObjects は、1 つ以上のオブジェクトをターゲットとなる特定の親にコピーするために使用されます。OPCopyObject を使用して、無制限の数のオブジェクトをコピーできます。ただし、多数のオブジェクトをコピーすると、HTTP(S) 読み取りタイムアウトで操作が失敗します。要求を複数の REST API 呼び出しに分割するスクリプトを使用すると、この問題を回避できます。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。targetParentId - ターゲット親オブジェクトのオブジェクト ID または絶対パス。ストリング。sourceObjectIds - ソース・オブジェクトの ID または絶対パスのリスト。ストリングのリスト。includesChildren - ソース・オブジェクトの子を含めるか、ソース・オブジェクトをコピーするかを示すのに使用するフラグ。ブール。conflictBehavior - 競合時の動作を決定するパラメーター。オプション。ストリング。以下のいずれかの値を指定できます。

• CREATECOPYOF – コピーを作成し、ターゲットの場所のコピーの名前にプレフィックスを追加します。プレフィックスは、競合の最初のインスタンスには Copy of、n 番めのインスタンスには Copy(n) of です。

• OVERWRITE - ソースの GRC オブジェクトで宛先の GRC オブジェクトを上書きします。• USEEXISTING - 宛先の GRC オブジェクトを保持し、それを移動対象のソース・オブジェクトに関連付けます。

• ERROR - 競合が存在している場合、OpenPagesException をプロンプトに表示します。childrenTypesToCopy - コピーするオブジェクト・タイプの ID または名前。オプション。ストリングのリスト。

出力パラメーターcopiedObjects - コピーされたオブジェクトのリスト。

OPCreateObjectOPCreateObject は、指定のフィールド値に基づいてオブジェクトを作成するために使用されます。OPCreateObject の使用方法の例については、19 ページの『OPObjectSelection クライアント・サイド・ヒューマン・サービスの使用』を参照してください。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。inObject - 作成するオブジェクト。オブジェクトのタイプは、OpenPages Solution Toolkit のビジネス・オブジェクトのいずれかである必要があります。任意。

出力パラメーターoutObject - ID 付きの、作成されたオブジェクト。オブジェクトのタイプは、inObject と同じです。

OPDeleteObjectOPDeleteObject は、objectId で指定したオブジェクトを削除するために使用します。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。objectId - 削除するオブジェクトのオブジェクト ID または絶対パス。ストリング。


OPDissociateChildrenOPDissociateChildren は、指定のオブジェクトと子の関連付けを解除するために使用されます。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。objectId - 親オブジェクトのオブジェクト ID または絶対パス。ストリング。children - 関連付けを解除するオブジェクトの ID または絶対パスのリスト。ストリングのリスト。



OPDissociateParentsOPDissociateParents は、指定のオブジェクトと親の関連付けを解除するために使用されます。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。objectId - 子オブジェクトのオブジェクト ID または絶対パス。ストリング。parents - 関連付けを解除するオブジェクトの ID または絶対パスのリスト。ストリングのリスト。


OPExecuteReportFragmentOPExecuteReportFragment は、特定のレポート・フラグメントを実行して HTML フラグメントである値を返すために使用します。HTML フラグメントにアイコンやイメージ・ファイルへのリンクが含まれていないことを確認してください。リンクは、Cognos® や IBM OpenPages with Watson でなく、IBM Business Process Manager 内で解決されるため、Coach ページにはレンダリングされません。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。objectId - オブジェクトのオブジェクト ID または絶対パス。ストリング。field - bundle-name:field-name の形式のフィールド名。ストリング。

出力パラメーターfragment - 実行されたレポート・フラグメントの値 (HTML フラグメント)。

OPGenericObjectQueryOPGenericObjectQuery は、IBM OpenPages with Watson GRC の REST API に、一般的な GRC オブジェクトのクエリーを発行するために使用されます。このサービスは、詳細な構成とカスタマイズが可能なサービスです。クエリー・ステートメント構文について詳しくは、IBM OpenPages with Watson GRC REST APIGuideを参照してください。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。queryStatement - OpenPages API のクエリー構文 (例: SELECT [Resource ID], [Name]FROM [SOXIssue]) を使用したクエリーの SELECT ステートメント。ストリング。isPrimary - 1 つのクエリー内で複数のタイプを結合する場合に、親と子の間の 1 次関連付けを優先するには true、すべての関連付けを返すには false に設定します。ブール。isCaseInsensitive - クエリー内のストリング値を比較する場合に大/小文字の違いを無視するにはtrue に設定します。デフォルトは false です。ブール。start - 結果の開始索引。最初の結果は 0 になります。リスト全体ではなく、特定の数の結果を取得するために使用します。例えば、start が 0 で、pageSize が 500 の場合、サービスは、クエリーによって検出された最初の 500 件 (0 から 499) までの結果を返します。start が 500 で、pageSize も500 の場合、次の 500 件 (500 から 999) の結果が返されます。start を使用すると、大規模なデータ・セットのパフォーマンスを改善できます。整数。

第 4 章 OpenPages の統合サービス 9

pageSize - REST API に対する要求が返すことができるクエリー結果の最大数。クエリー・フィルターと一致するすべてのクエリー結果を返すには、pageSizeに 0 を指定します。整数。returnType - 指定した場合、returnType はクエリーによって返されるビジネス・オブジェクト・タイプです。指定しない場合、OPObject ビジネス・オブジェクトが返されます。指定したクエリーがビジネス・オブジェクトに対する列を返さない場合、動作は予期できません。オプション。ストリング。

出力パラメーターreturnObjects - 指定した returnType のクエリーで返される GRC オブジェクトのリスト。指定しない場合は OPObject。queryStatement では、指定した returnType のフィールドと一致しているGRC オブジェクトのフィールドを選択する必要があります。queryStatement の SELECT 節の一部ではない returnType GRC オブジェクトのフィールドは、すべて NULL になります。

OPGetBaseURLOPGetBaseURL は、OpenPages サーバーのベース URL (例: http://opserver:port/) を取得するために使用します。例えば、このサービスを使用して、「詳細ビュー」ページの URL を構成できます。OpGetBaseURL の使用方法の例については、53 ページの『E メール通知の送信』を参照してください。入力パラメーターなし

出力パラメーターbaseURL - OpenPages サーバーのベース URL。

OPGetChildAssociationsOPGetChildAssociations は、子の関連付けのリストを取得するために使用します。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。ObjectId - 親オブジェクトのオブジェクト ID または絶対パス。ストリング。

出力パラメーターchildren - OPObject タイプのリスト。OPObject の 3 つのフィールド (id、path、およびtypeDefinitionId) にデータが取り込まれます。OPObject タイプの他のパラメーターは NULL です。

OPGetEnumeratedValuesOPGetEnumeratedValues は、列挙フィールドの列挙値 (ドロップダウン値) のリストを取得するために使用されます。依存関係選択リストを構成するときは、サービス呼び出し元が controllingValue 引数を渡すことで、使用できる列挙値を取得します。OPGetEnumeratedValues の使用方法の例については、23 ページの『Coach ページへの従属選択リスト付きの列挙フィールドの追加』を参照してください。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。ObjectTypeName - オブジェクト・タイプの名前 (例: SOXBusEntity)。ストリング。fieldName - bundle-name:field-name の形式のフィールドの名前 (例: OPSS-BusEnt:EntityType)。ストリング。ControllingValue - 依存関係選択リストが構成されているときに使用される統制フィールドの値。オプション。ストリング。


出力パラメーターoutObject - 列挙値のリスト。タイプは、OPEnumValue の値のリストです。

OPGetObjectOPGetObject は、GRC オブジェクトからのビジネス・オブジェクト情報を返すために使用されます。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。ObjectId - オブジェクトのオブジェクト ID または絶対パス。ストリング。computeReportFields - 計算済みフィールドの値を取得するか、NULL のままにするかを示すのに使用するフラグ。ブール。Fields - bundle-name:field-name の形式の取得するフィールド名のリスト。オプション。ストリングのリスト。

出力パラメーターoutObject - 取得された OpenPages オブジェクト。タイプは、取得するオブジェクト・タイプに基づいて決定されます。これは、OpenPages Solution Toolkit で定義されているビジネス・オブジェクトのいずれかです。

OPGetParentAssociationsOPGetParentAssociations は、親の関連付けのリストを取得するために使用されます。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。objectId - 子オブジェクトのオブジェクト ID または絶対パス。ストリング。

出力パラメーターparents - OPObject タイプのリスト。OPObject 内の id、path、および typeDefinitionId の 3 つのフィールドにデータが取り込まれます。OPObject タイプの他のパラメーターは NULL です。

OPHierarchicalAssigneeQueryOPHierarchicalAssigneeQuery は、特定の親インスタンスの下にある子オブジェクトについての階層クエリーを作成するために特殊なケースで使用されます。この方法によって、子オブジェクト・タイプについてのシステム・フィールドと共に、単一のフィールドを返すことができます。このフィールドは、IBMOpenPages with Watson GRC の REST API に一般的な GRC オブジェクトのクエリーを発行するために、assigneeField パラメーターで指定されます。OPHierarchicalAssigneeQuery の使用方法の例については、40 ページの『基本階層型プロセスの定義』を参照してください。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。parentType - クエリー対象の親オブジェクト・タイプの名前。ストリング。parentId - 親インスタンスの ID。ストリング。childType - クエリーを実行して返す子オブジェクト・タイプの名前。ストリング。assigneeField - 結果として返す子オブジェクト・タイプのフィールドを識別するフィールド名。field_group:field という命名規則を使用して、フィールドを修飾できます。ストリング。


isPrimary - 1 つのクエリー内で複数のタイプを結合する場合に、親と子の間の 1 次関連付けを優先するには true、すべての関連付けを返すには false に設定します。ブール。isCaseInsensitive - クエリー内のストリング値を比較する場合に大/小文字の違いを無視するにはtrue に設定します。デフォルトは false です。ブール。filters - クエリーに追加のフィルター条件を適用するために使用します。有効な API クエリー構文([Object Type].[Field Group:Field Name]) で指定する必要があります。フィルターは、クエリーに対して親タイプまたは子タイプのいずれかのフィールド用である必要があります。追加フィルターが不要な場合は null が渡されます。ストリング。start - 結果の開始索引。最初の結果は 0 になります。リスト全体ではなく、特定の数の結果を取得するために使用します。例えば、start が 0 で、pageSize が 500 の場合、サービスは、クエリーによって検出された最初の 500 件 (0 から 499) までの結果を返します。start が 500 で、pageSize も500 の場合、次の 500 件 (500 から 999) の結果が返されます。start を使用すると、大規模なデータ・セットのパフォーマンスを改善できます。整数。pageSize - REST API に対する要求が返すことができるクエリー結果の最大数。クエリー・フィルターと一致するすべてのクエリー結果を返すには、pageSizeに 0 を指定します。整数。isDirect - クエリーで、子タイプの階層全体を検査するか、直接の子を検査するかを指定するために使用します。ブール。

出力パラメーターreturnObjects - assigneeField で指定したフィールドを含む、親の子として返される GRC オブジェクトのリスト。

OPHierarchicalQueryOPHierarchicalQuery は、特定の親インスタンスの下にある子オブジェクトについての階層クエリーを作成するために使用されます。OPHierarchicalQuery の使用方法の例については、51 ページの『子オブジェクトのリストの取得』を参照してください。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。parentType - クエリー対象の親オブジェクト・タイプの名前。ストリング。parentId - 親インスタンスの ID。ストリング。childType - クエリーを実行して返す子オブジェクト・タイプの名前。ストリング。isPrimary - 1 つのクエリー内で複数のタイプを結合する場合に、親と子の間の 1 次関連付けを優先するには true、すべての関連付けを返すには false に設定します。ブール。isCaseInsensitive - クエリー内のストリング値を比較する場合に大/小文字の違いを無視するにはtrue に設定します。デフォルトは false です。ブール。filters - クエリーに追加のフィルター条件を適用するために使用します。有効な API クエリー構文([Object Type].[Field Group:Field Name]) で指定する必要があります。フィルターは、クエリーに対して親タイプまたは子タイプのいずれかのフィールド用である必要があります。追加フィルターが不要な場合は null が渡されます。ストリング。fields - 指定する場合、クエリーによって返されるフィールドの明示的リストです。フィールドは、コンマで区切り、field_group:field の形式で指定する必要があります。有効な API クエリー構文で指定する必要があります。また、クエリー・ステートメントの SELECT 節として、デフォルト値に代わって使用されます。指定が許可されるのは、子タイプのフィールドのみです。指定しない場合、デフォルトで、子タイプからのシステム・フィールドのみが返されます。オプション。ストリング。fields - 指定する場合、クエリーによって返されるフィールドの明示的リストです。フィールドは、コンマで区切る必要があり、[return_type].[field_group:field] という形式か、次のいずれか


の特殊キーワードを使用して指定する必要があります: Id (リソース ID のみの場合)、または SystemFields (子のタイプのすべてのシステム・フィールドの場合)。有効な API クエリー構文で指定する必要があります。また、クエリー・ステートメントの SELECT 節として、デフォルト値に代わって使用されます。指定が許可されるのは、子タイプのフィールドのみです。未指定の場合、デフォルトでは、子のタイプのリソース ID システム・フィールドのみが返されます。オプション。ストリング。start - 結果の開始索引。最初の結果は 0 になります。リスト全体ではなく、特定の数の結果を取得するために使用します。例えば、start が 0 で、pageSize が 500 の場合、サービスは、クエリーによって検出された最初の 500 件 (0 から 499) までの結果を返します。start が 500 で、pageSize も500 の場合、次の 500 件 (500 から 999) の結果が返されます。start を使用すると、大規模なデータ・セットのパフォーマンスを改善できます。整数。pageSize - REST API に対する要求が返すことができるクエリー結果の最大数。クエリー・フィルターと一致するすべてのクエリー結果を返すには、pageSizeに 0 を指定します。整数。isDirect - クエリーで、子タイプの階層全体を検査するか、直接の子を検査するかを指定するために使用します。ブール。

出力パラメーターreturnObjects - 親の子として返される GRC オブジェクトのリスト。

OPLaunchChildProcessesOPLaunchChildProcesses は、階層型プロセスの子プロセスを起動するために使用されます。OPLaunchChildProcesses の使用方法の例については、44 ページの『拡張階層型プロセスの定義』を参照してください。入力パラメーター

ProcessName – 起動するビジネス・プロセス定義の名前。ストリング。InputValues – リスト内の各エントリーが、起動する新規プロセスに入力値として渡されます。リストのサイズにより、起動するプロセスの数が決まります。InputValues マップは、起動するプロセスの入力タイプ変数に一致します。マップのキーは入力変数名で、マップの値は変数に渡される値です。マップ・リスト。Delay – プロセスを起動した後にサービスを一時停止する時間 (ミリ秒)。パフォーマンスの問題を回避するために、比較的長い遅延を使用してください。整数。AddDependency – 起動対象の子プロセスから親プロセスへの依存関係を追加します。起動対象の子プロセスに親を依存させることで、この 2 つのプロセス間に関係があるということを IBM BusinessProcess Manager に認識させます。すべての子プロセスが完了するまで、親プロセスは完了できません。ブール。親プロセスを終了すると、すべての子プロセスも終了します。

出力パラメーターChildPIDs – 子プロセス・インスタンスの ID のリスト。ストリングのリスト。

OPLockObjectOPLockObject は、objectId で指定したオブジェクトをロックするために使用します。OPLockObject の使用方法の例については、52 ページの『オブジェクトのロックとロック解除』を参照してください。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。ObjectId - オブジェクトのオブジェクト ID または絶対パス。ストリング。



OPMakeAddNewLinkOPMakeAddNewLink は、OpenPages で「新規追加」ウィザードを開くための HTML ハイパーリンク・タグを作成する際に使用します。特定の新しいオブジェクト・タイプと、親、親タイプ、およびビュー名に対するオプションのパラメーターを追加できます。リンクは新しいウィンドウで開きます。OPMakeAddNewLink の使用方法の例については、30 ページの『Coach ページへの添付ファイルの追加』を参照してください。入力パラメーター

newObjectType - 追加するオブジェクト・タイプの名前。ストリング。parentId - 「新規追加」ウィザードでデフォルトで選択される親のリソース ID。オプション。ストリング。parentType - デフォルトの親のオブジェクト・タイプ。オプション。ストリング。viewName - 新しいオブジェクト・タイプ用の特定のビュー。オプション。ストリング。linkText - リンクに表示するテキスト。ストリング。

出力パラメーターaddNewLink - オブジェクトに対して「新規追加」ウィザードを開くためのリンクの作成に使用するHTML コード。ストリング。

OPMakeDetailLinkOPMakeDetailLink は、OpenPages でオブジェクトの詳細ビューを開く HTML ハイパーリンク・タグを作成するために使用します。オプション・パラメーターを使用して、プロファイル・ビューの名前を指定できます。OPMakeDetailLink の使用方法の例については、28 ページの『Coach ページでの OpenPages 詳細ページへのリンクの追加』を参照してください。入力パラメーター

fileId - OpenPages 内のリンクされているオブジェクトのリソース ID。ストリング。viewName - オブジェクト・タイプ用の特定のビュー。指定しない場合のデフォルトは、詳細ビューです。オプション。ストリング。rootOPAppContext - OpenPages のルート・コンテキストのパス (例: openpages)linkText - リンクに表示するテキスト。ストリング。

出力パラメーターdetailViewLink - オブジェクトに対して「詳細ビュー」を開くために使用する HTML コード。ストリング。

OPMakeDocumentLinkOPMakeDocumentLink は、OpenPages から直接ファイルをダウンロードするための HTML ハイパーリンク・タグを作成する際に使用します。タスク志向のハイパーリンクについて詳しくは、https://www.ibm.com/support/knowledgecenter/SSFUEU_8.0.0/op_grc_admin/c_adm_task_oriented_hyperlinking.htmlを参照してください。OPMakeDocumentLink の使用方法の例については、32 ページの『Coach ページでの添付ファイルのダウンロード』を参照してください。


https://www.ibm.com/support/knowledgecenter/SSFUEU_8.0.0/op_grc_admin/c_adm_task_oriented_hyperlinking.html

https://www.ibm.com/support/knowledgecenter/SSFUEU_8.0.0/op_grc_admin/c_adm_task_oriented_hyperlinking.html

入力パラメーターfileId - 文書ファイルの resourceId。SOXDocument のオブジェクト・タイプである必要があります。ストリング。rootOPAppContext - OpenPages のルート・コンテキストのパス (例: openpages)linkText - リンクに表示するテキスト。ストリング。

出力パラメーターdocumentLink - ファイルをダウンロードするためのリンクの作成に使用する HTML コード。ストリング。

OPMoveObjectsOPMoveObjects は、1 つ以上のオブジェクトをターゲットとなる特定の親に移動するために使用されます。OPMoveObject を使用して、無制限の数のオブジェクトを移動できます。ただし、多数のオブジェクトを移動すると、HTTP(S) 読み取りタイムアウトで操作が失敗します。要求を複数の REST API 呼び出しに分割するスクリプトを使用すると、この問題を回避できます。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。targetParentId - ターゲット親オブジェクトのオブジェクト ID または絶対パス。ストリング。sourceObjectIds - ソース・オブジェクトの ID または絶対パスのリスト。ストリングのリスト。conflictBehavior - 競合時の動作を決定するパラメーター。オプション。ストリング。以下のいずれかの値を指定できます。• OVERWRITE - ソースの GRC オブジェクトで宛先の GRC オブジェクトを上書きします。• USEEXISTING - 宛先の GRC オブジェクトを保持し、それを移動対象のソース・オブジェクトに関連付けます。

• ERROR - 競合が存在している場合、OpenPagesException をプロンプトに表示します。childrenTypesToMove - 移動するオブジェクト・タイプの ID または名前。オプション。ストリングのリスト。


OPPerformRESTGetOPPerformRESTGet は、IBM OpenPages with Watson GRC REST API にアクセスするために使用できる汎用統合サービスです。要件を満たす統合サービスがないが、REST API が要件を満たしている場合、これを使用できます。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。requestPath – IBM OpenPages with Watson GRC REST API のパス (<OpenPages アプリケーション URL>/grc/api からの相対パス)。URL の末尾にパラメーターを追加できます。例えば、requestPath が以下のとおりであるとします。/contents/12345/permissions/effective?user=orm

この場合、ID が 12345 のオブジェクトについて、orm ユーザーの有効なアクセス制御が取得されます。

出力パラメーターresponse – REST API 呼び出しからの未加工ストリング (通常は REST API JSON 形式)。IBMBusiness Process Manager スクリプトを使用して、この未加工ストリングからデータを抽出できます。例:

var jsonResult = JSON.parse(tw.local.response); log.info("Effective permission for a user:" + jsonResult.securityPrincipal); log.info("¥tcanRead:" + jsonResult.canRead); log.info("¥tcanWrite:" + jsonResult.canWrite);

OPUnlockObjectOPUnlockObject は、objectId で指定したオブジェクトのロックを解除するために使用します。OPUnlockObject の使用方法の例については、52 ページの『オブジェクトのロックとロック解除』を参照してください。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。ObjectId - オブジェクトのオブジェクト ID または絶対パス。ストリング。


OPUpdateObjectOPUpdateObject は、指定のフィールド値に基づいてオブジェクトを更新するために使用されます。入力パラメーター

systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。inObject - 更新するオブジェクト。オブジェクトのタイプは、OpenPages Solution Toolkit のビジネス・オブジェクトのいずれかである必要があります。任意。

出力パラメーターoutObject - 更新されたオブジェクト。オブジェクトのタイプは、inObject と同じです。

オブジェクト・フィールドによるチーム・フィルターオブジェクト・フィールドによるチーム・フィルターは、オブジェクト・フィールドに名前があるユーザー (統制活動の責任者、リスクのオーナーなど) にタスクを割り当てるために使用するチーム・フィルター・サービスです。これは、ユーザー・グループ、および複数選択のユーザーとグループに対しても使用できます。入力パラメーター

originalTeam - チーム・フィルター・サービスに対して予約されているパラメーター。チーム。systemTask - この操作をシステム・アカウントとして実行するか、現在のユーザーとして実行するかを示すのに使用するフラグ。ブール。objectId - オブジェクトのオブジェクト ID または絶対パス。ストリング。field - bundle-name:field-name の形式のフィールド名。ストリング。expandGroups - グループ・メンバーシップを再帰的に解決し、フィルターに掛けられたチーム内のユーザーのみを含めることを示すフラグ。グループに多数のユーザーおよびサブグループが含まれている場合、これはシステム・パフォーマンスに影響することがあります。OpenPages のグループは、IBMBusiness Process Manager では使用できない場合があるため、LDAP が構成されている環境では trueに設定してください。ブール。


出力パラメーターfilteredTeam - チーム・フィルター・サービスに対して予約されているパラメーター。チーム。


第 5 章プロセス・オーサリングの例プロセス作成者は、本書にある例を使用して、IBM OpenPages with Watson を使用した IBM BusinessProcess Manager の実装時に発生する一般的な問題に対する解決策を検索できます。

OPObjectSelection クライアント・サイド・ヒューマン・サービスの使用OPObjectSelection クライアント・サイド・ヒューマン・サービスを使用して、ユーザーがビジネス・プロセスで OpenPages オブジェクトを選択できるようにします。クライアント・サイドのヒューマン・サービス OPObjectSelection では、ユーザーに以下のユーザー・インターフェースが表示されます。

インターフェースのタイトルは、オブジェクト・タイプです。それ以外の点では、使用するオブジェクト・タイプに関係なく、インターフェースは同じです。ユーザーが値を入力し、検索アイコンをクリックします。検索により、名前または説明における一致が見つかったオブジェクトのリストが返されます。次に、ユーザーは、オブジェクトを選択するか、キャンセルできます。選択したオブジェクトはビジネス・プロセスに返され、プロセスは続行します。次の例では、OPObjectSelection は、クライアント・サイド・ヒューマン・サービスの最初のステップとして挿入されます。

OPObjectSelection で使用されるオブジェクト・タイプは、ビジネス・プロセスの定義に応じて、変数で定義されるか、先行タスクで定義されます。また、モデルとして OPObjectSelection を使用して、独自のオブジェクト選択クライアント・サイド・ヒューマン・サービスを設計できます。手順

1. Process Designer Web エディターを開きます。

2.プロセス・アプリケーションを作成します。3. Process Designer で、そのプロセス・アプリケーションを開きます。4. OpenPages Toolkit に依存関係を追加します。

a)「Toolkit」の横の「+」をクリックし、「OpenPages Platform」を選択します。b)「Toolkit」の横の「+」をクリックし、「OpenPages Solutions」を選択します。

5.「ユーザー・インターフェース」 > 「クライアント・サイド・ヒューマン・サービス」の横にある「新規」をクリックして、ユーザー・インターフェースの名前を入力します。

6.パレットからキャンバスに「ネストされたクライアント・サイド・ヒューマン・サービス」をドラッグします。

7.「プロパティー」ペインで「実装」タブを選択します。8.「ネストされたクライアント・サイド・ヒューマン・サービス」で、OPObjectSelection を選択します。

9.「データ・マッピング」タブを選択し、入出力マッピングを定義します。

10.これで、クライアント・サイド・ヒューマン・サービス全体を定義できるようになりました。

フィールドの値に基づいたプロセス・タスクの割り当て指定したフィールドの値に基づいて、ユーザーにプロセス・タスクを割り当てることができます。この例では、プロセスで新しいアクティビティーを作成し、そのアクティビティーをオブジェクトのプライマリー責任者に割り当てます。手順1. Process Designer Web エディターを開きます。2.プロセス・アプリケーションを作成します。3. Process Designer で、そのプロセス・アプリケーションを開きます。4. OpenPages Toolkit に依存関係を追加します。


5.プロセスを作成します。6.パレットからキャンバスに「アクティビティー」をドラッグします。7.「プロパティー」ペインで「割り当て (Assignments)」タブを選択します。

a)「割り当て先」で、チームを選択します。b)「チーム」で、「すべてのユーザー」を選択します。


c)「チーム・フィルター・サービス」で、オブジェクト・フィールドごとに「チーム・フィルター」を選択します。

d)以下のように「チーム・フィルター・サービスの入力マッピング (Team Filter Service InputMapping)」を指定します。•「systemTask」で、タスクが OpenPages にシステム・アカウントとしてアクセスできるのか、あるいは現在のアカウントとしてアクセスできるのかを定義します。

•「objectId」に、オブジェクトの ID を入力します。これは、ローカル変数にすることができます。•「field」に、フィールド定義ストリングを入力します。これは、ローカル変数にすることができます。

8.プロセスを保存します。

Coach ページへのリッチ・テキスト・フィールドの追加リッチ・テキスト・フィールドが含まれている Coach ページを定義すると、OpenPages のリッチ・テキスト・エディター (CKEditor) では、IBM BPM リッチ・テキスト・エディターと比べて、異なる書式設定動作が発生します。この例では、Coach ページにリッチ・テキスト・フィールドを追加します。BPM エディターを使用して Coach ページ上に定義したリッチ・テキスト・フィールドの場合、CKEditor ではすべての書式設定が保持されるわけではありません。ユーザーが Coach ページ上のでリッチ・テキスト・フィールドにテキストを入力すると、そのフィールドが OpenPages の「詳細」ページに読み取り専用モードで表示されます。このフィールドは、ユーザーが Coach ページで指定した書式設定で表示されます。ただし、ユーザーが CKEditor を使用してオブジェクトを編集すると、次の書式設定は削除されます。• フォント・サイズ• フォント・タイプ• 段落の位置揃え (左、右、中央)• <blockquote> を使用する字下げタグのスタイル属性同様に、OpenPages で CKEditor エディターを使用して定義するリッチ・テキスト・フィールドについて、BPM エディターではすべての書式設定が保持されるわけではありません。ユーザーが OpenPages でリッチ・テキスト・フィールドにテキストを入力すると、そのフィールドを Coach ページに表示できます。テキストが Coach ページに表示されるときに、次の例外を除き、ほとんどの書式設定が保持されます。• 顔文字• 段落の位置揃え (位置調整)• 文書のブックマーク• 表の挿入• フォントの色• CKEditor 固有の CSS クラスのスタイル

第 5 章プロセス・オーサリングの例 21

手順1. Process Designer Web エディターを開きます。2.プロセス・アプリケーションを作成します。3. Process Designer で、そのプロセス・アプリケーションを開きます。4. OpenPages Toolkit に依存関係を追加します。



6.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。7.パレットからキャンバスに「テキスト域」ビューをドラッグします。8.「プロパティー」ペインで「構成 (Configuration)」タブをクリックします。9.「テキスト域タイプ」を「リッチ・テキスト」に設定します。

10. Coach ページを保存します。

Coach ページへの単一または複数の列挙フィールドの追加Coach ページに単一または複数の列挙フィールドを追加できます。この例では、新しいクライアント・サイドのヒューマン・サービスを作成し、Coach ページ用の単一の列挙フィールドを定義します。手順

1. Process Designer Web エディターを開きます。2.プロセス・アプリケーションを作成します。3. Process Designer で、そのプロセス・アプリケーションを開きます。4. OpenPages Toolkit に依存関係を追加します。



6.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。7.パレットからキャンバスに「単一選択」ビューまたは「複数選択」ビューをドラッグします。8.「プロパティー」ペインでラベルを指定し、コントロールを変数にバインドします。この例では、変数はインシデント・オブジェクトの OPSS-Inc フィールド・グループの Criticality フィールドにバインドされています。バインドされた変数のタイプが OPEnumValue であることを確認します。

9.「構成 (Configuration)」タブをクリックし、以下のフィールドを定義します。a)「選択サービス」で、OpenPages Platform Toolkit から OPAjaxGetEnumValues 統合サービスを選択します。


b)「選択サービスの入力テキスト (Selection service input text)」に、オブジェクト・タイプ、フィールド・グループ、およびフィールドを <object type>:<field group>:<field> の形式で指定します。

c)「表示名プロパティー」で、localizationLabel を選択します。d)「ソートを無効にする」を選択して、OpenPages で構成されている順序を維持します。


Coach ページへの従属選択リスト付きの列挙フィールドの追加Coach ページに従属選択リスト付きの列挙フィールドを追加することができます。この例では、新しいクライアント・サイドのヒューマン・サービスを作成し、Coach ページ用の依存関係選択リストを備えた列挙フィールドを定義します。手順

1. Process Designer のデスクトップ・エディターを開きます。2. Process Designer を開きます。3. OpenPages Toolkit に依存関係を追加します。

a)「Toolkit」をクリックし、「OpenPages Platform」を選択します。b)「Toolkit」をクリックし、「OpenPages Solutions」を選択します。

4.「ユーザー・インターフェース」 > 「Ajax サービス」の横にある「新規」をクリックして、サービスの名前を入力します。

5.「プロパティー」ペインで、text 入力変数と results 出力変数を追加します。変数名と変数タイプは一致している必要があります。

6.「図」タブをクリックし、パレットからキャンバスに「ネストされたサービス」をドラッグします。

7.「プロパティー」ペインで、「実装」タブをクリックし、OpenPages Platform Toolkit からOPGetEnumeratedValues サービスを選択します。

8.「データ・マッピング」ペインをクリックします。以下のパラメーターを指定します。a)「objectTypeName」に、選択対象の列挙フィールドのオブジェクト・タイプを入力します。b)「fieldName」に、選択対象の列挙フィールドのオブジェクト・フィールド・グループおよびオブジェクト・フィールドを入力します。

c)「controllingValue」に「tw.local.text」と入力します。d)「outObject」に「tw.local.results」と入力します。

9. Ajax サービスを保存します。10. Process Designer Web エディターを開きます。11.「ユーザー・インターフェース」 > 「クライアント・サイド・ヒューマン・サービス」の横にある「新規」をクリックして、ユーザー・インターフェースの名前を入力します。

12.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。13.パレットからキャンバスに「単一選択」ビューをドラッグします。14.「プロパティー」ペインでラベルを指定し、コントロールを OPEnumValue 変数にバインドします。15.「構成 (Configuration)」タブをクリックし、以下のフィールドを定義します。

a)「選択サービス」で、作成したサービスを選択します。b)「選択サービスの入力テキスト (Selection service input text)」に、統制列挙フィールドの名前フィールドを入力します。

c)「表示名プロパティー」で、localizedLabel を選択します。d)「ソートを無効にする」チェック・ボックスを選択して、OpenPages 側で構成されている順序を維持します。

図 3. 「構成 (Configuration)」タブでのフィールドの定義16. Coach サービスを保存します。


Coach ページへの計算済みフィールドの追加Coach ページに計算済みフィールドを追加できます。この例では、新しいクライアント・サイドのヒューマン・サービスを作成し、Coach ページ用の計算済みフィールドを定義します。計算済みフィールドのビジネス・オブジェクト・タイプは、ストリングです。値には、通常、未加工のHTML タグが含まれます。




6.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。7.「ビュー」 > 「拡張」をクリックし、パレットからキャンバスに「カスタム HTML」をドラッグします。

8.「プロパティー」ペインで「HTML」タブを選択します。9.「変数」を選択します。

10.ラベルを指定し、コントロールを変数にバインドします。この例では、変数はシナリオ分析の OPSS-ScenAn フィールド・グループの Buckets Overview フィールドにバインドされています。



Coach ページへの責任者フィールドの追加Coach ページに責任者フィールドを追加することができます。この例では、新しいクライアント・サイドのヒューマン・サービスを作成し、Coach ページを定義し、Coach ページに責任者フィールドを追加します。複数ユーザー・セレクター表示タイプを使用している責任者フィールドは、Coach ページに $;<value>$;と表示されます。例えば、プライマリー責任者の値「John Smith」は、Coach ページに「$;John Smith$;」と表示されます。$; は、プログラマチックに削除する必要があります。単一ユーザー・セレクター表示タイプを使用している責任者フィールドでは、$; は表示されません。この例では、クライアント・サイドのヒューマン・サービスで「OwnerField」という名前の変数に責任者フィールド値が含まれているものと想定します。これには、$;OpenPagesAdministrator$;itg$;fcm$; という値が入っています。Coach ページで値を表示する前に、ユーザーが読みやすいフォーマットに変換する必要があります。値は、Coach ページで変更された後に、変換して OpenPages 形式に戻す必要があります。




6.「変数」タブをクリックし、タイプが文字列の OutputOwnerField プライベート変数を追加します。7.「図」タブをクリックします。8.パレットからキャンバスに「クライアント・サイド・スクリプト」をドラッグします。「開始」の後に配置します。矢印リンクを「開始」ノードから新しい「クライアント・サイド・スクリプト」ノードに接続し、「クライアント・サイド・スクリプト」ノードから Coach に接続します。

9.パレットからキャンバスに 2 つめの「クライアント・サイド・スクリプト」ノードをドラッグします。Coach の後に配置し、矢印を接続します。すべてのノードに記述名を付けます。

10.最初のクライアント・サイド・スクリプト・ノードをクリックします。a)「プロパティー」ペインで「スクリプト」をクリックします。b)スクリプト・コードを入力します。次のコードでは、OwnerField 変数内の値を OpenPages 形式から表示形式に変換し、それを OutputOwnerFieldに返します。

if( tw.local.OwnerField !== null){//split based on the OP delimiter for multi-user selectors var names = tw.local.OwnerField.split("$;"); //array has a trailing and leading empty string //due to the extra delimiters in OP value names.pop(); names.shift();

//use JS arrays.join() to concatenate the array of names //into comma-delimited list format tw.local.OutputOwnerField = names.join(",");}

11. 2 番目のクライアント・サイド・スクリプト・ノードをクリックします。a)「プロパティー」ペインで「スクリプト」をクリックします。b)スクリプト・コードを入力します。次のコードは、OutputOwnerField 変数の値を OpenPages 形式に戻します。それを OutputOwner 変数に返します。この値は、元の OpenPagesオブジェクトに保存できます。if( tw.local.OutputOwnerField !== null){

var names = tw.local.OutputOwnerField.split(",");

//array needs trailing and leading empty string //due to the extra delimiters in OP value

names.push("");

names.unshift("");

//use JS arrays.join() to concatenate the array of names //into OP multi-user list format

tw.local.OwnerField = names.join("$;");

}

12.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。a)パレットからキャンバスにビュー (「テキスト」ビューなど) をドラッグします。b)「プロパティー」ペインで、「ラベル」の横に「責任者フィールド」と入力します。c)「バインディング」の横の「選択」をクリックし、tw.local.OutputOwnerField 変数を選択します。

13. Coach ページを保存します。14.クライアント・サイドのヒューマン・サービスを実行します。コンマ区切りフォーマットでユーザー名が含まれているテキスト・フィールドが Coach ページに表示されます。

15.「OK」をクリックすると、テキスト・フィールドに値が返されます。2 つ目のスクリプトがこの値をOpenPages 形式に変換します。その後、例えば、プロセスは、新しい値でオブジェクトの責任者フィールドを更新できます。注 : この例のコードは、ユーザーによって入力された名前を検証しません。ユーザーは、複数の名前をコンマ区切り値として入力する必要があります。


Coach ページでの OpenPages 詳細ページへのリンクの追加Coach ページに OpenPages 詳細ページへのリンクを追加できます。この例では、新しいクライアント・サイドのヒューマン・サービスを作成し、OpenPages 詳細ページを開く Coach ページ上のリンクを定義します。テストのために、OpenPages 内の既存のオブジェクトのリソース ID の値を入力します。実際の実装環境では、クライアント・サイド・ヒューマン・サービス上の入力変数でリンクするオブジェクトの ID を指定します。手順



5.「ユーザー・インターフェース」 > 「クライアント・サイド・ヒューマン・サービス」の横にある「新規」をクリックして、ユーザー・インターフェースの名前 (「Risk Detail Link」など) を入力します。

6.「変数」タブをクリックし、タイプが文字列の DetailLink プライベート変数を追加します。7.「入力」で、タイプが文字列の RiskId 入力変数を追加します。「デフォルトあり」を選択します。テストのために、OpenPages 内の既存のリスク・オブジェクトのリソース ID の値を入力します。

8.「図」タブをクリックします。9.パレットからキャンバスに「サービス」をドラッグします。「開始」の後に配置します。矢印リンクを開始ノードから新しいサービス・ノードに接続し、サービス・ノードから Coach に接続します。ノードに記述名を付けます。

10.サービス・ノードをクリックし、「実装」ペインを選択します。11.「動作」セクションで「サービスの呼び出し」を選択し、OpenPages Platform Toolkit から

OPMakeDetailLink 統合サービスを選択します。12.「データ・マッピング」ペインを選択し、以下のパラメーターを指定します。

a)「fileId」で、tw.local.RiskId という名前の RiskId 入力変数を選択します。b)「linkText」に「OpenPages の詳細の表示 (See Details in OpenPages)」と入力します。c)オプションで、「viewName」に、オブジェクト・タイプのプロファイル・ビューの名前を入力します。ブランクのままにした場合、ユーザーのプロファイルのデフォルト・ビューが使用されます。

d)「出力マッピング (Output Mapping)」の「documentLink」に「tw.local.DetailLink」を入力します。


13.サービスへの変更内容を保存します。14.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。15.「ビュー」 > 「拡張」をクリックし、パレットからキャンバスに「カスタム HTML」をドラッグします。

16.「プロパティー」ペインで「HTML」タブを選択します。「変数」をクリックし、DetailLink プライベート変数を選択します。

あるいは、Coach ページでカスタム HTML ビューではなく、出力テキスト・ビューを使用できます。「出力テキスト」を選択し、「バインディング」の下で、DownloadLink|DetailLink private変数を選択します。「プロパティー」ペインをクリックし、「構成 (Configuration)」タブを選択します。「HTMLエンコードを無効にする (Disable HTML encoding)」の設定を選択解除から選択済みに変更します。

17. Coach ページを保存します。注 : ログインしていないユーザーが Coach ページでリンクをクリックすると、そのユーザーに、OpenPages にログインするように求めるプロンプトが表示されます。

Coach ページでの Cognos レポートへのリンクの追加Coach ページに Cognos レポートへのリンクを追加できます。この例では、新しいクライアント・サイドのヒューマン・サービスを作成し、Cognos レポートを開く Coach ページ上のリンクを定義します。


6.「変数」タブをクリックし、タイプが文字列の baseURL プライベート変数を追加します。7.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。8.「ビュー」 > 「拡張」をクリックし、パレットからキャンバスに「カスタム HTML」をドラッグします。

9.「プロパティー」ペインで「HTML」タブを選択し、HTML スニペットを追加します。

スニペットは、以下のようにすることができます。<a href='#' onclick='window.open("{{tw.local.baseURL}}/my.report.list.post.do?submitAction=preview&label=Current Reporting Period&reportId=899","Title","toolbars=no,status=yes,menubars=no")'>Audit Plan Report</a>

BPM は、二重大括弧 {{}} で囲まれたテキストを変数値に置き換えます。10.この例では、レポート ID 899 を、実行するレポートに置き換えることができます。レポート ID は、

OpenPages システムからレポートを実行したときの URL に含まれています。 baseURL 変数はOpenPages アプリケーション URL であり、Cognos レポートにリダイレクトされます。


Coach ページへの添付ファイルの追加Coach ページで添付ファイルを開くためのリンクを追加できます。この例では、新しいクライアント・サイドのヒューマン・サービスを作成し、新規ファイルを OpenPages にアップロードするための新規追加ウィザードを開く単一のリンクを定義します。添付ファイルは、OpenPages サーバー上に保管されます。



5.「ユーザー・インターフェース」 > 「クライアント・サイド・ヒューマン・サービス」の横にある「新規」をクリックして、ユーザー・インターフェースの名前 (「Add New Document」など) を入力します。

6.「変数」タブをクリックし、タイプが文字列の AddNewLink プライベート変数を追加します。7.「図」タブをクリックします。8.パレットからキャンバスに「サービス」をドラッグします。これを開始ノードの後に配置します。矢印リンクを開始ノードから新しいサービス・ノードに接続し、サービス・ノードから Coach に接続します。ノードに記述名を付けます。


OPMakeAddNewLink 統合サービスを選択します。11.「データ・マッピング」ペインを選択し、次のパラメーターを指定します。

a)「newObjectType」に、添付ファイルのオブジェクト・タイプである「SOXDocument」と入力します。

b)「linkText」に「新規文書の追加 (Add New Document)」と入力します。c)オプションで、「新規追加」ウィザードの動作を指定します。

•「parentId」に、「新規追加」ウィザードで 1 次親として事前選択されるデフォルトの親のリソース ID を入力します。

•「parentType」で、デフォルトの親のオブジェクト・タイプ (SOXRisk など) を選択します。•「viewName」に、新規オブジェクト・タイプの作成ビューを指定します。

d)「出力マッピング (Output Mapping)」の「addNewLink」に「tw.local.AddNewLink」と入力します。

12.サービスへの変更内容を保存します。13.「Coach」タブをクリックし、テンプレートを選択します。14.「ビュー」 > 「拡張」をクリックし、パレットからキャンバスに「カスタム HTML」をドラッグします。


15.「プロパティー」ペインで、「HTML」タブを選択し、「変数」をクリックして、AddNewLink プライベート変数を選択します。

16. Coach ページを保存します。注 : ログインしていないユーザーが Coach ページでリンクをクリックすると、そのユーザーに、OpenPages にログインするように求めるプロンプトが表示されます。そのユーザーが「新規追加」ウィザードで新しい添付ファイル (または他のオブジェクト・タイプ) を保存すると、ウィザードは最初の「新規追加」ページに戻ります。ユーザーは、同じタイプの別のオブジェクトを追加できるため、複数のエントリーを簡単に追加できます。

Coach ページでの添付ファイルのダウンロードCoach ページで添付ファイルをダウンロードするためのリンクを追加できます。この例では、新しいクライアント・サイドのヒューマン・サービスを作成し、OpenPages から既存の添付ファイルをダウンロードする単一のリンクを定義します。テストのために、OpenPages 内の既存の添付ファイルのリソース ID の値を入力します。実際の実装では、クライアント・サイド・ヒューマン・サービス上の入力変数を使用して、リンク先文書オブジェクトの ID を指定します。手順

1. Process Designer Web エディターを開きます。2.プロセス・アプリケーションを作成します。


3. Process Designer で、そのプロセス・アプリケーションを開きます。4. OpenPages Toolkit に依存関係を追加します。


5.「ユーザー・インターフェース」 > 「クライアント・サイド・ヒューマン・サービス」の横にある「新規」をクリックして、ユーザー・インターフェースの名前 (例: 「Download Document」) を入力します。

6.「変数」タブをクリックし、タイプが文字列の DownloadLink プライベート変数を追加します。7.「入力」で、タイプが文字列の DocId 入力変数を追加します。「デフォルトあり」を選択します。テストのために、OpenPages 内の既存の添付ファイル文書のリソース ID の値を入力します。

8.「図」タブをクリックします。9.パレットからキャンバスに「サービス」をドラッグします。「開始」の後に配置します。矢印リンクを開始ノードから新しいサービス・ノードに接続し、サービス・ノードから Coach に接続します。ノードに記述名を付けます。


OPMakeDocumentLink 統合サービスを選択します。12.「データ・マッピング」ペインを選択し、以下のパラメーターを指定します。

a)「fileId」で、tw.local.DocId という名前の DocId 入力変数を選択します。b)「linkText」に「ファイルのダウンロード (Download File)」と入力します。c)「出力マッピング (Output Mapping)」の「documentLink」に「tw.local.DownloadLink」を入力します。

13.サービスへの変更内容を保存します。14.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。15.「ビュー」 > 「拡張」をクリックし、パレットからキャンバスに「カスタム HTML」をドラッグします。


16.「プロパティー」ペインで、「HTML」タブを選択し、「変数」をクリックして、DownloadLink プライベート変数を選択します。

あるいは、Coach ページでカスタム HTML ビューではなく、出力テキスト・ビューを使用できます。「出力テキスト」を選択し、「バインディング」の下で、DownloadLink|DetailLink private変数を選択します。「プロパティー」ペインをクリックし、「構成 (Configuration)」タブを選択します。「HTMLエンコードを無効にする (Disable HTML encoding)」の設定を選択解除から選択済みに変更します。

17. Coach ページを保存します。注 : ログインしていないユーザーが Coach ページでリンクをクリックすると、そのユーザーに、OpenPages にログインするように求めるプロンプトが表示されます。この例では、ユーザーが Coachページ内のリンクをクリックすると、ユーザーのブラウザーでファイルが保存されます。添付ファイル詳細ページに移動することはありません。詳細ページにリンクするには、「OPMakeDetailLink」統合サービスを使用する必要があります。詳細については、14 ページの『OPMakeDetailLink』を参照してください。

統合サービスを使用した OpenPages オブジェクトの作成統合サービスを使用して、ユーザー入力なしに OpenPages オブジェクトを作成できます。この例では、インシデント・オブジェクトを作成するビジネス・プロセスを定義し、「重大度」フィールドを列挙フィールド値に設定します。




5.「プロセス」 > 「プロセス」の横の「新規」をクリックし、「Create Incident Process」という名前を付けます。

6.「変数」タブをクリックし、次の 2 つのプライベート変数を追加します。• タイプ OPIncident の incident• タイプ OPEnumValue の criticalityEnums。「リスト」属性を選択します。

7.「定義」タブをクリックします。8.パレットから「システム」レーンに「開始」イベント・ノードと「終了」イベント・ノードをドラッグします。「チーム」スイムレーンは削除してかまいません。これはこの例では使用しません。

9.パレットからキャンバスに「アクティビティー」ノードをドラッグします。a)「プロパティー」ペインで、「一般」タブをクリックし、「Get Criticality Enum Values」という名前を付けます。

b)「プロパティー」ペインで、「実装」タブをクリックし、「タイプ」を「システム・タスク」に変更します。OpenPages Platform Toolkit から OPGetEnumeratedValues サービスを選択します。

10.パレットからキャンバスに「アクティビティー」ノードをドラッグします。a)「プロパティー」ペインで、「一般」タブをクリックし、「Setup New Incident Variable」という名前を付けます。

b)「プロパティー」ペインで、「実装」タブをクリックし、「タイプ」を「スクリプト」に変更します。11.パレットからキャンバスに「アクティビティー」ノードをドラッグします。

a)「プロパティー」ペインで、「一般」タブをクリックし、「Create Incident」という名前を付けます。

b)「プロパティー」ペインで、「実装」タブをクリックし、「タイプ」を「システム・タスク」に変更します。OpenPages Platform Toolkit から OPCreateObject サービスを選択します。

12.ノードを、左から右にリストされている順にリンクします。

これで、アクティビティーのデータ・マッピングを構成する準備ができました。13.「Get Criticality Enum Values」ノードをクリックし、「データ・マッピング」ペインを選択します。「入力マッピング (Input Mapping)」で、以下のフィールドを定義します。


•「systemTask」に true と入力します。•「objectTypeName」に「Incident」と入力します。•「fieldName」に「OPSS-Inc:Criticality」と入力します。「出力マッピング」で、次のフィールドを定義します。

•「outObject」で、tw.local.criticalityEnums 変数を選択します。14.「Create Incident」ノードをクリックし、「データ・マッピング」ペインを選択します。「入力マッピング (Input Mapping)」で、以下のフィールドを定義します。「入力マッピング (Input Mapping)」で、以下のフィールドを定義します。

•「systemTask」に true と入力します。•「inObject」で、tw.local.incident 変数を選択します。「出力マッピング」で、次のフィールドを定義します。

•「outObject」で、tw.local.incident 変数を選択します。これで、スクリプトを入力する準備ができました。

15.「Setup New Incident Variable」ノードをクリックします。「プロパティー」ペインで、「スクリプト」タブをクリックします。次のコード例を入力します。tw.local.incident = new tw.object.OPIncident();tw.local.incident.base = new tw.object.OPObject();tw.local.incident.base.name = "BPM Test Object creation " + new java.util.Date();tw.local.incident.OPLC_Owners__PrimaryOwner = "OpenPagesAdministrator";tw.local.incident.OPSS_Inc__Criticality = tw.local.criticalityEnums[0];

このスクリプトにより、tw.local.incident 変数が空の OPIncident オブジェクトで初期化されます。次に、ユース・ケースの必要に応じて、さまざまなフィールドが設定されます。incident 変数のプロパティーと、それにネストされているプロパティー (tw.local.incident.base など) を使用することで、インシデント・オブジェクトの任意のフィールドを設定できます。この例では、次のフィールドが設定されます。• 名前は、動的に作成される値に設定されます。• プライマリー責任者は、OpenPagesAdministrator に設定されます。• 重大度列挙フィールドは、最初のアクティビティーでデータが設定された criticalityEnum 変数のうちのいずれかの値に設定されます。フィールドの列挙値の名前または ID がわかっている場合は、OPGetEnumeratedValues サービスを使用せずにそれを直接設定できます。例えば、「重大度」フィールドを「高」に設定するには、次のコードを入力します。tw.local.incident.OPSS_Inc__Criticality = new tw.object.OPEnumValue();tw.local.incident.OPSS_Inc__Criticality.name = "High";

16.変更内容をプロセスに保存します。

クライアント・サイド・ヒューマン・サービスを使用した OpenPages オブジェクトの更新

統合サービスを使用して、クライアント・サイド・ヒューマン・サービスで OpenPages オブジェクトを更新できます。ユーザーが Coach ページにアクセスして、特定のオブジェクトのフィールドを更新すると、その変更内容が OpenPages に反映されます。OPUpdateObject OpenPages 統合サービスを使用します。ただし、クライアント・サイド・ヒューマン・サービスから直接 OPUpdateObject を呼び出すことはできません。OPUpdateObject はビジネス・オブジェクト・タイプが ANY の入力パラメーターを使用するためです。これを回避するために、ユーザーが更新できるオブジェクト・タイプを呼び出す統合サービスを作成できます。この例では、オブジェクト・タイプを更新できる統合サービスを定義します。次に、


OPUpdateObject を使用するクライアント・サイド・ヒューマン・サービスで、そのサービスを呼び出します。手順

1. Process Designer のデスクトップ・エディターを開きます。2. Process Designer を開きます。まず、オブジェクト・タイプを呼び出す統合サービス (この例では OPIncident) を作成します。

3. OpenPages Toolkit に依存関係を追加します。a)「Toolkit」をクリックし、「OpenPages Platform」を選択します。b)「Toolkit」をクリックし、「OpenPages Solutions」を選択します。

4.「実装」 > 「統合サービス」の横の「新規」をクリックし、「OPUpdateIncident」という名前を付けます。

5.「変数」タブをクリックし、次の 2 つのプライベート変数を追加します。•「inObject」で、入力として OPIncident を選択します。•「outObject」で、出力として OPIncident を選択します。クライアント・サイド・ヒューマン・サービスから変数を呼び出すことができるように、inObjectのタイプを ANY ではなく OPIncident として定義します。

6.「図」タブをクリックし、パレットからキャンバスに「ネストされたサービス」ノードをドラッグします。a)これに、「Update Incident」という名前を付けます。b)「プロパティー」ペインで「実装」タブをクリックします。OPUpdateObject OpenPages 統合サービスを選択します。

c)「データ・マッピング」タブをクリックします。「入力マッピング」で、「systemTask」に false と入力し、「inObject」に tw.local.inObject と入力します。「出力マッピング」で、「outObject(ANY)」に tw.local.outObject と入力します。

7.「OPUpdateIncident」ノードの前後に開始ノードと終了ノードを接続します。8. OPUpdateIncident 統合サービスを保存します。これで、クライアント・サイド・ヒューマン・サービスを定義する準備ができました。

9.「ユーザー・インターフェース」 > 「クライアント・サイド・ヒューマン・サービス」の横にあるプラス・アイコンをクリックして、ユーザー・インターフェースの名前 (「View and Edit Incident」など) を入力します。

10.「変数」タブをクリックし、次の 2 つのプライベート変数を追加します。• 文字列タイプの入力変数として objectId• OPIncident タイプのプライベート変数として Incident

11.「図」をクリックします。12.パレットからキャンバスに「サービス」ノードをドラッグします。このノードは、「インシデント」オブジェクトを取得します。a)「プロパティー」ペインで、「一般」タブをクリックし、「Retrieve Incident」という名前を付けます。

b)「プロパティー」ペインで、「実装」タブをクリックし、OpenPages Platform Toolkit から OPGetObjectサービスを選択します。

c)「データ・マッピング」タブをクリックします。「入力マッピング」で、「systemTask」に false と入力し、「objectId」に tw.local.objectId と入力します。「出力マッピング」で、「outObject(ANY)」に tw.local.incident と入力します。

13.デフォルトの Coach ノードを編集します。これに、「View and Edit Incident」という名前を付けます。「Coach」タブをクリックし、ユーザーが「インシデント」オブジェクトを表示および編集できるように、Coach ページにコントロールをドラッグします。


14.パレットからキャンバスに「サービス」ノードをドラッグします。このノードは、ユーザーが入力した編集内容で「インシデント」オブジェクトを更新します。a)「プロパティー」ペインで、「一般」タブをクリックし、「Update Incident」という名前を付けます。

b)「プロパティー」ペインで、「実装」タブをクリックし、前に作成した OPUpdateIncident サービスを選択します。

15.ノードを、左から右に手順の順序で接続します。16.クライアント・サイド・ヒューマン・サービスを保存します。

ローカリゼーション・リソースの使用ローカライズした言語で、Coach ページ上のフィールドのラベルおよびテキストを表示できます。この例では、新しいクライアント・サイド・ヒューマン・サービスを作成し、ローカライズした言語でフィールドを表示できるようにする変数を定義します。手順1. Process Designer Web エディターを開きます。2.プロセス・アプリケーションを作成します。3. Process Designer で、そのプロセス・アプリケーションを開きます。4. OpenPages Toolkit に依存関係を追加します。



6.「変数 (Variables)」タブをクリックします。a)「ローカリゼーション・リソース (Localization Resources)」を展開します。b)ローカライズした言語で表示できるようにする要素に対する変数を定義します。例えば、OPFieldLabels や OPPlatformTexts を選択します。変数を定義すると、Coach ページの設計を開始できます。


7.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。a)パレットからキャンバスにビュー (「単一選択」ビューなど) をドラッグします。b)「プロパティー」ペインで、「ラベル」の横のアイコンをクリックします。c)「選択」をクリックし、フィールドを選択します。


図 4. Coach ページの定義8.コントロールを変数にバインドし、ビューの定義を続行します。9. Coach ページを保存します。

基本階層型プロセスの定義階層型のプロセスでは、あるプロセスの親オブジェクトが、その親オブジェクトに関連付けられているオブジェクトに対して、子プロセスを起動できます。この例では、OpenPages から課題オブジェクトを取得します。課題オブジェクトには、1 つ以上のアクション・アイテムが含まれていることがあります。アクション・アイテムの是正後、内部統制上の課題を完了できます。この例では、少数 (10 から 20) の子オブジェクトを起動します。親プロセスは OPHierarchyAssigneeQuery統合サービスおよびマルチインスタンス・ループ・タイプを使用します。多数の子オブジェクトが起動する場合、サーバーのパフォーマンスを最適化するためのプロセスを構築できます。詳細については、44ページの『拡張階層型プロセスの定義』を参照してください。

子プロセスの定義「Complete Action Item」という名前の子プロセスを定義します。このプロセスには、子プロセスを並列で起動できるようにするためのユーザー・タスクが含まれます。手順

1. Process Designer Web エディターを開きます。2.プロセス・アプリケーションを作成します。3. Process Designer で、そのプロセス・アプリケーションを開きます。


4. OpenPages Toolkit に依存関係を追加します。a)「Toolkit」の横の「+」をクリックし、「OpenPages Platform」を選択します。b)「Toolkit」の横の「+」をクリックし、「OpenPages Solutions」を選択します。

5.プロセスを作成し、「Complete Action Item」という名前を付けます。6.「変数 (Variables)」タブをクリックします。入力変数を追加し、actionitemId という名前を付けます。

7.新しいスイムレーンを作成するか、既存のスイムレーンの名前を「担当者」に変更します。8.スイムレーンに単一の「アクティビティー」ノードを追加し、そのノードを開始ノードと終了ノードに接続します。「プロパティー」ペインをクリックし、次の項目を定義します。a)「実装」をクリックし、デフォルト・ヒューマン・サービスを使用するユーザー・タスクを定義します。後から、これを別の Coach UI に置き換えることができます。

b)「データ・マッピング」をクリックし、Coach UI 定義の入力をセットアップします。tw.local.actionItemId 変数を渡し、OpenPages オブジェクトを取得するために Coach が使用する ID 用の入力変数にその変数をマップします。

c)「割り当て」をクリックし、アクション・アイテムに名前が記載されているユーザーが担当者になることを指定します。「割り当て」の下で、次のフィールドを定義します。•「割り当て先」で、チームを選択します。•「チーム」で、「すべてのユーザー」を選択します。•「チーム・フィルター・サービス」で、オブジェクト・フィールドごとに「チーム・フィルター」を選択します。

「入力マッピング (Input Mapping)」の下で、以下のフィールドを定義します。•「systemTask」に true と入力します。•「objectId」に、tw.local.actionId と入力します。•「field」に、OPSS-AI:Assignee と入力します。•「expandGroups」に false と入力します。

9.プロセスを保存します。10. Coach ページを定義します。「Complete Action Item」は、OpenPages Toolkit の OPGetObject 統合サービスを使用して取得する「アクション・アイテム」からの情報を表示するカスタム・ヒューマン・サービス (Coach) にすることが理想です。これにより、内部統制上の課題について、割り当てられたアクション・アイテムに対する作業を実行するように求めるプロンプトをアクション・アイテムの担当者に表示するタスクを、その担当者が取得できるようになります。

親プロセスの定義「Issue Remediation」という名前の親プロセスを定義します。これは、存在しているアクション・アイテムを判別します。これは、OPHierarchyAssigneeQuery 統合サービスを使用します。「Complete ActionItem」プロセスにリンクし、内部統制上の課題の下の子アクション・アイテムごとに、プロセスを開始します。プロセスの完了には、ループ処理が使用されます。


手順1.プロセスを作成し、「内部統制上の課題の是正」という名前を付けます。

2.「変数 (Variables)」タブをクリックします。a)タイプが OPSOXIssue の変数を作成します。「issue」という名前を付けます。b)タイプが OPSOXTask のリスト変数を作成します。「actions」という名前を付けます。

3.「定義」タブをクリックし、以下の 3 つのスイムレーンを作成します。• Issue Assignee• Action Item Owners• System

4.「Issue Assignee」スイムレーンで、「ユーザー・タスク」アクティビティー・ノードを作成します。a)「アクション・アイテムの作成」という名前を付けます。b)「割り当て (Assignments)」をクリックします。「割り当て」で、次のフィールドを定義します。

•「割り当て先」で、チームを選択します。•「チーム」で、「すべてのユーザー」を選択します。•「チーム・フィルター・サービス」で、オブジェクト・フィールドごとに「チーム・フィルター」を選択します。

「入力マッピング」で、次のフィールドを定義します。•「systemTask」に true と入力します。•「objectId」に、tw.local.issue.base.id と入力します。•「field」に、OPSS-Iss:Assignee と入力します。•「expandGroups」に、false と入力します。

5.「Issue Assignee」スイムレーンで、別の「ユーザー・タスク」アクティビティー・ノードを作成します。a)「最終レビューの実行」という名前を付けます。b)「割り当て (Assignments)」をクリックします。「割り当て」で、次のフィールドを定義します。

•「割り当て先」で、チームを選択します。


•「チーム」で、「すべてのユーザー」を選択します。•「チーム・フィルター・サービス」で、オブジェクト・フィールドごとに「チーム・フィルター」を選択します。

「入力マッピング」で、次のフィールドを定義します。•「systemTask」に true と入力します。•「objectId」に tw.local.issue.base.id と入力します。•「field」に OPSS-Iss:Assignee と入力します。•「expandGroups」に false と入力します。

6.「System」スイムレーンで、「ユーザー・タスク」アクティビティー・ノードを作成します。a)「内部統制上の課題の取得」という名前を付けます。b)「実装」をクリックします。c)「実装」で、OPGetObject 統合サービスを選択します。これはテストのために使用します。実際の実装環境では、ユーザーが内部統制上の課題を選択できるようにする Coach 処理の UI を起動できます。

7.「System」スイムレーンで、別の「ユーザー・タスク」アクティビティー・ノードを作成します。a)「アクション・アイテムの計算」という名前を付けます。b)「実装」をクリックします。「実装」で、OPHierarchicalAssigneeQuery 統合サービスを選択します。これは、「内部統制上の課題」の下の「アクション・アイテム」の子に対するクエリーを実行します。

c)「データ・マッピング」をクリックします。「入力マッピング」で、次のフィールドを定義します。•「systemTask」に true と入力します。•「parentType」に、SOXIssue と入力します。•「parentID」に、tw.local.issue.base.id と入力します。•「childType」に「SOXTask」と入力します。•「assigneeField」に「OPSS-AI:Assignee」と入力します。•「isPrimary」に「true」と入力します。•「isCaseInsensitive」に「true」と入力します。•「filters」をブランクのままにします。•「pageSize」をブランクのままにします。•「isDirect」に「true」と入力します。

8.「Action Item Owners」スイムレーンで、「リンクされたプロセス」ノードを作成します。a)これに、「Complete Action Item」という名前を付けます。b)「一般」をクリックします。「動作」の「ループ・タイプ」で、「マルチインスタンス・ループ」を選択します。

c)「マルチインスタンス・ループ」で、次のフィールドを定義します。•「開始数 (Start quantity)」に、「tw.local.actions.listLength」と入力します。•「順序付け」で、「並列実行」を選択します。「並列実行」を選択すると、各子プロセスは即時かつ同時に起動します。これによりスケーラビリティーの問題が発生する場合があります (IBM BPM は子の実行を制限しないため)。例えば、子プロセスがシステム・タスクのみ実行して、OpenPages で新規オブジェクトを作成する場合、パフォーマンス負荷を最小にするために、代わりに「順序付け」と「順次実行」を選択することが望ましい場合があります。子プロセスに並列実行する必要があるタスクがあり、多数の子プロセス(10 から 20 を上回る数の子プロセス) が発生する可能性がある場合、44 ページの『拡張階層型プロセスの定義』で代わりの設計を参照してください。

•「フロー条件」で、「すべて終了するまで待機 (すべて)」を選択します。


d)「実装」をクリックします。「実装」の「タイプ」で、「リンクされたプロセス」を選択します。e)「データ・マッピング」をクリックします。「入力マッピング」で、次のフィールドを定義します。

•「actionItemId」に tw.local.actions[tw.system.step.counter].base.id と入力します。

9.線を接続します。10.プロセスを保存します。

拡張階層型プロセスの定義階層型プロセスで OPLaunchChildProcesses 統合サービスを使用できます。階層型プロセスでは、あるプロセスの親オブジェクトが、その親オブジェクトに関連付けられているオブジェクトに対して、子プロセスを起動できます。この例では、サーバーのパフォーマンスに影響を与えることなく、多数の (場合によっては数百の) 子アクション・アイテムを処理する方法を示します。

始める前に40 ページの『基本階層型プロセスの定義』のタスクを完了します。この例は、当該タスクの知識とデータに基づいています。このタスクについて基本階層型プロセスの例は、リンクされたプロセスのプロセス実行を抑制できないため、データ量が少ない場合に最も適していました。拡張階層型プロセスの例は、データ量が多い場合に適しています。BPMAPI を使用して、ChildInputs リスト変数 (作成するプライベート変数) のすべての値に対して子プロセスを起動します。この API では、実行を抑制するためのプロセス間の遅延 (必要な場合) を含め、プロセスをどの程度素早く起動するか制御できます。最後に、子プロセスが完了するまで待ってから次のアクティビティーに移るように、親プロセスを拡張できます。

OPLaunchChildProcesses を使用する親プロセスの定義OPLaunchChildProcesses 統合サービスを使用するように基本階層型プロセスの親プロセスを変更します。


手順1.基本階層型プロセスの例で作成した親プロセス「Issue Remediation」を複製します。名前を「IssueRemediation Adv」に変更します。

2.基本階層型プロセスの例で作成した子プロセス「Complete Action Items」を複製します。名前を「Complete Action Items - Adv」に変更します。

3.「変数 (Variables)」タブをクリックします。a)タイプがマップ (システム・データ) のプライベート変数を作成します。「childInputs」という名前を付けます。

b)「リスト」を選択して、「childInputs」をマップのリストにします。c)デフォルト値について「デフォルトあり」を選択します。

4.「定義」タブをクリックします。このプロセスには、次の 3 つのスイムレーンがあります。• Issue Assignee• Action Item Owners• System

5.「Action Item Owners」スイムレーンで、「Complete Action Item」ノードを選択します。a)このノードの名前を「Launch Child Processes」に変更します。b)このノードを「リンクされたプロセス」から「システム・タスク」に変更します。c)「一般」をクリックします。「動作」の「ループ・タイプ」で「なし」を選択します。d)「実装」をクリックします。「タイプ」で「システム・タスク」を選択します。e)「実装」で、OPLaunchChildProcesses 統合サービスを選択します。f)「データ・マッピング」をクリックします。「入力マッピング」で、次のフィールドを定義します。

•「ProcessName」に、子プロセスの名前である「Complete Action Item - Adv」を入力します。

•「InputValues」に tw.local.childInputs と入力します。•「Delay」に 1000 と入力します。•「AddDependency」に true と入力します。

6.「System」スイムレーンで、「Compute Action Items」の後にスクリプト・アクティビティー・ノードを作成します。a)これに「Map Input Values」という名前を付けます。b)「スクリプト」をクリックします。c)次の例のようなスクリプトを入力します。親プロセスおよび子プロセスに対して、この例に示されている変数名を使用する場合、スクリプトを変更する必要はありません。//initialize childInputs List of Mapstw.local.childInputs = new tw.object.listOf.toolkit.TWSYS.Map();//loop for every action itemfor (var i=0; i<tw.local.actions.listLength; i++) { //get the action item var action = tw.local.actions[i]; //initialize a map for this action item var map = new tw.object.toolkit.TWSYS.Map(); //map values from the action to the input variable names of the child process map.put("actionItemId", action.base.id); //insert map to the childInputs list tw.local.childInputs.insertIntoList(i, map);

d)「Compute Action Items」からの矢印が「Map Input Values」につながるように連結し直します。「MapInput Values」からの矢印を「Launch Child Processes」に連結します。

7.プロセスを保存します。

タスクの結果OPLaunchChildProcesses 統合サービスは、子プロセスを起動しますが、子プロセスが完了するまで待機せずに、次のアクティビティーに進みます。リスト内のすべての子プロセスが起動した後、OPLaunchChildProcesses 統合サービスは完了し、親プロセスが再開され、次のアクティビティー・ノードに進みます。これは、「Issue Remediation」の例の「Launch Child Processes」の後で、子プロセスが完了したかどうかに関係なく、「Issue Assignee」が「Do Final Review」のタスクを取得することを意味します。また、OPLaunchChildProcesses の AddDependency の入力が TRUE の場合、親プロセスと子プロセスの間の関係が作成されます。この関係がない場合、子プロセスが起動した後に、この 2 つのプロセスにはつながりがありません。依存関係により、すべての子プロセスが終了するまで、親プロセスは終了できません。また、親プロセスを終了すると、子プロセスも終了します。ユース・ケースによっては、これで要件が満たされる場合があります。IBM Business Process Manager の関係について詳しくは、https://www.ibm.com/support/knowledgecenter/SSFTN5_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/tcrtrelation.htmlを参照してください。次のタスクこれで拡張階層型の例は終わりです。オプションで、子プロセスが完了するまで待ってから次のアクティビティーに移るように、親プロセスを拡張できます。

子プロセスが完了するまで待機するように親プロセスを拡張オプションで、子プロセスが完了するまで待ってから次のアクティビティーに移るように、親プロセスを拡張できます。子プロセスの終了時に子プロセスが親プロセスにメッセージを送信できるように、Undercover Agent を定義します。次の図は、この例の部分で説明されている拡張を示しています。


https://www.ibm.com/support/knowledgecenter/SSFTN5_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/tcrtrelation.html

https://www.ibm.com/support/knowledgecenter/SSFTN5_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/tcrtrelation.html

Undercover Agent の定義Undercover Agent を定義します。Undercover Agent は、プロセスがメッセージを送信および listen できるキューを定義します。Undercover Agent は、プロセスまたはビジネス・プロセス定義内のメッセージ・イベントまたはコンテンツ・イベントに添付され、そのイベントを処理するサービスを呼び出します。Undercover Agent について詳しくは、https://www.ibm.com/support/knowledgecenter/SSFTN5_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/using_undercover_agents.htmlを参照してください。手順1. Process Designer のデスクトップ・エディターを開きます。2.対象のプロセスを含むプロセス・アプリケーションを開きます。3.「実装」で「Undercover Agent」をクリックします。

a)「名前」に AI_Complete と入力します。b)「スケジュール・タイプ」で「イベント発生時」を選択します。c)「詳細」の「変数の型」で「ストリング」を選択します。


https://www.ibm.com/support/knowledgecenter/SSFTN5_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/using_undercover_agents.html

https://www.ibm.com/support/knowledgecenter/SSFTN5_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/using_undercover_agents.html

4. Undercover Agent を保存します。Undercover Agent メッセージを送信するための子プロセスの変更子プロセスを更新して、親プロセス ID への変数参照を設定し、Undercover Agent に送信するメッセージを作成します。手順1. Process Designer Web エディターを開きます。2.「Complete Action Item - Adv」という名前の子プロセスを開きます。3.「変数」タブをクリックし、タイプが文字列 (システム・データ) のプライベート変数を追加します。「ParentPID」という名前を付けます。

4.「定義」タブをクリックします。5.終了ノードをクリックします。6.「プロパティー」ペインで「実装」タブをクリックします。

a)「終了イベント・タイプ (End event type)」で「メッセージ」を選択します。b)「イベント・プロパティー (Event Properties)」の「添付メッセージ UCA (Attached message UCA)」で AI Complete Undercover Agent を選択します。

7.「データ・マッピング」をクリックします。「入力マッピング」で、次のフィールドを定義します。•「InputValues」に tw.local.ParentPID と入力します。


8.プロセスを保存します。Undercover Agent のメッセージを待機するように親プロセスを拡張子プロセスが完了するのを待機してから続行するように既存の親プロセスを拡張します。ここでは、カウンターを使用して、子プロセスの完了のタイミングを追跡します。各子プロセスの終了時に送信されるUndercover Agent メッセージを受信するために、中間メッセージ・イベント (IME) を使用します、Undercover Agent を使用することで、異なるプロセス・インスタンス間での非同期通信が可能になります。これにより、子プロセスの終了時に送信される、必要なメッセージを待機するように親プロセスを制御できます。手順1. Process Designer Web エディターを開きます。2.「Issue Remediation Adv」という名前の親プロセスを開きます。3.「変数 (Variables)」タブをクリックします。

a)タイプが整数 (システム・データ) のプライベート変数を作成します。「ChildrenFinished」という名前を付けます。「デフォルトあり」を選択し、0 に設定します。

b)タイプが文字列 (システム・データ) のプライベート変数を作成します。「currentProcessId」という名前を付けます。

4.「定義」タブをクリックします。このプロセスには、次の 3 つのスイムレーンがあります。• Issue Assignee• Action Item Owners• System

5.「Action Item Owners」スイムレーンで、「Launch Child Processes」システム・タスクの後に 2 つのノードを追加します。

6.最初に、中間イベントを追加します。a)これに「Wait For Child」という名前を付けます。


b)「実装」をクリックします。c)「実装」で、「添付されたメッセージ UCA」に対して「AI_Complete」を選択します。d)「メッセージをコンシューム」を選択します。e)「永続サブスクリプション」を選択します。f)「データ・マッピング」をクリックし、「相関変数」で「出力 (ストリング)(Output (String))」を選択します。「出力 = (Output =)」のマッピングで、「tw.local.currentProcessId」と入力します。

g)「事前および事後」をクリックし、「事後割り当て」に以下の割り当てを追加します。tw.local.ChildrenFinished = tw.local.ChildrenFinished + 1

7.次に、排他ゲートウェイを追加します。a)これに「Have Children Finished」という名前を付けます。b)排他ゲートウェイ・ノードから出て中間イベントに戻る矢印を作成します。c)ゲートウェイから次のステップである「Do Final Review」タスクへの 2 番目の矢印を作成します。d)中間イベントからゲートウェイへの矢印を作成します。e)「実装」で、「デフォルト・フロー」を「To Wait For Child」として設定します。f)「To Do Final Review」条件を次の式に設定します。

1. tw.local.ChildrenFinished == tw.local.actions.ListLength

8.「Map Input Values」スクリプト・ノードを開き、「スクリプト」をクリックします。a)スクリプトの開始部分に次の行を挿入します。

tw.local.currentProcessId = tw.system.currentProcessInstance.id;

b) map.put("actionItemId", action.base.id); という行を見つけます。この行の後に、次の行を挿入します。//map the process instance id to the child process map.put("ParentPID", tw.local.currentProcessId);

これにより、子プロセスの新しい入力変数にプロセス・インスタンス ID が渡されます。最終的にスクリプトは以下のようになります。tw.local.currentProcessId = tw.system.currentProcessInstance.id;

//initialize childInputs List of Mapstw.local.childInputs = new tw.object.listOf.toolkit.TWSYS.Map();

//loop for every action itemfor (var i=0; i<tw.local.actions.listLength; i++) { //get the action item var action = tw.local.actions[i]; //initialize a map for this action item var map = new tw.object.toolkit.TWSYS.Map(); //map values from the action to the input variable names of the child process map.put("actionItemId", action.base.id); //map the process instance id to the child process map.put("ParentPID", tw.system.currentProcessInstance.id); //insert map to the childInputs list tw.local.childInputs.insertIntoList(i, map);}

9.プロセスを保存します。タスクの結果これで、すべての「Launch Child Processes」が終了するまで、「Do Final Review」タスクは「IssueAssignee」に割り当てられません。

子オブジェクトのリストの取得子オブジェクトのリストを取得し、Coach ページで表示できます。ユーザーは、リストの表示、リストからの 1 つ以上の子の選択、親オブジェクトまたは選択した子オブジェクトの更新を行うことができます。この例では、「リスクの評価と対応」オブジェクトの下にある「リスク」オブジェクトを検索し、Coach ページ内の表に表示します。新しいクライアント・サイド・ヒューマン・サービスを作成し、子オブジェクトのリスト用の変数を定義して、親オブジェクトの子オブジェクトを取得します。OPHierarchicalQuery サービスは、OPGetChildAssociations より多くの情報を返します。手順




6.「変数 (Variables)」タブをクリックします。a)「プライベート」をクリックし、名前 (ReturnedRisk など) を指定します。b)「リストである (Is list)」を選択します。c)「選択」をクリックし、ビジネス・オブジェクト (OPSOXRisk など) を選択します。

7.「図」タブを選択します。a)パレットからキャンバスに「サービス」をドラッグします。これに、「GetRisks」という名前を付けます。

b)「実装」ペインで、「サービスの呼び出し」をクリックします。c)「選択」をクリックし、OPHierarchicalQuery を選択します。

8.「データ・マッピング」ペインをクリックし、次のフィールドのエントリーを指定します。a)「systemTask」で、タスクが OpenPages にシステム・アカウントとしてアクセスするか、現在のアカウントとしてアクセスするかを指定します。

b)「parentType」に、親オブジェクト (「RiskAssessment」など) の ID または絶対パスを入力します。これはローカル変数でもかまいません。

c)「parentId」に、親オブジェクトの ID または絶対パス (tw.local.RA_ID など) を入力します。これはローカル変数でもかまいません。

d)「isPrimary」に「false」と入力します。e)「isCaseInsensitive」に「true」と入力します。f)「fields」に「[SOXRisk].*」と入力します。g)「isDirect」に「true」と入力します。h)「出力マッピング」で、「returnObjects (List of ANY)」を選択し、tw.local.ReturnedRisk と入力します。

9.「Coach (Coaches)」タブをクリックし、テンプレートを選択します。a)パレットからキャンバスに表をドラッグします。b)表ビューで、ReturnedRisk 変数を表にバインドします。c)最初の列の列見出しを作成します。

• 出力テキストを表にドラッグします。• 列見出しに「リスク名」という名前を付けます。


• その列を ReturnedRisks.currentItem.risk.base.name 変数にバインドします。d) 2 番目の列の列見出しを作成します。

• 出力テキストを表にドラッグします。• 列見出しに「リスク説明」という名前を付けます。• その列を ReturnedRisks.currentItem.risk.base.description 変数にバインドします。

10. Coach サービスを保存します。

オブジェクトのロックとロック解除ビジネス・プロセス内のオブジェクトをロックおよびロック解除できます。



5.「ユーザー・インターフェース」 > 「クライアント・サイド・ヒューマン・サービス」の横にある「新規」をクリックして、名前 (「Lock Incident」など) を入力します。

6.「図」タブをクリックし、プロセスをビルドします。7.オブジェクトをロックする必要がある時点で、「サービス」をパレットからキャンバスにドラッグします。前のノードから新しいサービスに矢印リンクを接続します。

8.サービス・ノードをクリックし、「実装」ペインを選択します。9.「動作」セクションで「サービスの呼び出し」を選択し、OpenPages Platform Toolkit から OPLockObject統合サービスを選択します。

10.「データ・マッピング」ペインを選択し、「objectId」に特定のオブジェクト ID またはtw.local.objectId を入力します。

11.サービスへの変更内容を保存します。注 : オブジェクトのロックを解除するには、同じステップに従いますが、OPUnlockObject 統合サービスを使用します。


E メール通知の送信ビジネス・プロセス内の指定する時点で E メール通知を送信するビジネス・プロセスを定義できます。この例では、リスク・オブジェクトが OpenPages から取得され、E メールがオブジェクトのプライマリー責任者に送信されます。E メールの本文テキストには、レビュー・タスクへのリンクが含まれています。この例で説明するビジネス・プロセスを次の図に示します。

まだ存在しないプロセス・タスクへの URL リンクが E メールに含まれているため、このプロセスでは並列ゲートウェイが使用されます。並列ゲートウェイは E メール送信システム・タスクを開始し、同時に UI タスク (URL に含まれているリンク先のタスク) を割り当てます。システム・タスクに、もう一方のタスクのID を検索するスクリプトを追加する必要があります。「Send Email」ノードは、次の図に示すネストされたサービスを呼び出します。

ネストされたサービスは、以下の機能を実行します。• OPGetObject を使用したオブジェクトの取得•「システムのデフォルト E メール・プロパティーの取得」を使用したシステムのデフォルト・プロパティーの取得


• OPGetBaseURL を使用した OpenPages への URL の取得• スクリプトを使用した E メールの件名と本文テキストの構成•「IBM BPM からの E メールの送信」を使用した E メールの送信手順

1. Process Designer のデスクトップ・エディターを開きます。2. Process Designer を開きます。3. OpenPages Toolkit に依存関係を追加します。

a)「Toolkit」をクリックし、「OpenPages Platform」を選択します。b)「Toolkit」をクリックし、「OpenPages Solutions」を選択します。

4.「プロセス」 > 「ビジネス・プロセス定義」の横にある「新規」をクリックし、「Review risk andsend email」という名前を付けます。

5.ビジネス・プロセス内に最初のノードを作成します (これらのノードは、この例の一部ではありません)。

6.ビジネス・プロセスで E メールを送信する時点で、パレットから「ゲートウェイ」を「システム」スイムレーンにドラッグします。a)「プロパティー」ペインで「一般」タブをクリックします。b)「ゲートウェイ・タイプ」で「並列ゲートウェイ」を選択します。c)「シミュレーション」タブの「発信フローの割合」を (後で自動的に設定されるように) 空のままにします。

7.パレットから「アクティビティー」を「チーム (Team)」スイムレーンにドラッグします。「リスクのレビュー」という名前を付けます。a)「プロパティー」ペインで「実装」タブをクリックします。「ユーザー・タスク」を選択します。「選択」をクリックし、E メールの受信者が E メールに含まれているリンクをクリックしたときに使用する Coach ページを表すクライアント・サイド・ヒューマン・サービスを選択します。

b)「データ・マッピング」をクリックし、Coach ページが必要とする入出力マッピングを追加します。8.パレットから「アクティビティー」を「システム (System)」スイムレーンにドラッグします。「SendEmail」という名前を付けます。

9.「プロパティー」ペインで「実装」タブをクリックします。「システム・タスク」を選択します。「新規」をクリックし、新しい統合サービスを作成します。「SendEmailForRiskOwner」という名前を付けます。

10.「変数」をクリックし、統合サービスが必要とする次の変数を定義します。• smtpHost (文字列)• defaultFromAddress (文字列)• emailTo (文字列)• emailSubject (文字列)• emailBody (文字列)• riskObject (OpSOXRisk)• opBaseUrl (文字列)

11.パレットからキャンバスに「ネストされたサービス」をドラッグします。オブジェクトを取得するようにこのノードを定義します。オブジェクトの責任者は、E メールの受信者になります。a)「プロパティー」ペインで、「実装」タブをクリックし、OPGetObject OpenPages 統合サービスを選択します。

b)「データ・マッピング」タブをクリックします。「入力マッピング (Input Mapping)」の「ObjectId」に「tw.local.objectId」と入力します。「出力マッピング (Output Mapping)」の「outObject(ANY)」に「tw.local.riskObject」と入力します。


12.パレットから「ネストされたサービス (Nested Service)」をドラッグします。このノードは、E メールで使用されるシステム・デフォルトのプロパティー (SMTP ホストとデフォルトの送信元アドレスなど)を取得します。a)「プロパティー」ペインで、「実装」タブをクリックし、「システムのデフォルト E メール・プロパティーの取得」システム統合サービスを選択します。これは、IBM Business Process Manager によって提供される統合サービスです。

b)「データ・マッピング」タブをクリックします。「出力マッピング」で、smtpHost とdefaultFromAddress を選択します。

13.パレットからキャンバスに「ネストされたサービス」をドラッグします。このノードは、ベース URLを取得します。a)「プロパティー」ペインで、「実装」タブをクリックし、OPGetBaseURL OpenPages 統合サービスを選択します。

b)「データ・マッピング」タブをクリックします。「出力マッピング」で、「baseURL (String)」にtw.local.opBaseUrl と入力します。

14.パレットからキャンバスに「サーバー・スクリプト」をドラッグします。このノードは、E メールの件名と本文テキストを構成します。a)「実装」ペインで、次のスクリプトを入力します。

// set log levellog.infoEnabled = true;

log.info("smtp host: " + tw.local.smtpHost);log.info("defaultFromAddress: " + tw.local.defaultFromAddress);

// find e-mail address of the risk object owner, and set it to a variablevar user = tw.local.riskObject.OPSS_Rsk__Owner;var user1 = tw.system.org.findUserByName(user);log.info("Risk Owner: " + user1);tw.local.emailTo = user1.attributes['Task Email Address'];log.info("email to: " + tw.local.emailTo);

// set e-mail subjecttw.local.emailSubject = '[BPM] Requesting your review on ' + tw.local.riskObject.base.name;

// find task id of the coach page to review the risk objectvar taskId = tw.system.currentProcessInstance.tasks[tw.system.currentProcessInstance.tasks.length-1] .id.split('¥.')[1];for(var i=0;i<tw.system.currentProcessInstance.tasks.length;i++) { if (tw.system.currentProcessInstance.tasks[i].subject.match(".*Review.*")) { taskId = tw.system.currentProcessInstance.tasks[i].id.split('¥.')[1]; }}

// find process idvar procId = tw.system.currentProcessInstance.id.split('¥.')[1];

// set e-mail content, which contains link to object detail page, BPM task page, and BPM process pagetw.local.emailBody = "Please review Object Link : " + tw.local.opBaseUrl + "openpages/view.resource.do?fileId=" + tw.local.objectId + " and";tw.local.emailBody += "Task Link : https://bpmserver.com:9443/ProcessPortal/ launchTaskCompletion?taskId=" + taskId + " , finally";tw.local.emailBody += "Process Link : https://bpmserver.com:9443/ProcessPortal/ launchInstanceUI?instanceId=" + procId + "";

15.パレットからキャンバスに「ネストされたサービス」をドラッグします。このノードは、E メールを送信します。a)「プロパティー」ペインで、「実装」タブをクリックし、「IBM BPM からの E メールの送信」システム統合サービスを選択します。

b)「入力マッピング」で、次の変数を指定します。•「to (ストリング) (to (String))」に「tw.local.emailTo」•「from (ストリング) (from (String))」に「tw.local.defaultFromAddress」•「subject (ストリング) (subject (String))」に「tw.local.emailSubject」•「messageText (ストリング) (messageText (String))」に「tw.local.emailBody」

•「contentType (ストリング) (contentType (String))」に「text/html」•「smtpHost (ストリング) (smtpHost (String))」に「tw.local.smtpHost」

16.すべてのノードを矢印で接続します。17.ビジネス・プロセスを保存します。

実行中のプロセスの強制終了IBM® Process Designer の Inspector を使用して、エラーがある実行中のプロセスのインスタンスを強制終了できます。これは、ビジネス・プロセス・インスタンスの管理、テスト、および統制にも使用できます。Inspector には、Process Admin Console でアクセスできます。Inspector について詳しくは、http://www.ibm.com/support/knowledgecenter/en/SSV2LR/com.ibm.wbpm.wle.editor.doc/topics/running_debugging_procs.html (http://www.ibm.com/support/knowledgecenter/en/SSV2LR/com.ibm.wbpm.wle.editor.doc/topics/running_debugging_procs.html) を参照してください。

手順1. Process Admin Console にアクセスします。2.「Process Inspector」をクリックします。

3.強制終了するプロセスのインスタンスを見つけます。4.インスタンスを強調表示させて「終了」をクリックします。


http://www.ibm.com/support/knowledgecenter/en/SSV2LR/com.ibm.wbpm.wle.editor.doc/topics/running_debugging_procs.html

http://www.ibm.com/support/knowledgecenter/en/SSV2LR/com.ibm.wbpm.wle.editor.doc/topics/running_debugging_procs.html

第 6 章エラー・メッセージと処理エラー・メッセージと処理は、OpenPages の統合サービスによって管理されます。OpenPages 統合サービスは、ユーザー入力エラーや構成エラーなどのさまざまな理由のために、エラー・メッセージを発行できます。エラーが発生すると、システムは、プロセス・インスタンスおよび統合サービスを強制終了します。ただし、Coach ページにエラー処理とエラー・メッセージ・コードを追加することで、デフォルトの動作を上書きできます。例えば、特定の条件下で、特定のエラー・メッセージの表示や、エラーからの復旧を実行できます。IBM Business Process Manager でのエラー処理について詳しくは、http://www.ibm.com/support/knowledgecenter/SSFTDH_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/handling_exceptions.html および(ftp://ftp.software.ibm.com/software/iea/content/com.ibm.iea.ibpmgr/ibpmgr/8.0/ProcessDesigner/BPM80_ErrorAndTerminationHandling.pdf)を参照してください。

統合サービスが発行するエラー・メッセージOpenPages 統合サービスが発行する可能性があるエラー・メッセージは、次のとおりです。OP26001要求された操作が OpenPages サーバーで理解できませんでした (HTTP エラー・コード 400)。詳しくは、BPM ログ・ファイルを参照してください。

OP26002認証失敗のため、要求された操作が失敗しました (HTTP エラー・コード 401)。

OP26003要求された操作を実行するための権限がありません (HTTP エラー・コード 403)。

OP26004要求されたオブジェクトが OpenPages サーバーで見つかりませんでした (HTTP エラー・コード 404)。

OP26005リソース競合のため、要求された操作が失敗しました (HTTP エラー・コード 409)。

OP26006要求された範囲を満たすことができません (HTTP エラー・コード 416)。

OP26007内部サーバー・エラーのため、要求された操作が失敗しました (HTTP エラー・コード 500)。詳しくは、BPM ログ・ファイルを参照してください。

OP26008接続が OpenPages サーバーによって拒否されました。

OP26009要求された操作がタイムアウトによって失敗しました。

OP26010OpenPages サーバーへの接続の初期化が失敗しました。OpenPages ベース URL 構成を確認してください。

OP26011引数を満たすことができないため、要求された操作が失敗しました。

OP26012システム・タスク認証エラーのため、要求された操作が失敗しました。OpenPages システム・タスクの資格情報構成を確認してください。

OP26013名前空間バインディング・エラーのため、要求された操作が失敗しました。名前空間バインディング構成を確認してください。

http://www.ibm.com/support/knowledgecenter/SSFTDH_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/handling_exceptions.html

http://www.ibm.com/support/knowledgecenter/SSFTDH_8.5.7/com.ibm.wbpm.wle.editor.doc/topics/handling_exceptions.html

ftp://ftp.software.ibm.com/software/iea/content/com.ibm.iea.ibpmgr/ibpmgr/8.0/ProcessDesigner/BPM80_ErrorAndTerminationHandling.pdf

ftp://ftp.software.ibm.com/software/iea/content/com.ibm.iea.ibpmgr/ibpmgr/8.0/ProcessDesigner/BPM80_ErrorAndTerminationHandling.pdf

OP26014OpenPages サーバー応答が、予期される JSON フォーマットでありません。

OP26999要求された操作で OpenPages へのアクセスに失敗しました。詳しくは、BPM ログ・ファイルを参照してください。

クライアント・サイド・ヒューマン・サービスへのエラー処理の追加統合サービスがユーザーにエラー・メッセージを表示できるように、クライアント・サイド・ヒューマン・サービスにエラー処理を追加できます。例えば、統合サービスが存在しない OpenPages オブジェクトにアクセスしようとすると、次のメッセージが発行されます。

クライアント・サイド・ヒューマン・サービスにエラー処理を追加しない場合は、エラー・メッセージがユーザーに表示されません。この例では、クライアント・サイドのヒューマン・サービスを作成し、Coach ページにエラー処理を追加します。



5.「ユーザー・インターフェース」 > 「クライアント・サイド・ヒューマン・サービス」の横にある「新規」をクリックして、名前を入力します。

6.「図」タブをクリックします。7.パレットからキャンバスに「イベント・ハンドラー」をドラッグします。イベント・ハンドラーの場合、矢印を接続する必要はありません。

8.「プロパティー」ペインで「実装」タブをクリックします。9.「トリガー・イベント (Triggering Event)」で「エラー・イベント (Error event)」を選択します。

10.「動作」で「すべてのエラーをキャッチ」と「特定のエラーをキャッチ」のいずれかを選択し、テストするエラーを指定します。すべてのエラー・コードのリストについては、59 ページの『統合サービスが発行するエラー・メッセージ』を参照してください。

11.イベント・ハンドラーを実装するには、図内のイベント・ハンドラー・アクティビティーをダブルクリックします。

12.パレットからキャンバスに「Coach」をドラッグします。13.パレットからキャンバスに「終了イベント」をドラッグします。「プロパティー」ペインで「実装」タブをクリックします。「イベント・タイプ」で「エラー終了イベント (Error end event)」を選択します。オプションで、ケースを予期される動作として処理し、親プロセスに進む場合、「終了イベント」のままにします。


14.「変数」タブをクリックし、エラー・コードとデータを保持するプライベート変数を加算します。それらに code1 と msg1 という名前を付けます。どちらの変数もストリングです。

15.「プロパティー」ペインで「事前および事後」タブを選択します。「実行前スクリプト」に次の行を追加します。tw.local.code1 = tw.error.code;

tw.local.msg1 = tw.error.data;

16.「Coach (Coaches)」タブをクリックします。出力テキスト・ビューを Coach ページに追加し、それらを code1 と msg1 にバインドします。

17.オプションで、エラー・コードおよびエラー・メッセージのコントロールの色を変更します。例えば、エラー・メッセージを赤いテキストとして表示する HTML 属性を追加できます。

18.クライアント・サイド・ヒューマン・サービスを保存します。

第 6 章エラー・メッセージと処理 61

特記事項本書は米国 IBM が提供する製品およびサービスについて作成したものです。本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。日本で利用可能な製品、サービス、および機能については、日本 IBM の営業担当員にお尋ねください。本書で IBM製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用することができます。ただし、IBM以外の製品とプログラムの操作またはサービスの評価および検証は、お客様の責任で行っていただきます。本書には、お客様が購入されたプログラムまたはライセンス資格に含まれない製品、サービス、または機能に関する説明が含まれる場合があります。IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。本書の提供は、お客様にこれらの特許権について実施権を許諾することを意味するものではありません。実施権についてのお問い合わせは、書面にて下記宛先にお送りください。〒 103-8510東京都中央区日本橋箱崎町 19番 21号日本アイ・ビー・エム株式会社法務・知的財産知的財産権ライセンス渉外

以下の保証は、国または地域の法律に沿わない場合は、適用されません。IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものではありません。それらの Web サイトにある資料は、このIBM 製品の資料の一部ではありません。それらの Web サイトは、お客様の責任でご使用ください。IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、自ら適切と信ずる方法で、使用もしくは配布することができるものとします。本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプログラム (本プログラムを含む) との間での情報交換、および (ii) 交換された情報の相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする方は、下記に連絡してください。IBM Corporation Location Code FT0 550 King Street Littleton, MA 01460-1250 U.S.A.

本プログラムに関する上記の情報は、適切な使用条件の下で使用することができますが、有償の場合もあります。本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、IBM より提供されます。

この文書に含まれるいかなるパフォーマンス・データも、管理環境下で決定されたものです。そのため、他の操作環境で得られた結果は、異なる可能性があります。一部の測定が、開発レベルのシステムで行われた可能性がありますが、その測定値が、一般に利用可能なシステムのものと同じである保証はありません。さらに、一部の測定値が、推定値である可能性があります。実際の結果は、異なる可能性があります。お客様は、お客様の特定の環境に適したデータを確かめる必要があります。IBM 以外の製品に関する情報は、その製品の供給者、出版物、もしくはその他の公に利用可能なソースから入手したものです。 IBM は、それらの製品のテストは行っておりません。したがって、他社製品に関する実行性、互換性、またはその他の要求については確証できません。 IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。IBM の将来の方向または意向に関する記述については、予告なしに変更または撤回される場合があり、単に目標を示しているものです。本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。より具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品などの名前が含まれている場合があります。これらの名称はすべて架空のものであり、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。この情報をソフトコピーでご覧になっている場合は、写真やカラーの図表は表示されない場合があります。この「ソフトウェア・オファリング」は、Cookie もしくはその他のテクノロジーを使用して個人情報を収集することはありません。

著作権ライセンス資料 - IBM Corporation の所有財産。© Copyright IBM Corporation, 2003, 2019.

本書には、様々なオペレーティング・プラットフォームでのプログラミング手法を例示するサンプル・アプリケーション・プログラムがソース言語で掲載されています。お客様は、サンプル・プログラムが書かれているオペレーティング・プラットフォームのアプリケーション・プログラミング・インターフェースに準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、配布することができます。このサンプル・プログラムは、あらゆる条件下における完全なテストを経ていません。従って IBM は、これらのサンプル・プログラムについて信頼性、利便性もしくは機能性があることをほのめかしたり、保証することはできません。お客様は、IBM のアプリケーション・プログラミング・インターフェースに準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、配布することができます。

商標IBM、IBM ロゴおよび ibm.com は、世界の多くの国で登録された International Business MachinesCorporation の商標です。他の製品名およびサービス名等は、それぞれ IBM または各社の商標である場合があります。現時点での IBM の商標リストについては、http://www.ibm.com/legal/copytrade.shtml をご覧ください。Java およびすべての Java 関連の商標およびロゴは Oracle やその関連会社の米国およびその他の国における商標または登録商標です。


バージョン 8.1.0 ibm openpages with...

Documents