EMC Documentum Process Builder ユーザガイド

EMC® Documentum®
Process Builder
バ ー ジ ョ ン 6.6
ユーザ ガイド
EMC Corporation
本社:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Copyright © EMC Corporation. All rights reserved.
2010 年 4 月
本書に記載されている情報は作成時点での情報に基づいています。この情報は予告なく変更されることがあります。
この資料に記載される情報は、「現状有姿」の条件で提供されています。EMC Corporation は、この資料に記載される情報に
関する、どのような内容についても表明保証条項を設けず、特に、商品性や特定の目的に対する適応性に対する黙示の保証
はいたしません。
この資料に記載される、いかなる EMC ソフトウェアの使用、複製、頒布も、当該ソフトウェア ライセンスが必要です。EMC の製
品名の最新の一覧については、EMC.com の EMC Corporation の商標をご覧ください。他のすべての名称ならびに製品につ
いての商標は、それぞれの所有者の商標または登録商標です。
目次
章1
プ ロ セ ス デ ザ イ ン を 理 解 す る ................................................................................ 9
ワークフローの紹介 ............................................................................................. 9
プロセス テンプレートと関連するワークフロー オブジェクト ..................................... 11
アクティビティ ................................................................................................ 12
プロセス データ ............................................................................................. 14
Business Activity Monitor (BAM) に関するレポートを有効にする ...................... 15
フロー ........................................................................................................... 15
ワークフローのプロセスを計画する ...................................................................... 16
ロールおよびアクセス権の設定 ....................................................................... 17
アクティビティ テンプレートを選択または作成する.............................................. 17
実行者を選択する ......................................................................................... 18
実行者を決定するタイミングを定義する ........................................................ 20
エイリアスを使用する .................................................................................. 20
委任と拡張を有効にする ................................................................................ 21
タスクの主題を定義する ................................................................................. 22
サインオフ要件を追加する .............................................................................. 23
優先度の値を設定する ................................................................................... 23
プロセス データを理解する ............................................................................. 27
フォーム テンプレートをパッケージに関連付ける ............................................... 29
トリガの条件を設定する .................................................................................. 29
タイマを設定する ........................................................................................... 30
通知を設定する ............................................................................................. 31
アクティビティ移行を定義する ......................................................................... 32
章2
Process Builder を 使 用 す る ................................................................................ 35
Process Builder の設計環境 ................................................................................ 35
Process Builder のツールバーを設定する.............................................................. 36
プロセス テンプレート プレファレンスを設定する ................................................... 37
Process Analyzer がプロセス テンプレートにアクセスできるようにする ................... 37
プロセス テンプレートを Process Analyzer と共有する....................................... 37
Process Analyzer からプロセスを取得する....................................................... 38
プロセスを共有するフォルダの場所を設定する .............................................. 38
受信アクティビティをデバッグするためのポート番号を設定する .......................... 38
アクティビティ テンプレート フォルダを管理する ................................................. 39
プロセス テンプレート メッセージ プレファレンスを設定する................................. 40
BAM データベースのプロセス データを更新する .............................................. 40
BAM 内の構造化データ タイプを更新する .................................................... 40
BAM 内のパッケージ オブジェクト タイプを更新する....................................... 41
[アクティビティ テンプレート] ウィンドウ ................................................................. 41
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
3
目次
[構造化データ タイプ] ウィンドウ ......................................................................... 42
構造化データ タイプ カテゴリを作成する .......................................................... 42
構造化データ タイプ カテゴリを削除する .......................................................... 42
構造化データ タイプ グループを作成する......................................................... 43
[構造化データ タイプ] ウィンドウを更新する ...................................................... 43
構造化データ タイプを作成する ...................................................................... 43
構造化データ タイプの詳細を表示する ............................................................ 45
構造化データ タイプを編集する ...................................................................... 45
XML スキーマから複雑な構造化データ タイプを作成する .................................. 46
プロセス テンプレート エディタ ペイン .................................................................. 46
プロセス テンプレート オブジェクトを選択する ................................................... 47
アクティビティを配置する ................................................................................ 47
アクティビティを置き換える .............................................................................. 48
[グリッドにスナップ] を使用する ....................................................................... 48
拡大または縮小する....................................................................................... 49
メモを追加する .............................................................................................. 49
タブを使用して複数のプロセスを表示する ........................................................ 51
[プロセス検証] タブを使用する ........................................................................... 51
プロセス テンプレート ナビゲータを使用する ........................................................ 52
章3
プ ロ セ ス テ ン プ レ ー ト を 操 作 す る ........................................................................ 53
プロセス テンプレートの概要 .............................................................................. 53
既存のプロセス テンプレートを開く ...................................................................... 54
プロセス テンプレートを作成する......................................................................... 54
プロセス テンプレートのプロパティを設定する ...................................................... 56
プロセス データを管理する ................................................................................. 58
パッケージを管理する .................................................................................... 59
プロセス変数を管理する ................................................................................. 61
プロセス パラメータを管理する ........................................................................ 62
アクティビティ レベルの設定を上書きする ......................................................... 63
詳細なオプションを設定する .............................................................................. 64
アクセス コントロール リスト (ACL) のオプションを設定する .................................. 64
プロセス用のカレンダーを選択する.................................................................. 65
プロセス パラメータ フォームを割り当てる.......................................................... 66
相関セットを作成する ..................................................................................... 66
受信 Web サービスを有効にする...................................................................... 67
プロセス テンプレートを保存する......................................................................... 68
プロセス テンプレートを検証する......................................................................... 70
プロセス テンプレートをインストールする .............................................................. 71
プロセス テンプレートを変更する......................................................................... 72
プロセス テンプレートのチェックイン、チェックアウト、およびバージョン管理を行
う ..................................................................................................................... 72
プロセス テンプレートをチェックアウトする ......................................................... 74
プロセス テンプレートをチェックインする ........................................................... 74
チェックアウトをキャンセルする ........................................................................ 75
プロセス テンプレートを削除する......................................................................... 75
プロセス テンプレートをインポートする ................................................................. 75
プロセス テンプレートをエクスポートする .............................................................. 76
共有プロセスを同期する .................................................................................... 77
4
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
目次
プロセス テンプレートを印刷する......................................................................... 78
章4
ア ク テ ィ ビ テ ィ を 接 続 す る ................................................................................... 81
接続アクティビティの概要................................................................................... 81
フローを作成する........................................................................................... 81
フローの表示設定を変更する ............................................................................. 82
章5
サ ブ プ ロ セ ス を 作 成 す る .................................................................................... 83
サブプロセスの概要 .......................................................................................... 83
トップダウン モデリングを使用してサブプロセスを作成する .................................... 84
ボトムアップ モデリングを使用してサブプロセスを作成する .................................... 84
サブプロセスのプロパティを設定する .................................................................. 85
サブプロセスの展開および折りたたみを行う ......................................................... 86
サブプロセスからアクティビティを削除する ........................................................... 86
サブプロセスにメモを追加する............................................................................ 86
サブプロセスおよびそのコンテンツを削除する...................................................... 87
章6
ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 操 作 す る ................................................................. 89
アクティビティ テンプレートを操作する ................................................................. 89
アクティビティ テンプレートを作成する .............................................................. 90
新しいアクティビティ テンプレートを作成する ................................................. 90
アクティビティ テンプレートをコピーする............................................................ 90
アクティビティ テンプレートを設定する .............................................................. 91
アクティビティ テンプレートを検証してインストールする ...................................... 92
アクティビティ テンプレートを検証する .......................................................... 93
アクティビティ テンプレートをインストールする ................................................ 93
アクティビティ テンプレートをアンインストールする .......................................... 93
章7
ア ク テ ィ ビ テ ィ を 操 作 す る ................................................................................... 95
アクティビティ インスペクタを使用する.................................................................. 96
アクティビティのプロパティを設定する ................................................................. 97
実行者を選択する ............................................................................................. 99
章8
プ ロ セ ス デ ー タ 要 素 を マ ッ プ す る ...................................................................... 129
データ マッピング ツールを理解する..................................................................
プロセス データをマッパで編集または追加する ...............................................
パッケージ属性をマップする .........................................................................
メッセージ プロパティを追加する....................................................................
XML スキーマをアクティビティ コンテンツに追加する ......................................
プロセスに Forms Builder フォームを組み込む.................................................
XML ファイルを使用してフォームに値を入力する ........................................
プロセス データを使用して高忠実度フォームを作成する ..............................
条件に基づいてノードを追加する ..................................................................
データをマップする ......................................................................................
データ マッパを使用する ...........................................................................
データ マッピング関数を使用する ..............................................................
メッセージ相関を理解する ............................................................................
相関識別子を使用する .............................................................................
相関セットを使用する................................................................................
章9
129
131
131
132
132
133
133
134
135
136
136
139
144
144
145
プ ロ セ ス テ ン プ レ ー ト を デ バ ッ グ す る ................................................................. 147
プロセス デバッガを理解する ............................................................................ 147
プロセス デバッグ環境を使用する.................................................................. 148
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
5
目次
プロセスのデバッグを準備する ......................................................................... 149
ブレークポイントを使用する........................................................................... 149
デバッガでワークフローを開始する ................................................................... 150
手動初期化アクティビティでデバッグ セッションを開始する............................... 150
インバウンド初期化アクティビティでデバッグ セッションを開始する .................... 151
デバッガでプロセスをテストする ........................................................................
[タスク マネージャ] タブを使用する ................................................................
手動タスクを管理する ...............................................................................
自動タスクを管理する ...............................................................................
[プロセス データ] タブを使用する ..................................................................
[コンソール] タブを使用する..........................................................................
[ワークフローの管理] タブを使用する.............................................................
プロセス デバッガを使用してカスタム メソッドをデバッグする .............................
章 10
151
152
153
153
155
155
156
156
ト ラ ブ ル シ ュ ー テ ィ ン グ ..................................................................................... 157
ログ ファイルを理解する ................................................................................... 157
アペンダ レベルを DEBUG に変更する .......................................................... 157
章 11
事 前 定 義 の ア ク テ ィ ビ テ ィ テ ン プ レ ー ト .............................................................. 159
事前定義のアクティビティ テンプレート .............................................................. 159
6
コンテンツ サービスのアクティビティ テンプレート ................................................
BOF モジュール...........................................................................................
フォルダの作成 ...........................................................................................
エンタープライズ コンテンツ統合サービス (Enterprise Content Integration
Services: ECIS) 検索.....................................................................................
プロセスの起動............................................................................................
ライフサイクル..............................................................................................
ライフサイクルの適用 ...................................................................................
フォルダにリンク...........................................................................................
テンプレートから新しいケースを作成..............................................................
160
160
162
フロー ............................................................................................................
決定分岐 ....................................................................................................
結合 ...........................................................................................................
親プロセスに対するイベントの通知 ................................................................
XSL 変換 ....................................................................................................
168
168
169
170
170
統合 ..............................................................................................................
ACL (アクセス制御リスト) を作成する..............................................................
iCalendar イベントの作成 ..............................................................................
DB 受信 - 初期化および手順 ........................................................................
DQL 受信 - 初期化および手順 ......................................................................
DQL 読み取り..............................................................................................
DQL 書き込み .............................................................................................
データベースの読み取り...............................................................................
データベースのストアド プロシージャ..............................................................
データベースの書き込み ..............................................................................
動的 Web サービス .......................................................................................
セキュリティ保護されていない Web サービスを呼び出すには.........................
171
171
172
173
175
176
177
178
180
183
184
185
162
163
164
166
166
167
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
目次
セキュリティ保護された Web サービスを呼び出す ......................................... 186
受信電子メール - 初期化および手順 ............................................................. 193
FTP 受信 - 初期化および手順 ....................................................................... 196
FTP 送信 .................................................................................................... 198
FTP による読み込み .................................................................................... 200
ファックス送信 ............................................................................................. 201
HTTP 受信 - 初期化および手順 .................................................................... 204
HTTP 送信 .................................................................................................. 206
JMS 受信 - 初期化および手順....................................................................... 207
JMS 送信 .................................................................................................... 209
プロセス データ マッピング ............................................................................ 210
SMTP アクティビティ テンプレート ...................................................................211
WS 受信 - 初期化および手順........................................................................ 214
Web サービス............................................................................................... 217
xPression 発行ドキュメント.............................................................................. 218
xPression 発行ドキュメント - 詳細 ................................................................... 219
章 12
廃止予定のアクティビティ テンプレート ..............................................................
監視ポイント ................................................................................................
FTP ............................................................................................................
HTTP による投稿 .........................................................................................
ライフサイクルの適用 (5.3x 以前)...................................................................
ライフサイクルの降格 ...................................................................................
ライフサイクルの昇格 ...................................................................................
JMS トピックに発行.......................................................................................
SMTP .........................................................................................................
JMS キューに送信........................................................................................
MQ JMS に送信...........................................................................................
サブプロセスの開始 .....................................................................................
221
221
223
223
224
224
224
225
225
226
227
228
サンプル ........................................................................................................
キュー タスク リワーク決定 .............................................................................
サンプル アクティビティ テンプレート ..............................................................
キュー タスク スキル決定 ...............................................................................
228
228
229
229
カ ス タ ム ア ク テ ィ ビ テ ィ で 代 替 変 数 を 使 用 す る .................................................... 231
カスタム アクティビティ テンプレートの属性に代替変数を使用する........................ 231
章 13
Process Builder の 設 定 フ ァ イ ル ........................................................................ 235
Process Builder の設定ファイル.......................................................................... 235
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
7
はじめに
このガイドでは、EMC Documentum Process Builder を使用してビジネス プロセス テンプレートを設
計および作成する際に役立つ情報について説明します。Process Builder は、ビジネス プロセ
ス ライフサイクルのすべてのフェーズを有効化およびサポートする、プロセス スイートのデザ
イン センターです。
対象読者
このガイドは、ビジネス プロセスの設計者を対象としています。読者の方が、基礎的な EMC
Documentum 製品の機能、特に Documentum Webtop または TaskSpace で提供される実行時ワー
クフロー機能についての知識があることを前提として書かれています。
改訂履歴
このマニュアルの改訂履歴を次に示します。
表 1 改訂履歴
改訂日付
説明
2010 年 4 月
初版発行
サポート情報
EMC Documentum のテクニカル サポートが提供するサービスおよびポリシーは、EMC Powerlink
Web サイト (http://Powerlink.EMC.com) からご利用いただけます。
注 記 : Powerlink をご利用になるには、事前にオンライン登録していただく必要があります。
関連資料
Process Builder は、ビジネス プロセス テンプレートを設計するためのツールです。設計したテ
ンプレートに基づいて実行時にワークフローが作成されます。ワークフローの実行とワークフ
ローへの参加については、Documentum Webtop または TaskSpace のユーザ対象のドキュメント
を参照してください。
Process Builder には、このガイドのほかにも次のガイドがあります。
• EMC Documentum Process Builder Development Guide (EMC Documentum Process Builder 開
発ガイド)
• EMC Documentum Process Builder Installation Guide (EMC Documentum Process Builder インス
トール ガイド)
• EMC Documentum Process Builder Release Notes (EMC Documentum Process Builder リリー
ス ノート)
• EMC Documentum Process Builder Localization Guide (EMC Documentum Process Builder
ローカライズ ガイド)
8
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
第1章
プロセス デザインを理解する
この章では、 次のトピックについて説明します。
•
ワークフローの紹介
•
プロセス テンプレートと関連するワークフロー オブジェクト
•
ワークフローのプロセスを計画する
ワークフローの紹介
Process Builder を使用してプロセス テンプレートを作成します。プロセス テンプレートによってビジ
ネス プロセスの定義が取り込まれ、ユーザがプロセスを繰り返し実行できるようになります。プロセ
ス テンプレートによって生成される個々のプロセス インスタンスは、ワークフローと呼ばれます。
ワークフローとは、保険金支払請求プロセスや、設計開発プロセスなどのビジネス プロセスを定型
化するものです。ワークフローは次の要素から構成されています。
• プロセス テンプレートは、定型化されたワークフロー定義として表されるビジネス プロセスです。
ユーザは、テンプレートを使用してビジネス プロセスを繰り返し実行できます。プロセス テン
プレートは実行時のインスタンスとは別のものなので、同じテンプレートに基づく複数のワー
クフローを同時に実行することもできます。
• プロセス テンプレートは複数のアクティビティから構成されます。
アクティビティは、電子メールの受信、ドキュメントのレビュー、リポジトリへのチェックイン、ドキュ
メントの承認など、プロセスを完了するために必要なタスクを表します。
• フローはアクティビティ間のリンクで、アクティビティ間の順序を示します。
• プロセス データは、ドキュメント、フォーム、プロセス変数 (部品番号や顧客アドレス、または管
理者がプロセス インスタンス全体の特定のパラメータの定数値を変更できるプロセス パラメー
タ) など、プロセスで使用されるさまざまなタイプのデータを指します。
プロセス データは、プロセス変数、プロセス パラメータ、およびワークフロー内を移動す
るパッケージから構成されます。
– プロセス変数は、プロセスの存続期間中に使用される個々の、またはグループのデー
タ タイプまたは実行データです。
プロセス変数の例には、さまざまなタイプの顧客情報を表すさまざまなデータ要素があげられ
ます。これらのワークフロー コンポーネントの詳細については、「プロセス テンプレートと関連
するワークフロー オブジェクト (11ページ) 」を参照してください。
– プロセス パラメータは、プロセスで使用する定数値をアプリケーション管理者が変更できるよ
うにする値です。プロセス パラメータは、昇格ロール、移行条件、実行者条件、不特定の実
行者の割り当て、タスク名、タスクの手順など、プロセス内で固定の値に使用できます。管理
者が TaskSpace の [管理] タブからパラメータの値を変更すると、すべての新しいプロセス
インスタンス内でその値が更新されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
9
プロセス デザインを理解する
– パッケージは、アクティビティ間で渡されるオブジェクト (通常はドキュメント ファイルやイメー
ジ ファイル) を含み、パッケージに対して作業が行われます。
ローン申込は、パッケージに含まれるオブジェクトの一例です。
図1
プロセス テンプレートによるビジネス プロセスのキャプチャ
プロセス テンプレートによって表されるビジネス プロセスには、単純なものも複雑なものもありま
す。作成するワークフローは、直列セグメント (アクティビティが指定された順序で 1 つずつ実行さ
れる) と、並列セグメント (2 つ以上のアクティビティが同時に実行される) の両方を持つことができ
ます。循環ワークフローも作成できます。このワークフローでは、あるアクティビティが完了すると、
既に完了しているアクティビティが再び開始されます。ワークフローを通してドキュメントが渡される
パスは、それまでに行われた処理に応じて変更することができます。たとえば、マネージャが承認
したか却下したかに応じて発注書を異なるアクティビティに送信できます。
プロセス テンプレートを作成して、さまざまな状況で使用することができます。このようにするには、
ワークフローに組み込むアクティビティの実行者を指定するときに実際のユーザ名を使用するの
ではなく、プロセス データまたはエイリアスを使用します。プロセス データまたはエイリアスを使用
する場合は、実際のユーザは実行時に選択されます。たとえば、ドキュメントを新規作成するビジ
ネス プロセスには、一般にドキュメントの作成、レビュー、改訂、および公開の 4 つのステップがあ
ります。実際の作成者とレビュー担当者は、ドキュメントによって異なります。ドキュメントごとに作成
者名とレビュー担当者名を設計プロセス時に割り当てるワークフローを作成するのではなく、作成
者とレビュー担当者の名前をプロセス データで定義するアクティビティの定義を使用して、1 つの
プロセス テンプレートを作成します。ワークフローの設計方法に応じて、作成者およびレビュー担
当者を、ワークフローの開始者が選択する方法、直前のアクティビティの実行者が選択する方
法、アクティビティの開始時にサーバが自動的に選択する方法、またはワークフローに定義さ
れた条件分岐ロジックに基づいて選択する方法があります。
アクティビティをプロセス テンプレートに追加するには、空のアクティビティを作成するか、アクティ
ビティのタスクのタイプに適切なアクティビティ テンプレートを選択します。アクティビティ テンプ
レートによって特定タイプのタスクに必要な設定属性を決定します。ここには、すべてのアクティビ
ティに共通の属性 (名前や実行者のリストなど) や特定のタスクにのみ必要なカスタム属性が含ま
れます。たとえば、Web サイトにファイルを公開するアクティビティのアクティビティ テンプレートに
は、公開のために使用する URL を格納した属性が含まれます。Process Builder には、一般的なア
クティビティ タイプを表すアクティビティ テンプレートが事前定義されており、ユーザはカスタム ア
クティビティ テンプレートを作成して、自分のニーズと正確に一致させることができます。
パッケージとアクティビティには、フォーム テンプレートを関連付けることができます。フォーム
テンプレートは、アクティビティを実行するユーザに対して表示されるデータ エントリ フィール
ドを定義し、入力されたデータを Documentum リポジトリに保存する方法を指定します。フォー
10
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
ムは、Documentum Forms Builder を使用して作成し、Process Builder を使用してプロセスに
関連付けます。
ワークフローのプロセス テンプレートは、Documentum Content Server によって dm_process オ
ブジェクトとして実装されます。プロセス テンプレート内の個々のアクティビティの定義は、
dm_activity オブジェクトに保存されます。ワークフローを設計する場合は、必要なアクティビティ定
義を新規作成するだけでなく、既存のアクティビティ定義を組み込むことができます。
ワークフローの開始時に、サーバはプロセス テンプレート (dm_process オブジェクト) を使用して
ワークフローの実行時インスタンス (dm_workflow オブジェクト) を作成します。アクティビティの
開始時に、サーバは 1 つまたは複数の作業項目 (dmi_workitem) を作成します。作業項目と
は、そのアクティビティの実行者として指定されたユーザの受信ボックスにサーバによって追
加されるタスクのことです。
次の図は、プロセス テンプレートのコンポーネントと実行時インスタンスが連携して機能す
る仕組みを示しています。
図2
ワークフローのコンポーネント
プロセス テンプレートと関連するワークフロー オブ
ジェクト
Process Builder のワークフロー プロセス データ モデルは、1 つのプロセス テンプレート、アクティ
ビティ定義セット、プロセスを通じて運ばれるデータのコレクション、アクティビティ同士を接続す
る一連のフロー、およびプロセス データ (処理されるドキュメントを表す 1 つまたは複数のパッ
ケージを含む) で構成されます。
プロセス テンプレートによってビジネス プロセスの構造を定義します。これは、アクティビティ定義
と、アクティビティを接続するフローを定義する属性のセットで構成されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
11
プロセス デザインを理解する
アクティビティ
アクティビティは、ビジネス プロセスを構成するタスクを表します。ワークフローには、数種類のアク
ティビティを含めることができます。
• 初期化アクティビティは、ワークフロー内の最初のアクティビティです。
• 開始アクティビティは、初期化アクティビティに接続されます。
• 終了アクティビティは、ワークフロー内の最後のアクティビティです。1 つのプロセス テンプレート
に、終了アクティビティは 1 つのみ含めることができます。
• 経過アクティビティは、開始と終了の間のアクティビティです。1 つのプロセス テンプレート
に、経過アクティビティはいくつでも含めることができます。
• メッセージ待機アクティビティは、外部アプリケーションとの非同期通信に参加する受信アクティ
ビティで、アプリケーションからの応答を待機するように設計されています。
• 障害対処アクティビティでは、自動アクティビティが失敗した場合に実行するアクションを
指定できます。
アクティビティは手動または自動のいずれでもかまいません。手動アクティビティは、1 人また
は複数の人物によって実行されます。自動アクティビティは、あるユーザの代わりにシステ
ムによって実行されます。
アクティビティ定義の属性により、以下のアクティビティ属性が決まります。
•
•
•
•
•
•
アクティビティの実行方法
作業の実行者
実行者の割り当て方法
アクティビティの開始条件
必要なトリガの種類
アクティビティが完了したときの移行動作
アクティビティには、そのアクティビティのタスクのタイプに特有の属性を含めることもできます。たと
えば、外部ベンダにドキュメントを送信するアクティビティには、ベンダの電子メール アドレスを格
納した属性を含めることができます。アクティビティに関連付けられるカスタム属性のセットは、アク
ティビティ テンプレートを使用して設定することができます。
サーバによってアクティビティが開始されると、作業項目が作成され、アクティビティの実行者とし
て指定されているユーザの受信ボックスに送信されます。これらの作業項目には、ユーザがタスク
を実行するために必要なパッケージや指示が含まれています。サーバは、作業項目にリンクされ
たキュー項目を受信ボックスに追加します。詳細については、『Documentum Content Server Object
Reference (Documentum Content Server オブジェクト リファレンス)』を参照してください。
初期化アクティビティ
初期化アクティビティでは、プロセス インスタンスを開始する条件を指定します。初期化アクティビ
ティは、任意の開始アクティビティに接続でき、手動アクティビティにすることも、自動アクティビティ
にすることもできます。1 つの手動初期化アクティビティを持つワークフロー、複数の自動初期化ア
クティビティを持つワークフロー、または 1 つの手動アクティビティといくつかの自動初期化ア
クティビティを組み合わたワークフローを開始することができます。初期化アクティビティが自
12
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
動アクティビティの場合、プロセスを通して渡されるプロセス データにメッセージのデータをコ
ピーするマッピング規則、およびチャネル設定を指定する必要があります。初期化アクティビ
ティが手動の場合、そのアクティビティを設定して、プロセスを開始する Forms Builder で作成し
たフォームを自動的に起動できるようにすることができます。
たとえば、ローン申込プロセス フローには、複数の初期化アクティビティを設定できます。このフ
ローは、ローン申込フォームを自動的に起動する手動初期化アクティビティを使用して開始できま
す。このフォームは、電話申込時にプロセッサによって入力されます。同じプロセスに、電子メール
メッセージを介してローン申込を受け取る自動初期化アクティビティを設定することもできます。
アクティビティ インスペクタの [プロパティ] タブで手動初期化アクティビティに Forms Builder で
作成したフォームを割り当てます。
自動初期化アクティビティを含めるには、電子メール フォーム受信という名前のアクティビティを作
成します。このアクティビティでは、電子メール アカウントを設定し、電子メールのヘッダーおよび
本文の詳細を、プロセスに定義されているプロセス データにマップします。
手動初期化アクティビティで設定に使用できるのは、[プロパティ]、[データ]、および [表示] タブの
みです。その他の初期化アクティビティ (受信電子メールなど) - 初期化アクティビティ テンプレート
には、すべての標準のタブのほかに、電子メール サーバ接続を設定するタブもあります。
メッセージ待機アクティビティ
ビジネス プロセスは、外部の他のアプリケーションとの非同期通信に参加できます。アプリケーショ
ンは、別のアプリケーションにメッセージを送信し、応答を待機することができます。Process Builder
では、そのメッセージに固有のデータから成る相関セットを使用し、応答を元の要求に一致させま
す。どの受信アクティビティ テンプレートでも、メッセージ待機アクティビティとして設定できます。
たとえば、購入プロセス内の 1 つのアクティビティで、購買発注書のアイテムが発送されたかどうか
に関する情報を要求する JMS メッセージがサプライヤに送信される場合があります。このメッセー
ジには、ベンダ ID 番号と該当アイテムの購買発注書番号が示されています。後日、ベンダのシス
テムでは、この購買発注書の入荷状況メッセージを返信し、メッセージ内に記載された購買発注
書番号とベンダID を使用して、要求を応答に一致させます。
障害対処アクティビティ
障害対処アクティビティは、関連付けられた自動アクティビティが実行時に失敗した場合にトリガさ
れる二次アクティビティです。手動アクティビティにも自動アクティビティにもすることができ、複数
の自動アクティビティからリンクできます。障害対処アクティビティに出力フローを持つことはできま
せん。つまり、プロセスで障害対処としてのみ使用できます。
障害対処を自動アクティビティに割り当てると、障害対処アクティビティに関連付けられたメソッド
が失敗するたびに障害対処が実行されます。したがって、指定した間隔で指定した回数だけ失
敗したメソッドを再試行するようにシステムを設定している場合、その回数の再試行が終了す
るまで、メソッドが失敗するたびに障害対処が実行されます。
指定した回数の再試行が終了すると、[実行者] タブの設定に基づいて最後のアクションが行
われ、ワークフローが継続、停止、または終了されます。失敗した自動アクティビティの再試行
回数および再試行の間隔を設定する方法の詳細については、実行者を選択する (99ページ)
を参照してください。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
13
プロセス デザインを理解する
図3
障害対処アクティビティ
エディタ ペインで、ツールバーの [障害対処の指定] フロー ボタンを使用して、障害対処アクティ
ビティを自動アクティビティに関連付けます。アクティビティ テンプレート上に稲妻アイコンが付い
たものが障害対処アクティビティとして示され、障害対処アクティビティと、その障害対処アクティビ
ティに関連付けられた自動アクティビティのリンクは破線で示されます。
注 記 : インバウンド アクティビティ テンプレートでは、障害対処はサポートされません。
プロセス データ
プロセス データは、プロセスで使用される次のようなさまざまなタイプのデータを指します。
• ドキュメント
• フォーム
• 部品番号、顧客アドレスなどのプロセス変数
• 管理者がプロセス インスタンス全体の特定のデータ要素の定数値を変更できるようにする
プロセス パラメータ
プロセス データを公開および活用すると、申込み者の名前、要求の承認ステータス、融資額
など、ユーザが自身のタスク リストを参照する際に、意味のあるビジネス データが表示されま
す。この情報によって、タスクの実行者は、受信ボックス内のタスクに対してより効率的に作
業を行うことができます。
プロセス データはいくつかのタイプのデータから構成されます。
• プロセスのコンテキストで定義されているプロセス変数。
このような変数は、プロセスの一部として設計時にデフォルト値を割り当てたり、プロセスに関連
付けられているフォームから初期化したりできます。プロセス変数は、ブール型値や文字列値な
どの単純な変数にすることも、[構造化データ タイプ] で定義したデータ タイプに基づく複合的
なデータ タイプにすることもできます。プロセス変数の詳細については、「プロセス変数を理
解する (28ページ) 」を参照してください。
• アプリケーション管理者がプロセスで使用する定数値を変更できるようにするプロセス パラメー
タ。プロセス パラメータは、昇格ロール、移行、実行者の選択、その他のプロセス内で固定の値
に使用できます。管理者が TaskSpace の [管理] タブからパラメータの値を変更すると、すべて
の新しいプロセス インスタンス内でその値が更新されます。
このトピックの詳細については、「プロセス パラメータを理解する (28ページ) 」を参照して
ください。
14
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
• Web サービスからの受信データやパッケージ データなど、ワークフローに関連するものを
ソースとするデータ。
パッケージ データの詳細については、「パッケージを理解する (27ページ) 」を参照してください。
• ワークフローの作成日や作業項目の実行時状態など、作業項目および現在のワークフロー
をソースとする実行データ。この情報はプロセス エンジンによって維持され、ワークフローが
終了すると破棄されます。
Business Activity Monitor (BAM) に 関 す る レ ポ ー ト を 有 効 に す る
Process Builder を使用すると、BAM データベースへのどの実行データを BAM レポートの作成に
使用できるかを設定できます。プロセス設計者は、BAM レポートで使用するパッケージに含まれ
る特定のプロセス変数 (構造化データ タイプも含む)、およびオブジェクトを選択できます。
Process Builder から BAM データベースのビジネス データを更新するには、次の手順に従います。
• 特定のプロセスの監査記録をアクティブにします。
監査記録は、レポート データを BAM データベースに発行する手段です。「プロセス テンプ
レートのプロパティを設定する (56ページ) 」では、監査記録の有効化について説明します。
• レポート用に選択されている属性を持つ構造化データ タイプを作成します。
「構造化データ タイプを作成する (43ページ) 」では、BAM レポート用に監視できる構造化
データ タイプの作成について説明します。
• プロセス レベルまたは個々のアクティビティから、レポートに含めるパッケージを選択します。
「パッケージを管理する (59ページ) 」および「アクティビティ内のプロセス データを変更する
(125ページ) 」では、監視のためのパッケージの選択について、プロセス レベルとアクティビ
ティ レベルの両面で説明します。
• 各アクティビティから、レポートに含める変数を選択します。
変数は、単純なタイプ (ブール型または文字列型) にすることも、レポートの作成時に選択され
た構造化データ タイプにすることもできます。「アクティビティ内のプロセス データを変更す
る (125ページ) 」では、アクティビティ レベルで監視を行うための変数と構造化データの選
択について説明します。
• 監視中のビジネス データに対する変更内容が BAM データベース内で更新されたかどうかを
確認します。「BAM データベースのプロセス データを更新する (40ページ) 」では、BAM デー
タベース内のプロセス データの更新について詳しく説明します。
BAM レポートの設定の詳細については、『Documentum Business Activity Monitor Implementation
Guide (Documentum Business Activity Monitor 実装ガイド)』を参照してください。
フロー
フローはプロセスでアクティビティ同士を接続し、パッケージ、プロセス変数、プロパティ、および接
続されたアクティビティ間の依存関係の移動を可能にします。
フローには次の 3 つのタイプがあります。
• 順方向フローは、通常のワークフローでパッケージをあるアクティビティから次のアクティビティ
に、たとえば編集アクティビティから承認アクティビティというように移します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
15
プロセス デザインを理解する
• 拒絶フローは、アクティビティの実行者が送られたタスクを却下した場合の処理方法を決
定します。承認アクティビティから編集アクティビティにパッケージを送り返すなど、逆方向
にパッケージを送ります。
• 障害対処フローは、関連する自動アクティビティが失敗した場合に実行する処理を決定しま
す。このトピックの詳細については、「障害対処アクティビティ (13ページ) 」を参照してください。
すべての経過アクティビティには、入/出力フローが最低 1 つずつ必要です。初期化アクティビティ
には、少なくとも 1 つの出力フローがありますが、入力フローはありません。終了アクティビティに
は、少なくとも 1 つの入力フローが必要ですが、出力フローはありません。
ワークフローのプロセスを計画する
プロセス テンプレートを作成するたびに、デザイン上の決定を行う必要があります。決定する必
要があるのは、プロセスで使用するプロセス データのタイプ、挿入するアクティビティ、および
ワークフローを構成する方法です。
最初に、自動化するビジネス プロセスを確認し、それを完了するために必要な一連のアクティビ
ティを特定します。アクティビティを選択する (18ページ) アクティビティに関する決定の指針に
ついては、「」を参照してください。
ワークフローの各アクティビティに対して、次の決定を行う必要があります。
• 必要なアクティビティ テンプレートが使用可能か。
追加のテンプレートを作成するかどうかを決定する方法については、「アクティビティ テンプレー
トを選択または作成する (17ページ) 」を参照してください。
• アクティビティの実行者は誰か。
この選択については、「実行者を選択する (18ページ) 」を参照してください。
• 手動アクティビティの場合
– ユーザがアクティビティを委任または拡張できるか。この選択については、「委任と拡張を有
効にする (21ページ) 」を参照してください。
– 作業項目に関する情報を提供するために、実行者に対してどのようなメッセージを表示す
る必要があるか。タスクの主題を定義する (22ページ) このオプションについては、「」を
参照してください。
– アクティビティを完了するためにユーザがサインオフする必要があるか。サインオフ要件を追
加する (23ページ) このオプションについては、「」を参照してください。
– アクティビティを完了するためにユーザがカスタム フォーム テンプレートを完成させる必要が
あるか。フォーム テンプレートをパッケージに関連付ける (29ページ) このオプションにつ
いては、「」を参照してください。
• 自動アクティビティの場合は、その優先度は何か。
自動アクティビティの優先度の値については、「優先度の値を設定する (23ページ) 」を参照
してください。
• プロセスでは、どのプロセス データをフローで転送するか。
「プロセス データを理解する (27ページ) 」で、ワークフロー内で使用できるプロセス データのさ
まざまなタイプについて説明しています。
• フローに基づいてレポートを作成する際、どのプロセス データをレポートで使用するか。
16
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
レポートでプロセス データ変数を使用できるようにする詳細については、「構造化データ タイプ
を作成する (43ページ) 」を参照してください。
• アクティビティはいつ開始されるのか。
この決定については、「トリガの条件を設定する (29ページ) 」を参照してください。
• 一定時間内にアクティビティが開始または終了されなかった場合、どのようなアクションが
起動されるか。
利用可能なアクションについては、「タイマを設定する (30ページ) 」を参照してください。
• メソッドが失敗した場合、自動アクティビティでどのような処理を行うか。
このトピックの詳細については、「障害対処アクティビティ (13ページ) 」を参照してください。
• システム イベントが発生した場合、このアクティビティはどんな通知を送信するのか。
通知オプションについては、「通知を設定する (31ページ) 」を参照してください。
• ワークフローで次に何が実行されるのか。
移行オプションについては、「アクティビティ移行を定義する (32ページ) 」を参照してください。
ロールおよびアクセス権の設定
実装の計画段階で、プロセスに関与する実行者のロールを定義します。それぞれの実行者ロー
ルについて、割り当てられたタスクを実行するために必要なデータに各実行者がアクセスするため
に必要とするアクセス権を識別します。実行者が入力または変更するデータのアクセス権に加え
て、表示だけを行うデータのアクセス権も必ず含めてください。
設定する必要がある最小アクセス権を以下に示します。
• プロセス テンプレートにより、開発者グループ内のユーザが編集を行うことができるようにするた
めに、参照を許可されています。
• プロセスを開始するには、関連するアクセス権および開始プロシージャ拡張アクセス権が必
要です。
• プロセス変数については、関与する可能性がある実行者が編集を許可されます。
• パッケージについては、ビジネス要件に応じて、関与する可能性がある当該実行者が、編
集、変更、または読み取りを許可されます。
アクティビティ テンプレートを選択または作成する
プロセスの各ステップで必要なビジネス タスクを識別する際、プロセスに追加する各アクティビティ
をサポートするアクティビティ テンプレートがあるかどうかを判別する必要があります。アクティビ
ティ テンプレートの多くは、特定のタスクに固有のカスタム属性を 1 つまたは複数含んでいます。
たとえば、電子メールを送信するアクティビティのアクティビティ テンプレートには、宛先の電子
メール アドレスを格納する属性が含まれています。また、このテンプレートでは、すべてのアクティ
ビティに共通な属性のデフォルト値を提供することもできます。
Process Builder には、一般的なアクティビティ タイプを表すアクティビティ テンプレートが事前定義
されています。用意されたテンプレートにはない特別な目的のアクティビティを含むビジネス プロ
セスの場合、そのアクティビティによって実行されるタスクを反映したカスタム属性を持つカスタム
アクティビティを作成する必要があります。必要なタスクを実行するために、カスタム ワークフロー メ
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
17
プロセス デザインを理解する
ソッドを開発する場合もあります。特定タイプのカスタム アクティビティを頻繁に使用する場合は、
カスタム アクティビティに基づいてカスタム アクティビティ テンプレートを作成することができます。
アクティビティ テンプレートの作成の詳細については、「アクティビティ テンプレートを操作する
(89ページ) 」を参照してください。
アクティビティを選択する
プロセス テンプレートにはそれぞれ 1 つ以上の開始アクティビティと 1 つの終了アクティビティが
必要です。テンプレートには経過アクティビティをいくつでも含めることができます。含める経過ア
クティビティの数は、業務上の要件に応じて異なるワークフローの構成によってのみ異なります。
ワークフロー内のそれぞれのアクティビティには、プロセス テンプレート内で一意の名前が必要で
す。この名前は、アクティビティをプロセス テンプレートに追加するときに割り当てられます。アク
ティビティで実行される作業を説明するアクティビティ名を選択します。
ユーザ自身が作成するアクティビティ、または少なくとも [関連付け] アクセス権のあるアクティビ
ティはどれでも含めることができます。
ワークフロー内でアクティビティ定義を複数回使用できます。たとえば、すべてのドキュメントを 2
回レビューすることにします。この場合、書き込み、レビュー 1、改訂、レビュー 2、発行、という
アクティビティのあるワークフローを作成できます。レビュー 1 とレビュー 2 のアクティビティに
は同じアクティビティ定義を使用できます。
ただし、ワークフロー内でアクティビティを複数回使用する場合は、アクティビティの 1 つのイ
ンスタンスだけがいつでもアクティブになるようにワークフローを構成する必要があります。同じ
定義を基にする先行アクティビティがまだ実行中である場合、ワークフローではアクティビティ
を開始できません。
実行者を選択する
アクティビティ定義には、Process Builder がアクティビティの実行者を判断するための情報が含ま
れます。Process Builder では、手動アクティビティの実行者に関して広範な選択肢が用意され
ています。自動アクティビティでは、スクリプトやプログラムの実行時に適用される権限を持つ
ユーザを指定する必要があります。
手動アクティビティの開始時、そのアクティビティの実行者として指定されたユーザの受信ボッ
クスに、作業項目が追加されます。大量のドキュメントを処理する場合、ワーク キューに作業
項目を追加し、多数のユーザに作業を割り当てることができます。ワーク キュー管理および実
行者の詳細については、『Documentum Webtop ユーザ ガイド』または『Documentum TaskSpace
設定ガイド』を参照してください。
次の表は、実行者を選択するカテゴリのリストです。それぞれのカテゴリは整数値で表されていま
す。自動アクティビティで使用できるのは、最初の 4 つのオプション (0 ～ 3) だけです。
表2
アクティビティ実行者の選択カテゴリ
ユーザのカテゴリ
実行者の選択方法
0 ワークフロー スーパーバイザ
アクティビティの開始時に、ワークフロー スーパーバイザとして
指定されたユーザがサーバにより選択されます。デフォルトで
は、ワークフローの開始者がワークフロー スーパーバイザです。
18
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
ユーザのカテゴリ
実行者の選択方法
1 リポジトリの所有者
アクティブな Documentum リポジトリの所有者として識別され
たユーザがサーバにより選択されます。
2 直前のアクティビティ実行者
現在のアクティビティのトリガ条件に合致する直前に完了した
アクティビティから実行者が選択されます (トリガ条件について
は「トリガの条件を設定する (29ページ) 」を参照)。これには、
複数の実行者や、直前に行われた他のアクティビティのユー
ザが含まれる場合があります。
3 特定ユーザ
テンプレートの作成時に実際のユーザ名を選択します。
4 グループのすべてのユーザ
テンプレートの作成時にグループ名を選択します。実行時に、
各グループ メンバーに個別の作業項目が割り当てられます。
5 グループの単独ユーザ (最初に作業
項目を取得する)
テンプレートの作成時にグループ名を選択します。実行時
に、各グループ メンバーに新しい作業項目が割り当てられま
す。グループの 1 人のメンバーが作業項目を取得すると、そ
の作業項目は他のすべてのグループ メンバーの受信ボック
スから削除されます。
6 グループの単独ユーザ (未完了の作
業項目の最少数)
テンプレートの作成時にグループ名を選択します。実行時に、
選択したグループのどのユーザの作業量が最も少ないかが
サーバにより識別され、そのユーザに新しい作業項目が割り
当てられます。作業量は、休止中の作業項目とアクティブな作
業項目の数として識別されます。
8 グループに所属する複数のユーザ
アクティビティの実行者として複数のユーザまたはエイリアスの
リストを選択します。実行者として選択された各ユーザの作業
項目がサーバにより割り当てられます。
9 複数の実行者が順次実行
アクティビティの実行者として複数のユーザまたはエイリアスの
リストを選択します。選択されたユーザのリストの最初のユーザ
に作業項目が割り当てられます。そのユーザが作業項目を完
了すると、選択されたユーザのリストの次のユーザに別の作業
項目が作成されます。選択されたすべてのユーザがそれぞれ
の作業項目を完了するまで、この操作が続行されます。
10 ワーク キュー
選択したワーク キューに作業項目が割り当てられます。作業を
割り当てられたユーザがワーク キューから優先度順に作業項
目を取り出すか、キューの管理者が作業項目を特定のユー
ザに割り当てます。ワーク キューの処理の詳細については、
『Documentum Webtop ユーザ ガイド』または『Documentum
TaskSpace 設定ガイド』を参照してください。
ワークフローの参加者には、自分がワークフロー タスクを実行できないことをマークするオプション
があります。ワークフローの実行時に、実行不可能な実行者としてマークされているユーザがいる
場合、ワークフロー エンジンは、ユーザから委任されたユーザに作業項目を与えようとします。委
任されるユーザの詳細については、「委任と拡張を有効にする (21ページ) 」を参照してください。
Process Builder でのアクティビティ実行者の選択については、「実行者を選択する (99ページ) 」
を参照してください。実行時に実行者を選択するアクティビティを作成する方法については、
「実行者を決定するタイミングを定義する (20ページ) 」および「エイリアスを使用する (20ペー
ジ) 」を参照してください。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
19
プロセス デザインを理解する
実行者を決定するタイミングを定義する
アクティビティを作成する場合、実行者のタイプとユーザ カテゴリを定義する必要があります。この
時点で実際の実行者を定義することも、次のいずれかによって実行時に実際の実行者を選択す
るようにアクティビティを設定することもできます。
• ワークフローの開始時にワークフローの開始者が選択
• アクティビティの開始時にサーバが選択
• 直前のアクティビティが完了したときに、直前のアクティビティの実行者が選択
• アクティビティで定義した条件分岐ロジックに基づいて選択
アクティビティ定義で実際の実行者を定義するのは、最も柔軟性に欠ける構造です。直前のアク
ティビティの実行者がアクティビティの実行者を選択できるようにする方がより柔軟性があります。
それは、この構造では現在の状況とビジネス ルールに基づいて実行者を決定できるためです。条
件に基づいて実行者を設定するのが、実行者を決定するための最も柔軟性のある構造です。
カテゴリ 0 (ワークフロー スーパーバイザ)、1 (リポジトリの所有者)、または 2 (直前のアクティビティ
実行者) をユーザのカテゴリとして選択した場合、実際のユーザはカテゴリによって定義されます。
たとえば、既存のワークフローのワークフロー スーパーバイザが 1 人のみで、そのワークフローが実
行されるリポジトリの所有者が 1 人のみだとします。この場合、アクティビティを作成したときに実際
のユーザを定義する必要はありません。サーバによって、アクティビティの開始時に選択されます。
カテゴリ 3 (特定ユーザ) を指定した場合、アクティビティを作成するときに実際のユーザを選択で
きます。ワークフローの実行時に特定のユーザが選択されるようにするには、エイリアスを使用する
か、またはユーザを決定するための条件分岐ロジックを定義します。詳細については、「エイリアス
を使用する (20ページ) 」または「条件に応じて実行者を選択 (106ページ) 」を参照してください。
エイリアスを使用する場合、ユーザは、サーバによってエイリアス セットが使用されて自動的に解
決されるか、直前のアクティビティの実行者によって解決されます。個別のユーザの代わりに
グループ名またはワーク キューを指定する点を除いて、同じオプションがカテゴリ 4、5、6 また
は 10 にも適用されます。アクティビティを作成するときに実際のグループ名またはキュー名を
選択する場合は、グループ名またはキュー名を指定します。実行時に実際のグループまたは
キューが選択されるようにするには、エイリアスを使用します。
カテゴリ 8 および 9 の場合、複数のユーザのリストの名前またはエイリアスを指定します。他の
カテゴリと同様に、アクティビティを作成するときに実際の実行者を選択することも、直前のアク
ティビティの実行者に実行者を選択させることも、エイリアスを使用して実行時に実行者が選
択されるようにすることもできます。
ユーザ カテゴリがワーク キュー、特定ユーザ、グループのすべてのユーザ、グループの単独
ユーザ、グループに所属する複数のユーザ、複数の実行者が順次実行の場合、条件判断の
表で定義したロジックおよびプロセス データに基づいて実行者を解決する条件分岐ロジックを
アクティビティで定義できます。実行時に、プロセス エンジンが設定済みの規則を評価してア
クティビティの実行者を割り当てます。このトピックの詳細については、「条件に応じて実行者
を選択 (106ページ) 」を参照してください。
エイリアスを使用する
エイリアスとは、実際のユーザまたはグループ名の代わりに使用する、ユーザまたはグループのカ
テゴリの説明的な名前です。エイリアスは、実行時にサーバによってその時点のカテゴリに合致す
20
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
る実際のユーザまたはグループの名前に置き換えられます。アクティビティ定義でエイリアスを使
用すると、さまざまな状況で使用できる柔軟なプロセス テンプレートを作成できます。
たとえば、休暇申請のワークフローを作成するとします。会社内の各部門に異なるマネージャがお
り、休暇を承認する必要があります。そのためには、部門ごとにプロセス テンプレートを作成する
のではなく、誰もが使用できるテンプレートを作成します。ビジネス プロセス自体はどの部門でも
同じだからです。アクティビティの実行者を特定の名前で指定せずに、[マネージャ] などのエイリ
アスを使用します。ワークフローの実行時、「ワークフロー開始者のマネージャは誰か?」という質
問にサーバが答え、そのユーザに作業項目を送信します。
エイリアスとそれに関連する実際の値を知るために、実行時にサーバによって 1 つまたは複数
のエイリアス セットが検索され、エイリアスが解決されます。エイリアス セットは、エイリアスとそ
れに対応する実際の値のリストを定義するオブジェクトです。エイリアス セットは Documentum
Administrator で作成します。エイリアス セットの詳細については、『Documentum Content Server
Administration Guide (Documentum Content Server 管理ガイド)』を参照してください。エイリアス
セットを特定のユーザに関連付けて、Process Builder でワークフローのデフォルト エイリアス
セットを識別することができます。
アクティビティの実行者としてエイリアスを含める場合、実行時にエイリアスを解決するためにサー
バが参照するエイリアス セットを次から指定できます。
• ワークフローのデフォルト エイリアス セット
• ワークフローを開始したユーザに関連付けられたエイリアス セット
• 直前のアクティビティの実行者のエイリアス セット
• 選択した任意のエイリアス セット
また、ワークフロー開始時に、ワークフロー開始者が手動でエイリアスの値を入力するように設
定することもできます。ワークフロー開始者にエイリアスを決定させるためには、プロセス テン
プレートにデフォルト エイリアス セットを定義する際に、エイリアスを含むがエイリアスのマッピ
ング先の名前は含まないエイリアス セットを指定します。詳細については、「手動実行者を選
択する (101ページ) 」を参照してください。
委任と拡張を有効にする
手動アクティビティを作成するとき、このアクティビティを実行するユーザがアクティビティを別
の実行者に委任できるか、あるいは追加実行者を指定することでアクティビティを拡張でき
るかを指定します。
委任の場合は、元の実行者はアクティビティを完了しません。拡張の場合は、元の実行者と指
定された追加実行者の両方がアクティビティを完了します。
委任を可能にした場合は、委任が自動的に行われる場合と手動で行われる場合があります。
• 自動委任が行われるのは、アクティビティの実行者が実行可能かどうかをサーバが調べた結
果、実行不可能であると判断されたときです。このとき、作業は元の実行者が [ワークフローの
利用可能性] ダイアログ ボックスで指定したユーザに自動的に委任されます。ユーザが指定
されていない場合、または指定されているユーザが実行不可能である場合、アクティビティ
の設計時に設定したオプションに応じて、作業項目はワークフロー スーパーバイザに再割り
当てされるか、元の実行者に返されます。
• 手動委任が行われるのは、作業項目の実行者、ワークフロー スーパーバイザ、またはスーパー
ユーザが、その作業項目を委任することを選択したときです。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
21
プロセス デザインを理解する
拡張が可能なときは、元の実行者はアクティビティの作業項目を完了したときに、そのアクティ
ビティの 2 回目の実行者を指定できます。2 回目の実行者に対する新しい作業項目が、サー
バによって生成されます。2 回目の実行者が作業を完了した後で、サーバがアクティビティの
移行条件を評価して次のアクティビティに進みます。2 回目の実行者は、アクティビティをそれ
以上拡張することはできません。
これらのオプションの設定については、「実行者を選択する (99ページ) 」を参照してください。
タスクの主題を定義する
タスクの主題は、作業項目の実行者に作業項目の情報を提供するメッセージです。このメッ
セージは、アクティビティ定義の一部です。メッセージには、サーバが実行時に値を置き換え
る 1 つまたは複数の属性への参照を挿入することができます。たとえば、次のようにタスクの主
題が定義されるとします。
Please work on the {dmi_queue_item.task_name} task (from activity number
{dmi_queue_item.r_act_seqno})of the workflow {dmi_workflow.object_name}.
The attached package is {dmi_package.r_component_name}.
task_name が 「Review」、r_act_seqno が 2、object_name が 「Engr Proposal」、r_package_name が
「First Draft」 であるとすると、実行時には次のように表示されます。
Please work on the Review task (from activity number 2) of the
workflow Engr Proposal. The attached package is First Draft.
タスクの主題は最大 255 文字であり (変数の参照が解決される前)、次のオブジェクト タイプと属性
への参照を含めることができます。
• dm_workflow オブジェクトの任意の属性
• 現在のタスクに関連付けられた dmi_workitem オブジェクトの任意の属性
• 現在のタスクに関連付けられた dmi_queue_item オブジェクトの任意の属性 (task_subject は除く)
• dmi_package オブジェクトの任意の属性
注 記 : パッケージ内のドキュメントの名前は、[プロセスのプロパティ] ダイアログ ボッ
クスの [実行時にパッケージにドキュメント名を保存] オプションを選択した場合にの
み表示されます。
参照は、中括弧で囲む必要があります。オブジェクト タイプ名と属性名は小文字で入力し、
ピリオドで区切る必要があります。
サーバでは、次の規則に従って文字列を解決します。
• サーバでは、解決済みのオブジェクト タイプと属性の参照を引用符で囲みません。
• 参照される属性が繰り返し属性の場合、サーバではすべての値を置き換えて、それらをカ
ンマで区切ります。
• 変数の解決後に作成された文字列の長さが 512 文字を超える場合、サーバでは文字列が
切り詰められます。
• オブジェクト タイプと属性の参照にエラーがある場合 (オブジェクト タイプまたは属性が存在
しない場合など)、サーバでは参照を解決しません。未解決の参照エラーはメッセージで
表示されます。
22
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
解決された文字列は、タスクに関連付けられたキュー項目オブジェクトの task_subject 属性に保存
されます。サーバが作業項目を作成した後は、参照される属性の値が変更されても、キュー項
目の task_subject 属性の値は変わりません。
サインオフ要件を追加する
多くのビジネス プロセスでは、アカウンタビリティが必要です。アカウンタビリティを提供する 1
つの方法は、実行するタスクをサインオフするよう実行者に求めることです。Process Builder で
手動アクティビティを定義する際、アクティビティを完了する場合に実行者がサインオフする必
要があることを指定できます。サインオフでは、実行者がパスワードを入力してタスクを実行し
たことを確定する必要があります。
注 記 : Content Server でも、タスクまたはタスクに関連付けられたドキュメントのサインオフ
の手段として、電子署名とデジタル署名がサポートされます。これらの高度なサインオフ
オプションの詳細については、Content Server のドキュメントを参照してください。
優先度の値を設定する
自動アクティビティの場合、キューに含まれるアクションに対してサーバがアクティビティを実行す
る順序を決定する優先度の値を指定します。優先度の値は、手動アクティビティの場合も設定で
き、この設定は実行者の受信ボックスのタスクのリストに反映されます。受信ボックスとは、実行者
に現在割り当てられているタスクが一覧表示されるユーザ特定の領域です。
自動アクティビティが開始されると、アクティビティは、定期的に実行される、サーバ ファシリティの
実行キューに入れられます。サーバ ファシリティは、優先度の順序でアクティビティを実行します。
デフォルトでは、ファシリティが起動されるたびに、キューに入れられたすべての自動アクティ
ビティが実行されますが、システム管理者がファシリティが実行するたびに処理されるアクティ
ビティの数を制限することもできます。サーバ設定 max_wf_jobs が小さい数値に設定されてい
て、優先度の高い多数のアクティビティがキューに含まれている場合、優先度が低いアクティビ
ティは、起動を数回待った後に実行される場合があります。
アクティビティの優先度の設定については、「アクティビティのプロパティを設定する (97ペー
ジ) 」を参照してください。
タスクの初期優先度とエージングを設定する
ほとんどのキュー プロセッサでは、作業項目は優先度に基づいて受信ボックスに表示されます。
最も優先度の高い項目は、それより優先度の低い作業項目よりも先に作業されるように割り当てら
れます。優先度とエージングの設定は、ワーク キューのタスクの処理における基本要素です。新し
い作業項目が作成されると、サーバではタスクをワーク キュー項目として識別し、項目の初期優先
度を割り当てるためのロジックをチェックします。タスクがキューに入った後は、エージング ジョブに
より、別のロジックに基づいてタスクの優先度が上げられます。これにより、タスクは作業されるまで
受信ボックスの上方に移動します。優先度が上がると、キュー アドニミストレータによるワーク
キュー間でのタスクの再分配またはリソースの再割り当てがトリガされます。
最初に表示されるタスクの優先度のレベルや、優先度が増加する速度は、ワーク キュー ポリシー
またはタスクのアクティビティ テンプレートのいずれかで設定できます。ワーク キュー ポリシーを使
用すると、キュー アドニミストレータまたはキュー マネージャはポリシーで設定したさまざまな値に
基づいて、タスクの初期優先度や優先度を上げる頻度と割合を指定します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
23
プロセス デザインを理解する
さらに複雑な初期化やエージングのシナリオを作成するには、Documentum Composer を使用して
優先度モジュールを作成します。優先度モジュールには、プロセスに属するプロセス データや他
の属性に基づいて優先度を動的に計算、更新するためのロジックが含まれます。優先度モジュー
ルは、ワーク キュー ポリシーまたは Process Builder のアクティビティに関連付けることができます。
タスクの初期優先度を解決するしくみ
システムでワーク キュー タスクが作成されるとき、プロセス エンジンは次の条件をこの順序で使
用して、タスクの初期優先度を決定します。
1. アクティビティ定義に関連付けられている優先度モジュール: アクティビティ定義に関連付けら
れている優先度モジュールがある場合は、モジュールの getInitialPriority() メソッドが使用さ
れ、その戻り値が初期優先度として設定されます。
2. ワ ー ク キ ュ ー ポ リ シ ー に 関 連 付 け ら れ て い る 優 先 度 モ ジ ュ ー ル : タスクのワーク キュー ポリ
シーに関連付けられている優先度モジュールがある場合は、モジュールの getInitialPriority()
メソッドが使用され、その戻り値が初期優先度として設定されます。
3. ワ ー ク キ ュ ー ポ リ シ ー : タスクに関連付けられている優先度モジュールがない場合は、
ワーク キュー ポリシー オブジェクトの initial_priority 設定が使用され、その初期優先度が
設定されます。
タスクの優先度を上げるしくみ
dm_QmPriorityAging ジョブが実行されるたびに、次の条件をこの順序で使用して、すべてのワー
ク キュー タスクの優先度が上げられます。
1. アクティビティ定義に関連付けられている優先度モジュール: アクティビティ定義に関連付けら
れている優先度モジュールがある場合は、モジュールの getIncrementPriority() メソッドが使用
され、その戻り値がインクリメント優先度として使用されます。
2. ワーク キュー ポリシーに関連付けられている優先度モジュール: タスクのワーク キュー ポリシー
に関連付けられている優先度モジュールがある場合は、モジュールの getIncrementPriority() メ
ソッドが使用され、その戻り値がインクリメント優先度として使用されます。
3. ワ ー ク キ ュ ー ポ リ シ ー : タスクに関連付けられている優先度モジュールがない場合は、ワー
ク キュー ポリシー オブジェクトの increment_priority 設定が使用され、そのインクリメント
優先度が設定されます。
タスクの静的優先度とエージング ロジックを設定する
ワーク キュー ポリシーを使用すると、キュー アドミニストレータまたはキュー マネージャは、ワーク
キュー内のタスクのエージングの頻度と、その初期優先度を定義できます。
システムでワーク キュー タスクが作成されるとき、その初期優先度は、関連付けられているワーク
キュー ポリシーの初期優先度設定に基づいて設定されます。タスクがキュー内で待機している間
は、dm_QmPriorityAging ジョブが実行されるたびに、そのタスクに関連付けられているワーク
キュー ポリシーのインクリメント優先度設定で指定されたレベルだけ優先度が上げられます。ワー
ク キュー ポリシーに基づくタスクの優先度とエージング ロジックの設定については、『Documentum
Webtop ユーザ ガイド』を参照してください。
24
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
タスクの動的優先度とエージング ロジックを設定する
状況によっては、初期優先度および優先度を上げるレベルの両方を動的に計算しなければならな
い場合があります。そのような場合は、ワーク キュー ポリシーの代わりに優先度モジュールを作成
して、優先度とエージング ロジックを設定します。優先度モジュールは、Webtop または TaskSpace
でワーク キューを作成するときや、Process Builder でアクティビティを作成するときに選択できます。
アクティビティへの優先度モジュールの割り当てについては、「ワーク キュー優先度モジュールを
アクティビティに関連付ける (100ページ) 」を参照してください。
プロセス データを使用して、ワークフロー内の値に基づいて初期優先度を設定したり、優先度を
上げたりすることができます。たとえば、優先顧客のローン申込がワーク キューに入ってきた場合
に、直ちに他の顧客のローン申込よりも高い優先度の値の位置に配置することができます。また、
ローンの申請額が多額の場合や優先ローン会社からの申込の場合に、より高い比率で優先度を
上げて、特定の時間内にタスクが処理されないときにはキュー スーパーバイザに警告が送信され
るようにすることができます。こうしたロジックは、納期や何らかの時間制限が近づくにつれてタスク
の優先度を上げる場合に特に有効です。納期が近づくにつれて優先度がより急激に上がっ
ていき、タスクがより高い割合でキューの上方に移動します。
優先度とエージングの値を設定するには
1. IWQTaskPriority インターフェイスおよび IDfModule インターフェイスの Java クラスを含む
優先度モジュールを作成します。
IWQTaskPriority は次の 2 つのメソッドを持ちます。
int getInitialPriority(IDfSession session, IDfWorkitemEx witem)
throws DfException;
int getIncrementPriority(IDfSession session, IDfWorkitemEx witem)
throws DfException;
IDfModule インターフェイスはメソッドを持ちません。
モジュールの構築の詳細については、『Documentum Composer User Guide (Documentum
Composer ユーザ ガイド)』を参照してください。
2. Composer を使用して、手順 1 で作成したクラスを使用するモジュールを作成します。
クライアント クラス パスに、bpm_infra.jar および dfc.jar を必ず含めてください。
優先度モジュールのサンプル
/*
* Copyright 1994-2008. EMC Corporation. All Rights Reserved.
*/
package com.documentum.bpm.priority.test;
import
import
import
import
com.documentum.bpm.IDfWorkitemEx;
com.documentum.bpm.priority.IWQTaskPriority;
com.documentum.fc.client.IDfModule;
com.documentum.fc.client.IDfSession;
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
25
プロセス デザインを理解する
import com.documentum.fc.common.DfException;
public class SamplePriorityModule2 implements IWQTaskPriority, IDfModule {
/**
* This example calculates priority from Process Data Variables.
* There are two Process Data Variables defined on the workflow template:
*
- is_vip (boolean)
*
- loan_info
*
-loan_amount (int)
*
- broker_class (String)
*/
public int getInitialPriority(IDfSession session,
IDfWorkitemEx witem) throws DfException
{
//
// If is_vip == true
//
initial_priority = 10
// Else
//
initial_priority = loan_info.loan_amount / 1000
//
Boolean is_vip = (Boolean) witem.getPrimitiveVariableValue("is_vip");
if (is_vip.booleanValue() )
return 10;
else {
Integer loan_amount = (Integer)witem.getStructuredDataTypeAttrValue
("loan_info", "loan_amount");
return (loan_amount.intValue() / 1000);
}
}
public int getIncrementPriority(IDfSession session,
IDfWorkitemEx witem) throws DfException
{
//
// If loan_info.broker_class = "A"
//
increment_priority = 10
// Elseif loan_info.broker_class = "B"
//
increment_priority = 5
// Else
//
increment_priority = 0
//
String broker_class = (String) witem.getStructuredDataTypeAttrValue
("loan_info", "broker_class");
if (broker_class.equalsIgnoreCase("A"))
return 10;
if (broker_class.equalsIgnoreCase("B"))
return 5;
else
return 0;
26
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
}
}
プロセス データを理解する
ビジネス プロセスを定義する際、フローで管理されるデータは、意味のある方法で表す必要が
あります。フロー内のデータは、ワークフロー変数、プロセス変数、またはそのフローに関連付
けられているパッケージのいずれかです。
プロセス データは、ドキュメント、フォーム、プロセス変数 (部品番号や顧客アドレス) など、プロセス
で使用されるさまざまなタイプのデータを指します。プロセスで定義できるプロセス データには、主
にパッケージ データとプロセス変数の 2 つのタイプがあります。これらのタイプのデータはどちらも、
プロセス内の個々のアクティビティで使用されるようにプロセス レベルで定義する必要があります。
パッケージを理解する
パッケージは、アクティビティが作業を実行するオブジェクトです。パッケージは、ドキュメント、
フォーム、またはアクティビティに関連付けられたその他のデータです。プロセスのプロパティの一
部として、プロセス オブジェクトで処理するすべてのパッケージを一覧にしてから、各アクティビ
ティについてどのパッケージを使用するかを指定します。1 つのアクティビティで複数のパッケージ
を処理できます。各パッケージにフォーム テンプレートを関連付けて、アクティビティの実行者が
パッケージで作業するときに表示されるユーザ インターフェイスを定義することができます。
ビジネス プロセスを定義する際、ワークフローで処理されるオブジェクトを指定します。ワークフ
ローによって処理されるオブジェクト (ドキュメントやイメージなど) が、パッケージです。パッケー
ジは、アクティビティの作業対象コンテンツを表します。アクティビティでは、必要に応じて 1 つ
または複数のパッケージを処理できます。
パッケージを定義するには、ワークフローで処理する項目を指定します。パッケージを処理するア
クティビティの実行者がタスクを行うために使用するフォームを選択するオプションもあります。
パッケージを使用して、アクティビティでは次のことを実行できます。
• パッケージを変更しない
• パッケージを変更し、新しいバージョンとしてリポジトリに保存する
• 受信したパッケージを転送するのではなく、新しい別のパッケージをワークフローに挿入する
• パッケージに関連付けられた属性を変更する
多くのワークフローでは、すべてのアクティビティで同じパッケージが処理されます。たとえば、購
買発注書を受信して承認するワークフローでは、同じ購買発注書ドキュメントがパッケージとして、
必要なすべてのアクティビティで使用されます。
他に、アクティビティで実行される作業が、受信パッケージから新しいバージョンのドキュメン
トを作成することになる場合もあります。たとえば、ユーザがレビューするドキュメントを受信す
ることがあります。ユーザはドキュメントをチェックアウトして、コメントや修正を加え、そのドキュ
メントをチェックインします。この場合、このアクティビティが次のアクティビティにパッケージを
送信するときに、新しいバージョンのコンポーネントを送信するようにできます。Process Builder
でこのシナリオを完成するには、受信した同じパッケージの異なるバージョンを転送するように
アクティビティを設定します。2.5 などのバージョン番号や「Draft」、「CURRENT」などの概念的
なバージョン ラベルを使用してバージョンを指定できます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
27
プロセス デザインを理解する
アクティビティによっては、受信するパッケージとはまったく異なるパッケージを送信するアクティビ
ティが実行する作業で必要になる場合があります。たとえば、個人的な活動通知を受け入れるアク
ティビティがあるとします。実行者 (HR 担当者) はこの通知をファイルして、別のフォームを会計部
門に送信する必要があります。Process Builder では、特定のパッケージを入力として受け取り、別
のパッケージを出力として渡すようにアクティビティを設定できます。
Process Builder でのフローやパッケージの設定については、「アクティビティ内のプロセス データ
を変更する (125ページ) 」を参照してください。
プロセス変数を理解する
プロセス変数は、ビジネス プロセスで使用されるさまざまなタイプのデータのインスタンスです。プ
ロセス変数は、単純なデータ タイプ (文字列型、ブール型、日付型) にすることも、複合的なデー
タ タイプ (購買発注書、製造品目など、論理的に関連のあるデータのグループ) にすることもでき
ます。複合データ タイプは、[構造化データ タイプ] ウィンドウで定義します。ここで、複合データ タ
イプは、構造化データ タイプとして、リポジトリ内の複数のプロセスで再利用できます。
デフォルト値は、単純なデータ タイプでのみ設定できます。複雑なデータ タイプでは、タイ
プ定義内のデフォルト値が使用されます。
構造化データ タイプの属性は、レポートで使用するように識別できます。これらの要素はプロセス
エンジンによって公開されるため、レポート ツールではそのデータを使用して、静的レポートおよび
BAM レポートを作成できます。プロセス変数は、[プロセスのプロパティ] でプロセスに定義します。
ワークフローのプロセス変数を定義する詳細については、「プロセス変数を管理する (61ページ)
」を参照してください。リポジトリの構造化データ タイプを定義する詳細については、「構造化
データ タイプを作成する (43ページ) 」を参照してください。
プロセス パラメータを理解する
プロセス パラメータにより、アプリケーション管理者は TaskSpace の [管理] タブを使用して、プロセ
スで使用する定数値を変更できます。プロセス パラメータは、しきい値、納期、昇格ロール、その
他のプロセス内で固定の値に使用されます。管理者が [管理] タブからパラメータの値を変更する
と、新規または現在実行中のすべてのプロセス インスタンスで更新された値が使用されます。
プロセス パラメータには、単純データ タイプ (文字列型、ブール型、整数型、浮動小数型、日付
型) を使用することができます。また、プロセス パラメータはプロセス テンプレート内で定義され、
テンプレート固有になります。プロセス変数と異なり、プロセス パラメータはリポジトリ内の複数のテ
ンプレートで共有したり再利用したりすることはできません。
たとえば、アプリケーション管理者がさまざまなビジネス要求へ応答するための実行者の値に変更
を行う必要があるとします。プロセス設計者は、プロセス パラメータ approver1 を含むプロセス テン
プレートを作成し、定数値 manager を作成します。プロセスが完成してインストールされたら、アプ
リケーション管理者は TaskSpace の [管理] タブからプロセス テンプレートを開き、関連付けられた
プロセス パラメータ フォームを使用して approver1 の値を manager から別の実行者に変更します。
すべての新しいワークフローで更新された値が使用されます。
また、プロセス パラメータは、データ マッパのソース (左) 側のプロセス データとして、
マッピングでも使用できます。プロセス設計者は、プロセス パラメータ recipient2 (値は
[email protected]) を作成して、電子メール通知の受信者を変更するマッピングを作
成できます。プロセス パラメータがアクティビティ テンプレートのデータ マッパのソース側に表示
されて、マッピングに使用できるようになります。後で、プロセスがインストールされて実行され
28
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
たら、アプリケーション管理者はプロセスを開き、プロセス パラメータ フォームで新しい値を入
力して電子メール受信者を変更できます。
Process Builder でプロセス パラメータを定義する詳細については、「プロセス パラメータを管理す
る (62ページ) 」を参照してください。
フォーム テンプレートをパッケージに関連付ける
フォーム テンプレートを、手動アクティビティに渡される各パッケージに関連付けることができま
す。フォーム テンプレートによって、データの表示や入力の実行者にカスタム ユーザ インター
フェイスが提供されます。設定オプションに応じて、次のいずれかが発生した場合に、実行者に
このフォームが表示される場合があります。
• ユーザが Documentum 受信ボックスからパッケージを開いたとき
• パッケージのプロパティを表示したとき
実行者はフォームに記入して、アクティビティを完了するか、パッケージのプロパティを更新しま
す。アクティビティが複数のパッケージを受信する場合、実行者は各パッケージに関連付けられた
複数のフォームに入力します。パッケージにフォームが関連付けられていない場合、実行者には
デフォルトの [タスク マネージャ] ダイアログ ボックスが表示されます。
ワークフローにパッケージを追加するときに、フォーム テンプレートを各パッケージに関連付けるこ
とができます (「パッケージを管理する (59ページ) 」を参照)。また、手動アクティビティを設定する
ときに、フォーム テンプレートをパッケージに関連付けることもできます。パッケージに一度に関連
付けることのできるフォームは 1 つだけですが、パッケージがワークフローを進むにつれて関連付
けるフォームを変えることができます。たとえば、購入要求を承認する担当者に表示されるフォー
ムを、要求を行う担当者が入力したものとは異なるフォームにできます。両方のフォームに含まれ
るデータは同じですが、その表示形態が異なります。アクティビティを設定するときに、そのアク
ティビティで使用するフォーム テンプレートとして、ビジネス プロセス レベルでパッケージに関連
付けられたものとは異なるフォーム テンプレートを設定できます。
フォーム テンプレートをパッケージに関連付けるには、フォーム テンプレートとパッケージが
同じ基本データ モデルを使用している必要があります。フォームの選択時には、パッケージ用
に選択されたデータ タイプとデータ モデルが一致するフォーム テンプレートだけが Process
Builder に表示されます。パッケージのオブジェクト タイプを設定する前にフォーム テンプレー
トを選択する場合、Process Builder では、選択したフォーム テンプレートのデータ モデルと一
致するオブジェクト タイプが設定されます。
フォーム テンプレートとフォームの詳細については、『Documentum Forms Builder User Guide
(Documentum Forms Builder ユーザ ガイド)』を参照してください。
トリガの条件を設定する
トリガは、アクティビティが開始できることを示すシグナルです。トリガの条件によって、アクティビ
ティの開始条件が定義されます。実行時に、アクティビティのトリガの条件が満たされるまでサーバ
はアクティビティを開始しません。トリガの条件には、アクティビティを開始する前に発生する必要
があるトリガ イベントをオプションとして含めることができます。
アクティビティに複数の入力フローがある場合、このアクティビティの開始前までに先行するアク
ティビティをいくつ完了しなければならないかを指定できます。トリガの条件は、アクティビティ
を開始する前に、そのアクティビティにパッケージを配信する必要があるフローの最小数で
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
29
プロセス デザインを理解する
す。たとえば、アクティビティに 3 つの入力フローがある場合、3 つのうちの 2 つがパッケージ
を配信したらアクティビティを開始できるように設定できます。トリガの条件は、1 と入力フロー
の総数との間の値にする必要があります。
トリガ イベントはワークフローにキュー登録済みのイベントです。このイベント名には、dm_checkin
などのシステム定義イベントの名前や、promoted、released などの独自の名前を入力できま
す。ただし、イベント通知を受信するワークフローを登録することはできないため、イベントは
Documentum API を使用して明示的にワークフローにキュー登録する必要があります。開始条件
にトリガ イベントを含める場合、アクティビティを開始する前に、ワークフローにキュー登録された指
定されたイベントをサーバが検出する必要があります。複数のアクティビティに同じイベントをトリガ
として使用することができますが、アプリケーションによってアクティビティごとにイベントがキューに
入れられる必要があります。イベントの定義およびキュー登録の詳細については、『Documentum
Content Server Fundamentals (Documentum Content Server の基本操作)』を参照してください。
アクティビティのトリガ条件の設定については、「アクティビティのトリガを設定する (111ペー
ジ) 」を参照してください。
タイマを設定する
アクティビティを設定するときに、作業が予定どおりにフローしていないと思われる場合に起動され
るタイマを設定できます。たとえば、ワークフローの開始後 12 時間以内にアクティビティが開始さ
れない場合や、アクティビティの開始後 4 時間以内にアクティビティが完了しない場合に、ワーク
フロー スーパーバイザが警告を受け取るようにすることができます。
Process Builder では、アクティビティに対して次の 2 種類の警告タイマがサポートされています。
• 事前タイマ。ワークフローの開始後、指定された時間以内にアクティビティが開始されなかっ
た場合に起動されます。
• 事後タイマ。アクティビティの開始後、指定された時間以内にそのアクティビティが完了しなかっ
た場合に起動されます。
管理者は Documentum TaskSpace でこの 2 種類のタイマを変更することができます。1 つのタスク
に複数のタイマが設定されている場合、システムは最初のタイマを TaskSpace の期限として使
用します。この期限は、システムによる TaskSpace の期限切れタスクの計算に使用されます。
TaskSpace の [管理] タブを使用して、タイマを変更する方法の詳細については、『Documentum
TaskSpace 設定ガイド』を参照してください。
ワークフローの開始時、事前タイマが設定されているすべてのアクティビティに対して事前タイ
マが作成されます。同時に、ワークフローの最初のアクティビティに対してタスクが作成されま
す。それが自動アクティビティである場合は、ワークフロー エージェントがそのタスクを直ちに処
理し、ワークフローを 2 番目のアクティビティに移動します。2 番目のアクティビティがトリガされ
ると、サーバによって事前タイマが非アクティブ化されます。
アクティビティの性質に応じて、有効期限の切れたタイマは次のいずれかのアクションを実
行します。
• [通知] — 通知メッセージを 1 人または複数の受信者に送信します。
• [プロセスの開始] — 現在のアクティビティのパッケージを使用して新しいワークフロー プロ
セスを開始します。
• [Java メソッドの実行] — 自動ワークフロー メソッドを実行します (スーパーユーザ権限を持つ
ユーザのみ使用可能)。
30
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
• [タスクの委任] — タスクを別の実行者に委任します。
• [タスクの完了] — 手動タスクを自動的に完了し、ワークフローを次のアクティビティに進めます。
最初の 2 つのアクションは、任意のアクティビティ タイマで利用できます。アクティビティの実行
者に、必要なスーパーユーザの権限があれば、どのタイマでもメソッドを起動できます。[タスク
の委任] アクションおよび [タスクの完了] アクションは、単一の作業項目を処理する手動アク
ティビティの、事後タイマのアクションとしてのみ使用できます。
タイマがタスクを完了した場合、ワークフローにあるいずれかのプロセス変数またはパッケージ
の属性の値をオプションで設定できます。アクティビティの移行条件はこの値についてテスト
することができ、パッケージまたはプロセス変数の属性に応じて、このフローを別の方法で
処理することができます。
1 つのアクティビティに複数のタイマを使用できます。また、最後のタイマ アクションは、アクティ
ビティが完了するまで、指定した時間間隔で繰り返し実行されるようにサーバに設定するこ
ともできます。
デフォルトでは、ユーザは、受信ボックス キューの項目の形式で警告通知を受信します。ただ
し、カスタム電子メール テンプレートを使用して電子メール通知を送信するようにタイマを設定
することもできます。
詳細については、「警告タイマを設定する (112ページ) 」を参照してください。
注 記 : タスクが中止または一時中断されている場合、事後タイマは停止されず、経過
時間のカウントを続行します。たとえば、ワークフロー タスクが停止された場合、関連
付けられた事後タイマは停止しません。事後タイマは、タスクが実行中であっても、タス
クに指定された時間を考慮し続けます。
警告タイマをチェックして要求されたアクションを実行するタスクは、dm_WfmsTimer ジョブによっ
て実行されます。dm_WfmsTimer ジョブは、Content Server と共にインストールされ、プロセス エン
ジンのインストール時にアクティブ化されます。
adm_WfmsTimer ジョブがアクティブになっているとき、デフォルト設定では 1 時間に 1 回実行され
ます。ジョブの実行頻度を変更するには、Documentum Administrator を使用します。また、システ
ムがタイマ処理に使用するスレッド数を変更することもできます。ジョブの設定変更の詳細、および
タイマ ジョブに使用される作業者スレッド数の変更については、『Documentum Administrator User
Guide (Documentum Administrator ユーザ ガイド)』を参照してください。
通知を設定する
Content Server には、特定のイベントを監視してイベント発生時に関連ユーザに通知する機能
があります。イベントとは Documentum オブジェクトに適用される固有のアクションのことです。
Process Builder のコンテキストにおいては、関連イベントとはワークフローに関連するアクションの
ことになります。たとえば、ユーザが作業項目の作業を開始したり、作業項目を他のユーザに
委任したりすることです。
プロセス テンプレートやアクティビティを設定するときに、電子メール メッセージのカスタム テンプ
レートを、いくつかの重要なワークフロー関連イベントに関連付けることができます。電子メール テ
ンプレートは、Documentum リポジトリ内に保存される特別な形式のドキュメントで、通知の電子
メール メッセージの件名と本文を定義します。テンプレートには、実行時にサーバによって値が置
き換えられる変数を含めることができます。配信されるメッセージには、現在の実行者や送られる
パッケージの名前といった、文脈に沿った情報が含まれます。イベントに電子メール テンプレート
が関連付けられていれば、イベントの通知を受信するように登録したユーザは、関連付けられた電
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
31
プロセス デザインを理解する
子メール テンプレートによって生成されたメッセージを受け取ることになります。カスタム電子メー
ル テンプレートを作成する詳細については、『Documentum Process Builder Development Guide
(Documentum Process Builder 開発ガイド)』を参照してください。
注 記 : サーバが通知メッセージを生成して送信するのは、ユーザがイベントの通知を受け
取るように登録している場合のみです。イベント通知の登録については、『Documentum
Content Server Fundamentals (Documentum Content Server の基本操作)』を参照してく
ださい。
通知オプションの設定方法については、「通知を設定する (122ページ) 」を参照してください。
アクティビティ移行を定義する
1 つのアクティビティに複数の出力フローがある場合、パッケージを後続のすべてのアクティビティ
に送信することも、アクティビティの結果に応じて後続のアクティビティの一部にのみ送信すること
もできます。たとえば、新しい形式のデザインをレビューする実行者が、そのデザインを次のレ
ビュー担当者に転送するか、改訂するためにそれを設計者に送り返すかを選択できるように指定
できます。この分岐ロジックを設定するには、このアクティビティから 2 つの可能性のある後続のア
クティビティへのフローを作成し、どのパスをたどるかを実行者が選択できるようにします。
アクティビティの移行タイプによって、そのアクティビティが完了したときに後続のアクティビティが
選択される方法が定義されます。移行には次の 3 つのタイプがあります。
• [すべての接続されたアクティビティを選択] - フローは、このアクティビティにリンクされている後
続のすべてのアクティビティ (順方向フローと拒絶フローの両方を含む) に進みます。
• [次のアクティビティを実行者に選択させる] - このアクティビティの実行者が、実行時にパッケー
ジを送信する後続のアクティビティを選択します。
• [条件に応じて実行者を選択] - パッケージまたはプロセス変数を受信するアクティビティ
は、アクティビティにあるプロセス データに基づく移行条件のセットを評価することによって
実行時に決定されます。
アクティビティがグループ アクティビティの場合、すなわち、実行者カテゴリが 4 (グループ内のすべ
てのユーザ) または 8 (グループに所属する複数のユーザ) の場合、サーバがすべてのアクティビ
ティが完了したものと判断して後続のアクティビティにパッケージを転送する前にタスクを完了する
必要があるグループ メンバーの数を指定します。たとえば、あるアクティビティの作業項目を 5 人の
ユーザが受け取る場合は、そのうちの 3 人がタスクを終了したときにアクティビティが完了するように
指定できます。あるいは、5 人のユーザすべてにタスクを完了させるように指定することもできます。
実行者に次のアクティビティを選択させる場合は、実行者が選択できる後続のアクティビティ
の数を制限できます。たとえば、アクティビティに 3 つの出力フローがある場合は、実行者にそ
の 3 つのフローすべてにパッケージを送信させることも、3 つのうちの 1 つまたは 2 つだけを
選択させることもできます。
実行者のグループに次のアクティビティを選択させる場合、すなわち実行者のカテゴリが 4 または
8 で移行オプションが [次のアクティビティを実行者に選択させる] である場合は、実行者が選択し
たアクティビティを組み合わせる方法もサーバに指定する必要があります。グループにアクティビ
ティを選択させると、転送するアクティビティを選択する実行者と、却下するアクティビティを選
択する実行者が出てくる可能性があります。このような場合、ワークフロー エンジンはどのアク
ティビティを開始するべきか、つまり、選択されたすべてのアクティビティか、却下するアクティ
ビティのみか、あるいは転送するアクティビティのみかを、指定する必要があります。また、い
32
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス デザインを理解する
ずれかの実行者が却下するアクティビティまたは転送するアクティビティを選択した場合に、即
座にアクティビティを完了するように指定することもできます。
条件による移行タイプを選択した場合、そのアクティビティに対して少なくとも 1 つの移行条件を
定義する必要があります。
移行条件を決定する
移行条件を利用すると、アクティビティの結果に応じてタスクの送信先を変更するアクティビティを
定義できます。移行条件は論理条件であり、関連付けられた 1 つ以上のフローです。実行時に
アクティビティが完了すると、サーバはアクティビティの移行条件を評価して、ワークフロー内
で次のステップとして開始する後続アクティビティを判別します。ワークフローは、TRUE である
最初の移行条件に関連付けられたアクティビティに進められます。1 つのアクティビティに複数
の移行条件を設定できますが、実行時にサーバによって選択されるのは常に 1 つのみ、つま
り最初に真と評価された移行条件のみです
移行条件は、ブール式でなければなりません。一般に、移行条件を使用してパッケージのコン
ポーネント、その条件が属するワークフロー、または最後に完了した作業項目の属性を調べます。
ワークフロー パッケージが XML ドキュメントの場合、XML ドキュメントに含まれる要素の値を
チェックするような移行条件を作成できます。
移行条件を使用する場合は、必ず Else オプションを組み込んでください。Else オプションは、どの
移行条件にも該当しないときにサーバによって実行されるアクションです。Else オプションには条
件は関連付けられません。1 つのアクティビティに指定できる Else ケースは 1 つだけです。
アクティビティの移行条件の定義については、「アクティビティ移行規則を設定する (118ペー
ジ) 」を参照してください。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
33
第2章
Process Builder を 使 用 す る
この章では、 次のトピックについて説明します。
•
Process Builder の 設 計 環 境
•
Process Builder の ツ ー ル バ ー を 設 定 す る
•
プロセス テンプレート プレファレンスを設定する
•
プ ロ セ ス テ ン プ レ ー ト を Process Analyzer と 共 有 す る
•
Process Analyzer か ら プ ロ セ ス を 取 得 す る
•
プロセスを共有するフォルダの場所を設定する
•
BAM 内 の 構 造 化 デ ー タ タ イ プ を 更 新 す る
•
BAM 内 の パ ッ ケ ー ジ オ ブ ジ ェ ク ト タ イ プ を 更 新 す る
•
アク テ ィ ビ テ ィ テ ン プ レ ー ト ] ウ ィ ン ド ウ
[ア
•
構造 化 デ ー タ タ イ プ ] ウ ィ ン ド ウ
[構
•
プロセス テンプレート エディタ ペイン
•
プロ セ ス 検 証 ] タ ブ を 使 用 す る
[プ
•
プロセス テンプレート ナビゲータを使用する
Process Builder の 設 計 環 境
Process Builder は、ビジネス プロセスのレイアウトと定義を行うためのグラフィック ツールです。
Process Builder のウィンドウは、2 つの主要なペインに分かれています。
• 左のペインは、プロセス テンプレートに追加できるアクティビティ テンプレート (41ページ) と構
造化データ タイプ (42ページ) を表示する [リソース ナビゲータ] サブシステムです。
• 右のペインはプロセス テンプレート エディタ (46ページ) と呼ばれ、作成したプロセス テンプ
レートがグラフィック表示されます。
2 つのペインのサイズは、その間の境界にカーソルを置いてドラッグすることにより、制御できます。
2 つのペイン間の上部には 1 組の矢印が表示されます。ペインのいずれかを拡大してウィンドウ全
体で表示するには、拡大するペインから離れる向きの矢印をクリックします。Process Builder を 2
つのペイン表示に戻すには、拡大後にウィンドウの端に表示される逆向きの矢印をクリックしま
す。また、プロセス テンプレート エディタでは、同じリポジトリから複数のプロセスを開き、それ
らのプロセスを表示および比較できます。このトピックの詳細については、「タブを使用して複
数のプロセスを表示する (51ページ) 」を参照してください。
[リソース ナビゲータ] では、各サブウィンドウの名前を表示するタイトル バー ボタンをクリックする
と、そのウィンドウを最小化および最大化できます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
35
Process Builder を使用する
設定可能なツールバー がウィンドウ上部に表示され、一般的なコマンドを素早く実行できます。
ワークフローが大きすぎて画面に表示できない場合は、ナビゲータ を使用することにより、完全な
プロセス テンプレートを参照してどの部分を表示するかを指定できます。
次の図は、Process Builder の設計環境を示しています。
図4
Process Builder
Process Builder の ツ ー ル バ ー を 設 定 す る
[表示] メニューのオプションを使用することで、ツールバーに表示するアイコンを制御します。
Process Builder には、次の 3 つのツールバー アイコンのコレクションがあります。
• 標準ツールバー アイコンでは、[ファイル] および [編集] メニューのコマンドを実行できます。
• ワークフロー ツールバー アイコンでは、アクティビティやフローを作成し、ワークフロー オブジェ
クトのプロパティを表示できます。
• 表示ツールバー アイコンでは、プロセス テンプレート エディタ ペインを拡大または縮小
表示できます。
デフォルトでは、ツールバーには 3 つのアイコン コレクションがすべて表示されています。
Process Builder の ツ ー ル バ ー で 表 示 す る ア イ コ ン を 選 択 す る に は
1. [表示] メニューの [ツールバー] をクリックします。
サブメニューには、利用可能なツールバー アイコンの各グループ名が表示されます。
現在ツールバーに表示されているグループには、その名前の横にチェック マーク
が付いています。
2. ツールバーに追加または削除するグループを選択します。
チェックの付いていないオプションを選択すると、そのアイコン グループがツールバー
に追加されます。チェックの付いたグループを選択すると、そのチェック マークが消
え、ツールバーからのそのアイコン グループが削除されます。
36
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
Process Builder を 使 用 す る
プロセス テンプレート プレファレンスを設定する
[プレファレンス] メニューには、次のことを実行できるオプションがあります。
•
•
•
•
•
Documentum Process Analyzer とのプロセス テンプレートの共有
インバウンド アクティビティのデバッグ時にシステムが使用するポート番号の設定
アクティビティ テンプレート フォルダの管理
プロセス テンプレート プリファレンスの設定
BAM データベースのプロセス データの更新
Process Analyzer が プ ロ セ ス テ ン プ レ ー ト に ア ク セ ス で き
るようにする
Process Analyzer または Process Builder のいずれかでビジネス プロセスをいったん定義または
変更すると、共有フォルダに保存される XML ファイル (XPDL 形式) としてそのプロセスを
もう一方のアプリケーションと共有できます。どちらのアプリケーションからでも、共有フォルダ
にあるその XML ファイルにアクセスし、開き、そのプロセスについて作業を開始できます。共
有フォルダの設定に関する詳細については、「プロセスを共有するフォルダの場所を設定する
(38ページ) 」を参照してください。
注 記 : プロセスの共有は、Process Analyzer と Process Builder の両方が同じマシンにイ
ンストールされている場合に有効となります。これらのアプリケーションが同じマシンに
インストールされていない場合にプロセスを共有するには、インポートおよびエクス
ポートのオプションを使用します。これらのオプションの詳細については、「プロセス テ
ンプレートをインポートする (75ページ) 」および「プロセス テンプレートをエクスポート
する (76ページ) 」を参照してください。
Process Analyzer で作成または変更されたプロセスを Process Builder で開くには、[Analyst からの
プロセスの取得] を使用します。Process Builder のプロセスを Process Analyzer を使用するアナリス
トが使用できるようにするには、[Analyst によるプロセスの共有] を使用します。
プロセスの共有時に自動および手動アクティビティ タイプは維持されますが、メソッドやタイマな
どの定義は Process Builder で開発者が追加する必要があります。パッケージは共有プロセス
には含まれません。
また、複数の終了アクティビティが含まれているプロセスを Process Analyzer から共有すると、
Process Builder によってすべての終了アクティビティに接続される空のアクティビティが追加さ
れます。これは、Process Analyzer からエクスポートされたプロセスに複数の終了アクティビティ
が含まれている場合があるのに対して、Process Builder でサポートされる終了アクティビティは
1 つだけであるためです。
プ ロ セ ス テ ン プ レ ー ト を Process Analyzer と 共 有 す る
プ ロ セ ス テ ン プ レ ー ト を Process Analyzer と 共 有 す る に は
1. [ファイル] メニューの [Analyst によるプロセスの共有] をクリックします。
システムにより、Process Builder の共有フォルダに XPDL ファイルが配置され、この
フォルダを通じて Process Analyzer からプロセス テンプレートにアクセスできます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
37
Process Builder を使用する
2. [OK] をクリックします。
Process Analyzer か ら プ ロ セ ス を 取 得 す る
Process Analyzer か ら プ ロ セ ス を 取 得 す る に は
1. [ファイル] メニューの [Analyst からのプロセスの取得] をクリックします。
[Analyst からのプロセスの取得] ダイアログ ボックスが開き、Process Analyzer の共
有フォルダにあるすべてのファイルが表示されます。
2. 開く XPDL ファイルを選択します。
3. [OK] をクリックします。
Process Builder によって、Process Analyzer プロセスを基に新しいドラフト プロセス テンプレー
トが作成されます。
アクティビティのレイアウト ロケーション情報が使用可能な場合は、共有プロセス テンプレート
に適用されます。使用できない場合は、デフォルトのレイアウトおよびグラフィック ディスプレイ
設定が使用されます。グラフィックスやイメージなどのユーザ インターフェイス情報は共有プロ
セスに含まれないため、Process Builder で作成し直す必要があります。
次に、アクティビティ インスペクタを使用してプロセスの実行情報を定義する必要があります。
アクティビティの実行の詳細を定義する方法については、「アクティビティ テンプレートを操
作する (89ページ) 」を参照してください。
プロセスを共有するフォルダの場所を設定する
Process Builder と Process Analyzer の間でプロセスを共有する場合、そのプロセスが保存される
フォルダの場所をいずれかのアプリケーションから設定できます。
プロセスを共有するフォルダの場所を設定するには
1. [ファイル] メニューの [プレファレンス] をクリックします。
[プレファレンス] ダイアログ ボックスが表示されます。
2. Process Analyzer の共有フォルダの場所を設定するには、[選択] をクリックします。
[開く] ダイアログ ボックスが表示されます。
3. Documentum がインストールされているディレクトリに移動し、Process Analyzer の XPDL ファイ
ルを保存するフォルダ (たとえば PA_Shared) を作成します。
通常、このフォルダは C:\Documentum です。
4. [OK] をクリックします。
5. Process Builder の XPDL ファイルの共有フォルダを設定するために、手順 2 ～ 4 を繰り
返します。
受信アクティビティをデバッグするためのポート番号を設
定する
プロセス デバッガで受信アクティビティをデバッグできるようにするには、[プレファレンス] ダイアロ
グ ボックスでポート番号を指定する必要があります。
38
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
Process Builder を 使 用 す る
受信ポート番号を設定するには
1. [ファイル] メニューの [プレファレンス] をクリックします。
[プレファレンス] ダイアログ ボックスが表示されます。
2. [HTTP/Web サービス受信ポート番号] ダイアログ ボックスで、デバッガが受信アクティビティの
デバッグに使用するポート番号を選択します。
アクティビティ テンプレート フォルダを管理する
Process Builder の [プレファレンス] ダイアログ ボックスを使用して、どのテンプレート フォルダを表
示するかを制御できます。設定したプレファレンスは、現在のユーザ ID にのみ適用されます。
ユーザごとに異なるプレファレンスを設定することができます。[アクティビティ テンプレート] ウィン
ドウに表示されるアクティビティ テンプレート フォルダの制御については、「フォルダ内のアクティ
ビティ テンプレートを管理する (90ページ) 」を参照してください。
Process Analyzer と Process Builder の両方が同じマシンにインストールされている場合、[プレファ
レンス] ダイアログ ボックスで、プロセスを共有するフォルダの場所を設定することもできます。共有
するフォルダの場所の設定の詳細については、「プロセス テンプレートを Process Analyzer と
共有する (37ページ) 」を参照してください。
アクティビティ テンプレート] ウィンドウに新しいアクティビティ テンプレート フォルダを追加するには
[ア
1. [ファイル] メニューの [プレファレンス] を選択します。
[プレファレンス] ダイアログ ボックスが表示されます。左側のリスト ボックスには使用可能な
フォルダが表示されます。右側のリスト ボックスには Process Builder に現在表示されている
フォルダが表示されます。
注 記 : プレファレンスは、ユーザ別に保存されます。別のユーザとしてログインした場
合、フォルダのリストが異なることがあります。
2. 使用可能なフォルダのリストに新しいフォルダを追加するには、[新規作成] をクリックして、表
示されたダイアログ ボックスにフォルダの名前を入力します。
ダイアログ ボックスで [OK] をクリックすると、新しいフォルダが右側のリスト ボックスに表示さ
れます。
3. [プレファレンス] ダイアログ ボックスで [OK] をクリックし、右側のリスト ボックスのフォルダを [ア
クティビティ テンプレート] ウィンドウに追加します。
アク テ ィ ビ テ ィ テ ン プ レ ー ト ] ウ ィ ン ド ウ か ら フ ォ ル ダ を 削 除 す る に は
[ア
1. [ファイル] メニューの [プレファレンス] を選択します。
[プレファレンス] ダイアログ ボックスが表示されます。左側のリスト ボックスには使用可能な
フォルダが表示されます。右側のリスト ボックスには Process Builder に現在表示されている
フォルダが表示されます。
注 記 : プレファレンスは、ユーザ別に保存されます。別のユーザとしてログインした場
合、フォルダのリストが異なることがあります。
2. [アクティビティ テンプレート] ウィンドウからフォルダを削除するには、右側のリスト ボックスで名
前を強調表示させて、[削除] をクリックします。
名前が左側のリスト ボックスに移動し、[アクティビティ テンプレート] ウィンドウから削除されます。
3. [OK] をクリックします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
39
Process Builder を使用する
プロセス テンプレート メッセージ プレファレンスを設定する
システムが、テンプレートの保存後にテンプレートの検証またはインストールを行うプロンプトを表
示するタイミングを指定できます。
プロセス テンプレート プレファレンスを設定するには
1. [ファイル] メニューの [プレファレンス] を選択します。
[プレファレンス] ダイアログ ボックスが表示されます。
注 記 : プレファレンスは、ユーザ別に保存されます。
2. Process Builder でテンプレートを保存するときに、テンプレートを検証するかインストールする
かを決めるメッセージの表示を指定します。
プロセス テンプレートを使用して実行中のワークフローを作成するには、テンプレート
を検証してインストールする必要があります。[保存後、検証とインストールのプロンプト
を必ず表示] チェックボックスをオンにすると、テンプレートを保存するときにメッセージ
が表示され、テンプレートを検証してインストールするかどうかをたずねられます。こ
のチェックボックスをオンにしていないと、メッセージは表示されません。テンプレー
トとそのアクティビティを明示的に検証してインストールすることにより、そのテンプ
レートを使用したワークフローの作成が可能になります。
3. メッセージの表示を再開するには、[リセットして、警告メッセージを表示します] をオンにします。
4. [OK] をクリックします。
BAM デ ー タ ベ ー ス の プ ロ セ ス デ ー タ を 更 新 す る
BAM データ定義の更新ページを使用すると、Process Builder から選択したプロセス データと
BAM データベースの既存のレポート データを更新することができます。この機能により、Process
Builder 内のデータの構造と、BAM 内の構造の間の一貫性が確保されます。このオプションを
使用すると、BAM データ定義の更新ページで選択した BAM ビジネス データとプロセス デー
タが更新されます。
データ定義の更新が必要なのは、データ定義が最初に使用される場合、またはデータ定義に変
更があった場合だけです。たとえば、構造化データを変更して新しいレポート可能属性を追加す
るかレポート可能属性の名前を変更する場合は、BAM でこの新しい定義を更新する必要がありま
す。 また、パッケージで使用する新しいオブジェクト タイプを作成する場合は、BAM データベー
スでこれらのパッケージ タイプ定義を更新する必要があります。
更新が実行されるようにするには、Content Server に BAM をインストールし、正しく設定す
る必要があります。
BAM 内 の 構 造 化 デ ー タ タ イ プ を 更 新 す る
構造化データ タイプを更新するには、次の手順に従います。
1. [ツール] > [BAM データ定義の更新] を選択します。
2. 次のいずれかの手順を実行します。
• 構造化データ タイプのリストから、BAM データベース内で更新するタイプを選択します。
リスト ボックスには、まだ更新されていない構造化データ タイプのみが表示されます。
40
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
Process Builder を 使 用 す る
• テキスト ボックスに表示されているすべての構造化データ タイプを更新する場合は、
[すべて選択] をクリックします。
3. [更新] をクリックします。
BAM 内 の パ ッ ケ ー ジ オ ブ ジ ェ ク ト タ イ プ を 更 新 す る
パッケージに含まれるオブジェクト タイプを更新するには、次の手順に従います。
1. BAM データベースでパッケージ内で使用されるオブジェクト タイプを更新するには、[オブ
ジェクト タイプ] グループ ボックスの [更新] をクリックします。
2. [閉じる] をクリックします。
ア ク テ ィ ビ テ ィ テ ン プ レ ー ト] ウ ィ ン ド ウ
[ア
Process Builder 画面の左側にある [アクティビティ テンプレート] ウィンドウには、プロセス テンプ
レートに追加できる事前定義されたアクティビティ テンプレートが表示されます。アクティビティ テ
ンプレートは、アクティビティ テンプレート フォルダによって関連グループに編成されます。たとえ
ば、フォルダの名前でアクティビティの一般的なカテゴリ (承認や統合など) を表すことができます。
各アクティビティ テンプレートは特定のタイプのアクティビティを表しており、そのアクティビティ
のタイプに固有で特別なプロパティを含んでいることがあります。たとえば、外部パートナーへ
の電子メールの送信用のアクティビティ テンプレートには、電子メール アドレスのプロパティが
含まれます。アクティビティ テンプレートの詳細については、「アクティビティ テンプレートを
操作する (89ページ) 」を参照してください。
Process Builder の [プレファレンス] ダイアログ ボックスを使用して、どのテンプレート フォルダを表
示するかを制御できます。ウィンドウに表示するフォルダの設定の詳細については、「アクティビ
ティ テンプレート フォルダを管理する (39ページ) 」を参照してください。
各アクティビティ テンプレート フォルダは、Documentum リポジトリ内のシステム フォルダ
に対応しています。アクティビティ テンプレート フォルダの名前は、システム フォルダ
(System/Workflow/Activity Templates) 内に存在しているフォルダの名前と同じです。このフォルダ
には、アクティビティ テンプレート フォルダのアクティビティ テンプレートに対応する dm_activity
オブジェクトが格納されています。
プロセス テンプレートにアクティビティを追加するには、該当するアクティビティ テンプレートを [ア
クティビティ テンプレート] ウィンドウからプロセス テンプレート エディタ内の目的の場所にドラッグ
アンド ドロップし、そのアクティビティのプロパティを設定します。アクティビティ テンプレートのプロ
パティを表示または編集するには、アクティビティ テンプレート フォルダ内にある該当アイコンをダ
ブルクリックします。アクティビティおよびアクティビティ テンプレートのプロパティを設定する詳細
については、「アクティビティ テンプレートを操作する (89ページ) 」を参照してください。
ショートカット メニューでも、ツールバーの [ファイル] メニューにある機能 (新しいフォルダやアク
ティビティ テンプレートの作成、保存、削除など) の多くを実行できます。
アクティビティ テンプレートは、下書き、検証済み、インストール済みのいずれかの状態でウィ
ンドウに表示されます。それぞれの状態はアイコンで表されます。プロセス テンプレートに追
加できるのは、インストール済みのアクティビティ テンプレートのみです。[アクティビティ テン
プレート] ウィンドウ内のアクティビティ テンプレートは、ショートカット メニューから検証、インス
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
41
Process Builder を使用する
トール、およびアンインストールすることができます。このトピックの詳細については、「アクティビ
ティ テンプレートを検証する (93ページ) 」を参照してください。
表3
アクティビティ テンプレートの状態と関連アイコン
状態
アイコン
下書き
検証済み
インストール済み
構造 化 デ ー タ タ イ プ ] ウ ィ ン ド ウ
[構
[構造化データ タイプ] ウィンドウには、リポジトリで定義されているすべての構造化データ タイプが
表示されます。構造化データ タイプは、現在の業務での使用方法に基づいて定義するカテゴリ
内に編成された階層構造で表示されます。
このウィンドウでは、構造化データ タイプ ウィザードを使用して、構造化データ タイプの追加
および削除、カテゴリの作成または削除、および構造化データ タイプの詳細の表示を行うこと
ができます。また、このウィンドウでウィザードを起動して、XML スキーマから構造化データ
タイプを作成することもできます。
構造化データ タイプ カテゴリを作成する
プロセス データは、現在の業務の編成方法に基づくデータの階層カテゴリに編成でき
ます。構造化データ タイプから編成される属性およびグループが、これらのカテゴリ内
でネストされます。
構造化データ タイプのリストにカテゴリを追加するには
1. [構造化データ タイプ] ウィンドウ内で右クリックして、[カテゴリの追加] を選択します。
[構成データ タイプの追加ウィザード] で [カテゴリの変更] を選択してもカテゴリを追加できます。
[カテゴリの選択] ダイアログ ボックスに、ツリー階層と使用可能なノードが表示されます。
2. 追加するカテゴリの名前を入力します。
3. 新しいカテゴリの追加先のツリー内のノードまたはカテゴリを反転表示し、新しいカテゴ
リの名前を入力します。
4.
をクリックして新しいカテゴリを追加します。
5. [OK] をクリックします。
構造化データ タイプ カテゴリを削除する
カテゴリを削除するには
1. [構造化データ タイプ] ウィンドウ内で、削除するカテゴリを強調表示します。
42
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
Process Builder を 使 用 す る
2. [構造化データ タイプ] ウィンドウ内で右クリックして、[カテゴリの削除] を選択します。
注 記 : カテゴリ内に構造化データ タイプが存在する場合、そのカテゴリは削除され
ません。
構造化データ タイプ グループを作成する
構造化データ タイプ内でグループを作成するには
1. [グループの追加]アイコン をクリックします。
2. グループの名前を入力します。
注 記 : グループの [名前] フィールドでは、1 バイト文字のみ使用できます。
構造 化 デ ー タ タ イ プ ] ウ ィ ン ド ウ を 更 新 す る
[構
構造 化 デ ー タ タ イ プ ] ウ ィ ン ド ウ の 内 容 を 更 新 す る に は
[構
1. ウィンドウ内で右クリックします。
2. [更新] を選択します。
ウィンドウが更新され、新しい構造化データ タイプがリポジトリ内で使用できるよう
になります。
構造化データ タイプを作成する
構造化データ タイプは、現在のプロセス フローに関連するビジネス データを表す 1 つの方法で
あり、通常は、名前、タイプ、デフォルト値の各データ要素から構成されます。
構造化データ タイプには、単純データ タイプと複合データ タイプの 2 種類があります。単純
データ タイプは、文字列値やブール型値などの単一の属性です。複合データ タイプは、いくつ
かの属性から構成されます。たとえば、支出予算要求の要素は、属性として submitter_name、
submitter_address、equipment_type を持つ要求グループに編成できます。また、各構造化データ
タイプ内で、属性をいくつかの関連グループに編成し、そのデータ タイプの構造を視覚的に確認
できるようにすることができます。たとえば、顧客構造化データ タイプ内で、市および州の属性
が含まれる住所グループを編成できます。
注 記 : 構造化データ タイプを作成するには、「タイプの作成」ユーザ権限を持ってい
る必要があります。
構造化データ タイプを作成するには
1. Process Builder で、[ファイル] > [新規作成] > [構造化データ タイプ] を選択します。
または、ツールバーにある新しい構造化データ タイプの作成アイコン をクリックする
か、[構造化データ タイプ] ウィンドウ内で右クリックして表示されるメニューから [構造
化データ タイプの追加] を選択します。
[構造化データ タイプの追加ウィザード] ダイアログ ボックスが表示されます。
2. カテゴリを変更する、または新しいカテゴリを作成するには、[カテゴリの変更] をクリックし、選
択したノードに新しいカテゴリを追加します。カテゴリの詳細な作成手順については、構造化
データ タイプ カテゴリを作成する (42ページ) を参照してください。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
43
Process Builder を使用する
3. 構造化データ タイプの [名前] を入力します。
名前は 70 文字未満で、1 バイト文字を使用する必要があります。いったん保存した名前を編
集することはできません。
名前を変更するためには、構造化データ タイプが使用されていないことを確認して削除し、
新しい名前で作成し直す必要があります。
4. 構造化データ タイプの [表示名] を入力します。
[表示名] フィールドのテキストが [構造化データ タイプ] ウィンドウのツリー表示に表
示されます。
注 記 : 表示名は 70 文字未満である必要があります。[表示名] フィールドでは 2 バイト
文字がサポートされます。
5. [グループの追加] アイコン
を選択してグループ名を入力することで、属性のグルー
プを作成できます。
構造化データ タイプの作成中の任意の時点でグループを作成できます。
グループの [名前] フィールドでは、1 バイト文字のみ使用できます。
6. この追加アイコン
をクリックすると、構造化データ タイプに属性が追加されます。
属性を削除する場合は、削除アイコン
をクリックします。
7. 属性の [名前] を入力します。
名前は 70 文字未満で、1 バイト文字を使用する必要があります。
8. 属性の [表示名] を入力します。
[表示名] フィールドのテキストが [構造化データ タイプ] ウィンドウのツリー表示に表示されます。
注 記 : 表示名は 70 文字未満である必要があります。[表示名] フィールドでは 2 バイト
文字がサポートされます。
9. 必要に応じて、属性の説明を入力します。
10. 属性のデータ タイプを選択します。
有効値は文字列、整数、浮動小数、日付、ブールです。
a. 定義しているデータ タイプに基づき、必要に応じてデフォルト値を入力します。
注 記 : 相関セットで使用されるプロセス変数には、デフォルトの値を設定しないでく
ださい。デフォルト値が設定されたプロセス変数は、プロセスの 1 つのインスタンス
に入力メッセージを一致させるために必要な一意の属性特性を持ちません。メッ
セージ相関を理解する (144ページ) 相関セットを使用してメッセージ コンテンツを
プロセス データにマップする詳細については、「」を参照してください。
b. 文字列値の場合、値の最大の長さ を入力します。
フィールドのデフォルト値は 256 文字です。
Process Builder では、データベースで当該タイプのフィールドに適用される制限に応じて、
最大 4000 バイトの文字列値を使用できます。
注 記 : DB2 データベースの制限により、DB2 のみを実行する BAM データベースでは、
256 文字を超える構造化データ タイプ属性は切り捨てられます。
11. 必要に応じて、属性のその他のオプションを定義します。
44
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
Process Builder を 使 用 す る
• 繰り返し属性を有効にする場合、[繰り返し可能] を選択します。
• BAM で属性のインデックスを作成できるようにするには、[検索可能] を選択します。
• このタイプを BAM データベースに公開して BAM レポートで使用するには、[レポート可
能] を選択します。
12. BAM でデータ タイプの定義を更新するには、[この SDT 定義に基づいて BAM データベー
スのテーブルを更新する] を選択します。
これにより、新しいデータ タイプが BAM データベースに送信され、レポートに使用される
テーブルに追加されます。
構造化データ タイプの詳細を表示する
構造化データ タイプの詳細を表示するには
1. [構造化データ タイプ] ウィンドウでデータ タイプを右クリックします。
2. メニューから [詳細を表示] を選択するか、構造化データ タイプをダブルクリックします。
[構造化データ タイプ] ダイアログ ボックスが開き、構造化データ タイプの詳細が表
示されます。
構造化データ タイプを編集する
構造化データ タイプを作成したら、その構造化データ タイプがプロセスで使用される前に、属性
のプロパティを変更したり、属性およびグループを追加することができます。構造化データ タイプ
がプロセスで使用された後は、プロセスの現在実行されているインスタンスの整合性を保つた
め、変更できるデータは最小限になります。
プロセスで使用される構造化データ タイプでは、ダイアログ ボックスの右上端に [使用中...] という
テキストが表示されます。このテキストをクリックすると、[プロセス リスト] ダイアログ ボックスが開き、
構造化データ タイプを現在参照しているプロセスが表示されます。
使用中の場合、属性を変更または削除することはできません。構造化データ タイプの表示名およ
び説明は変更できます。グループまたは属性を追加することもできます。
注 記 : BAM レポートで使用されている構造化データ タイプを編集する場合は、このペー
ジにある、新しい定義を BAM データベースで更新するオプションを選択してください。
使用中の構造化データ タイプの属性を変更するには
1. 該当のデータ タイプを使用している各プロセスを開きます。
2. プロセスをアンインストールします。
3. プロセス変数から該当のデータ タイプを削除します。
4. 構造化データ タイプを編集します。
注 記 : 新しい属性を追加して変更内容を保存すると、それ以降その属性は変更
できなくなります。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
45
Process Builder を使用する
XML ス キ ー マ か ら 複 雑 な 構 造 化 デ ー タ タ イ プ を 作 成 す る
XML スキーマ (.XSD ファイル) を検索および取得し、構造化データ タイプ オブジェクトとして
リポジトリにインポートすると、外部アプリケーションや現在の業務の別の場所にあるデータを
使用できるようになります。
注 記 : 使用しているスキーマに多くの要素が含まれる場合、1 回につき 1 つの要素をイン
ポートすることが推奨されます。
XML ス キ ー マ か ら 構 造 化 デ ー タ タ イ プ を 作 成 す る に は
1. [構造化データ タイプ] ウィンドウ内で右クリックして表示されるメニューから [XML スキーマか
らの構造化データ タイプの作成] を選択します。
[XML スキーマからの SDT の作成] ダイアログ ボックスが表示され、構造化データ タイ
プの追加先カテゴリが表示されます。
2. カテゴリを変更する、または新しいカテゴリを作成するには、[カテゴリの変更] をクリックし、選
択したノードに新しいカテゴリを追加します。
3. 次に示す方法で、使用する XML スキーマ ファイルを選択します。
をクリックして、ローカル ファイル システムからスキーマを選択します。
•
をクリックして、現在のリポジトリからスキーマを選択し、インポート対象のス
キーマに移動します。
• URL を入力し、 をクリックして、Web サイトからスキーマ名またはコンテンツを
取得します。
•
4. インポートするデータのタイプを選択します。
• [複合タイプ]: ネストした属性を含むすべての複合データ タイプを表示します。
• [要素タイプ]: このデータ タイプに関連する属性、コンテナ オブジェクト、および階層
情報を表示します。
5. リスト ボックスから、構造化データ タイプとして使用するデータ タイプを選択します。
データ タイプの関連情報が、[構造化データ タイプ] グループ ボックスに表示されます。
6. [表示名]、[説明] など、属性のより一般的なフィールドを編集できます。
7. 必要に応じて、属性のその他のオプションを定義します。
• 繰り返し属性を有効にする場合、[繰り返し可能] を選択します。
• BAM で属性のインデックスを作成できるようにするには、[検索可能] を選択します。
• BAM レポートの作成時にこのタイプを公開する場合、[レポート可能] を選択します。
8. [適用] をクリックして、インポートした構造化データ タイプを [構造化データ タイプ] ウィン
ドウに追加します。
プロセス テンプレート エディタ ペイン
プロセス テンプレート エディタ ペインは、ビジネス プロセス フローの設計を行う領域です。ビジネ
ス プロセスを定義するには、事前定義されたアクティビティ テンプレートをアクティビティ テンプ
レート フォルダからプロセス テンプレート エディタにドラッグするか、新しい手動アクティビティまた
は自動アクティビティを作成し、フローと接続して、アクティビティおよびフローのプロパティを定義
46
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
Process Builder を 使 用 す る
します。詳細については、「プロセス テンプレートを作成する (54ページ) 」を参照してください。テ
ンプレートのラベル エリアにはテキスト メモを追加する (49ページ) こともできます。
ビジネス プロセスの視覚的レイアウトを制御する手順は、他のグラフィック レイアウト ソフトウェ
アと同様です。
• プロセス テンプレートにオブジェクトを追加するには、アクティビティ テンプレート フォルダから
アクティビティをドラッグし、プロセス テンプレート エディタ ペインにドロップします。オブジェクト
は、マウス ボタンを離した場所にあるテンプレートに追加されます。ツールバーにも、(空の)
アクティビティやフローを追加するためのボタンがあります。
• プロセス テンプレート内でオブジェクトを移動するには、オブジェクトを選択して新しい場所にド
ラッグします。他のアクティビティに接続しているフローを持つアクティビティを移動する場合、フ
ローを示す矢印はアクティビティと共に移動します。フロー自体をそれだけでは移動できません。
• プロセス テンプレートからオブジェクトを削除するには、オブジェクトを選択してからツール
バーの選択されたオブジェクトの削除アイコン をクリックするか、[編集] メニューの [削
除] を選択します。
• アクティビティをコピーするには、アクティビティを選択してからツールバーのコピー アイコン
をクリックするか、[編集] メニューの [コピー] を選択します。テンプレートに新しいコピー
を追加するには、ツールバーの貼り付けアイコン
をクリックするか、[編集] メニューの
[貼り付け] を選択します。
• 特定のオブジェクトで実行できるアクションを知るには、オブジェクトを選択して右クリックします。
マウス カーソルを置いた場所にコンテキスト メニューで実行可能アクションが表示されます。
プロセス テンプレート オブジェクトを選択する
プロセス テンプレート エディタ ペインで 1 つまたは複数のオブジェクトを選択するには
1. ツールバーのオブジェクト選択アイコン
を選択するか、エディタ ページで右クリックする
か、または Esc キーを押して、選択モードに切り替えます。
2. プロセス テンプレート エディタ ペイン内のオブジェクトのグラフィック表示をクリックするか、
または何も表示されていない領域でクリックし、マウスをドラッグしてオブジェクトの周囲
に四角形を描画します。
選択したオブジェクトの周囲にブラック ボックスが表示されます。そのオブジェクトをもう
1 回クリックすると、選択が解除され、ブラック ボックスが消えます。
3. 複数のオブジェクトを追加するには、Shift キーを押しながら各オブジェクトをクリックします。
注 記 : Shift キーを押さずにオブジェクトを選択すると、それ以前に選択したオブジェクトは
自動的にクリアされます。
4. テンプレートのすべてのオブジェクトを選択するには、[編集] メニューの [すべて選択]
を選択します。
アクティビティを配置する
配置オプションでは、ワークフロー アクティビティを正確に配置できます。左端または右端、上端ま
たは下端、または中心に揃えて、垂直方向または水平方向にアクティビティを配置できます。
アクティビティを配置するには
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
47
Process Builder を使用する
1. 配置するアクティビティを選択します。
配置オプションを使用するには、2 つ以上のアクティビティを選択する必要があります。アク
ティビティの選択方法については、「プロセス テンプレート エディタ ペイン (46ページ) 」を
参照してください。
2. [表示] メニューの [配置] を選択して、サブメニューから適切な配置を選択します。
使用できる配置オプションは次のとおりです。
• [左] — 選択したオブジェクトの左端を揃えます。
• [垂直位置] — 選択したオブジェクトの中心を垂直方向に揃えます。
• [右] — 選択したオブジェクトの右端を揃えます。
• [上] — 選択したオブジェクトの上端を揃えます。
• [水平位置] — 選択したオブジェクトの中心を水平方向に揃えます。
• [下] — 選択したオブジェクトの下端を揃えます。
アクティビティの上端に揃えて配置するように選択した場合、一番上のアクティビティを基準に
他のアクティビティの配置が決まります。つまり、選択されたアクティビティは、一番上のアク
ティビティに合わせて配置されます。同様に、アクティビティの下端に揃えて配置するように選
択した場合、一番下のアクティビティを基準に他のアクティビティの配置が決まります。左端揃
えまたは右端揃えを選択した場合は、左端または右端のアクティビティが基準になります。
アクティビティを置き換える
アクティビティ テンプレート フォルダから新しいアクティビティ テンプレートをドラッグして既存のア
クティビティの上にドロップすると、プロセス テンプレート内のアクティビティを別のアクティビティ
テンプレートに置き換えることができます。
たとえば、プロセス開発者は Process Analyzer プロセスを Process Builder にインポートした後に、イ
ンポートした一般的なアクティビティを既存のアクティビティ テンプレートに置き換える必要がある
場合があります。この場合、新しいアクティビティをプロセス内の適切な場所にドラッグしてドロッ
プするだけで、元のアクティビティが削除され、新しいアクティビティに置き換えられます。この
方法でアクティビティを置き換えた場合、アクティビティ間のリンクは保持されますが、タイマ、
移行、マッピング規則などの設定情報は保持されません。[アクティビティ インスペクタ] を使用
してアクティビティを設定し直してください。
グリ ッ ド に ス ナ ッ プ ] を 使 用 す る
[グ
[グリッドにスナップ] オプションを使用すると、ワークフロー アクティビティやフローをより正
確に配置できます。
[表示] メニューから [グリッドにスナップ] を選択します。
このオプションをオンにすると、プロセス テンプレート エディタの背景にグリッドが表示され、エディ
タでアクティビティやフローを移動すると自動的にグリッドに沿って配置されるため、オブジェク
トの位置合わせが簡単になります。表示されるグリッドは、テンプレート上の既存のオブジェク
トのレイアウトには影響しません。
このオプションをオフにするとグリッドが消え、オブジェクトはドロップした位置にそのまま配置され
ます。オブジェクトの位置を微調整したい場合などには、このオブジェクトをオフにしてください。
48
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
Process Builder を 使 用 す る
拡大または縮小する
表示ツールバー ボタンがアクティブになっている場合、現在の表示倍率が拡大アイコン
と縮
小アイコン
の間のボックスに表示されます。拡大アイコンまたは縮小アイコンをクリックする
たびに、倍率が 1 レベルずつ増減します。
プロセス テンプレートを拡大または縮小するには
1. 拡大アイコンの横にあるリスト ボックスを展開するか、[表示] メニューの [拡大/縮小] を選
択します。
2. 以下の倍率のいずれかを選択します。
•
•
•
•
•
•
•
[200%] (最大倍率)
[150%]
[100%] (標準表示 - デフォルト)
[75%]
[50%]
[最後] - 現在のズーム オプションと前回のズーム オプション間の切り替えができます。
[幅] - プロセス テンプレート エディタ ペインの表示領域に合わせて、プロセス テンプ
レートの幅をサイズ変更します。
• [自動調整] - プロセス テンプレート エディタ ペインの表示領域に合わせて、プロセス
テンプレートを拡大または縮小できます。
メモを追加する
プロセス テンプレートの視覚的なレイアウトにテキストを追加するには、メモを使用します。メモを使
用すると、ビジネス プロセスの実際の動作に影響を与えることなく、テンプレートを参照するユーザ
にプロセスをわかりやすく表示することができます。メモはテンプレートのレイアウト内の任意の場
所に配置できます。デフォルトでは、メモのテキストは黄色の四角形の中に表示されますが、いく
つかの表示オプションがあります。次の例では、さまざまなフォーマットのメモを示しています。
図5
テキストを視覚的レイアウトに追加するメモ
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
49
Process Builder を使用する
Process Builder には、メモを表示しないオプションがあります。[ツール] メニューから [メモ] を選択
し、[表示] を選択してオプションのオン/オフを切り替えます。
プロセス テンプレートにメモを追加するには
1. ツールバーのメモ アイコン をクリックします。
プロセス テンプレートの編集領域でカーソルをドラッグすると、アイコンが表示されます。
2. メモを追加する場所でプロセス レイアウトをダブルクリックします。
最初のクリックでページ上に黄色の四角形が作成され、2 回目のクリックで [メモ インス
ペクタ] ダイアログ ボックスが開きます。
3. [メモの内容] タブで、メモのテキストを入力します。
4. [表示] タブをクリックします。
表示の設定を変更すると、ダイアログ ボックスの下部にある [プレビュー] リスト ボック
スに現在の選択内容が表示されます。
5. メモのテキスト用のフォントとスタイルを設定します。
a. [フォント] リストからフォントを選択します。
b. [フォント サイズ] ドロップダウン リストからフォント サイズを選択します。
c. ラベルのフォント スタイルを設定するには、[太字] と [斜体] をオンまたはオフにします。
6. メモのテキストの配置と色を設定します。
a. いずれかのラジオ ボタン ([左]、[中央]、または [右]) を選択して、メモの各テキスト行の
整列方法を指定します。
b. [テキストの色] ドロップダウン リストからテキストの色を選択します。
c. [背景色] ドロップダウン リストからメモの背景色を選択します。
背景色に関係なく、メモの外枠は黄色のままになります。
7. メモの透過度を指定します。
[透過性] スライダ コントロールを使用して透過度を設定します。透過性を 100 パーセ
ントに設定した場合、プロセス テンプレート上のメモは非透過になり、メモの背後に
あるオブジェクトは完全に隠れます。透過性が 0 パーセントの場合、メモは完全に
透けて表示されます。
8. メモの境界の表示を指定します。
a. [境界] チェックボックスをオンにして、黄色の境界を表示します。
b. [BPMN スタイル] チェックボックスをオンにして、Business Process Modeling Notation
(BPMN) フォーマットのテキスト注釈としてメモを表示します。メモの左側に太い境界
が表示されます。
9. [適用] をクリックしてメモ インスペクタを閉じずに更新を保存するか、[OK] をクリックして更
新を保存してメモ インスペクタを閉じます。
これで、メモがプロセス レイアウトに表示されます。
10. 必要に応じて、メモのボックスのサイズを変更します。
メモのサイズを変更するには、メモ オブジェクトを選択し、枠に沿って表示される
黒いハンドルの 1 つをドラッグします。
50
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
Process Builder を 使 用 す る
タブを使用して複数のプロセスを表示する
プロセス テンプレートを作成しているときに、別の既存プロセスを表示することが必要になる場合
があります。Process Builder では、複数のプロセスを開いて別々のタブで表示することができま
す。新しく開いたプロセスは新しいタブに表示され、もともと開かれていたその他のプロセスは
[Process Editor] ウィンドウの別のタブに表示されたままになります。
タブをダブルクリックすると、プロセスがウィンドウ全体のサイズに合うように展開表示されます。
もう一度ダブルクリックすると、プロセス ウィンドウが最小化されて、リソース ナビゲータが再度
表示されます。開いているテンプレートの現在の状態は、[Process Builder] ウィンドウのタイトル
バーに表示されます。タブ上に保存されていないデータが存在する場合、そのプロセスの
名前の先頭にアスタリスク (*) が付きます。
注 記 : 複数タブ表示は、同じリポジトリ内に存在するプロセスに対してのみ使用できます。
複数のリポジトリの複数のプロセスを開いたり表示することはできません。
現在表示しているタブを閉じるには、そのタブを右クリックして表示されるメニューから [閉じる] を
をクリックします。
選択するか、[ファイル] > [閉じる] を選択するか、タブ上の
プロ セ ス 検 証 ] タ ブ を 使 用 す る
[プ
[プロセス検証] タブを使用すると、保存したプロセスを検証するたびに検証エラーを表示できま
す。エラーのあるプロセスを検証すると、[プロセス検証] タブにアクティビティ名でグループ化され
たプロセスのエラーがすべて表示されます。
図6
プロ セ ス 検 証 ] タ ブ
[プ
[プロセス検証] タブには、次の項目を定義づけるプロセス データの変更によって生じるエ
ラーが表示されます。
• 実行者
• 条件付き実行者
• 移行ロジック
• タイマ アクション
• タスク名
• タスクの手順
• アクティビティ テンプレートのカスタム タブの要素設定
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
51
Process Builder を使用する
アクティビティのノードを展開して各アクティビティで見つかったすべてのエラーを表示します。タ
ブ内の個々のエラーを選択すると、プロセス エディタ ペイン内の対応するアクティビティが反転表
示になり、そのテンプレートを開いてエラーを修正できます。
すべてのアクティビティのすべてのエラーを表示するには、[すべて展開する] をクリックします。 す
べてのアクティビティのエラーのリストを閉じるには、[すべて折りたたむ] をクリックします。
また、[ファイルにエクスポートする] ボタンをクリックして、テキストのみのバージョンのエラーをファ
イルに保存したり、クリップボードにコピーしたりすることもできます。
[プロセス検証] タブと [プロセス デバッガ] タブを一緒に使用してプロセスのトラブルシューティ
ングを行うことができます。
注 記 : テンプレートに検証エラーがない場合は、[プロセス検証] タブは表示されません。
プロセス テンプレート ナビゲータを使用する
プロセス テンプレートを定義するとき、グラフィック表示が画面に全体表示できるサイズを超えてし
まうことがよくあります。オブジェクトを追加して、より大きなレイアウトを作成すると、プロセス テンプ
レート エディタが自動的にスクロールします。
ナビゲータでは、大きなテンプレートのどの部分を画面上に表示するかを制御できます。
画面上に表示するテンプレートの部分に移動するには
1. [表示] メニューの [ナビゲータ] を選択するか、ツールバーのナビゲータ アイコン
をク
リックします。
[Process Builder] ウィンドウの右側ペインに [ナビゲータ] ウィンドウが表示されます。こ
こには、現在のプロセス テンプレートの縮小表示が、画面に表示されるセクションをグ
レーの枠で囲んだ状態で表示されます。
2. 画面に表示するプロセス テンプレートの領域を変更するには、[ナビゲータ] ウィンドウのグ
レーの枠をドラッグし、エディタに表示したい領域が含まれるようにします。
マウス ボタンを離すと、選択した場所にエディタ ペインがスクロールします。
52
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
第3章
プロセス テンプレートを操作する
この章では、 次のトピックについて説明します。
•
プロセス テンプレートの概要
•
既存のプロセス テンプレートを開く
•
プロセス テンプレートを作成する
•
プロセス テンプレートのプロパティを設定する
•
プロセス データを管理する
•
詳細なオプションを設定する
•
プロセス テンプレートを保存する
•
チェックアウトしたプロセス テンプレートを保存する
•
チェックアウトされていないプロセス テンプレートを保存する
•
プロセス テンプレートを検証する
•
プロセス テンプレートをインストールする
•
プロセス テンプレートをアンインストールする
•
プロセス テンプレートを変更する
•
プロセス テンプレートのチェックイン、チェックアウト、およびバージョン管理を行う
•
プロセス テンプレートを削除する
•
プロセス テンプレートをインポートする
•
プロセス テンプレートをエクスポートする
•
共有プロセスを同期する
•
プロセス テンプレートを印刷する
•
ページ印刷オプションをセットアップする
•
印刷されるプロセスをプレビューする
プロセス テンプレートの概要
プロセス テンプレートは、特定のオブジェクトまたはオブジェクト セットのフローが経由するビジネ
ス プロセスを表します。開始から終了までワークフロー全体を定義します。Process Builder で
プロセス テンプレートを作成し、ユーザがそれを使用して個別のワークフロー インスタンスを
作成できるようにします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
53
プロセス テンプレートを操作する
プロセス テンプレートには、下書き、検証済み、インストール済みの 3 つの状態があります。開い
ているテンプレートの現在の状態は、Process Builder 画面のタイトル バーに表示されます。タイト
ル バーには、テンプレートがチェックアウトされているかどうかや、テンプレートが別のユーザに
よってチェックアウトされている場合はそのロック所有者のユーザ名も表示されます。
下書き状態のテンプレートは、作成または前回編集されてからまだ検証されていません。検証
済み状態のテンプレートは、サーバの検証チェックにパスしており、テンプレートが正しく定義
されていることが確認済みです。インストール済み状態のテンプレートは、アクティブ ワーク
フローに使用することができます。
既存のプロセス テンプレートを開く
新しいワークフローの出発点として、既存のテンプレートを確認、改訂、または名前を付けて保
存するために開くことができます。
プロセス テンプレートを開くには
1. [ファイル] メニューの [開く] をクリックします。
[プロセス テンプレートを開く] ダイアログ ボックスが表示されます。
2. テンプレート名がリスト ボックスに表示されるまで、キャビネットとフォルダ名をダブルクリック
してプロセス テンプレートに移動します。
3. [表示] リストから、テンプレートの現在のバージョンのみをウィンドウに表示する場合は [現
在のバージョンを表示] を選択し、テンプレートのすべてのバージョンのリストを表示する場
合は [全バージョンを表示] を選択します。
4. テンプレートの名前を反転表示して、[オープン時にプロセスをチェックアウト] のチェックボック
スをオンにしてプロセスを編集します。[表示] は、別のユーザがテンプレートをチックアウトして
いる場合にのみ使用でき、テンプレートの読み取り専用コピーを開きます。
注記: テンプレートが別のユーザによってチェックアウトされている場合、テンプレート名の横に
鍵アイコンが表示され、[表示] がそのテンプレートで使用できる唯一のオプションになります。名
前の上にカーソルを置くと、テンプレートのロックを所有しているユーザの名前が表示されます。
5. テンプレート名をダブルクリックするか、テンプレート名を反転表示して [開く] をクリックします。
プロセス テンプレートを作成する
ここでは、テンプレート作成手順の概要を説明します。一部の手順には他のトピックへのリンクがあ
り、クリックするとその手順で説明しているタスクの詳細が表示されます。
プロセス テンプレートを作成するには
1. このプロセスを使用するビジネス プロセスとワークフローを設計します。
ビジネス プロセスの設計の詳細については、「ワークフローのプロセスを計画する (16
ページ) 」を参照してください。
2. [ファイル] メニューの [新規作成] > [プロセス] をクリックします。
空のテンプレートが、新しいタブにデフォルトの初期化タスクと終了タスクが表示された状
態で開きます。
54
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
注 記 : 既存のテンプレートを基にテンプレートを作成するには、既存のテンプレートを開き、
別の名前を付けて保存します。
3. テンプレートのプロパティを設定します。
詳細については、「プロセス テンプレートのプロパティを設定する (56ページ) 」を
参照してください。
4. ビジネス プロセスの一部として関連付けられる、または作成されるプロセス データを指定します。
詳細については、「プロセス データを管理する (58ページ) 」を参照してください。
5. ワークフローの各タスクにアクティビティが 1 つずつ存在するようになるまで、プロセス テ
ンプレートにアクティビティを追加します。
• ツールバーの手動アクティビティ アイコン
または自動アクティビティ アイコン
をク
リックし、プロセス テンプレート エディタ ペイン内でアクティビティを表示させる場所をク
リックします。
• [アクティビティ テンプレート] ウィンドウからプロセス テンプレート エディタ ペインにアク
ティビティ テンプレートをドラッグ アンド ドロップします。
必要なアクティビティのタイプを表すテンプレートが [アクティビティ テンプレート] ウィンドウにな
い場合は、ツールバーの手動または自動アクティビティ ボタンをクリックして空のアクティビティ
を作成するか、新しいテンプレートを作成することができます。新しいアクティビティの作成方
法の詳細については、アクティビティ テンプレートを作成する (90ページ) を参照してください。
6. 各アクティビティを、論理フローでの先行するアクティビティに接続します。
ワークフローの先頭のアクティビティは、任意のタイプの初期化アクティビティに接続し、最後
のアクティビティは終了アクティビティに接続する必要があります。
2 つのアクティビティを接続するには、フロー アイコンのうちの 1 つを選択し、最初のアクティ
ビティの上にカーソルを移動します。選択ボックスが表示されたら、マウスを 2 番目のアク
ティビティにドラッグします。2 番目のアクティビティの選択ボックスが表示されたらマウス ボ
タンを放します。アクティビティの間に線が描画されます。
[Process Builder] ツールバーにある 4 つのフローの作成アイコンのうちの 1 つを使用して、アク
ティビティ間を接続します。
• データの前方向にアクティビティを接続するには、単一セグメント フローの作成アイコン
か、複数セグメント フローの作成アイコン
をクリックします。この 2 つの違いは視覚的
に表されます。前者ではアクティビティ間のフローを表す 1 本の直線が描画され、後者
では複数のセグメントから成る 1 本の線が描画されます。
をク
リックします。拒絶フローは、アクティビティのユーザが処理対象のオブジェクトを却下した
場合にとられるパスを表します。
• データの後方向にアクティビティを接続するには、元に戻すフローの作成アイコン
• 障害対処アクティビティをフローに接続するには、
をクリックします。
このトピックの詳細については、「障害対処アクティビティ (13ページ) 」を参照してください。
注 記 : 個々のアクティビティを設定する前に、すべてのアクティビティをフローに接続します。
一部の設定手順は、ビジネス プロセスでのアクティビティの位置に基づいています。
7. 各アクティビティを設定します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
55
プロセス テンプレートを操作する
アクティビティの設定の詳細については、「アクティビティ テンプレートを設定する (91
ページ) 」を参照してください。通常は、初期化アクティビティから始めて、ビジネス プロ
セスに表示される順序でアクティビティを設定することをお勧めします。各アクティビティ
に対し、必要なタブすべてを設定します。たとえば、結合アクティビティの場合は [トリガ]
タブ、決定分岐アクティビティの場合は [移行] タブを設定する必要があります。初期化
アクティビティで設定できるのは、[プロパティ]、[データ]、および [表示] タブのみです。
8. 必要に応じて、表示レイアウトを調整します。
プロセス テンプレートの表示レイアウト設定に使用できるオプションについては、「プロ
セス テンプレート エディタ ペイン (46ページ) 」を参照してください。
9. プロセス テンプレートを保存します。
「プロセス テンプレートを保存する (68ページ) 」を参照してください。
10. プロセス テンプレートを検証します。
「プロセス テンプレートを検証する (70ページ) 」を参照してください。
11. プロセス テンプレートをインストールします。
「プロセス テンプレートをインストールする (71ページ) 」を参照してください。テンプ
レートをインストールすると、ユーザがそのテンプレートを利用できるようになります。
プロセス テンプレートのプロパティを設定する
[プロセスのプロパティ] ダイアログ ボックスでは、作成するワークフローに関する基本的な情報を
設定します。プロセス テンプレートの元の作成者と現在の状態 (ロックの状態、ロック所有者、およ
びバージョンを含む) が、ダイアログ ボックスの最上部にある表示専用フィールドに表示されます。
注 記 : 既存のテンプレートを編集するには、そのプロセスをアンインストールする必要があ
ります。既存のプロパティの変更方法の詳細については、「プロセス テンプレートを変更
する (72ページ) 」を参照してください。
プロセス テンプレートのプロパティを設定するには
1. [ツール] メニューの [プロセスのプロパティ] を選択するか、ツールバーのテンプレートのプロ
パティ アイコン
をクリックします。
2. [一般] タブを選択します。
テンプレートの上部に、テンプレートの基本情報が読み取り専用テキストとして表
示されます。
3. プロセス テンプレートの所有者を変更するには、所有者名の横にある [変更] ボタンをクリック
して、表示されるダイアログ ボックスからユーザを選択します。
テンプレートのデフォルト所有者は、そのテンプレートの作成者です。テンプレートの所有
者を変更できるのはスーパーユーザのみです。スーパーユーザでない場合は、[変更] ボ
タンは使用できません。
4. [説明] テキスト ボックスにプロセス テンプレートの説明を入力します。
5. このプロセス テンプレートのデフォルトのエイリアス セットを変更するには、現在のエイリア
ス セットの横に表示される [変更] ボタンをクリックします。
56
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
• 既存のエイリアス セットを選択するには、[既存のエイリアス セットから選択] をオンにし、ド
ロップダウン リストからエイリアス セットの名前を選択して、[OK] をクリックします。
• 新しいエイリアス セットを作成するには、[新しいエイリアス セットの作成] をオンにし、新しい
エイリアス セットの名前と説明を入力して、[OK] をクリックします。
• 現在割り当てられているデフォルトのエイリアス セットを削除するには、[エリアス セッ
トを削除する] をオンにします。
エイリアス セットおよびワークフローでのエイリアス セットの使用方法の詳細については、
「エイリアスを使用する (20ページ) 」を参照してください。
6. [ワークフローの手順] ボックスに実行者への指示を入力します。
たとえば、すべてのアクティビティの実行者に対して、タスクに関する固有の指示を
与えることができます。
7. 該当するオプションをクリックして、[テンプレートの監査記録設定] をオンまたはオフに設
定します。
監査をオンにすると、このテンプレートから作成された各ワークフローについて監査記
録情報が保存されます。システムがレポート データを BAM データベースに発行でき
るようにするには、監査をオンにする必要があります。
注 記 : 監査記録設定を変更するためには、CONFIG_AUDIT 権限が必要です。
CONFIG_AUDIT はユーザ権限が拡張されたものであり、別のリポジトリの所有者またはスー
パーユーザが Documentum TaskSpace または Documentum Webtop を使用して許可する必要
があります。 ユーザ権限の拡張の詳細については、『Documentum Webtop ユーザ ガイド』およ
び『Documentum TaskSpace 設定ガイド』に示されています。
8. 送られるドキュメントの名前をユーザに対して表示するかどうかを指定します。
デフォルトでは、ワークフローを通して送られるパッケージには、セキュリティ上の理由からド
キュメント名は含まれていません。ドキュメント名をパッケージの一部として保存し、ワークフ
ローの参加者に渡される指示においてその名前を使用できるようにする場合は、[実行時に
パッケージにドキュメント名を保存] チェックボックスを選択します。
9. タイマの有効期限が切れたとき、または別のイベントが発生したときに電子メール メッセージを送
信するには、[イベント通知のテンプレートの選択] グループ ボックスの [追加] をクリックします。
グループ ボックスからテンプレートやイベントを削除する場合は、行を選択し、[削除]
をクリックします。
10. 通知をトリガするイベントをドロップダウン リストから選択します。
11. [クリックしてテンプレートを追加] をクリックし、サーバでイベント通知を送信する際に使用す
る電子メール テンプレートを選択します。
• リポジトリから既存のテンプレートを選択する、[既存のテンプレートを選択] オ
プションを選択します。
• または、通知テンプレート ウィザードを使用して [電子メール テンプレートを新規作
成] を選択します。 新しい電子メール テンプレートを作成する方法については、「通知テ
ンプレート ウィザードを理解する (122ページ) 」を参照してください。
サーバは、同じイベント タイプのすべての通知に、選択した電子メール テンプレートを使用し
ます。電子メール テンプレートを使用しない場合、サーバはデフォルトの通知を Documentum
受信ボックスに送信してユーザに通知します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
57
プロセス テンプレートを操作する
12. カスタム電子メール メッセージを特定のワークフロー イベントに関連付けるには、ダイアログ
ボックスの下部のボックス内でイベントと電子メール テンプレートを選択します。
プロセス関連イベントへの応答としてサーバが送信するメッセージを設定できます。イベントの
通知を受け取るように登録されているユーザは、イベントに関連付けられた電子メール テンプ
レートを使用して作成されたメッセージを受信します。電子メール テンプレートを、アクティビ
ティ定義の一部としてイベントに関連付けることもできます。
• 電子メール テンプレートをプロセス テンプレートに関連付けた場合、そのプロセス テン
ブレートから作成されたワークフローにおいてイベントが発生したら、常にその電子メー
ル テンプレートが使用されます。
• 電子メール テンプレートをアクティビティ定義に関連付けた場合、アクティビティのインスタ
ンスにおいてイベントが発生したら、常にそのテンプレートが使用されます。
• 特定のワークフロー インスタンスと、そのワークフローにおけるアクティビティの両方が、
同じイベントに対して関連付けられたテンプレートを持つ場合は、アクティビティに関連
付けられたテンプレートが使用されます。
詳細については、「通知を設定する (122ページ) 」を参照してください。
a. [追加] ボタンをクリックして、イベント通知ボックスに行を追加します。
b. 新しい行の [イベント] の列をクリックして、表示されるドロップダウン リストからワークフロー
イベントを選択します。使用可能なイベントは次のとおりです。
• dm_changedactivityinstancestate - エラー処理フラグが 0 に設定されており、作業項目が
0 以外の値を返してきたので、自動アクティビティが状態を変更します。
• dm_startedworkitem — 作業項目がワークフローの一部として生成されます。
• dm_delegatedworkitem — ユーザが作業項目を委任します。
• [事前タイマが期限切れです] — ワークフローの開始後、指定された時間以内にア
クティビティが開始されませんでした。
• [事後タイマの有効期限が切れています] — アクティビティの開始後、指定された
時間以内にアクティビティが完了しませんでした。
c. 電子メール テンプレート行の [電子メール テンプレート] の列をクリックして、手順 b で選択
したイベントに使用する電子メール テンプレートを選択します。電子メール テンプレート
は、Documentum リポジトリ内のドキュメントで、通知メッセージの構造を定義します。電子
メール テンプレートとして機能するドキュメントの構造については、『Documentum Process
Builder Development Guide (Documentum Process Builder 開発ガイド)』を参照してください。
13. 次のいずれかを実行します。
• [OK] をクリックしてダイアログ ボックスを閉じます。
• [データ] タブをクリックして、テンプレートにプロセス データを追加します。
プロセス データを管理する
[プロセスのプロパティ] ダイアログ ボックスの [データ] タブには、このプロセス テンプレートから作
成されるワークフローに関連するパッケージ、プロセス変数、およびプロセス パラメータのリストが
表示されます。プロセス データの構成要素は次のとおりです。
• ワークフロー変数
58
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
• プロセス変数
• プロセス パラメータ
• パッケージ
パッケージを管理する
多くのワークフローでは、同じパッケージがすべてのアクティビティ間で渡されます。たとえば、購
買発注書を確認して承認するワークフローでは、同じ購買発注書ドキュメントが、必要なすべての
アクティビティにパッケージとして渡されます。また、一部のアクティビティによって実行された作業
の結果、新しいドキュメントが作成される場合もあります。たとえば、個人的な活動通知を受け入れ
るアクティビティがあるとします。実行者 (HR 担当者) はこの通知をファイルして、別のフォームを
会計部門に送信する必要があります。[プロセスのプロパティ] ダイアログ ボックスのパッケージのリ
ストには、ワークフローに関連するすべてのパッケージ (プロセスの途中で作成されるパッケージ
や破棄されるパッケージを含む) が含まれていることが必要です。アクティビティを設定する場合
は、各アクティビティで処理するパッケージを指定します。詳細については、「アクティビティ内のプ
ロセス データを変更する (125ページ) 」を参照してください。
ビジネス プロセスのパッケージを設定するには
1. [プロセスのプロパティ] ダイアログ ボックスがまだ表示されていない場合は、[ツール] メニュー
の [プロセスのプロパティ] をクリックするか、またはツールバーにあるテンプレートのプロパ
ティ アイコン
をクリックします。
2. [データ] タブをクリックします。
3. ビジネス プロセスにパッケージを追加するには、ツリー表示ウィンドウの [パッケージ] ノードを
選択し、このウィンドウの上にある [+] ボタンをクリックします。
新しいパッケージがツリーの [パッケージ] ノードの下、および [パッケージ定義] リスト
ボックスにパッケージを定義するためのコントロールと共に表示されます。
4. [名前] テキスト ボックスにパッケージの名前を入力します。
ビジネス プロセスでアクティビティを設定するときにパッケージを識別できる名前にします。
注 記: パッケージ名は最大 16 文字です。
5. [バージョン] ドロップダウン リストで、使用するコンテンツのデフォルト バージョンを選択す
るか、入力します。
注 記 : Process Builder では、[バージョン] リストを表示しないように設定することがで
きます。詳細については、「Process Builder の設定ファイル (235ページ) 」を参照し
てください。リストが表示されない場合、ワークフローでは現在のバージョンが常
に使用されます。
指定したバージョンは、パッケージを処理する各アクティビティで使用されるデフォルト バー
ジョンとして表示されます。このバージョンは、アクティビティの設定時に上書きできます。バー
ジョンを指定するには、次の項目を選択または入力します。
• 「<任意>」。パッケージの任意のバージョンが使用されます。
• 特定のバージョン番号 (2.5 または 3.0 など)。バージョン番号を入力した場合、パッケー
ジには、常にそのバージョンのドキュメントが含まれます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
59
プロセス テンプレートを操作する
• 記号バージョン ラベル (ドラフトなど)。記号バージョン ラベルは大文字と小文字を区別す
るので、入力したバージョンがリポジトリのオブジェクトのバージョンに対応しているかどう
かを確認してください。
• CURRENT (デフォルトの選択)。[CURRENT] を選択すると、パッケージには常に
「CURRENT」というラベルが付けられたバージョン (通常はリポジトリ内の現在のバージョン
のオブジェクト) が含まれます。
注 記 : Process Builder では、[バージョン] リストを表示しないように設定することができます。詳
細については、「Process Builder の設定ファイル (235ページ) 」を参照してください。リストが表
示されない場合、ワークフローでは現在のバージョンが常に使用されます。
6. [タイプ]ドロップダウン リストから、パッケージに含めるオブジェクトのオブジェクト タイプ
を選択します。
注記: Process Builder では、[タイプ] リストを表示しないように設定することができます。詳細に
ついては、「Process Builder の設定ファイル (235ページ) 」を参照してください。[タイプ] リストが
表示されない場合、または選択したフォーム テンプレートに基づいてオブジェクト タイプが選
択されるようにする場合は、この手順をスキップできます。
通常、パッケージのオブジェクト タイプは、ドキュメント タイプ、またはユーザが作成したカス
タム ドキュメント タイプです。オブジェクト タイプの説明については、『Documentum Content
Server Reference (Documentum Content Server リファレンス)』 を参照してください。
7. フォーム テンプレートをパッケージに関連付けるには、[フォーム] ドロップダウン リストからテ
ンプレートを選択します。
フォーム テンプレートでは、ワークフローでこのパッケージを処理するユーザのためのカス
タム ユーザ インターフェイスを定義します。フォームとフォーム テンプレートの使用方法の
詳細については、「フォーム テンプレートをパッケージに関連付ける (29ページ) 」を参照し
てください。フォームをリストに表示するには、インストール済みの状態にする必要がありま
す。ここで指定したフォーム テンプレートは、パッケージを処理する各アクティビティで使用さ
れるデフォルト テンプレートとして表示されます。このフォーム テンプレートは、アクティビ
ティの設定時に上書きすることができます。
注 記 : パッケージのオブジェクト タイプを設定する前にフォーム テンプレートを選
択した場合は、Process Builder のドロップダウン リストに使用可能なすべてのフォー
ム テンプレートが表示され、選択したフォーム テンプレートに基づいてパッケージ
のオブジェクト タイプが設定されます。
a. [フォーム] ドロップダウン リストから既存のフォームを選択します。リストには、手順 5 で選択
したオブジェクト タイプに一致するデータ モデルが含まれているフォーム テンプレートのみ
が表示されます。目的のフォーム テンプレートが表示されない場合は、手順 5 で適切なオ
ブジェクト タイプを選択したかどうかを確認してください。
b. 新しいフォーム テンプレートを作成する、または選択したフォーム テンプレートを編集する
には、Forms Builder アイコンのボタンをクリックし、Forms Builder を起動します。ワークフ
ロー固有のカスタム フォームの作成方法に関する詳細については、『Documentum Forms
Builder User Guide (Documentum Forms Builder ユーザ ガイド)』を参照してください。
8. 選択したフォームを使用してパッケージのプロパティを表示するには、[プロパティ用フォーム
の使用] チェックボックスをオンにします。
[プロパティ用フォームの使用] チェックボックスをオンにしないと、手順 7 で選択したフォーム
は、アクティビティの実行者が受信ボックスからパッケージを選択したときに表示されます。
フォームはパッケージのコンテンツを保存するために使用されます。[プロパティ用フォームの
60
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
使用] チェックボックスをオンにすると、実行者がパッケージのプロパティを表示したときに
フォームが表示されます。この場合、フォームはパッケージのコンテンツを保存するためではな
く、リポジトリ内のパッケージのプロパティを設定するために使用されます。
注 記 : [プロパティ用フォームの使用] オプションを利用できるのは、ストレージ マッピング オプ
ションが [Store in Repository attributes (リポジトリに保存属性)] に設定されているフォーム テン
プレートのみです。このストレージ マッピング オプションについては、『Documentum Forms
Builder User Guide (Documentum Forms Builder ユーザ ガイド)』を参照してください。
9. このパッケージを、一部のアクティビティにのみ表示するには、[プロセス全体で表示] チェック
ボックスをオフにします。
デフォルトでは、プロセス全体でパッケージが使用されることを想定し、ビジネス プロセスのす
べてのアクティビティにパッケージが表示されます。このチェックボックスをオフにした場合は、
パッケージは明示的に追加したアクティビティにのみ表示されます。
注 記 : 一部のアクティビティにのみ表示されるように設定された既存のパッケージを選択し
た場合、このチェックボックスは使用できません。すべてのアクティビティを同じ値にリセット
する場合は、[アクティビティ レベル設定の変更] リンクをクリックし、表示されるダイアログ
ボックスで [はい] をクリックします。
10. パッケージに必ずドキュメントまたは他のコンテンツを関連付けるようにするには、[これは必須
パッケージ] チェックボックスをオンにします。
注 記: 一部のアクティビティでは必須で、他のアクティビティではオプションに設定された既存
のパッケージを選択した場合、このチェックボックスは使用できません。すべてのアクティビ
ティを同じ値にリセットする場合は、[アクティビティ レベル設定の変更] リンクをクリックし、
表示されるダイアログ ボックスで [はい] をクリックします。
11. Process Builder がパッケージ用のレポート データを BAM データベースに発行できるようにす
るには、[このパッケージはレポートの生成に使用できます] を選択します。
12. [適用] をクリックすると、パッケージがリスト ボックスに追加されます。
13. フローに他のパッケージを追加するには、手順 3 ～ 11 を繰り返します。
各アクティビティがどのパッケージを処理するかを指定します。初期化アクティビティから開始
して、ビジネス プロセス全体を進めていきます。
「アクティビティ内のプロセス データを変更する (125ページ) 」を参照してください。
プロセス変数を管理する
プロセス変数は、ビジネス プロセスで使用されるさまざまなタイプのデータを表します。プロセス変
数は、単純なデータ タイプ (文字列型、ブール型、日付型など) にすることも、複合的なデータ
タイプ (購買発注書、製造品目など、論理的に関連のあるデータのグループ) にすることもで
きます。プロセス変数は、リポジトリで再利用可能な、論理的に関連のあるデータ タイプの属
性のコレクションにグループ分けできます。
これらのプロセス変数、つまり構造化データ タイプは、[構造化データ タイプ] ウィンドウで利用で
き、リポジトリ内の複数のプロセス テンプレートで使用できます。
たとえば、承認済みのプロセス変数 (ブール型値) を作成し、プロセス フローに関連付けることが
できます。次に、承認済みのフィールドの値を示すラジオ ボタン付きの Forms Builder フォームを
設計し、そのフォームをプロセス フローに関連付けることができます。
ビジネス プロセスのプロセス変数を設定するには
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
61
プロセス テンプレートを操作する
1. [プロセスのプロパティ] ダイアログ ボックスがまだ表示されていない場合は、[ツール] メニュー
の [プロセスのプロパティ] をクリックするか、またはツールバーにあるテンプレートのプロパ
をクリックします。
ティ アイコン
2. [データ] タブをクリックします。
3. ビジネス プロセスにプロセス変数を追加するには、ツリー表示ウィンドウの [プロセス変数] ノー
ドを選択し、このウィンドウの上にある [+] ボタンをクリックします。
新しい変数がツリーの [プロセス変数] ノードの下および [変数定義] リスト ボックスに、
プロセス変数を定義するためのコントロールと共に表示されます。
4. [名前] テキスト ボックスに変数の名前を 255 文字以下で入力します。
ビジネス プロセスでアクティビティを設定するときに変数を識別できる名前にします。
注記: リポジトリで定義済みの変数の名前を変更した場合、この変更はプロセス内の変数に対
してのみ行われ、リポジトリ内の構造化データ タイプ名には反映されません。構造化デー
タ タイプでは元の名前が使用されます。
5. [タイプ] フィールドでデータ タイプを選択します。
有効値は文字列、整数、浮動小数、日付、ブールです。
また、[その他の値] を選択し、[タイプを選択] ダイアログ ボックスで構造化データ タイプのツ
リーを移動して、[構造化データ タイプ] から構造化データ タイプを選択することもできます。
注 記 : 文字列であるプロセス変数の最大長は 2000 文字です。
6. 定義したデータ タイプに基づき、必要に応じてデフォルト値を入力します。
7. この変数を ACL に関連付けるには、[参照] をクリックしてリストから ACL を選択します。
注 記 : 個々のプロセス変数に割り当てられた ACL は、プロセスレベルの ACL に優先します
([高度] タブでプロセスに割り当てられている場合)。
アクセス コントロール リストの詳細については、「アクセス コントロール リスト (ACL) のオプショ
ンを設定する (64ページ) 」を参照してください。
8. [適用] をクリックして新しい変数の定義を保存します。
9. フローに他の変数を追加するには、手順 3 から 11 を繰り返します。
10. [OK] をクリックして更新を保存し、ダイアログ ボックスを閉じます。
各アクティビティがどの変数を処理するかを指定します。初期化アクティビティから開始して、
ビジネス プロセス全体に進めていきます。
アクティビティ内のプロセス データの設定方法に関する詳細については、「アクティビティ内のプ
ロセス データを変更する (125ページ) 」を参照してください。
プロセス パラメータを管理する
アプリケーション管理者は、プロセス パラメータを利用して、プロセス全体で使用される定数値を
変更することができます。プロセス内で定義されているパラメータは、プロセスに含まれるすべて
のアクティビティで使用できます。
管理者は、TaskSpace の [管理] タブからパラメータの値を変更できます。更新された値は、ワーク
フロー内の新しいプロセス インスタンス、作業項目、および変数で使用されます。
62
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
プロセス パラメータの概要については、「プロセス パラメータを理解する (28ページ) 」を参照
してください。
注 記 : プロセス パラメータを移行すると、Documentum Composer は各プロセ
ス パラメータに対応するインストール パラメータを作成します。デフォルト値
はソース リポジトリの値に設定されます。インストール パラメータの名前は、
ProcessName_ProcessParameterName0.parameter のように、プロセス名から始まり、その後
にプロセス パラメータ名が続きます。Documentum Composer プロジェクトのインストー
ル パラメータの使用に関する詳細については、『Documentum Composer User Guide
(Documentum Composer ユーザ ガイド)』を参照してください。
ビジネス プロセスのプロセス パラメータを設定するには
1. [プロセスのプロパティ] ダイアログ ボックスがまだ表示されていない場合は、[ツール] メニュー
の [プロセスのプロパティ] をクリックするか、またはツールバーにあるテンプレートのプロパ
ティ アイコン
をクリックします。
2. [データ] タブをクリックします。
3. ビジネス プロセスにプロセス パラメータを追加するには、ツリー表示ウィンドウの [プロセス パラ
メータ] ノードを選択し、このウィンドウの上にある [追加] ([+]) ボタンをクリックします。
新しいパラメータがツリーの [プロセス パラメータ] ノードの下および [プロセス パラメー
タ] リスト ボックスに、パラメータを定義するためのコントロールと共に表示されます。
4. [名前] テキスト ボックスにパラメータの名前を 255 文字以下で入力します。
ビジネス プロセスでアクティビティを設定するときや TaskSpace の [管理] タブから設定
するときにパラメータを識別できる名前にします。パラメータ名にスペースおよび特
殊文字を使用することはできません。
5. [タイプ] フィールドでデータ タイプを選択します。
有効値は文字列、整数、浮動小数、日付、ブールです。
6. パラメータの [説明] を入力します。
7. 定義したデータ タイプに基づき、必要に応じて定数値を入力します。この値は、アプリケー
ション管理者が TaskSpace の [管理] タブで変更できます。
アクティビティ レベルの設定を上書きする
[プロセスのプロパティ] ダイアログ ボックスの [データ] タブで作成された設定はグローバル設定で
あり、プロセス全体に拡張されます。多数のプロパティの設定をアクティビティ レベルで編集し、そ
の特定の設定に対して混合状態を作成できます。たとえば、あるパッケージをプロセス レベルのレ
ポート可能に設定し、特定のアクティビティ内ではレポート可能オプションを変更できるようにする
ことができます。アクティビティの設定が、プロセスで指定されているグローバル設定と異なる場合
は、アクティビティ レベルの設定を上書きすることができます。
プロセスに対してアクティビティ レベルの設定を上書きするには、次の手順に従います。
1. [プロセスのプロパティ] ダイアログ ボックスの [データ] タブで、[アクティビティ レベル設
定の変更] リンクを選択します。
2. [アクティビティ レベル設定の変更] ダイアログ ボックスに、グローバル プロセスのプロパティと
異なる設定を持つアクティビティが表示されます。
3. 設定を上書きするには、アクティビティ名を選択して [はい] をクリックします。
アクティビティは、プロセスで割り当てられたグローバル設定を継承します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
63
プロセス テンプレートを操作する
詳細なオプションを設定する
[プロセスのプロパティ] ダイアログ ボックスの [高度] タブでは、プロセス全体に対するアクセス権
や、プロセス フローに関連付けられた個々の変数を設定できます。外部ソースからの受信メッセー
ジの属性とアクティビティのプロセス データを一致させる相関セットを作成することもできます。
ア ク セ ス コ ン ト ロ ー ル リ ス ト (ACL) の オ プ シ ョ ン を 設 定 す る
アクセス権セット (アクセス制御リストまたは ACL とも呼ばれます) は、アクセス権セットが割り
当てられているオブジェクトに適用するオブジェクトレベルのアクセス権を定義します。アクセ
ス権セットは、リポジトリ内の特定のアイテム (ファイルやフォルダなど) に対して各ユーザが保
持するアクセス権を指定します。リポジトリ内の各アイテムには、アイテムの所有者によってアク
セス権セットが割り当てられます。アクセス権セットは、オブジェクトに適用するオブジェクトレ
ベルのアクセス権を定義します。
新しいテンプレートを作成する場合、新しいプロセスとアクティビティ オブジェクトはユーザのデ
フォルトの ACL または親フォルダのデフォルトの ACL のいずれかに依存します (リポジトリの設定
によって異なります)。各ユーザにワークフローの要素に対する適切なアクセス権を与えるには、プ
ロセスおよびアクティビティに適用する ACL を Process Builder 内から設定します。
タスクの実行者がプロセスに対する読み取りアクセス権を持っていない場合、受信ボックス内に
タスクを受信して開くことはできますが、タスクを完了することはできません。タスクの実行者が
プロセス変数に対する読み取りアクセス権を持っていない場合は、TaskSpace または受信ボッ
クス内でプロセス変数を表示できません。タスクの実行者が書き込みアクセス権を持っていな
い場合は、プロセス変数を変更できません。
ACL の使用方法については、『Documentum Content Server Administration Guide (Documentum
Content Server 管理ガイド)』を参照してください。
表4
プロセスに対して必要なアクセス権
ユーザ
必要最低限のアクセス権レベル
プロセス作成者
書き込み
ワークフロー作成者
関連付け、Execute_procedure
ワークフロー スーパーバイザ
関連付け
タスク実行者
読み取り
表5
プロセス変数に対して必要なアクセス権
ユーザ
必要最低限のアクセス権レベル
プロセス作成者
書き込み
ワークフロー作成者
書き込み
ワークフロー スーパーバイザ
書き込み
タスク実行者
書き込み
64
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
ACL を 選 択 す る に は
1. [プロセスのプロパティ] ダイアログ ボックスがまだ表示されていない場合は、[ツール] メ
ニューの [プロセスのプロパティ] をクリックするか、またはツールバーにあるテンプレートの
プロパティ アイコン
をクリックします。
2. [高度] タブをクリックします。
3. デフォルトの BPM プロセス変数 ACL を受け付ける場合は、[デフォルト] をクリックします。
4. すべてのプロセス変数に対する ACL を変更する場合は、[参照] をクリックします。
[ACL の選択] ダイアログ ボックスが表示されます。
a. システムまたはユーザが所有する ACL を選択します。
どちらを選択したかによって、表示される ACL は異なります。システムの ACL は、
リポジトリ内のすべてのユーザが利用できます。これらの ACL はリポジトリの所有者
が管理します。その他の ACL は、それぞれの所有者が管理するか、システム管理
者またはスーパーユーザが管理できます。
b. すべてのプロセス変数に適用する ACL を選択します。
デフォルトとして、変数に対する ACL がサーバによって定義されます。ACL の説
明および関連付けられているアクセス権がダイアログ ボックスに表示されます。
c. [OK] をクリックします。
注 記 : プロセス テンプレートの [データ] タブに表示される個々のプロセス変数に割り当て
られた ACL は、プロセスレベルの ACL を上書きします。
5. プロセスに対する正しい ACL をサーバが選択できるようにする場合は、[デフォルト] をク
リックします。
6. プロセスに対するデフォルトの ACL を変更する場合は、[参照] をクリックして ACL を選
択します。
a. システムまたはユーザが所有する ACL を選択します。
どちらを選択したかによって、表示される ACL は異なります。システムの ACL は、リポ
ジトリ内のすべてのユーザが利用できます。これらの ACL はリポジトリの所有者が管理
します。その他の ACL は、それぞれの所有者が管理するか、システム管理者または
スーパーユーザが管理できます。
b. プロセスに適用する ACL を選択します。
ACL の説明および関連付けられているアクセス権がダイアログ ボックスに表
示されます。
c. [OK] をクリックします。
プロセス用のカレンダーを選択する
プロセス設計者は、標準のシステム カレンダーで定義されていない期間または勤務時間に基づ
くビジネス プロセスを実装することを求められる場合があります。Documentum Webtop または
TaskSpace を使用すると、設計者は、地域固有の勤務スケジュール、各国固有の休日、または他
の独特の時間的制約に基づいてカレンダーを作成できます。この方法の場合、プロセスのタイマ
と通知は、システム カレンダーではなく、特定のカレンダーに基づいて計算されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
65
プロセス テンプレートを操作する
注 記 : ユーザの受信ボックスに初めてタスクが届いたとき、そのタスクの期限がシステム カ
レンダーに基づいて計算される場合があります。次回タイマ ジョブが実行されるときに、そ
のジョブによりビジネス カレンダーに基づいて期限が更新されます。
プロセス用のカレンダーを選択するには
1. [プロセスのプロパティ] ダイアログ ボックスがまだ表示されていない場合は、[ツール] メ
ニューの [プロセスのプロパティ] をクリックするか、またはツールバーにあるテンプレートの
プロパティ アイコン
をクリックします。
2. [高度] タブをクリックします。
3. リスト ボックスからカレンダーを選択します。
カレンダーのリストには、[システム]/[ワークフロー]/[カレンダー] フォルダにあるすべてのカレ
ンダーが反映されます。
注 記 : プロセスおよびプロセス内のアクティビティについて種類の異なるカレンダーを選択
した場合は、アクティビティのカレンダーが使用されます。
プロセス パラメータ フォームを割り当てる
プロセス パラメータ フォームでは、プロセス全体で使用される定数値を変更するための管理者用
のページを作成します。管理者は、TaskSpace の [管理] タブから Documentum フォームにアクセス
してこのような変更を行います。更新された値は、ワークフロー内の新しいプロセス インスタン
ス、作業項目、および変数で使用されます。
このオプションを有効にするには、プロセス パラメータ フォームを割り当てるかまたは作成してパラ
メータを管理できるようにし、プロセスにプロセス パラメータ フォームを割り当てます。
プロセス管理フォームを割り当てるには
1. [フォーム] ドロップダウン リストから、プロセス パラメータを TaskSpace 管理者に表示するた
めに使用するプロセス パラメータ フォームを選択します。
2. [更新] ボタンをクリックして、使用可能なすべてのフォームをリポジトリから取得します。
このアクションにより、保存されているすべての管理フォームについてリポジトリにクエリが
実行されます。
3. 新しいプロセス パラメータ フォームを作成するには、次の手順に従います。
a. ボタンをクリックして、Forms Builder を起動します。
b. Forms Builder で、アクティビティに使用するフォームを作成します。
フォームの作成方法については、『Documentum Forms Builder User Guide
(Documentum Forms Builder ユーザ ガイド)』を参照してください。
TaskSpace でのプロセスの管理の詳細については、『Documentum TaskSpace 設定ガイ
ド』を参照してください。
相関セットを作成する
Process Builder は、入力データを処理するために、受信メッセージをワークフローの一意のインス
タンスに対してマッチングできる必要があります。相関セットは、メッセージのプロセス インスタンス
へのマッチングを可能にするアクティビティについて定義するプロセス変数のコレクションです。
66
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
相関セットは、受信メッセージのアクティビティ テンプレートから受信する情報のタイプに基づい
て、プロセス レベルで作成します。作成では、リポジトリで定義されている構造化データ タイプ
を使用します。1 つのプロセスに対して複数の相関セットを作成できますが、1 つのアクティビ
ティに関連付けられる相関セットは 1 つのみです。相関セットを使用して外部ソースからのメッ
セージをプロセス データに一致させる方法については、「メッセージ相関を理解する (144ペー
ジ) 」を参照してください。
新しい相関セットを作成するには
1. [プロセスのプロパティ] ダイアログ ボックスがまだ表示されていない場合は、[ツール] メニュー
の [プロセスのプロパティ] をクリックするか、またはツールバーにあるテンプレートのプロパ
ティ アイコン
をクリックします。
2. [高度] タブをクリックします。
3. [相関セット] グループ ボックスで、相関セットのルート ノードを選択して追加ボタン ([+]) をク
リックし、ツリー内に新しい相関セットを作成します。
4. 新しい相関セットの名前を付けるには、作成したノードを右クリックして [セット名の編集]
を選択します。
[ラベルの編集] ダイアログ ボックスが表示されます。
5. 相関セットの新しい名前を入力して、[OK] をクリックします。
相関セットの名前に使用できる文字数は、最大 128 文字です。
6. 相関セットに属性を追加するには、相関セット名を反転表示してから
未定義の新しいプロパティがツリーに追加されます。
をクリックします。
7. この属性を右クリックし、[相関モデルの編集] を選択します。
相関ダイアログ ボックスが開き、プロセスに関連付けられているプロセス変数が表
示されます。
8. 変数のツリーからプロセス変数を選択し、[OK] をクリックします。
注 記 : ツリーには保存されているプロセス データのみが表示されます。[データ] タブに変数を
追加した場合、その変数は保存するまではツリーに表示されません。
9. 続けて別の相関セットおよび関連する変数を追加する場合は、前述の手順を繰り返します。
10. [OK] をクリックします。
受 信 Web サ ー ビ ス を 有 効 に す る
受信 Web サービス アクティビティがプロセスに含まれている場合、WSDL ロケーションのターゲッ
ト名前空間 URI を入力する必要があります。複数の Web サービス アクティビティがプロセスに含
まれている場合は、そのすべてで同じターゲット名前空間が使用されます。
注 記 : プロセス内に複数の Web サービス受信アクティビティが存在する場合にこのフィー
ルドに入力しないと、システムがプロセスを検証できません。
受 信 Web サ ー ビ ス を 有 効 に す る に は
1. WSDL の [ターゲット名前空間 URI] を入力します。
2. [適用] をクリックします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
67
プロセス テンプレートを操作する
プロセス テンプレートを保存する
プロセス テンプレートが完成したら、それを検証およびインストールする前に保存する必要があり
ます。テンプレートを保存すると、変更がリポジトリにコピーされます。
保存するプロセスは、既存のテンプレートへの変更を保存するか、新しいテンプレートを保存する
か、またはテンプレートに新しい名前を付けて保存するかによって異なります。
既存のテンプレートへの変更を同じバージョンとして保存するには、テンプレートに対する書き込
みアクセス権が必要です。また、使用しているテンプレートの状態は、下書きまたは検証済みでな
ければなりません。[ファイル] メニューの [保存] オプションが使用できない場合は、テンプレートが
インストール済みであることを示している可能性があります。
テンプレートの現在の状態は、Process Builder のタイトル バーに表示されます。タイトル バーに
は、テンプレートがチェックアウトされているかどうかや、テンプレートが別のユーザによってチェッ
クアウトされている場合はそのロック所有者のユーザ名も表示されます。
Process Builder では、プロセス テンプレートに強制的に一意の名前を付けたり、特定のフォルダに
保存されるように設定したりすることができます。詳細については、「Process Builder の設定ファイ
ル (235ページ) 」を参照してください。ただしデフォルトでは、プロセス テンプレートはリポジトリの
任意の場所に保存できます。また、名前を一意にする必要があるのは各フォルダ内でのみです。
新しいプロセス テンプレートを保存する、または既存のテンプレートに新しい名前を付けて
保存するには
1. [ファイル] メニューの [名前を付けて保存] をクリックします。
Docbase に新規ドキュメントを保存するときに、[名前を付けてプロセス テンプレートを保存] ダ
イアログ ボックスが表示されます。
注 記 : 現在のプロセス テンプレートが新しい (一度も保存されたことがない) テンプレート
の場合は、[保存] を選択すると [名前を付けてプロセス テンプレートを保存] ダイアログ
ボックスが表示されます。
2. プロセス テンプレートの名前を入力します。
プロセス テンプレートの名前は 80 文字未満である必要があります。80 文字以上の名
前は、Business Activity Monitor で許可されず、プロセス監視が妨害されます。
3. テンプレートとそれに関連付けられたオブジェクトを格納するフォルダを作成するには、[関連す
る項目のための新しいフォルダを作成] チェックボックスがオンになっていることを確認します。
チェックボックスは、デフォルトでオンになっています。Process Builder によって、次の手順で選
択するフォルダの下にある、テンプレートと同じ名前のフォルダにテンプレートが保存されます。
チェックボックスがオフになっている場合は、[保存する場所] ダイアログ ボックスでテンプ
レートを保存するフォルダの名前が反転表示されるまでキャビネットとディレクトリをダブ
ルクリックし、そのフォルダに移動します。
ダイアログ ボックスの下部にあるテキスト ボックスにフォルダの完全なパスが表示されます。
4. [OK] をクリックします。
選択したフォルダに対して十分なアクセス権を持っている場合は、Process Builder によってテ
ンプレートとそのアクティビティが保存されます。
68
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
インストールおよび検証のプロンプトが表示されるように設定されている場合は、テンプレート
を検証するかどうかをたずねるダイアログ ボックスが表示されます。インストールおよび検証の
プロンプトを表示するかどうかは、[プレファレンス] ダイアログ ボックスで設定します。詳細につ
いては、「プロセス テンプレートのプロパティを設定する (56ページ) 」を参照してください。
5. プロセス テンプレートを検証するかどうかを選択します。
テンプレートの検証の詳細については、「プロセス テンプレートを検証する (70ページ) 」を参
照してください。テンプレートの検証を選択した場合、Process Builder によって検証が試行され
ます。検証が失敗した場合、それを通知するダイアログ ボックスが表示されます。検証の失敗
の原因となったエラーを表示するには、[詳細] ボタンをクリックします。
検証が正常に実行された場合、テンプレートをインストールして使用可能にするかどうかをた
ずねるダイアログ ボックスが表示されます。
6. プロセス テンプレートをインストールするかどうかを選択します。
テンプレートのインストールの詳細については、「プロセス テンプレートをインストール
する (71ページ) 」を参照してください。
チェックアウトしたプロセス テンプレートを保存する
チェックアウト済みの更新したプロセス テンプレートを保存するには
1. [ファイル] メニューの [保存] をクリックします。
現在のプロセス テンプレートが前に保存されていて、かつチェックアウトされている場合、保存
されているファイルが Process Builder によって更新されます。
テンプレートのチェックインの詳細については、「プロセス テンプレートをチェックインする
(74ページ) 」を参照してください。
2. 選択したフォルダに対して十分なアクセス権を持っている場合は、Process Builder によって
テンプレートとそのアクティビティが保存されます。インストールおよび検証のプロンプトが
表示されるように設定されている場合は、テンプレートを検証するかどうかをたずねるダイ
アログ ボックスが表示されます。
テンプレートの検証の詳細については、「プロセス テンプレートを検証する (70ページ) 」を
参照してください。
チェックアウトされていないプロセス テンプレートを
保存する
チェックアウトされていない更新したプロセス テンプレートを保存するには
1. 現在のバージョンに加えた変更内容を保存するには、[ファイル] メニューの [保存] を選
択するか、[保存] ボタンをクリックします。
2. [OK] をクリックします。
選択したフォルダに対して十分なアクセス権を持っている場合は、Process Builder によって
テンプレートとそのアクティビティが保存されます。インストールおよび検証のプロンプトが
表示されるように設定されている場合は、テンプレートを検証するかどうかをたずねるダイ
アログ ボックスが表示されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
69
プロセス テンプレートを操作する
3. プロセス テンプレートを検証するかどうかを選択します。
テンプレートの検証の詳細については、「プロセス テンプレートを検証する (70ページ) 」を参
照してください。テンプレートの検証を選択した場合、Process Builder によって検証が試行され
ます。検証が失敗した場合、それを通知するダイアログ ボックスが表示されます。検証の失敗
の原因となったエラーを表示するには、[詳細] ボタンをクリックします。
検証が正常に実行された場合、テンプレートをインストールして使用可能にするかどうかをた
ずねるダイアログ ボックスが表示されます。
4. プロセス テンプレートをインストールするかどうかを選択します。
テンプレートのインストールの詳細については、「プロセス テンプレートをインストールする
(71ページ) 」を参照してください。
プロセス テンプレートを検証する
テンプレートを検証して、テンプレートで定義されたプロセスがシステム条件を満たすことを確認し
ます。テンプレートを検証した場合にテンプレートにエラーがあると、[プロセス検証] タブが表示さ
れます。プロセス内にエラーがない場合、このタブは表示されません。そのままリポジトリにプロ
セスをインストールすることも、作業を続けることもできます。
テンプレートを検証できるのは、開いているテンプレートが下書き状態で、かつ書き込みアクセス
権がある場合のみです。
プロセス デバッガ内から検証プロセスを呼び出して両方のタブを同時に表示し、プロセスのト
ラブルシューティングを行うことができます。
このタブには、アクティビティ ツリーおよび各アクティビティに対応するエラー一覧が表示されま
す。ツリーに含まれるアクティビティのエラーをクリックすると、関連するアクティビティが設計キャン
バス内に開き、検証時にエラーを修正できます。各種操作ボタンを使用すると、ツリーを展開した
り折りたたむ、検証タブを閉じる、またはエラー ツリーのプレビューをテキスト ファイルにエクスポー
トすることなどの操作を行うことができます。このファイルには、検証ツリーをテキスト形式で表現し
たものが含まれており、テキスト エディタにコピーしたりシステム上の場所に保存したりできます。
プロセス テンプレートを検証して、以下を確認します。
• テンプレート内の参照アクティビティの名前が一意であること。
• 少なくとも 1 つの初期化アクティビティと 1 つだけの終了アクティビティがあること。
• 各アクティビティから終了アクティビティまでのワークフローのパスがあること。
• すべての参照オブジェクトがローカル オブジェクトとして存在すること。
• 自動アクティビティに、選択されているメソッドがあること。
プロセス テンプレートを検証するには、次の手順に従います。
1. [ツール] メニューの [プロセス テンプレート] を選択します。
2. [検証] を選択します。
プロセスにエラーがある場合は、[プロセス検証] タブが開き、そのプロセスのエラーの一
覧が表示されます。
3. 検証が正常に実行された場合、テンプレートをインストールして使用可能にするかどうかをた
ずねるダイアログ ボックスが表示されます。
70
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
さらに、インストールおよび検証のプロンプトが表示されるように設定してある場合は、テンプ
レートの保存時に、テンプレートを検証するかどうかを確認するダイアログ ボックスが表示され
ます。インストールおよび検証のプロンプトは、[テンプレートのプロパティ] ダイアログ ボックス
でオンまたはオフに設定します。詳細については、「プロセス テンプレートのプロパティを設
定する (56ページ) 」を参照してください。
プロセス テンプレートをインストールする
アクティブなワークフローでプロセス テンプレートを使用するには、あらかじめインストールしておく
必要があります。テンプレートをインストールできるのは、テンプレートが検証済み状態で、かつ
書き込みアクセス権がある場合のみです。開いているテンプレートの現在の状態は、[Process
Builder] ウィンドウのタイトル バーに表示されます。検証済みでない場合は、[ツール] メニューの
[プロセス テンプレート] > [検証] を選択してください。詳細については、「プロセス テンプレートを
検証する (70ページ) 」を参照してください。
インストールしたテンプレートに変更を加える場合は、まずそのテンプレートをアンインストール (71
ページ) する必要があります。そのテンプレートに基づくアクティブなワークフローは、すべて中止
されます。変更を加えた後で、テンプレートを検証してもう一度インストールします。
再インストールする場合は、テンプレートをアンインストールしたときに中止されたワークフローの
処理方法を選択できます。次の処理が可能です。
• 中止されたワークフローを、中止の時点から再開する
• ワークフローを強制停止する
どちらのオプションを選択するかは、ワークフローに加えた変更によります。たとえば、アクティビ
ティを削除したり、ワークフロー内のすべてのオブジェクトに対して実行するアクティビティを追加し
たり、移行条件を変更したとします。こうした場合はいずれも、ワークフローを強制停止してもう一
度開始します。実行中のワークフローを削除するには、ワークフローを強制停止し、オプションを
選択してから、Webtop の実行時オブジェクトを破棄します。既定の動作では、そのテンプレートを
参照しているすべての中止されたワークフローが再開されます。
プロセス テンプレートをインストールするには
1. [ツール] メニューの [プロセス テンプレート] > [インストール] を選択します。
[インストール] オプションが使用できない場合は、テンプレートが現在インストールされている
こと、または保存あるいは検証されていないことを示します。
2. このプロセス テンプレートを使ったワークフローの中に中止されたワークフローがある場
合、そのワークフローを再開するか停止するかを選択することができます。以下のいずれ
かをクリックします。
• 中止されたワークフローを再開するには [はい] をクリックします。 プロセス テンプレー
トに大きな変更を加えた後で、そのテンプレートを使用するワークフローを再開するとき、古
いプロセス テンプレートと変更後のプロセス テンプレートの間に矛盾がある場合は、ワー
クフローが未定義の状態に置かれる可能性があります。
• 中止されているワークフローを強制停止するには [いいえ] をクリックします。
プロセス テンプレートをアンインストールする
プロセス テンプレートをアンインストールするには
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
71
プロセス テンプレートを操作する
1. [ツール] メニューの [プロセス テンプレート] > [アンインストール] を選択します。
テンプレートをアンインストールできるのは、テンプレートがインストール済み状態で、かつ
書き込みアクセス権がある場合のみです。
このテンプレートに基づいたワークフローを実行しているユーザがいる場合は、アクティブな
ワークフロー インスタンスがあることを示す警告メッセージが表示されます。
2. この警告メッセージが表示された場合は、[はい] をクリックするとワークフローが中止され、[い
いえ] をクリックするとアンインストール処理がキャンセルされます。
3. [はい] をクリックして、このプロセス テンプレートとそのすべてのアクティビティをアンインス
トールします。
4. 処理の完了を通知するメッセージ ボックスの [OK] をクリックして、このメッセージ ボック
スを閉じます。
プロセス テンプレートを変更する
プロセス テンプレートは、そのプロセス フローまたはアクティビティ定義を変更することによっ
て変更できます。プロセス テンプレートを変更する場合は、既存のテンプレートに変更を上書
きすることも、そのテンプレートの新しいバージョンを作成することもできます。行う変更はすべ
て、オブジェクトレベルのアクセス許可によって管理されます。
プロセス テンプレートに変更を行い、新しいバージョンを作成しないで変更したものを保存するに
は、そのテンプレートをアンインストールする必要があります。テンプレートをアンインストールする
には、テンプレートに対する [関連付け] アクセス権か、システム管理者またはスーパーユーザ権
限が必要です。変更を保存するには、[書き込み] アクセス権が必要です。
プロセス テンプレートの新しいバージョンを作成するには、そのテンプレートを変更する前に
チェックアウトする必要があります。少なくとも、そのテンプレートの [バージョン] アクセス権を持っ
ている必要があります。現在のバージョンをアンインストールせずに、テンプレートの新しいバー
ジョンを作成できます。プロセス テンプレートの新しいバージョンを作成することによって、テンプ
レートの旧バージョンに基づいた実行中のワークフローが影響を受けることはありません。
変更を保存またはチェックインすると、その新バージョンが下書き状態になります。新バージョン
は、それに基づいたワークフローを開始する前に、検証およびインストールする必要があります。
「プロセス テンプレートを保存する (68ページ) 」も参照してください。
プロセス テンプレートのチェックイン、チェックアウト、
およびバージョン管理を行う
既存のプロセス テンプレートをロックして編集する場合は、Process Builder を使用してそのプロセ
ス テンプレートをチェックアウトします。編集目的でプロセスを開くとシステムによってファイルが
ロックされ、他のユーザが変更できないようになります。編集が終わってから、変更したプロセ
ス テンプレートをチェックインするときに、バージョン ラベルを編集してプロセス テンプレートに
対するすべての変更の履歴を残します。また、チェックインにより、テンプレートがアンロックさ
れ、他のユーザが変更できるようになります。
72
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
プロセス テンプレートがチェックアウトされると、[プロセス テンプレートを開く] ダイアログ ボックス
内のアイコンが、別のユーザによってロックされていることを反映します。ロックの所有者のユーザ
名を表示するには、カーソルをそのアイコン上に置きます。
表6
プロセス テンプレートの状態と関連アイコン
状態
アイコン
このユーザによって
チェックアウトされていま
す (ロック済)
チェックイン済 (ロック解
除済)
テンプレートを新規作成すると、必ずバージョン番号 1.0 が割り当てられます。テンプレートを編集
した後チェックインするときに、そのファイルを新しいバージョンとしてチェックインするか、同じバー
ジョンとしてチェックインするかを選択できます。テンプレートをリポジトリにチェックインするときに
は、バージョン番号を整数で増加させるか、小数点以下で増加 (0.1 ずつ増加) させるかを選択で
きます。整数でのバージョン番号の増加はメジャー改訂と見なされ、小数点以下での増加はマ
イナー改訂と見なされます。一番最近チェックインされたファイルには、「CURRENT」のマーク
が付きます。バージョン番号を増加させずにファイルをチェックインする場合は元のテンプレー
トと同じバージョン番号が維持され、変更を加えた元のファイルで上書きされて「CURRENT」
とラベル付けされます。テンプレートをチェックアウトする場合は、現在のバージョンのみ表示
するか、すべてのバージョンを表示するかを選択できます。
Process Builder を使用してプロセスをリポジトリにチェックインしたりリポジトリからチェックアウトする
操作は、他の Documentum アプリケーションでドキュメントをチェックインまたはチェックアウトする
操作とほとんど変わりません。ただし重要な相違点が 1 つあります。それは、プロセス テンプレート
をインストールしてチェックアウト時に使用できることです。既存のテンプレートを編集して同じバー
ジョン (「CURRENT」) として保存する場合は、最初にそのテンプレートをアンインストールする必
要があります (この操作によって、実行環境にあるテンプレートのすべてのインスタンスが停止
します)。これにより、実行環境で使用中のテンプレートは変更できないようになります。プロセ
ス テンプレートをアンインストールした後は、そのテンプレートを編集して同じバージョンとして
チェックインし、検証してからインストールすることができます。
注 記 : テンプレートのアンインストール中は、ワークフローの実行中のすべてのインスタン
スが停止され、新しいインスタンスを起動することはできません。テンプレートを再度インス
トールしたら、テンプレートに加えた変更の複雑度に応じて、停止されたインスタンスを
キャンセルするか再開するかを選択できます。既存のテンプレートを編集する場合、イン
スタンスによって現在使用されていないアクティビティ プロパティをごく一部変更するか、
またはインスタンスの今後のアクティビティに関連した変更のみ行うようにしてください。
実行中のワークフローを削除するには、ワークフローを強制停止し、オプションを選択
してから、Webtop の実行時オブジェクトを破棄します。
インストール済みのテンプレートをアンインストールしないでチェックアウトすると、プロセスの実行中
のインスタンスは、(「CURRENT」とラベル付けされた) テンプレートの既存のバージョンを使用して
引き続き実行されます。編集中のテンプレートのバージョンは下書きとして開かれ、そのテンプレー
トの保存またはチェックインは、新しいマイナー バージョンまたはメジャー バージョンとしてしか実
行できません。新しいバージョンのテンプレートがチェックイン、検証、およびインストールされた後
は、実行環境で使用できます。前のバージョンを使用して作成されたプロセス インスタンスはすべ
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
73
プロセス テンプレートを操作する
て、完了するまで引き続き実行されます。バージョンの使用方法の詳細については、『Documentum
Administrator User Guide (Documentum Administrator ユーザ ガイド)』を参照してください。
チェックアウトをキャンセルするとプロセス テンプレートがアンロックされ、チェックアウト中にそのテ
ンプレートに対して行った変更はすべて破棄されます。リポジトリには、前のバージョンのテンプ
レートが現在のバージョンとして保持されます。
プロセス テンプレートをチェックアウトする
プロセス テンプレートをチェックアウトするには
1. [ファイル] メニューの [開く] を選択して、[プロセス テンプレートを開く] ダイアログ ボックス
を表示します。
注記: エディタ ペインですでに開いているプロセスをチェックアウトする場合は、
るか、または [ファイル] メニューの [チェックアウト] を選択します。
をクリックす
2. [表示] ボックスで次のいずれかを実行します。
• 既存のすべてのバージョンを表示するには、[全バージョンを表示] を選択する
• 「CURRENT」とラベル付けされたテンプレートのバージョンだけ表示するには、
[現在のバージョンを表示] を選択する
3. [プロセス テンプレートを選択] ボックスで、目的のテンプレートに移動して選択します。
テンプレートが別のユーザによってチェックアウトされている場合、テンプレート名の横
に鍵のアイコンが表示されます。ロック所有者がそのテンプレートをチェックインするま
では、読み取り専用バージョンを表示することしかできません。
4. テンプレートを開いたときにチェックアウトする場合は、[オープン時にプロセスをチェッ
クアウト] を選択します。
注記: テンプレートがインストール済みの場合、最初にテンプレートをアンインストールするか、
またはアンインストールしないでチェックアウトを続行するか、いずれかを選択するよう求めるメッ
セージが表示されます。インストールされているテンプレートは下書きとして開かれ、新しいメ
ジャー バージョンまたはマイナー バージョンとしてしか保存できません。テンプレートの既存の
バージョンに変更を加えるには、チェックアウトの前にアンインストールしておく必要があります。
5. [開く] をクリックして、エディタ ペインでテンプレートのロックされたバージョンを開きます。
Process Builder のタイトル バーに表示されるテンプレートの状態が、[チェックアウ
ト] に変わります。
プロセス テンプレートをチェックインする
プロセス テンプレートをチェックインするには
1.
のアイコンをクリックするか、[ファイル] メニューの [チェックイン] を選択します。[プロセス テ
ンプレートのチェックイン] ダイアログ ボックスが表示されます。
2. 新しいプロセスを保存するオプションとして、[同じバージョン]、[マイナー バージョン]、ま
たは [メジャー バージョン] を選択します。
テンプレートを同じバージョンとしてチェックインすると、現在のバージョンに対して変更
を加えることになります。
74
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
注 記 : インストール済みのテンプレートに変更を加えた場合、そのテンプレートはマイナー
バージョンまたはメジャー バージョンとしてのみ保存できます。現在のバージョンを上書きする
とプロセスの実行中のインスタンスが影響を受けるため、この場合同じバージョンでチェッ
クインするオプションは選択できません。
3. 必要に応じて、新しいバージョンの説明ラベルを入力します。
4. [OK] をクリックします。
チェックアウトをキャンセルする
この手順は、変更内容を保存しないでテンプレートをリポジトリに再度チェックインする
場合に使用します。リポジトリ内にある「CURRENT」とラベル付けされた既存のバー
ジョンは変更されません。
プロセス テンプレートのチェックアウトをキャンセルするには
1.
のアイコンをクリックするか、[ファイル] > [チェックアウトのキャンセル] を選択します。[チェッ
クアウトのキャンセル] ダイアログ ボックスが表示されます。
テンプレートに対して行ったすべての変更が失われることを警告するメッセージ
が表示されます。
注 記 : スーパーユーザは、他のユーザによってロックされているテンプレートのチェックアウ
トをキャンセルできます。
2. [はい] をクリックして、チェックアウトをキャンセルします。
プロセス テンプレートを削除する
プロセス テンプレートを削除するオプションは、プロセス テンプレートを Process Builder で開
いているときに限り使用できます。
プロセス テンプレートを削除するには
1. [ツール] メニューの [プロセス テンプレート] > [プロセスの削除] を選択します。
テンプレートが現在インストール済み状態の場合、削除を実行する前にアンインストールする
よう求めるメッセージが表示されます。さらに、このテンプレートに基づいたワークフローを
実行しているユーザがいる場合は、アクティブなワークフロー インスタンスがあることを示す
警告メッセージも表示されます。
2. プロセス テンプレートをアンインストールして、そのテンプレートおよび関連するアクティビティ
を削除するには、[はい] をクリックします。
プロセス テンプレートをインポートする
プロセスのインポートでは、エクスポートされた XPDL ファイルを取り込んで Process Builder また
は Process Analyzer で操作できるようにします。インポート時に自動および手動アクティビティ
タイプは維持されますが、メソッドやタイマなどの定義は Process Builder で追加する必要があ
ります。パッケージはプロセスのインポートに含まれません。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
75
プロセス テンプレートを操作する
また、複数の終了アクティビティが含まれているプロセスを Process Analyzer からインポート (または
再インポート) すると、Process Builder によってすべての終了アクティビティを接続する空のアクティ
ビティが追加されます。これは、Process Analyzer からエクスポートされたプロセスに複数の終
了アクティビティが含まれている場合があるのに対して、Process Builder でサポートされる終了
アクティビティは 1 つだけであるためです。
注 記 : インポートされた XPDL 内に意味解析上のエラーがある場合、システムは新しいプ
ロセス テンプレートを無効な状態で保存します。各検証エラー メッセージに示されている
情報を使用してエラーを修正し、プロセス テンプレートを検証してインストールします。
Process Builder に プ ロ セ ス テ ン プ レ ー ト を イ ン ポ ー ト す る に は
1. [ファイル] メニューの [インポート] > [XPD ] クリックします。
[プロセスのインポート] ダイアログ ボックスが表示されます。
2. インポートするファイルの名前が反転表示されるまで [プロセスのインポート] ダイアログ ボック
スに表示されているディレクトリをダブルクリックして、そのファイルに移動します。
3. [開く] をクリックします。
Process Builder によって、Process Analyzer プロセスを基に新しいドラフト プロセス
テンプレートが作成されます。
アクティビティのロケーション情報が使用可能な場合は、インポートしたプロセス テンプレートに適
用されます。使用できない場合は、デフォルトのレイアウトおよびグラフィック ディスプレイ設定が
使用されます。グラフィックスやイメージなどのユーザ インターフェイス情報はプロセスと共にエク
スポートされないため、Process Builder で作成し直す必要があります。
次に、アクティビティ インスペクタを使用してプロセスの実行情報を定義する必要があります。
アクティビティの実行の詳細を定義する方法については、「プロセス テンプレートをインストールす
る (71ページ) 」を参照してください。
プロセス テンプレートをエクスポートする
Process Builder または Process Analyzer からプロセスをエクスポートすると、XPDL (XML Process
Definition Language) ファイルが作成され、ファイル システムの指定した場所に保存されます。この
ファイルを Process Analyzer または Process Builder にインポートできます。Process Builder からエク
スポートしたテンプレートには、Process Analyzer で対応するビジネス オブジェクトを作成するため
に使用するタイプの定義が含まれています。エクスポートした XPDL にはまた、BAM レポート用と
して識別されたアクティビティに関する情報も含まれています。
Process Builder か ら プ ロ セ ス を エ ク ス ポ ー ト す る に は
1. [ファイル] メニューの [エクスポート] > [XPDL] をクリックします。
[プロセスのエクスポート] ダイアログ ボックスが表示されます。
2. エクスポートするファイルの保存先フォルダが反転表示されるまで、[プロセスのエクスポート] ダ
イアログ ボックスに表示されているディレクトリをダブルクリックして、そのフォルダに移動します。
3. [保存] をクリックします。
76
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
共有プロセスを同期する
ビジネス プロセスは Process Builder または Process Analyzer のどちらでも共有および変更できま
す。2 つのアプリケーション間でプロセスを同期させるには、変更したプロセスをそのネイティブ ア
プリケーションに再インポートする必要があります。
Process Analyzer プロセスをエクスポートし、Process Builder にインポートして変更できます。たとえ
ば、Process Builder を使用して実行詳細の定義、新しいアクティビティの追加、またはアクティビ
ティの順序変更を行います。これらの変更の結果、ビジネス アナリストは Process Analyzer でもう
一度プロセスを確認したり、変更したビジネス プロセスのシミュレーションを実行したりします。
Process Builder で変更したプロセスを再インポートすると、Process Analyzer で元のプロセスが更新
され、両方のアプリケーション間でプロセスを同期させることができます。
既存の Process Builder プロセスをそのネイティブ アプリケーションからエクスポートし、Process
Analyzer にインポートして変更できます。たとえば、ビジネス アナリストはアクティビティの順序変
更、追加、または削除を行うことができます。新しく変更されたプロセスをそのプロセスの実行可能
モデルと同期させるには、Process Builder に再インポートする必要があります。再インポート時
に、バージョン管理機能を利用して、プロセスを同じバージョン、マイナー バージョン、またはメ
ジャー バージョンとして保存するオプションが用意されています。
変 更 し た ビ ジ ネ ス プ ロ セ ス を Process Builder に 再 イ ン ポ ー ト す る に は
1. Process Analyzer からプロセスをエクスポートします。
2. エクスポートしたプロセスを選択して Process Builder にインポートします。
Process Builder にプロセスをインポートする手順については、「プロセス テンプレー
トをインポートする (75ページ) 」を参照してください。
3. [ファイル] メニューの [保存] をクリックします。
[プロセス テンプレートのチェックイン] ダイアログ ボックスに、リポジトリでそのプロセス
の既存のバージョンが検出されたことを示すメッセージが表示されます。
4. 新しいプロセスを保存するオプションとして、[同じバージョン]、[マイナー バージョン]、ま
たは [メジャー バージョン] を選択します。
新しいプロセスがそのプロセスの現在のバージョンになり、古いバージョンは履歴のために残り
ます。前のバージョンを使用して作成されたプロセス インスタンスはすべて、引き続き前の
バージョンのプロセス テンプレートを使用して実行されます。
また、プロセスがメジャー バージョンまたはマイナー バージョンとしてチェックインされると、
Process Builder では、リポジトリ内に新しいバージョンのプロセスがある場合、それより古いバー
ジョンを保存できなくなります。たとえば、リポジトリにプロセスのバージョン 1.1 が既に存在す
る場合は、そのプロセスのバージョン 1.0 をインポートしても保存できません。古いバージョ
ンは、名前を変更して、別のプロセスとして保存できます。
ビジネス プロセスのバージョンがまだインストールされていない場合は、同じバージョンと
してのみ保存できます。そのビジネス プロセスの既存のバージョンがインストールされてい
る場合は、同じバージョンとして保存できません。変更されたバージョンとしてプロセスを保
存する必要があります。
5. [OK] をクリックします。
選択したフォルダに対して十分なアクセス権を持っている場合は、Process Builder に
よってテンプレートとそのアクティビティが保存されます。インストールおよび検証のプ
ロンプトが表示されるように設定されている場合は、テンプレートを検証するかどうかを
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
77
プロセス テンプレートを操作する
たずねるダイアログ ボックスが表示されます。テンプレートの検証の詳細については、
「プロセス テンプレートを検証する (70ページ) 」を参照してください。
6. オプションで、プロセス テンプレートをインストールできます。
テンプレートのインストールの詳細については、「プロセス テンプレートをインストールする
(71ページ) 」を参照してください。
プロセス テンプレートを印刷する
プロセス テンプレートはいつでも印刷できます。
プロセス テンプレートを印刷するには
1. 印刷するプロセス テンプレートを開きます。
2. ページ設定オプションが適切に設定されていることを確認します。
これらのオプションの詳細については、「ページ印刷オプションをセットアップする
(78ページ) 」および「印刷されるプロセスをプレビューする (79ページ) 」を参照してく
ださい。
3. ツールバーのテンプレートのレイアウトの印刷アイコンをクリックするか、[ファイル] メニュー
の [印刷] を選択します。
4. [名前] ボックスから印刷するプリンタの名前を選択します。
5. プリンタのプロパティを変更するには、[プロパティ] をクリックし、設定を更新します。
プリンタのプロパティの詳細については、プリンタのドキュメントを参照してください。
6. プロセス テンプレートをプリンタで印刷するのではなく、ファイルに出力する場合は、[ファイル
へ出力] チェックボックスをオンにします。
7. 複数の部数のプロセス テンプレートを印刷するには、[部数] ボックスに印刷部数を入力します。
注 記 : [印刷範囲] ボックスのコントロールは [すべて] 以外は使用できません。テンプレート全
体の印刷のみが可能で、テンプレートの一部だけ印刷することはできません。
8. [OK] をクリックします。
ファイルに出力することを選択すると、[ファイルへ出力] ダイアログ ボックスが表示され
ます。それ以外の場合、プロセス テンプレートは選択したプリンタに出力されます。
9. [ファイルへ出力] ダイアログ ボックスで、作成するファイルの名前をフル パスを含めて入
力します。
ページ印刷オプションをセットアップする
ページ設定オプションによって、プロセス テンプレートの印刷方法が決まります。
ページ設定オプションを設定するには
1. [ファイル] メニューの [ページ設定] をクリックします。
[ページ設定] ダイアログ ボックスが表示されます。
2. プロセス テンプレートの印刷用の用紙サイズを選択します。
78
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートを操作する
[用紙] ボックスに、6 つの標準サイズが表示されます。各形式のサイズは、[余白] フィールド
で選択した単位に応じて、インチまたはセンチメートルで表示されます。用紙サイズのオプ
ションは次のとおりです。
• US Letter (8.5 x 11 インチ)
• US Legal (8.5 x 14 インチ)
• US Executive (7.25 x 10.5 インチ)
• A3 (29.69 x 42.01 センチメートル)
• A4 (21 x 29.7 センチメートル)
• A5 (14.8 x 21 センチメートル)
3. 縦と横のどちらの向きで印刷するのかを指定します。
4. 印刷ページの余白を入力します。
サイズは、1.25 インチ、4.44 センチメートルなどのようにインチまたはセンチメートル
で小数点以下 2 桁まで入力できます。
5. [OK] をクリックしてページ設定オプションを保存し、このダイアログ ボックスを終了するか、[印
刷] をクリックしてこれらの設定で現在のテンプレートを印刷します。
印刷されるプロセスをプレビューする
[印刷プレビュー] オプションによって、印刷されるイメージをグラフィック表示することができます。
印刷フォーマットを表示するには
1. [ファイル] メニューの [印刷プレビュー] をクリックします。
[印刷プレビュー] ダイアログ ボックスが表示されます。右側のボックスには、プロセ
ス テンプレートの印刷イメージが表示されます。これはページがどのように印刷され
るかを表すものです。このレイアウトは、ページ設定オプション (78ページ) と [印刷
サイズ] オプションでの設定内容に基づいています。
2. プロセス テンプレートの印刷出力のサイズを設定します。
[印刷サイズ] のオプションは次のとおりです。
• [実際のサイズ] - 印刷出力は、Process Builder のプロセス テンプレートの表示と同じサ
イズになります
• [用紙に合わせる] - プロセス テンプレートのサイズは、手順 2 と 3 で指定したサイズと向
きに収まるように調整されます。
• [次に合わせる] - プロセス テンプレートのサイズは、縦と横に指定した枚数のページに収ま
るように調整されます。このオプションを選択した場合は、横にある 2 つのテキスト ボックス
それぞれに数値を入力する必要があります。
3. [OK] をクリックして [印刷サイズ] オプションを保存し、このダイアログ ボックスを終了するか、
[印刷] をクリックしてこれらの設定で現在のテンプレートを印刷します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
79
第4章
アクティビティを接続する
この章では、 次のトピックについて説明します。
•
接続アクティビティの概要
•
フローの表示設定を変更する
接続アクティビティの概要
ワークフロー内のアクティビティを接続するフロー行は、ワークフローで送信されるドキュメントまた
はオブジェクトのフローを表します。フローを使用すると、接続されたアクティビティ間でパッケー
ジ、そのプロパティ、および依存関係を移動できるようになります。フローの詳細については、「プ
ロセス テンプレートと関連するワークフロー オブジェクト (11ページ) 」を参照してください。
テンプレートにフローを追加した後で、フロー設定を使用してフローを設定します。フロー インスペ
クタを開くには、プロセス テンプレート エディタ ペインでフローをダブルクリックするか、1 つまたは
複数のフローを選択して [ツール] メニューの [フロー インスペクタ] をクリックします。
フロー インスペクタでは、プロセス テンプレートの表示画面上でのフローの表示方法を制御しま
す。詳細については、「フローの表示設定を変更する (82ページ) 」を参照してください。
設定しているフローの名前が、フロー インスペクタの上部のテキスト ボックスに表示されます。複
数のフローを選択した場合は、テキスト ボックスの横に矢印ボタンが表示され、選択したフローを
スクロールすることができます。ここで設定する内容は、[選択したすべてに適用] オプションを選
択しない限り、このボックスに名前が表示されているフローだけに適用されます。
複数のフローを選択した場合、フロー インスペクタのそれぞれのタブに、[選択したすべてに
適用] というラベルが付いた 1 つまたは複数のチェックボックスが表示されます。このチェック
ボックスをオンにすると、Process Builder によって、上部のテキスト ボックスに名前が表示されて
いるフローだけではなく、選択したすべてのフローに対して、関連する設定 (つまり、チェック
ボックスの右側に表示される設定) が適用されます。チェックボックスがオンになっていない設
定は、現在のフローにしか適用されません。
フローを作成する
[Process Builder] ツールバーにある 4 つのフローの作成アイコンのうちの 1 つを使用して、アク
ティビティ間を接続します。
• データの前方向にアクティビティを接続するには、単一セグメント フローの作成アイコン
か、
複数セグメント フローの作成アイコン
をクリックします。この 2 つの違いは視覚的に表されま
す。前者ではアクティビティ間のフローを表す 1 本の直線が描画され、後者では複数のセ
グメントから成る 1 本の線が描画されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
81
アクティビティを接続する
• データの後方向にアクティビティを接続するには、元に戻すフローの作成アイコン
をク
リックします。拒絶フローは、アクティビティのユーザが処理対象のオブジェクトを却下した
場合にとられるパスを表します。
• 自動アクティビティを障害対処アクティビティに接続するには、障害対処の指定アイコン
をク
リックします。障害対処を使用すると、自動アクティビティが失敗した場合に二次エラーを処理す
るアクティビティを自動アクティビティに対して指定することができます。障害対処アクティビティで
は、自動アクティビティと関連付けられた障害対処の間に、フローを表す破線が表示されます。
「プロセス テンプレートと関連するワークフロー オブジェクト (11ページ) 」は、さまざまな種類
のフローを示しています。
フローの表示設定を変更する
[表示] タブのオプションで、プロセス テンプレートの画面にフローをどのように表示するか
を制御します。
注 記 : [表示] タブのオプションで、フロー行を BPMN スタイルのダイヤモンドから開始するか
どうかは制御できません。フローにダイヤモンドを使用するのは、元のアクティビティが条件分
岐ロジックを使用して次のアクティビティを選択する場合です。詳細については、「アクティビ
ティ移行規則を設定する (118ページ) 」を参照してください。
フローの表示設定を変更するには
1. フロー インスペクタで [表示] タブを選択します。
2. フロー行を、接続されたアクティビティ間を直線で結ぶ [単一行] として表示するか、垂直また
は並行の複数のセグメントを持つ [複数セグメント行] として表示するかを指定します。
一般的に、ユーザには複数セグメント行のあるフローの方がたどりやすくなります。
3. フローで送信するパッケージの名前またはフローのラベルの表示に使用するフォントとスタ
イルを設定します。
この設定は、次の手順 4 でパッケージ名の表示を選択する場合、または対象のフロー
セグメントのカスタム ラベルを入力する場合にのみ必要です。
a. [ラベルのフォント] リストからフォントを選択します。
b. [フォント サイズ] ドロップダウン リストからフォント サイズを選択します。
c. アクティビティのラベルのフォント スタイルを設定するには、[太字] と [斜体] をオンま
たはオフにします。
4. プロセス テンプレート エディタ表示でフローのラベルを表示する方法を指定します。
a. [ラベルを表示] チェックボックスをオンにするとフローのラベルが表示され、オフにするとフ
ローのラベルは表示されません。チェックボックスをオフにした場合、その下にある 2 つ
のラジオ ボタンは使用できなくなります。
b. [宛先アクティビティでパッケージを表示] を選択し、次のアクティビティで処理されるパッ
ケージの名前をフローにラベル付けします。また、[カスタム ラベル] を選択して、隣のテキ
スト ボックスにラベル テキストを入力します。
5. [適用] をクリックしてフロー インスペクタを閉じずに更新を保存するか、[OK] をクリックして更
新を保存してフロー インスペクタを閉じます。
82
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
第5章
サブプロセスを作成する
この章では、 次のトピックについて説明します。
•
サブプロセスの概要
•
トップダウン モデリングを使用してサブプロセスを作成する
•
ボトムアップ モデリングを使用してサブプロセスを作成する
•
サブプロセスのプロパティを設定する
•
タイ マ ] タ ブ を 使 用 す る
[タ
•
表示 ] タ ブ を 使 用 す る
[表
•
サブプロセスの展開および折りたたみを行う
•
サブプロセスからアクティビティを削除する
•
サブプロセスにメモを追加する
•
サブプロセスおよびそのコンテンツを削除する
サブプロセスの概要
サブプロセスを使用すると、プロセス テンプレートのビジネス上の意味を伝えやすくなります。大規
模なプロセスや複雑なプロセスは、ワークフロー全体を完了するために多数のアクティビティが
必要になると、視覚的に整理するのが難しくなることがあります。プロセスのレイアウトを簡略化
するには、関連するアクティビティを、ビジネス プロセスを集合的に表すサブプロセスにグルー
プ化することが必要になる場合があります。
Process Builder では、サブプロセスを展開して個々のアクティビティを表示したり、サブプロセスを
折りたたんでより簡略化したプロセスの概要を作成したりできます。プロセスには、何らかの関
連があり、管理しやすくするためにコンテナにグループ化されるアクティビティが含まれていま
す。これは、ビジネス上の機能やプロセスの論理的なステップを集合的に表す一連のアクティビ
ティをグループ化する場合に特に便利です。同じプロセス データを共有するアクティビティを、1
つのサブプロセスにまとめることもできます。
サブプロセスに関連付けられる入力フローや出力フローの数に制限はありません。フローは、サブ
プロセス コンテナではなく、コンテナ内の各アクティビティに接続されます。
サブプロセスは、BAM レポート データに含まれます。プロセスに対して監査記録が有効になっ
ている場合は、エントリと終了のデータが BAM レポート データベースに送信されます。また、
サブプロセスに含まれているアクティビティ テンプレートも、レポート用に選択されている場合
はレポート データを発行します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
83
サブプロセスを作成する
トップダウン モデリングを使用してサブプロセスを
作成する
トップダウン モデリングは、最初に空のサブプロセスを作成してから、各アクティビティを定義する
ときにサブプロセスに追加する方法です。この方法は、まずプロセスの大まかな概要を設計し、そ
の後の開発段階で詳細を決めていくような場合に最適です。
既存のアクティビティを選択してサブプロセスを作成するには、次の手順に従います。
1. [サブプロセスの作成] アイコンを選択し、プロセス テンプレート エディタ ペイン内でサブプ
ロセスを表示させる場所をクリックします。
新しい空のサブプロセスが、「サブプロセス」というラベルが付いた色付きの四角形
で表示されます。
2. サブプロセスをクリックして、プロセス エディタ ウィンドウ内の目的の位置にドラッグします。
3. サブプロセスを右クリックして [サブプロセス インスペクタ] を選択し、このサブプロセス内のす
べてのアクティビティで共有するプロパティを設定します。
これらのプロパティの設定手順については、「サブプロセスのプロパティを設定する
(85ページ) 」を参照してください。
4. プラス記号 ([+]) をクリックしてサブプロセスを展開します。
必要に応じて、サブプロセスの境界線を選択してドラッグするとサブプロセスの枠
を大きくすることができます。
5. グループに含める各アクティビティを、サブプロセス コンテナにドラッグします。
アクションを確認するメッセージが表示されます。ウィンドウ内の別の位置にサブプロセ
スを移動した場合は、サブプロセスに含まれるアクティビティも一緒に移動されます。
6. 個々のフロー行を作成し、プロセス フローのすべてのアクティビティを接続します。
フロー行は、サブプロセス コンテナではなく、サブプロセス内の各アクティビティに
接続されます。サブプロセスの境界から出たり入ったりする入力フローや出力フ
ローの数に制限はありません。
ボトムアップ モデリングを使用してサブプロセスを
作成する
ボトムアップ モデリングは、ビジネス プロセスとそのすべてのアクティビティを作成した後
で、関連するアクティビティをサブプロセスにまとめる方法です。この方法では、必要なす
べてのアクティビティを最初に作成し、サブプロセスにグループ化してから、よりコンパクト
で単純なフローを表示するためにそれらのサブプロセスを折りたたむことができます。
既存のアクティビティを選択してサブプロセスを作成するには
1. サブプロセスに含めるアクティビティを選択します。
複数のアクティビティを選択する場合は、サブプロセスに追加するアクティビティを
囲む四角形をマウスでドラッグするか、Shift キーを押しながら個々のアクティビティ
をクリックします。
選択したアクティビティは緑色の破線で囲まれます。
84
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
サブプロセスを作成する
2. [ツール] > [サブプロセス] > [サブプロセスに追加] を選択します。
選択されたアクティビティが、「サブプロセス」というラベルが付いた色付きの四角形
で表示されます。
3. サブプロセスを右クリックして [サブプロセス インスペクタ] を選択し、このサブプロセス内のす
べてのアクティビティで共有するプロパティを設定します。
これらのプロパティの設定手順については、「サブプロセスのプロパティを設定する
(85ページ) 」を参照してください。
4. 新しいサブプロセスをクリックして、ウィンドウ内の目的に位置にドラッグします。
サブプロセスのプロパティを設定する
サブプロセスのプロパティを設定するには
1. サブプロセスを右クリックします。
2. [サブプロセス インスペクタ] を選択し、サブプロセス内のすべてのアクティビティで共有する
プロパティを設定します。
サブプロセスのプロパティは、アクティビティのプロパティとは独立しています。
[サブプロセス インスペクタ] を使用して、サブプロセスを表示するオプションとともに、サブ
プロセスのタイマを設定することもできます。
タイ マ ] タ ブ を 使 用 す る
[タ
Process Builder では、サブプロセスに対して次の 2 種類の警告タイマがサポートされています。
• 事前タイマ。ワークフローの開始後、指定された時間以内にアクティビティがトリガされなかっ
た場合に起動されます。
アクティビティは、ワークフローによって作成されていれば、必ずしもユーザによって取得されて
いなくても、起動されたと見なされます。事前タイマは、ワークフローの開始時に自動的に起動
されるため、ワークフローの最初のアクティビティで有効にされません。
• 事後タイマ。アクティビティの開始後、指定された時間以内にそのアクティビティが完了しなかっ
た場合に起動されます。
ワークフロー タイマの詳細については、「タイマを設定する (30ページ) 」を参照してください。
サブプロセスに 1 つまたは複数のタイマのアクションが設定されている場合、サブプロセスの右下
の隅に小さな時計アイコンが表示されます。
表示 ] タ ブ を 使 用 す る
[表
[表示] タブのオプションで、プロセス テンプレートの画面にアクティビティをどのように表示す
るかを制御します。
注 記 : アクティビティに 1 つまたは複数のタイマのアクションが設定されている場合、サブプロセ
ス コンテナの右下隅に小さな時計アイコンが表示されます。
1. [サブプロセス インスペクタ] で、[表示] タブをクリックします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
85
サブプロセスを作成する
2. テンプレートでアクティビティのラベルに使用するフォントとスタイルを設定します。
[ラベルのフォント] リストからフォントを選択します。
[フォント サイズ] ドロップダウン リストからフォント サイズを選択します。
アクティビティのラベルのフォント スタイルを設定するには、[太字] と [斜体] をオ
ンまたはオフにします。
3. サブプロセス フォームの背景色を [背景色] フィールドから選択します。
4. [適用] をクリックして [サブプロセス インスペクタ] を閉じずに更新を保存するか、[OK] をクリッ
クして更新を保存して [サブプロセス インスペクタ] を閉じます。
サブプロセスの展開および折りたたみを行う
サブプロセスを展開したり折りたたんだりして、サブプロセスの内容の表示と非表示を切り
替えることができます。各サブプロセスを展開する場合は、プラス記号 をクリックするとサ
ブプロセスの枠が大きくなり、その内容が展開されて個々のアクティビティが表示されるよう
になります。テンプレートのすべてのサブプロセスを展開する場合は、[ツール] > [サブプ
ロセス] > [すべて展開する] を選択すると、すべてのサブプロセスの内容が表示されます。
サブプロセスを個別に折りたたむ場合は、マイナス記号 をクリックするとサブプロセスが最小化
され、その内容が表示されなくなります。テンプレート内のすべてのサブプロセスを折りたたむに
は、[ツール] > [サブプロセス] > [すべて折りたたむ] を選択します。
サブプロセスを折りたたむと、そのサブプロセスに含まれているアクティビティは表示されなくなりま
す。折りたたんだサブプロセスをプロセス テンプレート エディタ内の別の位置にドラッグすると、フ
ロー行の長さがその位置に合わせて自動的に調節されます。折りたたんだサブプロセスにアク
ティビティをドラッグすることはできません。
サブプロセスからアクティビティを削除する
サブプロセスの完全な状態を維持しながら、サブプロセスからアクティビティを削除できま
す。サブプロセス内の 1 つ以上のアクティビティを選択します。
サブプロセスからアクティビティを削除するには
1. サブプロセス内にあるアクティビティまたはアクティビティのセットを選択します。
2. [ツール] > [サブプロセス] > [サブプロセスから削除する] を選択します。
アクティビティがサブプロセスから完全に削除されることを確認するメッセージが表
示されます。
3. アクティビティをキャンバス上の新しい場所にドラッグします。
サブプロセスにメモを追加する
プロセス テンプレートの視覚的なレイアウトにテキストを追加するには、メモを使用します。
サブプロセスにメモを追加するには、展開したサブプロセスを選択し、メモ アイコンをクリックしてか
ら、サブプロセスの枠内をクリックします。プロセス テンプレート エディタ内でメモを作成し、そ
のメモをサブプロセスにドラッグすることもできます。サブプロセスが折りたたんである場合はメ
86
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
サブプロセスを作成する
モは表示されず、展開すると表示されます。プロセス テンプレートでメモを使用する手順につ
いては、「メモを追加する (49ページ) 」を参照してください。
サブプロセスおよびそのコンテンツを削除する
サブプロセスを削除すると、そのサブプロセス内のすべてのオブジェクトも削除されま
す。このオブジェクトには、サブプロセス内にあるアクティビティ テンプレートも含まれま
す。サブプロセスに含まれているアクティビティ テンプレートを保持するには、代わりに
[サブプロセスから削除する] オプションを使用します。
サブプロセスおよびそのコンテンツを削除するには
1. サブプロセスを選択します。
2. ショートカット メニューから [削除] を選択します。
サブプロセスとその内容、および接続されているフロー行が削除されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
87
第6章
アクティビティ テンプレートを操作する
この章では、 次のトピックについて説明します。
•
アクティビティ テンプレートを操作する
•
新しいアクティビティ テンプレートを作成する
•
フォルダ内のアクティビティ テンプレートを管理する
•
フォルダからアクティビティ テンプレートを削除する
•
アクティビティ テンプレートを検証する
•
アクティビティ テンプレートをインストールする
•
アクティビティ テンプレートをアンインストールする
アクティビティ テンプレートを操作する
アクティビティ テンプレートは、ユーザがビジネス プロセスに追加できる特定のタイプのタスクを表
しています。このテンプレートは、タスクを完了するために必要な基本となるワークフロー メソッドを
識別し、タスクを完了するために設定する必要のある設定属性を決定します。また、このテンプ
レートでは、いくつかの共通属性のデフォルト値を設定することもできます。
ビジネス プロセス テンプレートにアクティビティを追加するには、アクティビティ テンプレート ウィ
ンドウ内のフォルダの 1 つから該当するインストール済みのアクティビティ テンプレートを選択
して、プロセス テンプレート エディタ ウィンドウにドラッグします。Process Builder には、共通の
統合アクティビティ タイプのテンプレートや、サンプル アクティビティのテンプレートが含まれて
います。Process Builder で利用できるアクティビティ テンプレートの一覧は、「事前定義のアク
ティビティ テンプレート (159ページ) 」を参照してください。カスタム アクティビティ テンプレー
トの作成方法については、『Documentum Process Builder Development Guide (Documentum
Process Builder 開発ガイド)』を参照してください。
アクティビティ テンプレートには、下書き、検証済み、インストール済みの 3 つの状態があります。
下書き状態のアクティビティ テンプレートは、作成または前回編集されてからまだ検証されていま
せん。検証済み状態のアクティビティ テンプレートは、サーバの検証チェックにパスしており、テン
プレートが正しく定義されていることが確認済みです。インストール済み状態のテンプレートは、プ
ロセス フローでのアクティビティの作成に使用することができます。アクティビティ テンプレートの現
在の状態は、[アクティビティ テンプレート] ウィンド内のテンプレート アイコンで示されています。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
89
アクティビティ テンプレートを操作する
アクティビティ テンプレートを作成する
Process Builder が適切なアクティビティ テンプレートを備えていないアクティビティが、ユーザのビ
ジネス プロセスに含まれている場合、新しいテンプレートを作成することができます。テンプレート
を新規に作成するか、既存のテンプレートをコピーして、それを変更することができます。
新しいアクティビティ テンプレートを作成する
新しいアクティビティ テンプレートを作成するには
1. 新しいテンプレートを追加するフォルダを選択します。
2. [ツール] メニューの [アクティビティ テンプレート] > [新規作成] を選択するか、またはフォル
ダを右クリックしてメニューから [新規作成] を選択します。
[無題] という名前の新しいアクティビティ テンプレートが、アクティビティ テンプレートの
現在アクティブなフォルダに表示されます。
3. 新しいアクティビティ テンプレートをダブルクリックして、[アクティビティ テンプレート イン
スペクタ] を表示します。
4. アクティビティ テンプレートを設定します。
アクティビティ テンプレートの設定については、「」を参照してください。
アクティビティ テンプレートをコピーする
既存のテンプレートをベースにした新しいアクティビティ テンプレートを作成するには
1. アクティビティ テンプレート ノードで、コピーするアクティビティ テンプレートを選択します。
2. [ツール] メニューの [アクティビティ テンプレート] > [名前を付けて保存] を選択します。
[リポジトリ エクスプローラ] が開き、システム/ワークフロー/アクティビティ テンプレートの
下に、使用可能なアクティビティ テンプレートを示すフォルダが一覧表示されます。
3. 新しいテンプレートを追加するアクティビティ テンプレート フォルダを選択します。
4. [名前] テキスト ボックスに新しいアクティビティ テンプレートの名前を入力します。
5. [OK] をクリックします。
選択したノードにアクティビティ テンプレートが表示されます。新しいテンプレート
は、手順 1 で選択したテンプレートと同じ属性を持っています。ただし、元のテンプ
レートと新しいテンプレートは互いに独立しており、今後片方を変更しても、もう一方
は影響を受けません。
6. 新しいアクティビティ テンプレートに必要な変更を行います。
アクティビティ テンプレートの設定については、「アクティビティ テンプレートを設定
する (91ページ) 」を参照してください。
フォルダ内のアクティビティ テンプレートを管理する
アクティビティ テンプレート ウィンドウのフォルダ (またはノード) 内には、機能ごとに分類されたア
クティビティ テンプレートがあらかじめ多数用意されています。フォルダを展開したり折りたたんだ
りすることによって、これらのアクティビティ テンプレートを表示または非表示にすることができま
90
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティ テンプレートを操作する
す。アクティビティ テンプレートが格納されているノードの詳細、および各アクティビティ テンプ
レートの設定方法については、「事前定義のアクティビティ テンプレート (159ページ) 」を参照して
ください。アクティビティ テンプレート ウィンドウでフォルダを作成、追加、または削除する方法に
ついては、「アクティビティ テンプレート フォルダを管理する (39ページ) 」を参照してください。
カスタム アクティビティ テンプレートを作成するときは、そのテンプレートを保存するフォルダを指
定します。アクティビティ テンプレートは複数の状況やビジネス プロセスに関連していることがある
ので、1 つのテンプレートが複数のフォルダに表示される場合があります。
フォルダからアクティビティ テンプレートを削除する
アクティビティ テンプレート フォルダからアクティビティ テンプレートを削除するには
1. 削除するアクティビティ テンプレートを選択します。
2. [ツール] メニューの [アクティビティ テンプレート] > [削除] を選択するか、またはアクティビティ
テンプレート ウィンドウ内を右クリックして [削除] を選択します。
アクティビティ テンプレートが現在のフォルダから削除されます。テンプレートが別の
フォルダにもリンクしている場合、そのフォルダ内のテンプレートは削除されません。
アクティビティ テンプレートを設定する
アクティビティ テンプレートの設定は、アクティビティ テンプレート インスペクタを使用して行いま
す。アクティビティ テンプレート インスペクタは、アクティビティ インスペクタと複数のタブを共
有しており、これらを使用して個々のアクティビティを設定します。これらの共有タブでは、アク
ティビティ テンプレート用に設定した値がテンプレートから作成されたアクティビティのデフォル
ト値になります。アクティビティ テンプレート インスペクタでは、優先度、パッケージ、入出力フ
ロー、または移行オプションに関する情報は設定できません。これらの設定属性は、個々のア
クティビティを特定のプロセス フローに適合させる方法に関連するもので、アクティビティ テン
プレートとは関連しないためです。
アクティビティ テンプレート インスペクタには、このほかに [定義] という名前のタブも含まれ、こ
れを使用してテンプレートによって作成されるアクティビティのカスタム属性を定義します。属
性は XML を使用して定義されます。XML では、名前、データ タイプ、カスタム属性の表示特
性を定義し、ユーザが属性の値を入力するときの補助機能も定義します。アクティビティをテン
プレートから作成する場合、[アクティビティ インスペクタ] には、ユーザがカスタム属性の値を
入力するときに使用するための特別なタブが 1 つまたは複数含まれています。この特別なタ
ブの名前は XML ファイルで指定されます。
アクティビティ テンプレート定義ファイルでは、特別なタブを定義するだけでなく、[アクティビ
ティ インスペクタ] の 1 つまたは複数の標準タブを非表示にすることもできます。テンプレート
からアクティビティを作成する場合、[アクティビティ インスペクタ] では非表示に指定されたタ
ブが表示されないため、ユーザはそのタブの値を変更することができません。アクティビティ テ
ンプレート インスペクタで設定された値は変更されません。
アクティビティ テンプレートの XML ファイルの構造は、スキーマ ファイル activity.xsd によって定義
されます。このファイルは、ディレクトリ Program Files\Documentum\bpm\classes 内のローカル ファイ
ル システムに存在しています。ファイルの構造の詳細については、『Documentum Process Builder
Development Guide (Documentum Process Builder 開発ガイド)』を参照してください。アクティビティ
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
91
アクティビティ テンプレートを操作する
テンプレートの XML ファイルのサンプルについては、サンプル アクティビティ テンプレート フォル
ダにインストールされているサンプル アクティビティ テンプレートを参照してください。
アクティビティ テンプレートの属性を設定するには
1. フォルダ内のアクティビティ テンプレートをダブルクリックするか、これを選択して [ツール] メ
ニューの [アクティビティ テンプレート インスペクタ] を選択します。
アクティビティ テンプレート インスペクタが表示されます。
2. その他のタブで使用可能ないずれかの設定属性にデフォルト値を設定します。
アクティビティ テンプレートで設定したデフォルト値が、テンプレートから作成されるア
クティビティのデフォルト値になります。属性の設定については、「アクティビティ テンプ
レートを操作する (89ページ) 」を参照してください。通常は、テンプレートを [実行者]
タブのカスタム ワークフロー メソッドにリンクさせます。
3. [定義] タブを選択します。
テキスト ボックスに、このアクティビティ テンプレートのカスタム属性を定義する XML
要素が表示されます。これが新しいアクティビティ テンプレートである場合、またはカス
タム属性を持たないテンプレートの場合、アクティビティ テンプレートの XML スキーマ
を識別する要素は、最上位の <xml> 要素と <activity> 要素のみです。
4. XML を編集して、カスタム属性と、カスタム属性を編集するためのユーザ インターフェ
イスを定義します。
入力する XML は、activity.xsd スキーマに準拠する必要があります。ファイルの構造の
詳細については、『Documentum Process Builder Development Guide (Documentum
Process Builder 開発ガイド)』を参照してください。
5. アクティビティ インスペクタのタブを非表示にするには、各タブの <tab> 要素を入力します。
<tab> 要素は <tabs> 要素のサブ要素である必要があり、これはアクティビティ イン
スペクタで表示するカスタム タブの指定も行います。非表示にするタブごとに、この
フォーマットで要素を入力します。
<tab id="TAB_NAME" showInActInspector="false" />
TAB_NAME の有効な値は、PROPERTIES、PERFORMER、TRIGGER、NOTIFICATION、
TRANSITION、PACKAGE、および DISPLAY です。これらの各タブのオプションについては、
「アクティビティ インスペクタを使用する (96ページ) 」を参照してください。カスタム タブの場
合、showInActInspector パラメータは無視されます。
6. [OK] をクリックして [アクティビティ テンプレート インスペクタ] を閉じます。
アクティビティ テンプレートを検証してインストールする
アクティビティ テンプレートには、下書き、検証済み、インストール済みの 3 つの状態があります。
下書き状態のアクティビティ テンプレートは、作成または前回編集されてからまだ検証されてい
ません。検証済み状態のアクティビティ テンプレートは、サーバの検証チェックにパスしてお
り、テンプレートが正しく定義されていることが確認済みです。
システムによって実行される検証チェックでは、次のようなことをチェックします。
• すべてのアクティビティが、1 つのパスを経由して終了アクティビティに接続されている。
• 事前タイマおよび事後タイマが正しく設定されている。
• 手動アクティビティの場合、ユーザの選択が有効である。
92
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティ テンプレートを操作する
• すべての経過アクティビティが直接または間接的に初期化アクティビティに接続されている (た
だし、障害対処アクティビティは例外です。このアクティビティは自動アクティビティにのみ接
続され、出力フローを持たないためです)。
インストール済み状態のアクティビティ テンプレートは、アクティビティの作成に使用するこ
とができます。アクティビティ テンプレートの現在の状態は、[アクティビティ テンプレート] ウィ
ンドウ内のテンプレート アイコンで示されています。有効なテンプレートはテンプレート アイコ
ンの上に赤いチェック マークが表示され、インストール済みのテンプレートはテンプレート アイ
コンの上に矢印が表示されます。
アクティビティ テンプレートを検証して、テンプレートがシステム要件を満たしていることを確認しま
す。アクティビティ テンプレートを検証できるのは、開いたテンプレートが下書き状態にあって
[書き込み] アクセス権がある場合のみです。
アクティビティ テンプレートを使用してアクティビティを作成できるようにするには、まずアクティ
ビティ テンプレートをインストールする必要があります。アクティビティ テンプレートをインス
トールできるのは、アクティビティ テンプレートが検証済み状態にあって [書き込み] アクセス
権がある場合のみです。
インストールしたアクティビティ テンプレートに変更を加える場合は、まずそのテンプレートを
アンインストールする必要があります。変更を加えた後で、テンプレートを検証してもう一度
インストールします。
アクティビティ テンプレートを検証する
アクティビティ テンプレートを検証するには
1. 検証するアクティビティ テンプレートを選択します。
2. [ツール] メニューの [アクティビティ テンプレート] > [検証] を選択します。
[検証] オプションが利用できない場合は、テンプレートが現在検証済みまたはインス
トール済みであるか、ユーザに検証を実行するためのアクセス権がないことを示します。
検証に失敗するとダイアログ ボックスが表示されます。[詳細] ボタンをクリックすると
検証失敗の原因となったエラーが表示されます。 検証が正常に終了すると、[アク
ティビティ テンプレート] ウィンドウ内のアクティビティ テンプレートのアイコンの横に
赤いチェック マークが表示されます。
アクティビティ テンプレートをインストールする
アクティビティ テンプレートをインストールするには
1. [ツール] メニューの [アクティビティ テンプレート] > [インストール] を選択します。
[インストール] オプションが利用できない場合は、テンプレートが現在インストールされ
ていること、またはユーザにインストールするためのアクセス権がないことを示します。
インストールが正常に終了すると、[アクティビティ テンプレート] ウィンドウ内のアクティ
ビティ テンプレートの横に検証アイコンが表示されます。
アクティビティ テンプレートをアンインストールする
アクティビティ テンプレートをアンインストールするには
1. [ツール] メニューの [アクティビティ テンプレート] > [アンインストール] を選択します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
93
アクティビティ テンプレートを操作する
アクティビティ テンプレートをアンインストールできるのは、テンプレートがインストール
済み状態にあって [書き込み] アクセス権がある場合のみです。テンプレートが正常に
アンインストールされたら、テンプレートのアイコンの横の矢印 (インストール済み状態
を表す) が赤いチェック マーク (検証済み状態を表す) に置き換えられます。
94
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
第7章
アクティビティを操作する
この章では、 次のトピックについて説明します。
•
アクティビティ インスペクタを使用する
•
アクティビティのプロパティを設定する
•
実行者を選択する
•
ワーク キュー優先度モジュールをアクティビティに関連付ける
•
手動実行者を選択する
•
今すぐ実行者を割り当てる
•
アクティビティの実行者が他の実行者を決定する
•
ワー ク フ ロ ー が 実 行 さ れ る と き に 実 行 者 が 割 り 当 て ら れ ま す )
実 行 者 エ イ リ ア ス の 定 義 (ワ
•
条件に応じて実行者を選択
•
プロセス データまたはプロセス パラメータに基づいて実行者を選択する
•
繰り返し属性のすべての値に基づいて実行者を指定する
•
プロセス データをワーク キュー スキル セットにマップする
•
自動実行者を選択する
•
アクティビティのトリガを設定する
•
警告タイマを設定する
•
通知を送信する
•
プロセスを開始する
•
Java メ ソ ッ ド を 実 行 す る
•
タスクを委任する
•
タスクを完了する
•
アクティビティ移行規則を設定する
•
移行条件を作成する
•
通知を設定する
•
通知テンプレート ウィザードを理解する
•
新しい電子メール テンプレートを作成する
•
アクティビティ内のプロセス データを変更する
•
既存のパッケージ プロセス データを編集する
•
手動アクティビティからパッケージを自動的に起動する
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
95
アクティビティを操作する
•
既存のプロセス変数を変更する
•
既存のプロセス変数を編集する
•
表示設定を変更する
アクティビティ インスペクタを使用する
アクティビティは、ワークフローを構成するタスクです。ワークフローのほとんどの設定は、ワークフ
ローのアクティビティの設定に関連するものです。ワークフロー アクティビティの設定の計画につ
いては、「ワークフローのプロセスを計画する (16ページ) 」を参照してください。
アクティビティを設定するためにアクティビティ設定を使用します。[アクティビティ インスペクタ] を開
くには、プロセス テンプレート エディタ ペインのアクティビティをダブルクリックするか、1 つまたは
複数のアクティビティを選択して [ツール] メニューの [アクティビティ インスペクタ] をクリックします。
[アクティビティ インスペクタ] にはいくつかのタブがあり、それぞれどの視点からアクティビティ
を設定するかに対応しています。
• [プロパティ] タブでは、自動アクティビティの優先度を設定し、手動実行者に対する指示を入
力します。また、アクティビティのフォームも指定できます。詳細については、「アクティビティ
のプロパティを設定する (97ページ) 」を参照してください。
• [実行者] タブでは、アクティビティの実行者、および実行者が実行できるアクションを選択しま
す。詳細については、「実行者を選択する (99ページ) 」を参照してください。
• [トリガ] タブでは、アクティビティの開始日を設定します。詳細については、「アクティビティのトリ
ガを設定する (111ページ) 」を参照してください。
• [タイマ] タブでは、作業に障害が発生した場合に通知するタイマを設定します。詳細について
は、「警告タイマを設定する (112ページ) 」を参照してください。
• [移行] タブでは、ワークフロー内で次に発生するアクティビティを決定します。詳細について
は、「アクティビティ移行規則を設定する (118ページ) 」を参照してください。
• [通知] タブでは、特定のシステム イベントが発生した場合にワークフロー スーパーバイザに
通知するかどうかを指定します。詳細については、「通知を設定する (122ページ) 」を参照
してください。
• [データ] タブでは、アクティビティが処理するプロセス データ (パッケージ、プロセス変数など)
を制御します。詳細については、「アクティビティ内のプロセス データを変更する (125ペー
ジ) 」を参照してください。
• [表示] タブでは、プロセス テンプレートの表示画面上でのアクティビティの表示方法を制御しま
す。詳細については、「表示設定を変更する (128ページ) 」を参照してください。
• アクティビティの多くには、アクティビティのタイプに固有のプロパティを含む 1 つまたは複数の
タブが追加されます。このタブの名前と、そこに含まれるプロパティは、アクティビティ テンプ
レートで設定します。カスタム アクティビティ テンプレートの設定については、「アクティビティ
テンプレートを設定する (91ページ) 」を参照してください。
カスタム タブのフィールドに値を入力するときには、dm_workflow オブジェクトの名前など、
実行時に現在の環境による値で置き換えられる変数を挿入することができます。変数を挿
入するには、XML 要素 <dmp:param>supported_parameter</dmp:param> を入力します。この
supported_parameter は、Process Builder が変数置換用にサポートしている変数の 1 つです。サ
ポートされている変数の一覧については、「カスタム アクティビティ テンプレートの属性に代替
変数を使用する (231ページ) 」を参照してください。
96
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
注 記 : アクティビティの性質によっては、アクティビティ インスペクタに表示されないタブもありま
す。たとえば、決定分岐アクティビティ テンプレートから作成したアクティビティの場合、表示され
るのは [タイマ] タブ、[表示] タブ、および [定義] タブのみです。これらのタブの設定は、決定
分岐アクティビティに関連しているもののみです。表示されるタブのセットは、アクティビティ テ
ンプレートによって定義されます。詳細については、「アクティビティ テンプレートを設定する
(91ページ) 」を参照してください。
設定しているアクティビティの名前が、アクティビティ インスペクタの上部のテキスト ボックスに表示
されます。テンプレート内のそれぞれのアクティビティには一意の名前が必要です。アクティビティ
名を変更するには、以前の名前のあるテキスト ボックスに新しい名前を入力します。複数のアクティ
ビティが選択されると、テキスト ボックスの横に矢印のボタンが表示されます。このボタンを使用し
て、選択したアクティビティをスクロールできます。ここで設定する内容は、[選択したすべてに適用]
オプションを選択しない限り、このボックスに名前が表示されるアクティビティだけに適用されます。
複数のアクティビティを選択した場合、アクティビティ インスペクタのそれぞれのタブに、[選択し
たすべてに適用] というラベルが付いた 1 つまたは複数のチェックボックスが表示されます。こ
のチェックボックスをオンにすると、上部のテキスト ボックスに名前が表示されているアクティビ
ティだけでなく、選択したすべてのアクティビティに対して関連する設定 (つまり、チェックボッ
クスの右側に表示される設定) が適用されます。たとえば、複数のアクティビティを選択してか
ら、そのすべてに対して同じ実行者を選択することができます。チェックボックスがオンになって
いない設定は、現在のアクティビティにしか適用されません。
アクティビティのプロパティを設定する
[アクティビティ インスペクタ] の [プロパティ] タブでは、自動アクティビティの優先度の設
定、手動アクティビティの実行者に対する指示の入力、アクティビティとフォームの関
連付けを行うことができます。フォームを使用するアクティビティを作成すると、実行時
にタスクの実行者がタスクを開いたときに、タスク マネージャの標準のインターフェイス
ではなくそのフォームが表示されます。
アクティビティ プロパティを設定するには
1. [アクティビティ インスペクタ] で [プロパティ] タブを選択します。
[アクティビティ ID] フィールドに、リポジトリ オブジェクト ID およびアクティビティの状態
が読み取り専用の値として表示されます。
2. [優先度] ドロップダウン リストから優先度のレベルを選択します。
優先度の値は、自動アクティビティの実行優先度を表します。この値は手動アクティ
ビティでは無視されます。詳細については、「優先度の値を設定する (23ページ)
」を参照してください。
動的な優先度とは、アクティビティの優先度が、プロセス テンプレートの一部として設定さ
れるのではなく、ワークフロー実行時にカスタム コードを使用して設定される場合の優先度
です。動的な優先度は、実行時に優先度を設定するカスタム コードがシステムに存在する
場合に限り、割り当てる必要があります。
3. [説明] テキスト ボックスにアクティビティの説明を入力します。
4. [タスク名] ボックスに、手動実行者の受信ボックスに表示されるメッセージ用のテキストを入
力します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
97
アクティビティを操作する
このボックスには、デフォルトではデフォルト メッセージが表示されます。このメッセージ
には、通常のテキストのほかに、システムが実行時に決定するワークフロー属性の値を
挿入することもできます。たとえば、ワークフローの名前や送られるドキュメントの名前
を、メッセージに挿入することができます。最大 255 文字を入力できます。ユーザに表
示されるメッセージは、評価された変数を含め、512 文字を超えると切り詰められます。
タスク名に実行時属性を含めるには、次の手順に従ってメッセージに変数を追加します。
a. [タスク名] ボックスで、テキスト内に変数を挿入する位置にカーソルを置きます。
b. [挿入] をクリックします。
[タスク名の挿入] ダイアログ ボックスが表示され、ここで挿入する実行時属性
を選択できます。
c. [パッケージのタイプ] ツリーから、主題メッセージに含める属性を選択します。
d. [OK] をクリックしてダイアログ ボックスを閉じます。
使用可能な変数については、「タスクの主題を定義する (22ページ) 」を参照してくださ
い。タスク名には複数の変数を挿入することができます。
5. [タスクの手順] フィールドに、このアクティビティの実行者に与える指示を入力します。
注 記 : [タスクの手順] フィールドでは二重引用符がサポートされていません。二重引
用符を使用すると、システムからカスタム電子メール通知を送信できなくなります。
タスクの手順に実行時属性を含めるには、次の手順に従ってメッセージにパラメータを追
加します。
a. [タスクの手順] ボックスで、テキスト内にパラメータを挿入する位置にカーソルを置きます。
b. [挿入] をクリックします。[タスクの手順] ダイアログ ボックスが表示され、ここで挿入す
る実行時属性を選択できます。
c. [パッケージのタイプ] ツリーから、タスクの手順に含める属性を選択します。
d. [OK] をクリックしてダイアログ ボックスを閉じます。
6. アクティビティの実行者に対してこのタスクを表示するには、フォーム テンプレートがある場合
は、[フォーム] ドロップダウン リストからフォーム テンプレートを選択します。
注 記 : リストには、プロセスと関連付けられているフォームのみが表示されます。
アクティビティにプロセス パラメータが含まれている場合は、プロセス管理フォームを作成
してパラメータの管理を有効にすることができます。管理者は、フォーム内からプロセス
パラメータの値を変更できます。
アクティビティに適用するフォームを新規作成するには、次の手順に従ってください。
a. ボタンをクリックして、Forms Builder を起動します。
b. Forms Builder で、アクティビティに使用するフォームを作成します。
フォームの作成方法については、『Documentum Forms Builder User Guide
(Documentum Forms Builder ユーザ ガイド)』を参照してください。
c. [更新] ボタンをクリックして、使用可能なすべてのフォームをリポジトリから取得します。
7. [適用] をクリックして [アクティビティ インスペクタ] を閉じずに更新を保存するか、[OK] をクリッ
クして更新を保存して [アクティビティ インスペクタ] を閉じます。
98
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
実行者を選択する
アクティビティを定義するには、アクティビティの実行者を指定する必要があります。アクティビティ
は、指定済みの個人、グループ、ワーク キュー、またはエイリアスにより手動で実行するか、ワーク
フロー メソッドによって自動的に実行することができます。手動タスクの場合、特定の実行者を選
択するか、またはワークフローの参加者が実行者を選択するように設定できます。自動タスクの場
合、自動タスクがどのユーザのアクセス権を獲得するのかを指定する必要があります。
アクティビティの実行者を選択するには
1. アクティビティ インスペクタで [実行者] タブを選択します。
2. [アクティビティ作業の実行方法] ボックスで実行者を選択します。
• 手動実行者を選択するには [単独または複数の実行者が手動で実行] を選択
します。
• 自動実行者を選択するには [自動的に実行する] を選択します。
3. [実行者の選択] ボタンをクリックし、このアクティビティの実行者を選択するためのウィザード
を表示します。
• 1 人または複数の手動実行者を選択するには、「手動実行者を選択する (101
ページ) 」を参照してください。
• 自動アクティビティに使用するアクセス権を持つユーザを選択するには、「自動実
行者を選択する (110ページ) 」を参照してください。
4. 1 人または複数の手動実行者を選択する場合、実行者が実行できるまたは実行する必
要があるアクションを選択します。
• 実行者がタスクを他のユーザまたはグループに渡せるようにするには、[アクティビ
ティの実行を委任する] をオンにします。このオプションを選択した場合はさらに、実
行者によって委任されたユーザも実行不可能な場合のタスクの送信先を指定する
必要があります。自動委任が失敗した場合は、タスクをワークフロー スーパーバイザ
に転送するか、元の実行者に返すことができます。
• 実行者に、他のユーザまたはグループにもこのタスクを実行させるように選択する権
限を与えるには、[他の実行者にアクティビティ作業を繰り返させる] をオンにします。
• 実行者にアクティビティが完了したらサインオフするように要求するには、[完了時に
実行者のサインオフが必要] をオンにします。
委任と拡張のオプションの詳細については、「委任と拡張を有効にする (21ページ) 」を
参照してください。
5. 自動アクティビティを選択した場合、実行パラメータを設定します。
a. [このメソッドを自動的に実行] チェックボックスをオンにし、ドロップダウン リストから自動実
行パラメータを選択します。 (Documentum Process Builder 6.5 以前のリリースを使用する
と、このチェックボックスは自動的にオンになります。)ボックス内のアクションはワークフ
ロー メソッドです。
[このメソッドを自動的に実行] オプションに対応するチェックボックスがオンに
なっていない場合、システムは、実行時にメソッドを起動するのでなく、あらかじ
め用意されている dm_bpm_noop_method を使用してリポジトリに接続し、アク
ティビティを完了させます。すなわち、タスクの実行者に代わってシステムがタス
クを取得して完了させます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
99
アクティビティを操作する
注 記 : ここでカスタム メソッドを使用可能にするには、a_special_app 属性を設定する必
要があります。a_special_app は Documentum 製品で使用するために予約されている
dm_sysobject 属性です。この属性は、ワークフローの値を持っている必要があります。
カスタム ワークフロー メソッド開発の詳細については、『Documentum Process Builder
Development Guide (Documentum Process Builder 開発ガイド)』を参照してください。
b. 自動処理が実行されたときに実行ログを保存するには、[実行結果を保存しますか?]に
対して、[はい] を選択します。
c. プロセス エンジンが中止するまでにこのメソッドを実行する試行時間の長さを設定します。
[メソッドのタイムアウト時間] ボックスに秒数を入力します。
6. メソッドが失敗した場合にシステムで使用するオプションを設定します。
a. メソッドが失敗したときに再試行が行われるようにするには、[再試行] を選択して、[再
試行間隔] に再試行が行われる間隔を入力します。[最大再試行回数] フィールドに
は、手順 6c で指定するいずれかのアクションが実行される前にシステムが再試行する
最大回数を入力します。
b. このアクティビティに障害対処を割り当ててある場合は、[障害対処へ進む] フィールド
にその障害対処アクティビティの名前が表示されます。障害対処は、メソッドが失敗す
るたびに実行されます。
このトピックの詳細については、「障害対処アクティビティ (13ページ) 」を参照し
てください。
c. ワークフロー メソッドにエラーが発生したときにワークフローを停止するか続行するかを
決定します。
• [実行を停止] を選択すると、タスクは一時停止状態になり、ワークフロー スー
パーバイザに再割り当てされます。
• [実行を継続] を選択すると、タスクは取得済み状態になり、強制的に完了します。
• [実行を中断] を選択すると、ワークフローが停止し、再開もされません。
7. [適用] をクリックして [アクティビティ インスペクタ] を閉じずに更新を保存するか、[OK] をクリッ
クして更新を保存して [アクティビティ インスペクタ] を閉じます。
ワーク キュー優先度モジュールをアクティビティに
関連付ける
アクティビティ インスペクタの [実行者] タブから、優先度モジュールをアクティビティに関
連付けることができます。プロセスの動的な優先度とエージング ロジックの設定の詳細に
ついては、「優先度の値を設定する (23ページ) 」を参照してください。
ワーク キュー優先度モジュールとアクティビティを関連付けるには
1. [アクティビティ インスペクタ] を開き、[実行者] タブを選択します。
2. 実行者として [ワーク キュー] を選択します。
3. [タスク優先度モジュールの選択] リスト ボックスから、優先度モジュールを選択します。
注 記 : ワークフローに対して 2 つの異なるモジュールが選択されていた場合 (1 つはア
クティビティ定義から、1 つはワーク キュー ポリシーから)、システムはエージングと優先
度を調整するため、アクティビティ内から選択されたモジュールを使用します。
100
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
手動実行者を選択する
アクティビティの手動実行者を選択する手順は、次の 2 つの主要素に応じて異なります。
• アクティビティの実行者が単独であるか複数であるか。
• この時点で実際のユーザをテンプレートの一部として指定するか、ユーザ エイリアスを使
用するか。
手動実行者の選択オプションの詳細については、「実行者を選択する (18ページ) 」を参照
してください。
アクティビティの複数の手動実行者を選択するには
1. アクティビティ インスペクタの [実行者] タブで、[単独または複数の実行者が手動で実行] を選
択して、[実行者の選択] ボタンをクリックします。
[実行者の選択] ダイアログ ボックスが表示されます。
2. ドロップダウン リストから、このアクティビティを実行するユーザまたはグループを選択します。
特定のユーザやグループを選択するか、またはワークフローの実行時に特定のユー
ザを指定するオプションを選択できます。オプションは次のとおりです。
• [ワーク キュー]: 選択されたワーク キューのメンバーがアクティビティを実行します。
ワーク キュー スキル セットをキューのタスクにマップする方法については、「プロセス データ
をワーク キュー スキル セットにマップする (110ページ) 」を参照してください。
• [ワークフロー スーパーバイザ] : ワークフロー スーパーバイザがアクティビティを実行しま
す。デフォルトではこのスーパーバイザはワークフローの開始者になっています。
• [リポジトリの所有者]: リポジトリの所有者がアクティビティを実行します。
• [直前のアクティビティ実行者]: 同一ユーザ、またはワークフローにおいて直前のアク
ティビティを完了したユーザがアクティビティを実行します。このオプションでは、複数の
ユーザを指定できます。このアクティビティを完了させる実行者または実行者のグルー
プが含まれるアクティビティ名を選択します。次に、実行者を選択する次の 2 つのオプ
ションのうち 1 つを選択します。
• [前のアクティビティの最後の実行者に割り当て]: 前のアクティビティの完了をトリガした
ユーザが実行者として割り当てられます。
• [前のアクティビティのすべての実行者に割り当て]: 識別されているアクティビティのすべ
ての実行者が実行者として割り当てられます。
• [特定ユーザ]: 指定されたユーザがアクティビティを実行します。
• [グループのすべてのユーザ ]: 特定のグループのすべてのメンバーがアクティビティを
実行します。
• [グループの単独ユーザ]: 特定のグループの単独のユーザがアクティビティを実行します。
• [グループに所属する複数のユーザ ]: 特定のグループのすべてのメンバーではなく一部の
複数のメンバーがアクティビティを実行します。
• [複数の実行者が順次実行]: 複数のユーザが順番にアクティビティを実行します。
残りの手順は、選択するオプションによって異なります。[ワークフロー スーパーバイザ] または
[リポジトリの所有者] を選択した場合は、ワークフローの実行時に特定のユーザが指定さ
れます。[完了] をクリックして、残りの手順を無視します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
101
アクティビティを操作する
最初の 2 つのオプション以外のオプションを選択すると、[実行者の定義] ボックスが画面に
表示されます。このボックスのオプションを選択して、このアクティビティの特定の実行者の
選択方法を指定します。
3. [直前のアクティビティ実行者] を選択すると、このアクティビティを完了させる実行者または実
行者のグループが含まれるアクティビティ名を選択します。次に、実行者を選択するための次
の 2 つのオプションのいずれかを選択できます。
• [前のアクティビティの最後の実行者に割り当て]: 前のアクティビティの完了をトリガ
したユーザが実行者として割り当てられます。
• [前のアクティビティのすべての実行者に割り当て]: 識別されているアクティビティのすべて
の実行者が実行者として割り当てられます。
4. 複数の実行者が順次実行] を選択した場合、このアクティビティのそれぞれの実行者に、
受信したパッケージを却下してそのパッケージを順次処理で送信した実行者に戻す権限
を与えるかどうかを指定します。
デフォルトでは順次実行者にこのオプションはありません。順次実行者がこのオプ
ションを使用できるようにするには、[実行者の選択] ボックスのすぐ下にあるチェック
ボックスをオンにします。
5. このアクティビティの実行者を今選択するか、ワークフローの実行時に動的に選択されるよう
にするかを指定します。
[実行者の定義] ボックスの次のオプションから 1 つを選択します。
• [今すぐ実行者を割り当てる]: プロセス テンプレートの一部として特定のユーザまたは
グループを選択します。
• [アクティビティ <アクティビティ名> の実行者にアクティビティ <アクティビティ名> の実行
者を決定させる]: 先行するアクティビティの実行者が、ワークフローの実行時にこのアク
ティビティの実行者を選択します。このアクティビティに複数の先行アクティビティがある
場合は、どのアクティビティの実行者がこのアクティビティの実行者を選択するかをドロッ
プダウン リストから選択します。
• [実行者エイリアスの定義 (ワークフローが実行されるときに実行者が割り当てられる)]: この
アクティビティの実行者がエイリアス セットにより指定されます。次の手順で使用するエイリ
アス セットを指定します。このオプションは、[グループに所属する複数のユーザ] または [複
数の実行者が順次実行] を選択した場合は使用できません。
• [次の条件に基づいて実行者を選択]: アクティビティの実行者は、パッケージ データやプロ
セス変数など、ユーザが定義した条件分岐ロジックに従って決まります。
• [プロセス データに応じて実行者を選択 ]: アクティビティの実行者は、パッケージ データ、
プロセス変数、実行データなど、ユーザが定義したプロセス データによって決まります。
6. [グループの単独ユーザ] を選択した場合、選択したグループのどのユーザがアクティビ
ティを実行するかを指定します。
次の手順でグループを選択します。グループのどのユーザがアクティビティを実行するかを指
定するには、[グループからユーザを選択] ボックスの次のオプションから 1 つ選択します。
• [最初に作業項目を取得するユーザ]: 先行するアクティビティが完了すると、グループ内の各
ユーザの受信ボックスに作業項目が追加されます。受信ボックスから最初に作業項目を取得
したユーザが実行者になり、その作業項目は他のユーザの受信ボックスから削除されます。
• [未完了の作業項目の最少数]: 先行するアクティビティが完了すると、受信ボックスにある未
完了のタスクの数が最も少ないユーザの受信ボックスに作業項目が追加されます。
102
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
7. [次へ] をクリックして操作を続けます。この操作を完了する手順は、選択するオプションに
よって異なります。
実行者を定義するオプションの詳細については、「今すぐ実行者を割り当てる (103
ページ) 」、「アクティビティの実行者が他の実行者を決定する (103ページ) 」、「実行者
エイリアスの定義 (ワークフローが実行されるときに実行者が割り当てられます) (105
ページ) 」、および「条件に応じて実行者を選択 (106ページ) 」を参照してください。
今すぐ実行者を割り当てる
実行者を今すぐ割り当てるためのオプションとして、次のものが用意されています。
• [ワーク キュー] を選択した場合は、対象のワーク キューを反転表示してから [次へ] をクリック
してデータ マッピング画面を開き、キューに対して定義されているスキル セットにプロセ
ス データを割り当てます。
プロセス データをスキル セットにマップする方法については、「プロセス データをワーク キュー
スキル セットにマップする (110ページ) 」を参照してください。
• 前の画面で [特定ユーザ] を選択した場合は、[グループ] リスト ボックスのグループ名または [<
すべてのユーザ>] を強調表示し、このアクティビティの実行者を、[グループ内のユーザ] リスト
ボックスの選択されたグループから選択します。ユーザを選択したら、[完了] をクリックします。
• 前の画面で [グループのすべてのユーザ] または [グループの単独ユーザ] を選択した場合
は、[グループ] リスト ボックスからグループを選択して、[完了] をクリックします。
• [グループに所属する複数のユーザ] または [複数の実行者が順次実行] を選択した場合は、ア
クティビティを実行する複数のユーザ、グループ、およびエイリアス名を指定できます。[次へ]ア
クティビティの実行者が他の実行者を決定する (103ページ) をクリックしたときに表示されるオ
プションの詳細については、「」の手順を参照してください。
注 記 : [今すぐユーザを割り当てる] を選択したため、実行者として作成したリスト内のすべての
ユーザが選択されます。「アクティビティの実行者が他の実行者を決定する (103ページ) 」に説
明されているような、先行アクティビティの実行者に提供される選択リストは使用されません。
アクティビティの実行者が他の実行者を決定する
この機能は、不特定の実行者の選択とも呼ばれます。このオプションを使用すると、アク
ティビティの実行者に、ワークフローの後続のアクティビティの実行者を選択する権限を与
えることができます。実行時に、アクティビティの実行者は指定されているグループから
1 人または複数のユーザを選択します。
[グループに所属する複数のユーザ] または [複数の実行者が順次実行] を選択した場合は、複
数のユーザ、グループ、またはエイリアス名の組み合わせを指定します。実行時に、直前のアク
ティビティの実行者がこの中から実行者を選択します。実行者のタイプとしてこの他のものを選択
した場合は、実行者の定義はそれ以上必要ありません。このページは表示されません。
エイリアスおよびエイリアス セットの詳細については、「エイリアスを使用する (20ページ) 」を参照
してください。
ユーザおよびグループを選択するには
1. ユーザを選択するためのオプションを 1 つ以上選択します。複数のオプションを選択した場合
は、次のオプションが順番に表示されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
103
アクティビティを操作する
• [特定のユーザ、グループ、またはその両方] - この時点でユーザ名およびグループ名を
選択します。
• [ワークフローの開始者が実行者エイリアスを選択] - ここで選択したエイリアス セットお
よびエイリアスに対応するユーザ名およびグループ名を、ワークフローの開始時にワー
クフロー開始者が指定します。
• [実行時にエイリアス セットから決定される実行者エイリアス (複数可)] &; ここで選択した
エイリアス セットおよびエイリアスを使用して、実行時にサーバが実際のユーザおよび
グループを決定します。
2. [次へ] をクリックします。
3. [特定のユーザ、グループ、またはその両方] を選択した場合は、このアクティビティを実行でき
るグループまたはユーザの名前を選択します。
a. 左側のリストでユーザまたはグループの名前が反転表示されている状態で [追加] をクリッ
クすると、そのユーザまたはグループが右側の選択リストに移動されます。
b. 追加する個々のユーザまたはグループに対して、手順 3a を繰り返します。
c. 選択するユーザおよびグループがすべて [選択リスト] に表示されていることを確認して、
[次へ] または [完了] をクリックします (どちらが表示されるかは手順 1 で他のオプション
を選択したかどうかによります)。
4. [ワークフローの開始者が実行者エイリアスを選択] を選択したが、このワークフローのデフォル
トのエイリアス セットをまだ定義していない場合は、エイリアス セットを選択します。
• 既存のエイリアス セットを選択するには、[既存のエイリアス セットから選択する] をク
リックして、ドロップダウン リストからエイリアス セットを選択します。このリストには、
現在接続しているリポジトリ内のエイリアス セットのうち、[書き込み] アクセス権を
持っているものがすべて表示されます。
• 新しいエイリアス セットを選択するには、[新しいエイリアス セットの作成] をクリック
し、新しいエイリアス セットの名前と説明を入力します。このページと次のページで
入力した情報に基づいて、新しいエイリアス セットが作成されます。
エイリアス セットを指定したら、[次へ] をクリックします。
5. [ワークフローの開始者が実行者エイリアスを選択] を選択した場合は、1 つまたは複数の
エイリアスを指定します。ワークフロー開始者は、ワークフローを開始するときにこれらのエ
イリアスの値を入力する必要があります。
a. [新しい実行者エイリアスの作成] と [既存の未定義実行者エイリアスを使用] のどちらを行う
かを指定します。定義されていない既存のエイリアスとは、エイリアス セットに表示される
が、エイリアス セット内で特定のユーザ名が割り当てられていないエイリアスのことです。
b. 新しい実行者エイリアスを作成するには、エイリアスの名前と説明を入力して [追加] をク
リックすると、エイリアスが [選択リスト] に追加されます。
c. 既存の実行者エイリアスを使用するには、[既存の実行者エイリアス] ドロップダウン リストで
エイリアスを選択して [追加] をクリックすると、エイリアスが選択リストに追加されます。
必要に応じて、ワークフロー開始者がエイリアスの目的をすぐ理解できるようにエイリア
スの説明を変更します。
d. 選択するエイリアスがすべて選択リストに表示されていることを確認して、[次へ] または
[完了] をクリックします (どちらが表示されるかは手順 1 で最後のオプションを選択し
たかどうかによります)。
6. [実行時にエイリアス セットから決定される実行者エイリアス (複数可)] を選択した場合は、選
択したエイリアス セットからサーバによって解決されるエイリアスを選択します。
104
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
a. [エイリアス セット] リストからエイリアス セットを選択し、次にその下のリストからエイリ
アスを選択します。
b. [追加] をクリックすると、エイリアスが選択リストに追加されます。
c. 追加する個々のエイリアスについて、手順 6a および 6b を繰り返します。リスト内のエイリ
アス セットの位置を変更したい場合は、対象のエイリアスを選択してから、上下方向の
矢印を使用して移動することもできます。
7. [完了] をクリックします。
ワー ク フ ロ ー が 実 行 さ れ る
実 行 者 エ イ リ ア ス の 定 義 (ワ
ときに実行者が割り当てられます)
このオプションを選択した場合、実行時にプロセス エンジンがこのアクティビティの実行者
を決定するときに使用するエイリアス セットとエイリアスを指定する必要があります。まずエ
イリアス セットを選択し、次にそのセット内の特定のエイリアスを指定します。
エイリアスおよびエイリアス セットの詳細については、「エイリアスを使用する (20ページ) 」を参照
してください。
実行者のエイリアス セットとエイリアスを指定するには
1. エイリアスの指定に使用するエイリアス セットを選択します。オプションは次のとおりです。
• [デフォルトのエイリアス セット (ワークフローの開始者がワークフローの開始時に決
定される)] — このワークフローのデフォルトとして定義されたエイリアス セットがサー
バにより参照されます。エイリアス セットが選択されていない場合、[テンプレートの
プロパティ] ダイアログ ボックスでデフォルト エイリアス セットを定義します。次の
ページでこれを設定することができます。
• [特定のエイリアス セット] — 横にあるドロップダウン リストから名前を選択したエ
イリアス セットがサーバにより参照されます。このリストには、現在接続しているリ
ポジトリ内のエイリアス セットのうち、[書き込み] アクセス権を持っているものが
すべて表示されます。
• [パッケージ内のドキュメントのエイリアス セット] — このアクティビティが受信する
パッケージのドキュメントに割り当てられたエイリアス セットがサーバにより参照され
ます。横にあるドロップダウン リストから、使用するパッケージのエイリアス セット
を選択します。[<任意>] を選択した場合、手順 4 で指定する特定のエイリアスに
一致する最初のエイリアスが見つかるまで、すべてのパッケージのエイリアス セッ
トがスキャンされます。
• [前の実行者のエイリアス セット] — 先行するアクティビティの実行者に割り当てら
れたエイリアス セットがサーバにより参照されます。このオプションは、たとえば、
このアクティビティが、直前のアクティビティ実行者のマネージャによる実行を必
要とする場合などに使用します。前の実行者がエイリアス セットを持たない場合
は、サーバは実行時に前の実行者のグループに属するエイリアス セットを使用し
ます。グループもエイリアス セットを持たない場合は、失敗したタスクがワークフ
ロー スーパーバイザに送信されます。
2. [次へ] をクリックします。
[デフォルトのエイリアス セット] を選択していても、このワークフローのデフォルトのエイ
リアス セットをまだ選択していない場合は、エイリアス セットを選択する必要があります。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
105
アクティビティを操作する
どちらかのオプションを選択した場合やワークフローのデフォルト エイリアス セットを既に選択
してある場合は、[次へ] をクリックすると、そのセット内の特定のエイリアスを選択するページに
移動します。手順 3 をスキップしてください。
3. このワークフローのデフォルト エイリアス セットをまだ定義していない場合は、オプション
を 1 つ選択します。
• 既存のエイリアス セットを選択するには、[既存のエイリアス セットから選択する] をク
リックして、ドロップダウン リストからエイリアス セットを選択します。このリストには、
現在接続しているリポジトリ内のエイリアス セットのうち、[書き込み] アクセス権を
持っているものがすべて表示されます。
• 新しいエイリアス セットを選択するには、[新しいエイリアス セットの作成] をクリック
し、新しいエイリアス セットの名前と説明を入力します。このページと次のページで
入力した情報に基づいて、新しいエイリアス セットが作成されます。
エイリアス セットを指定したら、[次へ] をクリックします。
4. 選択したエイリアス セット内の特定のエイリアスを指定します。
手順 2 で特定のエイリアス セットを選択した場合、[実行者エイリアス] ドロップダウン リストに、
そのエイリアス セットに定義されているエイリアスが表示されます。
前の実行者のエイリアス セットなど、実行時に選択されるエイリアス セットを選択する場合
は、[実行者エイリアス] ドロップダウン リストには何も表示されません。ボックス内にエイリア
スの名前を入力します。サーバで見つかるエイリアス セット内の名前とその名前が完全に
一致することを確認します。実行時にサーバが実行者エイリアスと一致するエイリアス セッ
トの使用可能エイリアスを見つけられなかった場合は、アクティビティ タスクが通知と共に
ワークフロー スーパーバイザに返されます。
5. [完了] をクリックします。
条件に応じて実行者を選択
アクティビティ内に設定した条件分岐ロジックに基づいて、タスクの実行者を動的に決
定することができます。実行者は、条件判断の表に定義したプロセス データおよびロ
ジックに基づいて決定されます。
式の左辺には、プロセス属性からのデータに基づく条件を定義します。式の右辺には、ロジックが
解決されたときにタスクを実行するワーク キュー、ユーザ、またはグループの名前を指定できます。
実行時に、プロセス エンジンが設定済みの規則を評価してアクティビティの実行者を割り当てます。
条件分岐ロジックに基づいて実行者を割り当てるには
1. 条件分岐ロジックを設定するための基準を満たす実行者タイプを選択します。
有効な値は次のとおりです。
• ワーク キュー
• 特定ユーザ
• グループのすべてのユーザ
• グループの単独ユーザ
• グループに所属する複数のユーザ
• 複数の実行者が順次実行
106
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
2.
3.
4.
5.
[実行者の選択] ボックスで、[条件に応じて実行者を選択] を選択します。
[次へ] をクリックします。クエリを定義するダイアログ ボックスが表示されます。
[クエリ] 表の「IF」で始まる行を反転表示します。
[クエリの対象] ドロップダウン リストから、この条件の適用先オブジェクトを選択します。
• [実行中のワークフロー] — 条件によって dm_workflow オブジェクトの属性がチェックさ
れます。
• [プロセス データ] — ドロップダウン リストから選択したプロセス パッケージまたはプロセス変
数の属性が、条件によってチェックされます。
6. プロセス データを使用してクエリを実行する場合は、[プロセス データ] リスト ボックスを使用し
て、プロセスと関連付けられているパッケージまたはプロセス変数を選択します。
7. 手順 5 で選択したオプションに基づいて、条件で使用する値を持つ属性を選択します。
手順 5 で選択したオブジェクト タイプの属性がドロップダウン リストに表示されます。
8. 選択した属性に繰り返しの値が 1 つまたは複数ある場合は、リストの 4 つのオプションから
1 つを選択するか、有効なインデックス値を入力することで、この条件の中で使用するイン
デックス値を指定します。
有効な値は、[最初]、[最後]、[すべて]、および [任意] です。
9. [条件] ドロップダウン リストから論理比較演算子を選択し、比較値を [値] テキスト ボックス
に入力します。
注 記 : 浮動小数点タイプのプロセス変数では、等号 (=) 演算子は使用しないでくださ
い。浮動小数点タイプのプロセス変数で等号演算子を使用すると、データの切り捨
てや損失が生じる可能性があります。
10. [クエリ] 表の「SELECT」で始まる行をクリックします。
11. [条件付き実行者の選択] ボックスで、リストから実行者を選択するか、DQL (Documentum
Query Language) を使用してクエリを入力するか、プロセス データまたはプロセス パラメータを
使用して実行者を割り当てます。
• [リストから選択] を選択した場合は、リストから実行者を選択します。
• 複数の実行者を選択するときは、各実行者の名前を選択して [追加] をクリックすると、[選
択リスト] にその実行者を移動できます。
• [DQL クエリの入力] を選択した場合は、テキスト ボックスにクエリを入力してから、[クエリの
検証] をクリックしてそのクエリが有効かどうかを確認します。
• [プロセス データから選択] を選択した場合は、実行者を割り当てるためにプロセス データま
たはプロセス パラメータを選択できます。プロセス データを使用して実行者を割り当てる
方法については、「プロセス データまたはプロセス パラメータに基づいて実行者を選択
する (108ページ) 」を参照してください。
場合によっては、実行者の選択を完成させるために、データの一部に属性や要素を追加す
る必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法につい
ては、「パッケージ属性をマップする (131ページ) 」を参照してください。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
107
アクティビティを操作する
注 記 : プロセス データを使用して実行者を選択するオプションが有効である実行
者タイプは、特定ユーザ、ワーク キュー、グループの単独ユーザ、および複数の
順次ユーザのみです。
12. [OK] をクリックします。
13. この条件に句を追加するには、[AND] または [OR] ボタンをクリックして、これまでの手順を
繰り返します。
条件に複数の句が組み込まれている場合、サーバでは一般的な順序の規則を使用し
て式が評価されます。言い換えると、AND で結合された句は、OR で結合された句の
前に評価されます。たとえば、条件に次のようなフォームがあるとします。英字が条件
句を表しているとします。 IF A AND B AND C OR D AND E OR F SELECT 実行者名
サーバでは、この条件が次のように評価されます。
IF (A AND B AND C) OR (D AND E ) OR F SELECT 実行者名
14. 特定の条件をすべて定義したら、どの条件も満たさない場合にタスクが割り当てられる実
行者を選択します。
すべての条件を定義したら、[クエリ] 表内の「ELSE」で始まる行を反転表示し、どの条
件も該当しない場合に使用される実行者を選択します。
プロセス データまたはプロセス パラメータに基づ
いて実行者を選択する
アクティビティにあるプロセス データまたはプロセス パラメータに基づいて、アクティビティの実行
者を動的に解決することができます。実行者には、ユーザ、グループ、またはワーク キューの名前
を使用できます。一般に、実行者の選択では文字列ベースの属性のみを使用できます。
プロセス データに基づいて実行者を割り当てるには
1. プロセス データに基づいて実行者を割り当てるための基準を満たす実行者タイプを選
択します。
有効な値は次のとおりです。
• ワーク キュー
• 特定ユーザ
• グループの単独ユーザ
• グループ内のすべてのユーザ
• グループに所属する複数のユーザ
2. [実行者の選択] ボックスで、[プロセス データに応じて実行者を選択] を選択します。
3. [次へ] をクリックします。プロセス データ ツリーが表示されます。
4. プロセス データ ツリーのノードを展開し、実行者をタスクに割り当てるために使用するパッケー
ジ、プロセス変数、またはプロセス パラメータを選択します。
場合によっては、実行者の選択を完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
注 記: プロセス データ ツリーから選択できる属性は 1 つのみです。
108
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
5. [完了] をクリックします。
[式] テキスト ボックスに属性が表示されます。プレースホルダはドル記号「$」で囲まれ
ます (たとえば、ワーク キュー: $Var0.name$)。
繰り返し属性のすべての値に基づいて実行者を指
定する
プロセス データに基づいて実行者を指定する場合、次の実行者タイプについて、繰り返し値
の [すべて] 属性を選択できます。
• グループに所属する複数のユーザ
• グループ内のすべてのユーザ
[すべて] 属性を選択した場合、次のように実行者名が [実行者の選択] テキスト ボックスに
表示されます。
<user type>: $<variable or package name>.<attribute name>[ALL]$
たとえば、[グループに所属する複数のユーザ] として実行者を選択し、プロセス変数の [すべて]
属性を使用した場合、次のようになります。
Some users from a group: $Group_A.username[ALL]$
実行時、プロセス エンジンにより、プロセス データの繰り返し値属性に指定されたすべての実
行者について、作業項目が作成されます。これには、個々のユーザ名やグループ名が混在す
る場合があります。
プロセス エンジンは、[すべて] 繰り返し属性が選択された場合、次の作業項目を作成します。
• グループに所属する複数のユーザ:
システムは、繰り返し値が個々のユーザ名であるのか、グループ名であるのかを判断しま
す。その後、個々のユーザごとに 1 つの作業項目を作成し、グループごとに 1 つの作業
項目を作成します。
• グループのすべてのユーザ:
システムは、繰り返し値が個々のユーザであるのか、グループ名であるのかを判別します。
その後、個々のユーザごとに 1 つの作業項目をリスト内に作成し、グループ内のユーザごと
に 1 つの作業項目を作成します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
109
アクティビティを操作する
プロセス データをワーク キュー スキル セットにマッ
プする
特定のワーク キューによって実行されるアクティビティを作成する場合は、そのワーク キューの名
前を選択して、[アクティビティ インスペクタ] の [実行者] タブでアクティビティに必要なスキルを設
定します。プロセス データ マッパを使用して、パッケージまたは変数のプロセス データを、ワーク
キューで定義したスキルに関連付けることができます。プロセス データをスキルにマップすると、シ
ステムはこの情報に基づいて、実行時にタスクのプロセッサを認定します。
ワーク キュー スキルへのプロセス データのマッピングは、オプションの手順です。スキルがマップ
されていない場合、タスクではこのスキルを必須として扱わず、プロセッサの認定時にスキル
は使用されません。
注 記 : 特定のアクティビティに対するスキルを設定する前に、ワーク キュー、および
キューに関連するスキルのセットを定義しておく必要があります。また、システムが実行
時にプロセッサを割り当てるためにこれらのマッピングを使用できるように、Java メソッ
ド サーバを起動しておきます。
プロセス データをワーク キュー スキル セットにマップするには
1.
2.
3.
4.
5.
6.
7.
[実行者] タブで、[単独または複数の実行者が手動で実行] を選択します。
[実行者の選択] をクリックします。
[実行者の選択] ダイアログ ボックスで、ドロップダウン リストから [ワーク キュー] を選択します。
[今すぐ実行者を割り当てる] を選択します。
[次へ] をクリックします。
タスクで使用されるワーク キューの名前を反転表示します。
[次へ] をクリックして、マッピング ツールを開きます。左側の列にはプロセス データのリスト、右
側の列にはワーク キューと関連するスキルが表示されます。
8. データ マッピング ツールを使用して、パッケージ データの属性をワーク キュー内の事前定義
されたワーク キュー スキルに関連付けます。
データ マッピング ツールの使用方法の詳細については、「データ マッピング ツールを
理解する (129ページ) 」を参照してください。
9. [完了] をクリックします。
10. [OK] または [適用] をクリックして、構成設定を保存します。
自動実行者を選択する
自動アクティビティの実行者には、単一ユーザを指定する必要があります。この制限によって、次
のユーザ カテゴリに対する自動アクティビティの選択肢が限定されます。
• ワークフロー スーパーバイザ (デフォルトではワークフロー開始者)
• リポジトリ所有者
• 先行アクティビティの実行者
• 特定のユーザ
特定のユーザが選択されていない場合、サーバは実行時に実際のユーザを判断します。
110
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
自動アクティビティに使用するセキュリティ アクセス権を持つユーザを選択するには
1. [アクティビティ インスペクタ] の [実行者] タブで、[自動的に実行する] を選択して、[実行者
の選択] をクリックします。
[実行者の選択] ダイアログ ボックスが表示されます。
2. 自動アクティビティにどのユーザのセキュリティ アクセス権を使用するかを選択します。
• [ワークフロー スーパーバイザ] — ワークフロー スーパーバイザの権限を自動アクティ
ビティに使用します。デフォルトでは、この権限はワークフローの開始者の権限です。
• [リポジトリの所有者] — リポジトリの所有者の権限を自動アクティビティに使用します。
• [直前のアクティビティ実行者] — ワークフロー内で先行するアクティビティを実行し
たユーザ (複数の場合あり) の権限を自動アクティビティに使用します。
• [特定ユーザ] — 次の手順で選択するユーザの権限を自動アクティビティに使用
します。
3. [特定ユーザ] を選択した場合、使用される権限を持つユーザを選択します。
a. [選択] をクリックして、[ユーザの選択] ダイアログ ボックスを表示します。
b. [グループ] リスト ボックスで、グループ名または [<すべてのユーザ>] を反転表示します。
[グループのユーザ] リスト ボックスに、選択したグループ内のユーザが表示されます。
c. [グループのユーザ] リスト ボックスからユーザを選択します。[選択] テキスト ボックスに
ユーザ名が表示されます。
d. [OK] をクリックします。
[ユーザ] テキスト ボックスに選択したユーザ名が表示されます。
4. [完了] をクリックします。
[実行者の選択] ボタンの横にあるテキスト ボックスに選択したユーザ名が表示さ
れます。
アクティビティのトリガを設定する
トリガは、アクティビティが開始できることを示すシグナルです。[トリガ] タブを使用して、アクティビ
ティをトリガする条件を定義し、パッケージを実行者の受信ボックスに送信します。
アクティビティに複数の入力フローがある場合、このアクティビティの開始前までに先行するアク
ティビティをいくつ完了しなければならないのかを指定できます。トリガの条件は、このアクティビ
ティを開始するためにパッケージを受け入れる必要がある入力フローの最小数です。たとえば、ア
クティビティに 3 つの入力フローがある場合、3 つのうちの 2 つがパッケージを受け入れるとア
クティビティが開始できると決定できます。
注 記 : 1 つのアクティビティに複数の受信フローがある場合、それはビジネス プロセス全体におけ
る結合アクティビティを表します。つまり、プロセス内で異なるパスを使用するパッケージが集まるこ
とを意味します。ビジネス プロセス テンプレート内の結合アクションを明確に表示するには、明示
的な結合アクティビティ テンプレートをフローに挿入します。結合アクティビティは、次のアクティビ
ティのトリガ条件を設定します。次のアクティビティは、結合アクティビティからの入力フローを 1
つだけ持ちます。「結合 (169ページ) 」を参照してください。
アクティビティのトリガの詳細については、「トリガの条件を設定する (29ページ) 」を参照して
ください。
アクティビティをトリガするタイミングを設定するには
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
111
アクティビティを操作する
1. アクティビティ インスペクタで、[トリガ] タブを選択します。
2. このアクティビティの開始前までにアクティビティの入力フローをいくつ完了しなければな
らないのかを指定します。アクティビティの入力フローが 1 つだけの場合、これらのオプ
ションは区別できません。
• 直前の先行アクティビティがすべて完了している場合にのみこのアクティビティを開始する
には、[すべての入力フローが選択されたとき] を選択します。
• 先行するアクティビティのうち指定された数のアクティビティが完了した場合にのみこのアク
ティビティを開始するには、[次に指定した個数の入力フローが選択されたとき] をオンにし
て、アクティビティの実行前に完了するべき先行アクティビティの数を入力します。このアク
ティビティの入力フローの合計数がテキスト ボックスの横に表示されます。
3. 選択したアクティビティが実行される前に特定のアクションが確実に実行されるようにする
には、[次に指定したイベントが到着したとき] チェックボックスをオンにして、横にあるテ
キスト ボックスにイベント名を入力します。
このイベント名には、dm_checkin などのシステム定義イベントの名前や、promoted、released な
どの独自の名前を入力できます。開始条件にトリガ イベントを含める場合、アクティビティを開
始する前に、ワークフローにキュー登録された指定されたイベントをサーバが検出する必
要があります。Documentum API を使用したイベントの定義およびキュー登録の詳細につ
いては、『Documentum Content Server Fundamentals (Documentum Content Server の基本操
作)』を参照してください。
4. 同じワークフローで複数回アクティビティを実行できるようにするには、[このアクティビティを
ワークフロー内で複数回実行可能にする] チェックボックスをオンにします。
繰り返し可能なアクティビティは、特定のワークフロー内で複数回実行できるアクティビティで
す。デフォルトでは、アクティビティは繰り返し可能なアクティビティとして定義されます。複数の
実行者が順番に実行するアクティビティは繰り返せません。実行者のユーザのカテゴリについ
ては「実行者を選択する (18ページ) 」を参照してください。
ワークフロー内でアクティビティを複数回使用する場合、アクティビティの 1 つのインスタンスだ
けがいつでもアクティブになるようにワークフローを構成する必要があります。同じ定義を基に
する先行アクティビティがまだ実行中である場合、サーバではアクティビティを開始できません。
5. 次のいずれかを実行します。
• [適用] をクリックして、アクティビティ インスペクタを閉じずに更新を保存する。
• [OK] をクリックし、更新を保存してアクティビティ インスペクタを閉じる。
警告タイマを設定する
Process Builder では、アクティビティに対して次の 2 種類の警告タイマがサポートされています。
• 事前タイマ。ワークフローの開始後、指定された時間以内にアクティビティがトリガされなかっ
た場合に起動されます。
アクティビティは、ワークフローによって作成されていれば、必ずしもユーザによって取得されて
いなくても、起動されたと見なされます。事前タイマは、ワークフローの開始時に自動的に起動
されるため、ワークフローの最初のアクティビティで有効にされません。
• 事後タイマ。アクティビティの開始後、指定された時間以内にそのアクティビティが完了しなかっ
た場合に起動されます。
112
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
ワークフロー タイマの詳細については、「タイマを設定する (30ページ) 」を参照してください。
アクティビティに 1 つまたは複数のタイマのアクションが設定されている場合、プロセス テンプレー
ト エディタ ペインには、アクティビティのアイコンの右下隅に小さな時計アイコンが表示されます。
タイマのアクションを設定するには
1. アクティビティ インスペクタで [タイマ] タブを選択します。
2. タイマ アクションのカレンダーを選択するには、[カレンダーの選択] リスト ボックスからカ
レンダーを選択します。
リストには、System/Workflow/Calendar フォルダにあるすべてのカレンダーが含まれています。
• タイマ計算用のカスタム カレンダーを使用するには、ビジネス カレンダーを選択します。
• プロセス全体に対して指定されているカレンダーを継続して使用するには、[プロセス カ
レンダーの使用] を選択します。
• アクティビティのシステム カレンダーを使用するには、[カレンダーなし] を選択します。
注 記: プロセスと、そのプロセス内のアクティビティの両方に対して異なるカレンダーが選
択されている場合、システムはアクティビティのタイマに対してアクティビティのカレンダー
を使用します。
カレンダーの詳細については、「プロセス用のカレンダーを選択する (65ページ) 」を参照
してください。
注記: ユーザの受信ボックスに初めてタスクが届いたとき、そのタスクの期限がシステム カレン
ダーに基づいて計算される場合があります。次回タイマ ジョブが実行されるときに、そのジョブ
によりビジネス カレンダーに基づいて期限が更新されます。
3. リスト ボックスの上にある [+] (追加) ボタンをクリックして新しいタイマを追加するか、リスト ボッ
クス内の既存のタイマを反転表示します。
4. [イベント] ドロップダウン リストで、作成するタイマ アクションの種類 (事前タイマの有効期間ま
たは事後タイマの有効期間) を選択します。
5. [有効時間] テキスト ボックスでタイマの有効期限が切れるまでの経過時間を指定します。
このアクションが、特定の種類 (事前タイマまたは事後タイマ) の最初のタイマである場合、タイ
マの有効期限は、ワークフローまたはアクティビティの開始以降、指定された時間が経過した
時点で切れます。それ以降のタイマは、前回のタイマが期限切れとなってから、指定された時
間が経過した時点で有効期限が切れます。
注 記: ワークフロー タスクが停止したとき、関連する事後タイマは停止しません。事後タイマ
は、タスクは実行中であるものとして、タスクに指定された時間を考慮し続けます。
6. タイマの有効期限が切れたときに、Webtop や TaskSpace の受信ボックスではなくサードパー
ティ製の電子メール プログラムに電子メール メッセージを送信するには、[電子メール テンプ
レートの使用] チェックボックスをオンにし、[選択] ボタンをクリックします。
a. リポジトリから [既存のテンプレートを選択] オプションを選択するか、通知テンプレート ウィ
ザードを使用して新しい電子メール テンプレートを作成します。
新しい電子メール テンプレートを作成する方法については、「通知テンプレート ウィザード
を理解する (122ページ) 」を参照してください。
b. 既存の電子メール テンプレートを選択するか、新しいテンプレートを作成すると、[電子メー
ル テンプレートの使用] フィールドに電子メール テンプレートの名前が表示されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
113
アクティビティを操作する
サーバは、同じイベント タイプ (事前タイマまたは事後タイマ) のすべての通知に、選択し
た電子メール テンプレートを使用します。[電子メール テンプレートの使用] チェックボック
スをオフにした場合、サーバはデフォルトの通知を Documentum 受信ボックスに送信し
てユーザに通知します。
7. タイマの有効期限が切れたときに、Webtop や TaskSpace の受信ボックスではなくサードパー
ティ製の電子メール プログラムに電子メール メッセージを送信するには、[電子メール テン
プレートの使用] チェックボックスをオンにし、[選択] ボタンをクリックして、通知用のカスタ
ム電子メール テンプレートを選択します。
a. 既存のテンプレートを開くには、ファイル構造内で対象のテンプレートに移動し、選
択します。
b. [電子メール テンプレートの新規作成] を行うには、オプションを選択して [OK] をクリッ
クします。
c. Notification Template Wizard (通知テンプレート ウィザード) が表示され、これを使用して
新しい電子メール テンプレートを動的に作成できます。ウィザードを使用して電子メー
ル テンプレートを作成する手順については、通知テンプレート ウィザードを理解する
(122ページ) を参照してください。
8. サーバにアクティビティが完了するまで、最後の事前タイマまたは事後タイマ アクションを繰り
返させるには、[最後のアクションを繰り返す] チェックボックスをオンにします。
事前タイマ アクションと事後タイマ アクションでは、[最後のアクションを繰り返す] オプ
ションに異なる値を設定します。選択すると、最後のタイマ アクションは、アクティビティ
が完了するまで、指定した時間間隔で繰り返し実行されます。
9. [アクション] ドロップダウン リストから、タイマの有効期限が切れたときに起動されるアクショ
ンの種類を選択します。
選択可能なオプションは、定義されているタイマの種類 (事前タイマまたは事後タイマ) に依存
し、また、現在のアクティビティの性質によっても異なります。
• [通知] — 1 人または複数の受信者への通知メッセージの送信を有効にします (通知を
送信する (115ページ) )。
• [プロセスの開始] — 現在のアクティビティのパッケージを使用してプロセスを開始す
る (115ページ) ことができます。
• [Java メソッドの実行] — Java メソッドを実行する (116ページ) ことができます (スーパー
ユーザ権限を持つユーザのみ使用可能)。
• [タスクの委任] — 別の実行者にタスクを委任する (117ページ) ことができます (手動アク
ティビティの事後タイマにのみ使用可能)。タスクは、プロセス データに基づいて実行者に
委任することもできます。
• [タスクの完了] — タスクを完了する (117ページ) こと、および、そのタスクをワークフロー内の
次のアクティビティに転送することができます (手動の事後タイマにのみ使用可能)。
10. このアクティビティに追加する個々のタイマについて、これらの手順を繰り返します。
11. リスト ボックス内のタイマの順序を変更するには、タイマ アクションを反転表示し、リスト ボックス
の上部にある上下の矢印ボタンをクリックします。
この順序は重要です。タイマの有効期限は、前のタイマの有効期限が切れた時点後
の特定の時間間隔を示しているためです。
12. [適用] をクリックして [アクティビティ インスペクタ] を閉じずに更新を保存するか、[OK] をクリッ
クして更新を保存して [アクティビティ インスペクタ] を閉じます。
114
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
通知を送信する
タイマの有効期限が切れたときにユーザに電子メール通知を送信するには、このオプション
を使用します。
通知を送信するには
1. [通知の送信先] テキスト ボックスの横に表示された [選択] ボタンをクリックし、タイマの有効期
限が切れたときに通知するユーザを特定します。
[グループとユーザ]、[エイリアス]、または [プロセス データ] に基づいて通知を送信できます。
2. [グループとユーザ] に通知を送信するには、ラジオ ボタンを選択します。
a. ダイアログ ボックスの左半分でユーザまたはグループ名を反転表示します。
[グループ内のユーザ] ボックスには [グループ] ボックスで選択したグループのメンバーが
表示され、グループの個々のメンバーを選択することができます。
b. [追加] をクリックして、選択項目を選択リストに移動します。
c. [OK] をクリックします。
3. 特定の [エイリアス] を満たすユーザに通知を送信するには、ラジオ ボタンを選択します。
a. ダイアログ ボックスの左半分でエイリアス セットを選択します。
[実行者エイリアス] ボックスには、エイリアス セットと関連付けられたエイリアスが表示
されます。これらのエイリアスのいずれかを選択すると、システムには、エイリアス セッ
トが割り当てられている名前だけでなく、実行者エイリアスの説明も表示されます。
b. [追加] をクリックして、選択項目を右側のリスト ボックスに移動します。
c. [OK] をクリックします。
4. [プロセス データ] に基づいて通知を送信するには、ラジオ ボタンをクリックします。
システムにはプロセス データ ツリーが表示されます。
a. プロセス データ ツリーのノードを展開し、通知用に選択する属性を選択します。
場合によっては、実行者の選択を完成させるために、データの一部に属性や要素
を追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法につい
ては、「パッケージ属性をマップする (131ページ) 」を参照してください。
b. [追加] をクリックして、選択項目を右側のリスト ボックスに移動します。
c. [OK] をクリックします。
プロセスを開始する
タイマの有効期限が切れたときにワークフローを開始するには、このオプションを使用します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
115
アクティビティを操作する
プロセスを開始するには
1. [プロセスの開始] テキスト ボックスの横に表示された [選択] ボタンをクリックします。
2. 開始するプロセスのプロセス テンプレートを選択します。
選択されたテンプレートが受け取るパッケージの数と種類は、現在のアクティビティと
一致している必要があります。
3. 通知を受けるユーザを選択します。
通知対象となるユーザの選択の詳細については、「通知を送信する (115ページ)
」を参照してください。
4. [OK] をクリックします。
Java メ ソ ッ ド を 実 行 す る
タイマの有効期限が切れたときに Java メソッドを実行するには、このオプションを使用します。
対象の事後タイマ アクションがメソッドを呼び出す場合、タイマ ジョブはそのメソッドを起動
し、メソッドに次の引数を渡します。
• docbase_name <ドックベース>
• serverconfig_name <サーバ設定>
• workflow_id <ワークフロー ID>
• act_seqno <アクション シーケンス番号>
• timer_type <タイマのタイプであり、0 は事前タイマ、1 は事後タイマを示す>
• user_name <ドックベースのインストール所有者名>
注 記 : カスタム Java メソッドは、自動メソッド専用に予約されているため、これを
WorkflowMethod から拡張しないでください。
Java メ ソ ッ ド を 実 行 す る に は
1. [メソッド] テキスト ボックスの横に表示された [選択] ボタンをクリックします。
2. タイマの有効期限が切れたときに実行するワークフロー メソッドを選択し、[OK] をクリックします。
注 記 : ここでカスタム メソッドを使用可能にするには、a_special_app 属性を設定する必要があ
ります。a_special_app は Documentum 製品で使用するために予約されている dm_sysobject
属性です。この属性は、ワークフローの値を持っている必要があります。カスタム ワーク
フロー メソッド開発の詳細については、『Documentum Process Builder Development Guide
(Documentum Process Builder 開発ガイド)』を参照してください。
3. メソッドが実行されたときに実行ログを保存するには、[はい、実行結果を保存します] チェック
ボックスをオンにします。
4. 通知を受けるユーザを選択します。
通知対象となるユーザの選択の詳細については、「通知を送信する (115ページ)
」を参照してください。
116
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
タスクを委任する
タイマの有効期限が切れたときにタスクを委任するには、このオプションを使用します。
タスクを委任するには
1. [実行者] テキスト ボックスの横に表示された [選択] ボタンをクリックします。
[実行者の選択] ダイアログ ボックスが表示されます。[グループとユーザ]、[エイリア
ス]、または [プロセス データ] に基づいて実行者を割り当てることができます。
2. [グループとユーザ] に基づいて実行者を選択するには、ラジオ ボタンを選択します。
a. ダイアログ ボックスの左半分でユーザまたはグループ名を反転表示します。
[グループ内のユーザ] ボックスには [グループ] ボックスで選択したグループのメン
バーが表示され、グループの個々のメンバーを選択することができます。
b. [追加] をクリックして、選択項目を選択リストに移動します。
c. [OK] をクリックします。
3. 特定の [エイリアス] から実行者を選択するには、ラジオ ボタンを選択します。
a. ダイアログ ボックスの左半分でエイリアス セットを選択します。
[実行者エイリアス] ダイアログ ボックスに、エイリアス セットと関連付けられたエイ
リアスが表示されます。これらのエイリアスのいずれかを選択すると、システムに
は、エイリアス セットが割り当てられている名前だけでなく、実行者エイリアスの
説明も表示されます。
b. [追加] をクリックして、選択項目を右側のリスト ボックスに移動します。
c. [OK] をクリックします。
4. [プロセス データ] に基づいて実行者を選択するには、ラジオ ボタンをクリックします。
システムにはプロセス データ ツリーが表示されます。
a. プロセス データ ツリーのノードを展開し、実行者の属性を選択します。
場合によっては、実行者の選択を完成させるために、データの一部に属性や要素
を追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法につい
ては、「パッケージ属性をマップする (131ページ) 」を参照してください。
b. [追加] をクリックして、選択項目を右側のリスト ボックスに移動します。
c. [OK] をクリックします。
タスクを完了する
タイマの有効期限が切れたときにタスクを完了するには、このオプションを使用します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
117
アクティビティを操作する
タスクを自動的に完了する場合、属性を特定の値に選択すると、その属性値に基づくアクティビ
ティの移行条件に従って、タスクを別の宛先に転送できます。
タスクを完了するには
1. タスクが完了するときにタイマに属性値を設定させるには、[プロセス データ属性の変更]
チェックボックスをオンにします。
このチェックボックスをオフにした場合は、手順 3 にスキップします。
2. [プロセス データ] ドロップダウン リストから、タイマに値を設定させる属性を持つプロセス変数
またはパッケージを選択します。
3. [属性] ドロップダウン リストから、タイマに値を設定させる属性を選択します。
4. 選択した属性に値が複数ある場合は、[インデックス] リスト ボックスの 4 つのオプションから
1 つを選択するか、有効なインデックス値を入力することで、この条件の中で使用するイン
デックス値を指定します。
5. [値] テキスト ボックスで、タイマに設定させる選択した属性の値を入力します。
6. 通知を受けるユーザを選択します。
通知対象となるユーザの選択の詳細については、「通知を送信する (115ページ)
」を参照してください。
アクティビティ移行規則を設定する
移行規則により、ワークフロー内で次に発生するアクティビティを決定します。フローは、プロセス
データを使用して定義される移行ロジックに基づいて変更されます。1 つのアクティビティに複数
の出力フローがある場合、パッケージを後続のアクティビティすべてに送信することも、アクティビ
ティの結果に応じて一部の後続のアクティビティにのみ送信することもできます。たとえば、新しい
形式のデザインをレビューする実行者が、そのデザインを次のレビュー担当者に転送するか、改
訂するためにそれを設計者に送り返すかを選択できるようにすることができます。この分岐ロジック
を設定するには、このアクティビティから 2 つの可能性のある後続のアクティビティへのフローを作
成し、どのパスをたどるかを実行者が選択できるようにします。
注 記 : 分岐ロジックを持つ複数の出力フローがあるアクティビティは、ビジネス プロセス全体の決
定ポイントを表します。ビジネス プロセス テンプレートで決定ポイントをわかりやすく表示するに
は、明示的な決定分岐アクティビティ テンプレートをフローに挿入します。現在のアクティビティに
分岐ロジックを設定するのではなく、現在のアクティビティを単一の決定分岐アクティビティに接
続し、その決定分岐アクティビティに分岐ロジックを設定してください。詳細については、「決
定分岐 (168ページ) 」を参照してください。
アクティビティの出力フローが 1 つだけの場合、移行条件を設定する必要はありません。[移行] タ
ブは、[すべての接続されたアクティビティを選択] オプションが選択されているときは利用できませ
ん。アクティビティの自動ワークフロー メソッドで setoutput メソッドを使用して次のアクティビティを
選択する場合を除き、一般に自動アクティビティでは、[アクティビティの実行者に選択させる] オ
プションは選択しないでください。詳細については、『Documentum Process Builder Development
Guide (Documentum Process Builder 開発ガイド)』を参照してください。
移行の詳細については、「アクティビティ移行を定義する (32ページ) 」を参照してください。
移行アクションを定義するには
1. [アクティビティ インスペクタ] で、[移行] タブを選択します。
118
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
2. アクティビティからパッケージを次のアクティビティに送信する方法を指定します。
• このアクティビティに関連するすべての後続のアクティビティ (拒絶フローを含む) に
タスクを送信するには、[すべての接続されたアクティビティを選択] をオンにします。
• 現在のアクティビティが完了したときに実行者に選択するアクティビティを決定させ
るには、[次のアクティビティを実行者に選択させる] をオンにします。
• 条件セットに基づいて異なるアクティビティにパッケージを送信するには、[条件に応
じて実行者を選択] をオンにします。
条件セットに基づいてパッケージを送信する場合は、手順 6 にスキップします。
3. アクティビティが複数の実行者によって実行される場合 (つまり [実行者] タブで [グループの
すべてのユーザ] または [グループに所属する複数のユーザ] を選択した場合)、タスクを実行
する必要がある実行者の数を指定します。
• すべての実行者にタスクを完了させるには、[すべての実行者がタスクを完了しま
す] ラジオ ボタンを選択します。
• 特定の数の実行者がタスクを完了したときにアクティビティを完了するには、[複数の
実行者がタスクを完了します] ラジオ ボタンを選択し、テキスト ボックスに必要な実
行者の数を入力します。入力した数字が、実行時にこのアクティビティの作業項目
を受け取る実行者数より多い場合、サーバはすべての実行者がタスクを完了し
たときにアクティビティを完了します。
手順 2 で [すべての接続されたアクティビティを選択] を選択した場合は、手順 7
にスキップします。
4. 実行者に次のアクティビティを選択させる場合は、[アクティビティを最大 [ ] まで選択] ドロップ
ダウン リスト ボックスを使用して、実行者が選択できるアクティビティの最大数を指定します。
このリスト ボックスには、デフォルトで、次に実行可能なアクティビティの合計数が表示
されます。1 からこの合計数までの任意の数を選択できます。実行時はサーバによっ
て、実行者が選択できるアクティビティの数がここで指定された数までに制限されます。
5. 実行者のグループに次のアクティビティを選択させる場合 (つまり実行者のカテゴリが [グルー
プのすべてのユーザ] または [グループに所属する複数のユーザ] で、切り替えオプションが
[次のアクティビティを実行者に選択させる] の場合) は、選択された次のアクティビティにパッ
ケージを転送するタイミングを指定します。
• 選択された拒絶アクティビティを今すぐ開始するには、[却下する実行者] ラジオ ボタンを選
択します。いずれかの実行者が拒絶アクティビティを選択すると、それらのアクティビティは
他の応答を待たずに開始され、他の実行者の選択はすべて無視されます。
• 選択された転送アクティビティを今すぐ開始するには、[転送する実行者] ラジオ ボタンを選
択します。いずれかの実行者が転送アクティビティを選択すると、それらのアクティビティは
他の応答を待たずに開始され、他の実行者の選択はすべて無視されます。
• 手順 3 で指定した数の実行者がタスクを完了した場合にのみ、選択された次のアクティビ
ティを開始するには、[すべての実行者がタスクを完了します] ラジオ ボタンを選択します。
このオプションを選択すると、サーバはすべての実行者が選択したアクティビティを組み
合わせます。一部のユーザが転送アクティビティを選択し、別のユーザが拒絶アクティビ
ティを選択した場合、サーバはこのタブの最後にあるラジオ ボタン セットの設定に基づい
て、開始するアクティビティを決定します。
– 実行者によって選択されたすべてのアクティビティ、すなわち、転送アクティビティと拒
絶アクティビティの両方を開始するには、[選択したすべてのアクティビティを開始] を
選択します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
119
アクティビティを操作する
– 選択されている拒絶アクティビティだけを開始するには、[拒絶アクティビティのみ開始] を
クリックします。この場合、転送するアクティビティは、すべての実行者が転送するアクティ
ビティを選択した場合にのみ開始されます。
– 選択されている転送アクティビティだけを開始するには、[転送アクティビティのみ開始] を
クリックします。この場合、却下するアクティビティは、すべての実行者が却下するアクティ
ビティを選択した場合にのみ開始されます。
6. パッケージを受信するアクティビティを決定するためにサーバに適用される条件を指定します。
移行条件の作成については、「移行条件を作成する (120ページ) 」を参照してください。
7. 次のいずれかを実行します。
• [適用] をクリックして、アクティビティ インスペクタを閉じずに更新を保存する。
• [OK] をクリックし、更新を保存してアクティビティ インスペクタを閉じる。
移行条件を作成する
[条件に基づいて次のアクティビティを選択] オプションを選択すると、定義されている移
行条件を示す表が表示されます。最初にアクティビティを定義するとき、この表は空白で
す。以下の手順を実行して、ワークフローの次のアクティビティを自動選択するための
移行条件を追加します。切り替え条件の詳細については、「アクティビティ移行を定義
する (32ページ) 」を参照してください。.
注 記 : 移行条件を使用するアクティビティの場合、次のアクティビティに進むフローには、
そのフロー行の開始点にダイヤモンドが使用されます。このフォーマットは、Business Process
Modeling Notation (BPMN) 標準に準拠します。
移行条件を作成するには
1. [クエリ] 表の「IF」で始まる行を反転表示します。
システムにより、[移行ウィザード] タブおよび [手動編集] タブが表示されます。
2. [手動編集] を使用してカスタム条件タイプを作成するには、テキスト ボックスにテキストを
入力し、[適用] をクリックして、条件をクエリに追加します。
a. [移行ウィザード] を使用して条件を作成するには、[クエリの対象] ドロップダウン リスト
からオブジェクトを選択します。これは、当該条件を適用するオブジェクトです。有効
な選択肢は、次のとおりです。
• [実行中のワークフロー] — 条件によって dm_workflow オブジェクトの属性がチェックさ
れます。
• [アクティビティの前回の完了作業項目] — 条件によって dmi_workitem オブジェク
トの属性がチェックされます。
• [プロセス データ] — ドロップダウン リストから選択したプロセス パッケージまたはプ
ロセス変数の属性が、条件によってチェックされます。
b. [プロセス データ] を使用してクエリを実行する場合は、プロセスと関連付けられているパッ
ケージまたはプロセス変数をリスト ボックス内で選択します。
c. 選択した入力パッケージが XML ドキュメントであり、この条件で内部の XML 要素の値
をチェックする場合は、[XPath 式] チェックボックスをオンにし、条件の中で値を使用
する XML 要素を指定します。
120
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
• [スキーマ] テキスト ボックスに、パッケージ内のドキュメントに適用する XML スキーマの
完全修飾名を入力します。テキスト ボックスに直接名前を入力する以外に、[ローカル]
をクリックしてローカル ファイル システムからスキーマを選択したり、[リポジトリ] をクリック
して、Documentum リポジトリからスキーマを選択することもできます。
この手順は必須ではありません。スキーマを利用できない場合は、テキスト ボックス
は空白のままにしてください。
• [XPath 式] テキスト ボックスに、条件の中で使用する要素の XPath 式を作成します。手
順 a でスキーマを選択した場合は、[選択] ボタンをクリックして、有効な XPath 式の一覧
から選択できます。手順 a でスキーマを選択しなかった場合は、[書き込みの式] リンクを
クリックし、表示されたダイアログ ボックスで完全な XPath 式を入力します。式を入力した
ら、指定した要素の XML データ タイプを選択し、[OK] をクリックします。
[XPath 式] チェックボックスをオフにした場合は、条件の中で値を使用する Documentum リ
ポジトリ属性を選択します。
手順 2 で選択したオブジェクト タイプの属性がドロップダウン リストに表示されます。
単純なデータ タイプ (文字列型、ブール型、整数値、倍精度値、または日付型) をプロセ
ス変数として選択した場合、リストは使用できません。構造化されたデータ タイプがボッ
クスに表示され、ここから選択できます。
[繰り返し属性、インデックスを選択または指定してください] ドロップダウン リストが表示され
る場合、選択した属性は複数の値を持つことができます。リストの 4 つのオプションから 1
つを選択するか、有効なインデックスを入力することで、この条件の中で使用するインデッ
クスを指示します。移行条件に繰り返し属性への参照が含まれている場合は、その属性の
値が 1 つもなければ移行条件の評価時にエラーが発生します。
d. 選択した属性に対して実行するテストを指定します。
[条件] ドロップダウン リストから論理比較演算子を選択し、比較値を [値] テキス
ト ボックスに入力します。選択した属性のデータ タイプがボックスの下に表示さ
れます。
3. この条件が真の場合は、ページ下部にあるリスト ボックス内のアクティビティ名を反転表示し、
次に実行するアクティビティを選択します。
このアクティビティにフローによって接続されたアクティビティの名前が一覧表示されます。
複数のアクティビティを選択するには、Ctrl キーまたは Shift キーを押したまま、アクティ
ビティ名をクリックします。
注 記 : 条件に追加の句を加える予定であっても、アクティビティは今すぐ選択する必要が
あります。
4. この移行条件に追加の句を加えるには、[別の句を追加] ラベルの横にある [AND] または
[OR] ボタンをクリックして、手順 2 ～ 6 を繰り返します。
条件に複数の句が組み込まれている場合、サーバでは一般的な順序の規則を使用して式が
評価されます。言い換えると、AND で結合された句は、OR で結合された句の前に評価されま
す。たとえば、条件に次のようなフォームがあるとします。英字が条件句を表しているとします。
IF A AND B AND C OR D AND E OR F SELECT アクティビティ 1
サーバでは、この条件が次のように評価されます。
IF (A AND B AND C) OR (D AND E )OR F SELECT アクティビティ 1
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
121
アクティビティを操作する
5. 別の移行条件を追加するには、クエリ ボックスの上にある [+] ボタン (ELSE IF で始まる行
を追加します) をクリックして、前述の手順を繰り返します。
6. すべての移行条件を定義したら、どの条件も満たさない場合にパッケージが送られるアク
ティビティを選択します。
すべての移行条件を定義したら、[クエリ] 表内の「ELSE」で始まる行を反転表示し、ど
の条件も該当しないときに実行されるアクティビティを選択します。
通知を設定する
[通知] タブでは、ワークフロー関連イベント (アクティビティ状態の変更、自動イベント中のメソッド
のエラーなど) への応答としてサーバが送信するメッセージを設定できます。イベントの通知を受
け取るように登録されているユーザは、イベントに関連付けられた電子メール テンプレートを使用
して作成されたメッセージを受信します。詳細については、「通知を設定する (31ページ) 」を参照
してください。ワークフロー タイマに基づいて通知を送信することもできます。詳細については、
「警告タイマを設定する (112ページ) 」を参照してください。
注 記 : 自動アクティビティの場合、サーバは [作業項目の開始時] には通知を送信し
ません。
通知に使用する電子メール メッセージを指定するには
1. アクティビティ インスペクタの [通知] タブを選択します。
通知を送信する対象となるイベント名がタブに表示されます。通知に使用する電子
メール テンプレートの名前が、イベント名の下に表示されます。
2. デフォルトのイベント通知メッセージの代わりにカスタムの電子メール テンプレートを使用する場
合は、イベント名の横にある [電子メール テンプレートの変更] チェックボックスをオンにします。
このチェックボックスをオンにすると、[選択] ボタンがアクティブになります。
a. リポジトリから [既存のテンプレートを選択] オプションを選択するか、通知テンプレート ウィ
ザードを使用して新しい電子メール テンプレートを作成します。
新しい電子メール テンプレートを作成する方法については、「通知テンプレート
ウィザードを理解する (122ページ) 」を参照してください。
b. 既存の電子メール テンプレートを選択するか、新しいテンプレートを作成すると、イベント
名の下に電子メール テンプレートの名前が表示されます。
3. システムが電子メール通知を送信する対象の各イベントについて、必要に応じて手順 2 を
繰り返します。
4. [適用] をクリックして [アクティビティ インスペクタ] を閉じずに更新を保存するか、[OK] をクリッ
クして更新を保存して [アクティビティ インスペクタ] を閉じます。
通知テンプレート ウィザードを理解する
アクティビティの内部から電子メール テンプレートを動的に作成するには、通知テンプレート ウィ
ザードを使用します。電子メール通知テンプレートはプロセス データを基にして作成でき、テンプ
レートが /System/Workflow/EmailTemplates フォルダに保存されるようにすることができます。複数
122
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
のプロセスでテンプレートを共有できます。ただし、テンプレートは各プロセスに固有のプロセス
データおよびマッピングに基づくため、共有しないことをお勧めします。
注 記 : 通知テンプレートでマッピングを編集すると、システム全体でテンプレートが変
更されます。テンプレートを使用するすべてのアクティビティは、ユーザが行った変更
を反映するためにすぐに更新されます。
デフォルトの通知送信者および受信者のリストは、イベントのタイプに基づいています。マッピング
で指定された受信者に加えて、デフォルトの受信者にもシステムから通知が送信されます。電子
メールの [送信者] フィールドが特定の値にマップされている場合、デフォルトの送信者はマップさ
れた値によって上書きされ、マップされた送信者の値のみが使用されます。
表7
イベントに基づくデフォルトの送信者および受信者
イベント名
説明
デフォルトの送信者
デフォルトの受信者
dm_startedworkitem
新しいタスクが作成さ
アクションにより新しいタス
タスクの実行者
れる
クの作成をトリガしたユーザ
(前のアクティビティの実行
者など)
dm_delegatedworkitem
タスクが委任または再
タスクを委任したユーザ
ターゲット ユーザ
タスクの実行者
ワークフロー スー
割り当てされる
dm_changedactivity
自動タスクの失敗
パーバイザ
instancestate
事前タイマの有効期限切れ
事前タイマの有効期
リポジトリ インストール所有
通知対象として事
限切れ
者
前タイマ リストで選
択されたユーザ/グ
ループ
事後タイマの有効期限切れ
事後タイマの有効期
リポジトリ インストール所有
通知対象として事
限切れ
者
後タイマ リストで選
択されたユーザ/グ
ループ
新しい電子メール テンプレートを作成する
新しい電子メール テンプレートを作成するには
1. アクティビティ インスペクタの [通知] タブを選択します。
2. [電子メール テンプレートの新規作成] を行うためのオプションを選択して [OK] をクリックします。
3. 英数字のみを使用してテンプレート名を入力します。
スペース、アンダースコア、または特殊文字は使用できません。
4. 通知の件名を入力します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
123
アクティビティを操作する
プロセス データにマップされる静的テキストまたはプレースホルダを使用すると、動的テキス
トを表現できます。
• プレースホルダの前には、ドル記号「$」が付きます (例: 発注書番号を表す $orderno)。
• 複数値のプレースホルダを作成するには、2 つのドル記号「$$」を使用します。
• 通知でリテラルのドル記号を使用するには、「\$」を使用します (たとえば、500 ドルは
「\$500.00」と表されます)。
注 記: プレースホルダ値は、スペースを含まない英数字である必要があります。プレースホ
ルダは、ドル記号「$」の後から始まり、最初の英数字以外の文字で終わります。
たとえば、購買発注書が正常に処理されたことを示すメッセージを送信するために、「購買発注
書 $orderno は正常に処理されました」というテンプレート テキストを使用するとします。プレース
ホルダ "orderno" がデータ マッピング画面に表示され、パッケージまたはプロセス変数にマッ
プすることができます。送信される通知の件名は、「購買発注書 0896523 は正常に処理されま
した」となります。ここで、"0896523" は応答データ マッピングにより置き換えられた値です。
注 記 : プレースホルダ値はすべて、プロセス データにマップする必要があります。
5. 電子メール テンプレートのテキストを [本文テンプレート] テキスト ボックスに入力します。
静的テキスト、サード パーティの HTML エディタからコピーされた HTML、プロセス データに
マッピングされるプレースホルダ値を含めることができます。
電子メール本文に HTML マークアップを使用する場合は、電子メール メッセージの [本
文] ノードの [コンテンツ タイプ] に、定数値「text/html」をマップする必要があります。[コン
テンツ タイプ] が特定の値にマップされていない場合、コンテンツ タイプはデフォルトで
text/plain が使用されます。
• プレースホルダの前には、ドル記号「$」が付きます (例: $orderno)。
• 複数値のプレースホルダを作成するには、2 つのドル記号「$$」を使用します。
• 電子メール本文でリテラルのドル記号を使用するには、「\$」を使用します (たとえば、500 ド
ルは「\$500.00」と表されます)。
注 記 : プレースホルダ値は、スペースを含まない英数字である必要があります。プレースホ
ルダ トークンは、ドル記号「$」の後から始まり、最初の英数字以外の文字で終わります。ま
た、プレースホルダ値はすべて、プロセス データにマップする必要があります。
6. [次へ] をクリックして、プロセス データを電子メール メッセージに関連付ける入力メッセージ
マッピングを作成します。
右側のペインに電子メール メッセージ構造、左側のペインにプロセス データが表示されま
す。電子メール メッセージ属性をプロセス データ モデルの属性からマップすることにより、そ
の値を設定できます。電子メールの添付ファイルが複数ある場合、[添付ファイル] ノードの
[追加] をクリックしてさらに添付ファイルを追加できます。
注 記 : システムは、[通知] フィールドで定義されているユーザごとに 1 回ずつ電子メール テ
ンプレートを呼び出します。電子メール テンプレートに受信者もマップされている場合は、
[タイマ] タブで定義されているユーザごとに 1 つの電子メールがその受信者に送信されま
す。通知先として 3 人のユーザが選択されており、[送信先:] フィールドに受信者がマップさ
れている場合、システムは、3 人の各ユーザに通知を送信し、[送信先:] マッピングで指定
されているユーザにも通知の 3 つのコピーを送信します。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
124
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
注 記 : [件名] ノードおよび [本文] ノードのプレースホルダ ノードはすべて、この時点でマップ
する必要があります。[受信者] フィールドがマップされている必要はありません。
7. [次へ] をクリックして出力メッセージをマップします。
たとえば、プロセス変数 MsgId を追加した場合、ソース メッセージの通知メッセージ ID 属
性をそのプロセス変数にマップできます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
8. [OK] をクリックします。
テンプレートは、テンプレートを作成した対象である特定の通知の、デフォルト テ
ンプレートになります。
アクティビティ内のプロセス データを変更する
アクティビティを設定する場合は、アクティビティの実行中に使用されるプロセス データを指定し、
プロセス テンプレートの構成要素である各パッケージ、プロセス パラメータ、またはプロセス変数
がアクティビティでどのように処理されるかを定義する必要があります。プロセス データは、[プロセ
スのプロパティ] の [データ] タブで定義します。プロセス データをプロセス テンプレートに追加す
る方法については、「パッケージを管理する (59ページ) 」を参照してください。
アクティビティ インスペクタの [データ] タブでは、プロセスで使用されるパッケージ、プロセス パラ
メータ、プロセス変数のいずれかに関連するカテゴリに分類されたプロセス データがツリー表示さ
れます。リスト ボックスには、プロセス データに固有なタイプやバージョンその他の属性など、
プロセス データに関して使用可能な情報が表示されます。
個々のパッケージ、プロセス パラメータ、またはプロセス変数に関する情報を表示するには、[パッ
ケージ]、[プロセス パラメータ]、または [プロセス変数] の特定のノードを反転表示します。パッ
ケージの場合、名前、タイプ、バージョンが表示されるフィールドはいずれも読み取り専用で、[プ
ロセスのプロパティ] ページでしか変更できません。プロセス変数およびプロセス パラメータに
関する情報は、ノード表示で変更できます。
[データ] タブ内のチェックボックスのオンとオフを切り替えることにより、アクティビティがプロセ
ス データを処理する方法を変更できます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
125
アクティビティを操作する
既存のパッケージ プロセス データを編集する
既存のパッケージ プロセス データを編集するには
1. [アクティビティ インスペクタ] で [データ] タブを選択します。
2. [パッケージ] ノードを展開し、ツリーにあるいずれかのパッケージを選択します。
パッケージのリストは、プロセス テンプレート定義から生成されます。
3. アクティビティの実行者に対してこのパッケージを表示するには、[フォーム] ドロップダウン リス
トからフォーム テンプレートを選択します。
デフォルトでは、[プロセスのプロパティ] ダイアログ ボックスでパッケージに割り当てられた
フォーム テンプレートが表示されます。ドロップダウン リストには、デフォルトのフォーム テ
ンプレートと同じデータ モデルを使用するフォーム テンプレートだけが表示されます。ワー
クフローでのフォームの使用方法については、「フォーム テンプレートをパッケージに関連
付ける (29ページ) 」を参照してください。
フォーム テンプレートがパッケージに割り当てられていない場合、タスク マネージャはデフォ
ルトのオプションを使用してパッケージのコンテンツを表示します。通常はドキュメント タイプ
に関連付けられたアプリケーション (たとえば、Word 文書の場合は Microsoft Word) でパッ
ケージを開くことができるようになります。
4. 手順 3 で選択したフォームを使用してパッケージのプロパティを表示するには、[プロパティ用
フォームの使用] チェックボックスを選択します。
[プロパティ用フォームの使用] チェックボックスがオフの場合、手順 3 のフォームは、ア
クティビティの実行者が自分の受信ボックスからパッケージを選択したときに表示され
ます。フォームはパッケージのコンテンツを保存するために使用されます。このチェック
ボックスをオンにすると、実行者がパッケージのプロパティを表示したときにフォームが
表示されます。この場合、フォームはパッケージのコンテンツを保存するためではな
く、リポジトリ内のパッケージのプロパティを設定するために使用されます。
5. このパッケージをアクティビティの実行者が利用できるようにするには、[このアクティビティ
で表示] チェックボックスをオンにします。
[このアクティビティで表示] チェックボックスがオフの場合、このパッケージはアク
ティビティの実行者には表示されません。ただし、パッケージを移行条件で使用す
ることはできます。
6. パッケージに常にコンテンツ オブジェクトを関連付けるようにするには、[これは必須パッ
ケージ] をオンにします。
このチェックボックスがオフの場合、アクティビティの実行者は、パッケージにコンテン
ツを割り当てるかどうかを任意で選択できます。
7. Process Builder がパッケージ用のレポート データを BAM データベースに発行できるようにす
るには、[このパッケージはレポートの生成に使用できます] を選択します。
8. プロセスに含まれる各パッケージについて、手順 2 ～ 6 を繰り返します。
次のいずれかを実行します。
• [適用] をクリックして、アクティビティ インスペクタを閉じずに更新を保存する。
• [OK] をクリックし、更新を保存してアクティビティ インスペクタを閉じる。
126
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
アクティビティを操作する
手動アクティビティからパッケージを自動的に起動する
手動アクティビティからパッケージを自動的に起動するには
1. [パッケージ] ノードを反転表示します。
ページには、プロセス フローに関連付けられているパッケージのみが表示されます。
2. [自動起動パッケージ] をクリックして、アクティビティが開始するときにパッケージまたは関連付
けられているフォームが自動的に表示されるようにします。
このオプションを選択すると、パッケージが直ちに表示されるようになります。デフォル
トでは、実行者が受信ボックスからアクティビティを開始すると、タスク マネージャが表
示され、各パッケージがリンクとして表されます。実行者がそのリンクをクリックすると、
パッケージに割り当てられたフォームまたはドキュメント タイプに関連付けられたアプ
リケーションを使用して、パッケージが表示されます。
3. ドロップダウン リストから、起動されるパッケージの名前を選択します。
既存のプロセス変数を変更する
既存のプロセス変数を変更するには
1. [アクティビティ インスペクタ] で [データ] タブを選択します。
2. [プロセス変数] ノードを反転表示します。
ページには、プロセス テンプレートに関連付けられているプロセス変数のみが表
示されます。
3. プロセス変数をアクティビティの実行者が利用できるようにするには、[この変数はこのアク
ティビティで表示されます] チェックボックスをオンにします。
このチェックボックスがオフの場合、この変数はアクティビティの実行者には表示
されません。
4. この変数を公開してレポートの生成に使用するには、[この変数はレポートの生成に使用で
きます] チェックボックスをオンにします。
既存のプロセス変数を編集する
既存のプロセス パラメータを編集するには
1. [アクティビティ インスペクタ] で [データ] タブを選択します。
2. [プロセス パラメータ] ノードを反転表示します。
ページには、プロセス テンプレートに関連付けられているプロセス パラメータが表
示されます。
3. この変数を公開してレポートの生成に使用するには、[この変数はレポートの生成に使用で
きます] チェックボックスをオンにします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
127
アクティビティを操作する
表示設定を変更する
[表示] タブのオプションで、プロセス テンプレートの画面にアクティビティをどのように表示す
るかを制御します。
注 記 : アクティビティに 1 つまたは複数のタイマのアクションが設定されている場合、プロセス
テンプレート エディタ ペインには、アクティビティのアイコンの右下隅に小さな時計アイコンが
表示されます。
アクティビティの表示設定を変更するには
1. [アクティビティ インスペクタ] で [表示] タブを選択します。
2. テンプレート内のアクティビティを示すグラフィックを変更するには、[リポジトリの参照] また
は [ローカルの参照] を選択して新しい画像を検索します。
3. グラフィックが含まれているファイルに移動します。
• ローカル ファイル システムを参照している場合は、ファイルに移動して [開く]
をクリックします。
• リポジトリを参照している場合は、ファイルに移動して [選択] をクリックします。
[イメージ ファイル] ボックスに、選択したファイルが表示されます。
注記: アクティビティ イメージの標準の場所 (リポジトリ フォルダ System/Workflow/Images) 以外
からイメージを選択する場合は、ユーザがアクティビティを保存するときに、イメージのコピーが
このフォルダ内に自動的に保存されます。[ローカルの参照] を使用して標準のイメージ ディレク
トリ (C:\Program Files\Documentum\BPM\classes\images) 以外の場所にあるイメージを選択する
場合、イメージ ファイルはリポジトリ フォルダ System/Workflow/Images 内にインポートされます。
4. アクティビティを表すグラフィックのサイズを変更するには、[イメージ サイズ] ドロップダウン リ
ストから表示倍率を選択します。
この表示倍率は、グラフィックの実際のサイズ倍率です。
5. アクティビティのラベルを表示するかどうかを指定するには、[ラベルを表示] チェックボッ
クスをオンまたはオフにします。
[ラベルを表示] をオフにした場合は、手順 5 と 6 をスキップします。
6. アクティビティに [アクティビティ名] と [実行者] のどちらのラベルを表示するかを選択します。
テンプレートの検証時などに表示されるエラーメッセージでは、アクティビティがその名
前で示されます。アクティビティのラベルを実行者名にした場合、アクティビティを識別
するためにこの設定を一時的に [アクティビティ名] に変更することもできます。
7. テンプレートでアクティビティのラベルに使用するフォントとスタイルを設定します。
• [ラベルのフォント] リストからフォントを選択します。
• [フォント サイズ] ドロップダウン リストからフォント サイズを選択します。
• アクティビティのラベルのフォント スタイルを設定するには、[太字] と [斜体] をオン
またはオフにします。
8. 次のいずれかを実行します。
• [適用] をクリックして、アクティビティ インスペクタを閉じずに更新を保存する。
• [OK] をクリックし、更新を保存してアクティビティ インスペクタを閉じる。
128
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
第8章
プロセス データ要素をマップする
この章では、 次のトピックについて説明します。
•
データ マッピング ツールを理解する
•
タスク コメントをプロセス データとしてマップする
•
XML フ ァ イ ル を 使 用 し て フ ォ ー ム に 値 を 入 力 す る
•
HTTP 受 信 初 期 化 ア ク テ ィ ビ テ ィ を 使 用 し て 新 し い 高 忠 実 度 フ ォ ー ム イ ン ス タ ン ス を 作 成 す る
•
高忠実度フォーム インスタンスをパッケージとして作成する
•
添付ファイルとして高忠実度フォームを作成する
•
データ マッパを使用する
•
繰り返し属性をマップする
•
繰り返し属性を使用する
•
ノードに新しいインデックス値を追加する
•
複数値属性に単一値属性をコピーする
•
単一値属性に複数値インデックスをコピーする
•
複数値インデックスの特定のインデックスに、複数値属性のすべての値をコピーする
•
入力コンテキストを理解する
•
プロセス データ マッパ アクティビティを使用してグローバル ログイン チケットを生成する
•
動 的 Web サ ー ビ ス ア ク テ ィ ビ テ ィ を 使 用 し て 、 信 頼 さ れ た 各 種 リ ポ ジ ト リ の グ ロ ー バ ル ロ グ
イン チケットを生成する
データ マッピング ツールを理解する
データ マッピング ツールは、ワークフロー データを渡すプロセスを単純化する、視覚的なマッピ
ング ツールです。このツールでは、ウィンドウ左側のプロセス データ、プロセス パラメータ、ま
たはワークフローの属性と、ウィンドウ右側のサーバまたはワークフローの属性との間でデータ
をマップすることができます。たとえば、ワークフロー メソッドの引数、Web サービスのパラメー
タ、データベース クエリの戻り値などのデータ ソースや、JMS、HTTP、FTP などのサービスに固
有の属性などをマップできます。
また、実行者を定義する際に、データ マッパを使用して、フロー内のパッケージまたは変数のプロ
セス データを、ワーク キューで定義したスキルに関連付けることができます。
自動化されたアクティビティの多くでは、1 つのデータ ソースから別のデータ ソースへのマッピン
グ情報が必要です。たとえば、ローン貸付プロセスに、顧客の信用度を調べる Web サービスを呼
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
129
プロセス データ要素をマップする
び出すアクティビティが含まれているとします。このアクティビティでは、ローン申込パッケージの社
会保障番号を Web サービスに渡す必要があります。また、返された信用度を、それ以降のアク
ティビティでも利用できるように別のパッケージ属性にコピーすることも必要です。グラフィック マッ
ピング ツールを使用すると、パッケージ属性のデータを Web サービスの入力パラメータにマップし
たり、Web サービスの出力メッセージのデータをパッケージ属性にマップしたりできます。
図7
HTTP 受 信 メ ッ セ ー ジ を プ ロ セ ス デ ー タ に マ ッ プ す る
データ マッピング ツールには、次の 3 つの列があります。
• 左側の列では、利用可能なデータ ソースが、折りたたみ式のツリー コントロール形式で表示さ
れます。
• 右側の列では、利用可能なデータ デスティネーションが、折りたたみ式のツリー コントロー
ル形式で表示されます。
• 中央の列はマッピング領域です。データ マッピング関数を表すボックス、およびそれらのボック
スと入力ソースや出力先を結ぶ線が表示されます。
左右の列のコンテンツは、設定しているアクティビティの種類によって異なります。入力値を指定
する必要があるアクティビティの場合、通常、左側の列には、すべてのビジネス プロセス パッ
ケージの属性、プロセス変数、および実行時に利用可能な実行時変数 (担当スーパーバイザ
名など) が表示されます。
中央の列には、左側の 1 つまたは複数のデータ ソースから右側のデータ デスティネーションに、
データを転送するための関数が表示されます。マッピング ツールを使用すると、1 つのデータ
ソースから別のデータ ソースへの値の直接コピー、データ タイプの変換、文字列の連結、数学演
算処理、定数値の挿入などの操作を行うことができます。使用可能な関数の一覧については、
「データ マッピング関数を使用する (139ページ) 」を参照してください。
130
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス データ要素をマップする
ツリー コントロール内の最低レベルのアイテム (ツリーの「リーフ」) とデータをマップするときは、横
の [+] または [—] のアイコンを使ってツリーを展開したり折りたたんだりします。ツリーに表示される
データ タイプは、パッケージ、プロセス変数、実行データ、プロセス パラメータなどです。
プロセス データをマッパで編集または追加する
[編集] リンクを選択して [プロセス データの編集ダイアログ] を開くことにより、データ ツ
リーのほとんどの要素を追加したり編集したりできます。データ エディタを使用すると、
マッパのデータ ツリーから要素を作成、更新、削除できます。また、プロセス設計時に
必要に応じてプロセス モデルを変更することもでき、デザイナを終了して [プロセスの
プロパティ] ダイアログ ボックスを開く必要はありません。
ノード、パッケージ、またはデータ属性で緑のプラス記号のアイコン が表示された場合、プロセ
ス データ内のその場所に関連付けられたデータを追加または編集できることを表しています。
パッケージ属性をマップする
デフォルトでは、マッパの両側のパッケージについて、選択されている属性だけがツリーに表示
されます。 つまり、パッケージのオブジェクト タイプに対応したすべてのカスタム属性、および
選択した一般的な標準属性が表示されます。また、パッケージ ノードには、コンテンツを他の
ソースにマップできる次の 3 つの追加属性も表示されます。
• content-type : パッケージのコンテンツの MIME タイプ文字列表現。
• format : コンテンツに関連付けられているフォーマット オブジェクト (dm_format) の名前。
• data : パッケージの実際のコンテンツ。
また、パッケージには r_object_id 属性もあります。r_object_id 属性には、パッケージのオ
ブジェクト ID が含まれています。
デフォルトでは、マッパに表示されるのは基本のパッケージ属性のみです。しかし、マッピング
を完成させるためには、現在ツリーに表示されていない、パッケージの他の属性も表示させた
い場合もあります。
追加のパッケージ属性を表示するには
1. パッケージ名を右クリックして、[その他の属性の表示] を選択します。
マッパのパッケージを選択すると、ダイアログ ボックスが開いて、パッケージのオブジェ
クト タイプに対するすべての属性のリストが表示されます。
2. マッピングで使用する属性を反転表示します。
複数の属性を選択する場合は、Shift または Ctrl キーを押しながら選択します。
3. [OK] をクリックしてダイアログ ボックスを閉じます。
選択した属性が、ツリー コントロールのリストにアルファベット順で追加されます。
注 記 : 追加した属性を関数にマップしていない場合、アクティビティを保存してから [アクティ
ビティ インスペクタ] を再び開いても、その属性は表示されません。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
131
プロセス データ要素をマップする
タスク コメントをプロセス データとしてマップする
パッケージのコメントを構造化データ タイプにマップすることで、作成日、作成者名、およびメモ
ID とともに複数の実行者コメントを取り込むことができます。その後、統合されたコメントは、後続の
アクティビティで表示したり、電子メール メッセージの本文にマップしたりすることができます。
左側のソース入力メッセージ マッピングにあるデータ ツリーの [パッケージ] ノードに、[note[ALL]]
属性のみが表示されます。
ア ク テ ィ ビ テ ィ テ ン プ レ ー ト で note[ALL] を 設 定 す る に は
1. [プロセスのプロパティ] ダイアログを使用して、繰り返し値であるパッケージおよび構造
化データ タイプをプロセスに追加します。
構造化データ タイプには、コメントのマッピングで使用する属性が含まれています。SDT に
は、必須属性 ([id]、[writer]、[text]、および [creation_date]) が含まれている必要があります。
2. アクティビティ テンプレートを開き、設定して、データ マッパを開きます。
3. 入力メッセージ マッピングで、[プロセス データ] > [パッケージ] > [note[ALL]] を展開します。
4. 宛先側に表示されている、作成した構造化データ タイプの属性に、必要なソース属性を
マップします。
5. アクティビティ テンプレートを保存します。
メッセージ プロパティを追加する
マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加したい場合があり
ます。この場合、そのプロパティをメッセージに追加できますが、必ず正しいノードに追加して、適切
な名前を付ける必要があります。追加されたメッセージ プロパティに対する検証は行われません。
プロパティをメッセージに追加するには
1. ツリーのメッセージ プロパティ ノードを右クリックします。
2. メニューの [追加] を選択します。
[データ マッパ パラメータ] ダイアログ ボックスが表示されます。
3. マッパにプロパティを追加するには、 をクリックします。
未定義の新しいプロパティがツリーに追加されます。
4. プロパティの [表示名] と [フルネーム] を入力します。
5. 追加するプロパティの [タイプ] を選択します。
6. [OK] をクリックすると、このプロパティがメッセージに追加されます。
注 記 : 追加したプロパティを関数にマップしていない場合、[アクティビティ インスペクタ] を再
び開いたときには、そのプロパティは保存されていません。
XML ス キ ー マ を ア ク テ ィ ビ テ ィ コ ン テ ン ツ に 追 加 す る
添付ファイルまたはパッケージ コンテンツ、あるいは外部ソース (HTTP または JMS サービスなど)
から受信したコンテンツに XML スキーマを関連付け、マッパを使用してそのスキーマから要
素をマップすることができます。スキーマをデータ マッパ ツリーのノードに関連付ける前に、ス
132
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス データ要素をマップする
キーマを変更して、相対 URL を含むスキーマ インポート ステートメントのすべてで絶対 URL が
使用されるようにします。
XML スキーマがコンテンツ データと関連付けられれば、データ ノードは展開されます。XML ス
キーマを使用するフォームとパッケージが関連付けられている場合、コンテンツ データのノードに
はフォームと関連付けられている XML スキーマが自動的に表示されます。
注 記 : ユーザがマップする値が列挙セットに基づいている場合、値を右クリックして [列挙
の表示] を選択することで、使用可能な値のリストを表示することができます。
XML ス キ ー マ を 追 加 す る に は
1. 属性のツリーで、[データ] 要素に移動します。
2. [データ] を右クリックし、[要素の追加] を選択して [スキーマ] ダイアログを表示します。
3. [参照] をクリックして、リポジトリからスキーマを選択します。
XML ファイルと XSD ファイルを表示するようにリストをフィルタ処理したり、すべてのコ
ンテンツ タイプ形式を表示するように選択できます。
4. マッピングで使用するスキーマの [要素] を選択します。
5. 必要に応じて、メッセージ本文を必要な形式に変換する際に使用する [トランスレータ]
を選択します。
プ ロ セ ス に Forms Builder フ ォ ー ム を 組 み 込 む
Forms Builder フォームとワークフローを関連付けると、フォームを使用してプロセスに情報を入力
し、それを指定 URL または電子メール アドレスに送信することができます。その後、このデータを
ワークフローに組み込むことができます。フォームからワークフローにデータが送信されると、フォー
ムのスキーマからの要素を、プロセス変数、パッケージ、または添付ファイルにマップできます。
XML フ ァ イ ル を 使 用 し て フ ォ ー ム に 値 を 入 力 す る
入力 XML スキーマを使用して、フォーム スキーマに要素をマップすることにより、データ マッパ
でフォームのフィールドに値を入力することができます。
XML フ ァ イ ル か ら フ ォ ー ム に デ ー タ を 取 り 込 む に は
1. Forms Builder でフォームを作成し、そのフォームをパッケージとしてプロセスおよび FTP 受信
アクティビティ テンプレートなどのアクティビティに関連付けます。
フォーム スキーマがパッケージのデータ ノードに表示されます。
2. データ マッパを使用して、リポジトリの XML スキーマとアクティビティの [データ] ノードを
関連付けます。
データ マッパに XML スキーマを追加する方法については、「XML スキーマをアク
ティビティ コンテンツに追加する (132ページ) 」を参照してください。
3. マッパ内のマッピング機能を使用して、XML のファイル スキーマからフォーム スキーマに
コンテンツを移動します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
133
プロセス データ要素をマップする
プロセス データを使用して高忠実度フォームを作成する
高忠実度フォーム テンプレートは、紙のフォームにきわめて似ており、OpenOffice.org の機
能が組み込まれたフォームを生成します。
高忠実度フォーム テンプレートとプロセスを関連付けると、スキーマの要素にプロセス データをマッ
プし、プロセス データから高忠実度フォームのインスタンスを作成または生成することができます。
HTTP 受 信 初 期 化 ア ク テ ィ ビ テ ィ を 使 用 し て 新 し い 高 忠 実 度 フ ォ ー ム イ ン
スタンスを作成する
受信アクティビティを使用して、新しい高忠実度フォーム インスタンスを作成することができます。
インスタンスから新しい高忠実度フォームを作成するには
1. [URL 接尾辞] を使用して HTTP 受信 - 初期化アクティビティ テンプレートを設定し、[リクエスト
タイプ] として [通知] を選択して、添付ファイルを要求に含めるように選択します。
2. リポジトリにインストールされている高忠実度フォームに基づいたプロセス内でパッケージ
を作成します。
[これは必須パッケージ] チェックボックスをオフにして、そのパッケージをプロセスの必
須パッケージに設定しないようにします。
3. HTTP 受信 - 初期化アクティビティ テンプレート用のデータ マッパで、添付ファイルに対応す
る [ソース データ] ノードを右クリックし、[フォーム テンプレートを追加] を選択します。
4. 目的のフォーム テンプレートの場所を参照し、選択します。
オブジェクト タイプは dm_xfm_form です。
5. マッピングで使用するスキーマの [要素] を
6. [OK] をクリックします。選択します。
[データ] ノードを展開すると、高忠実度フォームの属性を参照することができます。
7. 作成したフォームで電子メールを送信する場合は、プロセスに SMTP 送信アクティビティ テン
プレートを追加し、電子メール添付ファイル ノードにパッケージ コンテンツをマップします。
8. HTTP 添付ファイルの [データ] ノードから [パッケージ] ノードに必要なスキーマ要素をマップ
し、アクティビティ テンプレートを保存します。
プロセス データ マッピング アクティビティを使用して高忠実度フォーム イン
スタンスを作成する
プロセス データ マッピング アクティビティ テンプレートを使用して、ワークフローに高忠実度
フォーム インスタンスを作成後、FTP 送信や SMTP 送信などの送信アクティビティ テンプレートを
使用して、添付ファイルまたはパッケージとしてフォームを送信することができます。
高忠実度フォーム インスタンスをパッケージとして作成する
高忠実度フォーム インスタンスをパッケージとして作成するには
1. リポジトリにインストールされている高忠実度フォームに基づいたプロセス内でパッケージ
を作成します。
134
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス データ要素をマップする
[これは必須パッケージ] チェックボックスをオフにして、そのパッケージをプロセスの必
須パッケージに設定しないようにします。
2. プロセス データ マッピング アクティビティ テンプレートを開いて、パッケージの [ソース データ]
ノードを右クリックし、[フォーム テンプレートを追加] を選択します。
3. 目的のフォーム テンプレートの場所を参照し、選択します。
オブジェクト タイプは dm_xfm_form です。
4. マッピングで使用するスキーマの [要素] を選択します。
5. [OK] をクリックします。
パッケージのデータ ノードを展開すると、高忠実度フォームの属性を参照すること
ができます。
6. デフォルトのフォルダではないフォルダに新しい高忠実度フォームを作成するには、新しい
フォルダの場所に r_folder_path をマップします。
7. 作成したフォームで電子メールを送信する場合は、プロセスに SMTP 送信アクティビティ テン
プレートを追加し、電子メール添付ファイル ノードにパッケージ コンテンツをマップします。
添付ファイルとして高忠実度フォームを作成する
高忠実度フォーム インスタンスを添付ファイルとして作成するには
1. 前述の「高忠実度フォーム インスタンスをパッケージとして作成するには」 (134ページ)
の手順に従います。
2. マッピング先で、[添付ファイル] ノードの [フォーム テンプレート名] を右クリックし、高忠実度
フォーム テンプレート名に割り当てます。
注 記 : このマッピングは必須です。
3. フォームの属性に必要なプロセス データ値をマップします。
4. 作成したフォームで電子メールを送信する場合は、プロセスに SMTP 送信アクティビティ テン
プレートを追加し、電子メール 添付ファイル ノードに添付ファイル コンテンツをマップします。
高忠実度フォームを使用してプロセスにデータを追加する
プロセスで高忠実度フォームを受信し、後でワークフローで使用できるようにフォームの情報をプ
ロセスに組み込むことができます。たとえば、高忠実度フォームの添付ファイルを含む受信電
子メール アクティビティ テンプレートからフォームを受信する場合、プロセス変数に受信プロセ
ス データをマップし、プロセスにその情報を追加できます。
条件に基づいてノードを追加する
ノードの子属性を使用して作成された式を使用するデータ ツリーにノードを追加するには、
Conditional Node Builder を使用します。このオプションは、複数の属性を持つ一部の繰り返しノー
ドと、[実行データ] 親ノード内に位置する作業項目ノードで使用できます。
ノ ー ド に 条 件 を 追 加 す る に は:
1. ノードを右クリックし、[条件ビルダの表示] を選択します。
2. データ ツリーを展開し、式を作成する対象である要素を選択します。
3. 要素と演算子を選択し、式の作成で使用する値を入力します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
135
プロセス データ要素をマップする
4. [式の挿入] ボタンをクリックして式を作成します。
テキスト ボックスに式が表示されます。
5. [OK] をクリックします。
式のテキストと共に、データ ツリーに新しいノードが表示されます。式のテキストの
全体が表示されていない場合、ノードを右クリックして Conditional Node Builder を開
き、式の完全なテキストを表示します。
データをマップする
中央の列には、データ マッピング機能を表すボックスと、機能ボックスをその入力引数および出
力先につなぐ線が示されています。実行時にアクティビティは入力引数の値を関数に渡し、そ
の結果を宛先属性の値として保存します。
マッピング関数は、一度に 1 つずつ作成します。データ マッピング ツールでは、入力パラメータと
出力先を選択して 1 つのマッピングを完了してから、次のマッピングを開始する必要があります。
プロセス データをマップするときは必ず、対応するフォーマットまたはコンテンツ タイプも同様に
マップする必要があります。これはどのようなサービスの場合も検証されます。
データ マッピング関数は、いずれも単一値属性および繰り返し属性が処理します。入力引数が繰
り返し属性、つまり結果が複数行に及ぶクエリの場合、データ マッピング関数ではいずれかまたは
すべての繰り返し値を使用します。結果を出力先属性に書き込む際、新しい結果によって既存の
値が上書きされるか、または新しい属性値が追加されます。繰り返し属性のマッピングの詳細につ
いては、「繰り返し属性を使用する (138ページ) 」を参照してください。
データ マッパを使用する
データをマップするには
1. 中央の列のマッピング領域の上にあるリスト ボックスから、関数を選択します。
使用可能な関数については、「データ マッピング関数を使用する (139ページ) 」を
参照してください。
関数を表すアイコンがマッピング領域に表示されます。右下の赤い X は、関数に必要な引
数が揃っていないことを示しています。関数に必要な引数をすべて指定すると (後述の
手順 4 または 5 を参照)、X が消えます。
現在の関数が無効であれば、関数のリスト ボックスは使用不可のままです。関数は一度に 1
つしか定義できません。
2. 関数ボックスを、希望の表示位置までドラッグします。
関数ボックスの位置は、単なる表示上の設定にすぎません。位置は実行の順序には影響し
ません。
3. 左側の列から、関数の入力データとなる値の属性を選択します。
名前をクリックして、属性を選択します。マッピング領域に、選択した属性と現在の関数ボックス
を結ぶ線が表示されます。選択した属性のデータ タイプが、関数で予測されるデータ タイプと
一致しない場合、線は点線になります。システムは、実行時に、必要なデータ タイプに値を変
換することを試みます。属性名をもう 1 回クリックすると、選択が解除され、線が削除されます。
136
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス データ要素をマップする
現在の関数が複数の入力値を受け入れる場合は、左側の列から複数の属性を選択すること
ができます。デフォルトでは、属性は、選択した順序で関数の入力引数リストに追加されます。
引数の順序の変更については、手順 5 を参照してください。
目的の属性が、すでに別の関数にリンクされている場合、[線描画モード] ボタン (中央
列上部の関数リストの右側) をクリックし、前の選択項目の線の左端にある黒色のダイヤモ
ンドから、目的の関数を表しているボックスに線を描画することで、現在の関数にリンクす
ることができます。
場合によっては、入力データとして属性を一切使用しない関数を定義することがあります。つ
まり、入力値がすべて定数となります。その場合は、この手順を省略し、手順 5 で適切な定
数値を入力してください。
4. 右側の列から、アクティビティが関数の適用結果を書き込む属性を選択します。
右側の列では、各マッピング関数につき 1 つの属性しか選択できません。
5. 必要に応じて、関数の入力引数を修正します。
関数ボックスをダブルクリックして、[関数エディタ] ダイアログ ボックスを表示します。ダイアログ
ボックスには、関数の名前、構文、および入力値のリストが表示されます。手順 3 で選択し
た属性の名前が、XPath 形式で表示されます。このダイアログ ボックスを使用して、属性の
順序を変更したり、入力値に定数を追加したりできます。
6. [OK] をクリックしてダイアログ ボックスを閉じます。
7. 作成するデータ マッピング関数ごとに、これらの手順を繰り返します。
繰り返し属性をマップする
1 回のデータ マッピング手順で、単一ソース変数を複数ターゲット変数にコピーするような場合が
あります。複数回のコピーを実行せずに、これを行うことができます。マッピングには各種の関数を
選択できるため、他のさまざまな操作も実行できます。たとえば、コピー関数を使用して、日付か
ら日付にコピーを行うのと同時に、日付から文字列への処理関数を使用して、その同じ日付
を文字列変数にコピーすることができます。
1 つの変数を複数の変数にコピーするには
1. 通常どおり、最初のアイテムとしてコピー関数を作成します。
2. 2 つ目のコピー関数を追加して、対象となる変数をクリックします。
3. ツールバーの [線描画モード] ボタンをクリックします。
4. ソース変数内の小さいハンドル上にカーソルを移動し、1 回クリックします。
5. コピー関数の左側にあるハンドルをクリックし、マッピングを実行します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
137
プロセス データ要素をマップする
繰り返し属性を使用する
すべてのアクティビティ テンプレートの[入力メッセージ マッピング] および [出力メッセージ マッピ
ング] 画面では、複数値属性がサポートされます。
複数値属性の名前の横には [追加] リンクがあります。この [追加] リンクを使用して複数値属性の
特定のインデックスを表すノードを作成します。[追加] をクリックすると、デフォルトのインデック
ス値を持つ新しいノードが作成されます。 インデックス値を変更するには、インデックス値をダ
ブルクリックし、[繰り返しインデックス] ダイアログ ボックスで [最初] または [最後] を選択する
か、あるいは数値を入力します。
ノードに新しいインデックス値を追加する
ノードに新しいインデックス値を追加するには
1. システムに対し、デフォルトのインデックス値で新しいノードを作成するように指示する属性の
横にある [追加] をクリックします。
2. 新しいインデックス値をダブルクリックして、[繰り返しインデックス] ダイアログ ボックスを起
動します。
3. インデックス値を変更するには、[最初] または [最後] を選択するか、インデックス位置の
数値を入力します。
[最初] では、属性の最初のインデックス位置を作成します。通常、これは、属性の最初の
値を出力メッセージ マッピング側の別の属性にマッピングする場合に、入力メッセージ
マッピング側で非常に便利です。
[最後] では、既存の他の属性の最後に新しい属性を作成します。通常、これは、入力値を繰
り返し値の最後の位置にマップする場合に、出力メッセージ マッピング側で非常に便利です。
これにより、マップされたデータが既存の値を上書きするのを回避できます。
複数値属性に単一値属性をコピーする
複数値属性の特定のインデックスに、単一値属性をコピーするには
1. ターゲット ツリーで複数値属性の特定のインデックスを表すノードを作成します。
2. ソース ツリーで、単一値属性のノードをクリックして選択します。
3. ターゲット ツリーで複数値属性の特定のインデックスを表すノードを選択します。
138
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス データ要素をマップする
単一値属性に複数値インデックスをコピーする
単一値属性に複数値属性の特定のインデックスをコピーするには、次の手順に従います。
1. ソース ツリーで複数値属性の特定のインデックスを表すノードを作成します。
2. ソース ツリーで複数値属性の特定のインデックスを表すノードを選択します。
3. ソース ツリーで、単一値属性を表すノードを選択します。
複数値インデックスの特定のインデックスに、複数値
属性のすべての値をコピーする
複数値インデックスの特定のインデックスに複数値属性のすべての値をコピーするには、
次の手順に従います。
1. ターゲット ツリーで、複数値属性の特定のインデックスを表すノードを作成します。
2. ソース ツリーで、すべての値を表すノード (このノードのインデックス値は [すべて]) を選
択します。
3. ソース ツリーで、単一値属性を表すノードを選択します。
4. functoid をダブルクリックして関数ダイアログ ボックスを表示します。
5. 関数ダイアログ ボックスで、[コンテキストの入力] の値として [値ごと] を選択し、[コンテキストの
出力] の値として [上書き]、[前に挿入]、または [後に挿入] を選択します。
[後に挿入] オプションを使用すると、値がインデックスの後に挿入されます。[前に挿
入] オプションを使用すると、値がインデックスの前に挿入されます。[上書き] オプショ
ンを使用すると、既存の値が上書きされます。
入力コンテキストを理解する
マッピング規則として選択した [コンテキストの入力] オプションによって、複数値属性のすべての
値がマッピング関数に引数として渡されるか ([すべて] オプション)、またはマッピング規則関数
が値ごとに 1 回実行されます ([値ごとに])。
[すべて] では、すべての属性のアクションを実行し、単一の出力が表示されます。繰り返し属
性のグループについて追加操作を使用して、[すべて] を選択すると、出力では、すべての値
の合計が単一の値で示されます。
[値ごと] では、各属性のアクションを個別に実行し、複数の出力が表示されます。それぞれの繰
り返し属性について、操作を選択して実行できます。たとえば、複数の添付ファイルがある場
合、各添付ファイルについて識別子を個別に作成できます。
[コンテキストの入力] オプションの表示や更新は、関数ダイアログ ボックスから行うことができます。
データ マッピング関数を使用する
マッピング領域の上のリスト ボックスに、使用可能な関数が表示されます。リストから関数を選択す
ると、関数を表すアイコンがマッピング領域に表示されます。関数を入力引数と出力先にリンクし
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
139
プロセス データ要素をマップする
たら (「データをマップする (136ページ) 」を参照)、[関数エディタ] ダイアログ ボックスを使用して
関数の定義を完了する必要があります。関数エディタを使用すると、関数における入力引数の順
序を変更したり、プロセス データ以外からの値を持つ定数入力引数を追加したりできます。
関数ボックスをダブルクリックして、[関数エディタ] ダイアログ ボックスを表示します。ダイアログ
ボックスには、関数の名前、構文、および予測される入力値のリストが表示されます。関数にリンク
された入力属性の名前が、XPath 形式で表示されます。ユーザがマップする値が列挙セットに基
づいている場合、関数の宛先ノードの列挙値が示されるリストを表示することができます。
• 入力引数の順序を変更するには、1 つの引数を反転表示し、上下の矢印ボタンをクリックしなが
らリストの新しい場所まで引数を移動します。
• 入力引数のリストに定数を追加する場合は、定数に先行する引数を反転表示して、[+] ボタ
ンをクリックします。反転表示した行の下に、新しい行が表示されます。新しい行に定数値
を入力します。
注記: このダイアログ ボックスで、関数に新しいパッケージ属性を追加することはできません。新
しいパッケージ属性を追加するには、マッピング画面に戻り、左側の列から属性を選択します。
• 入力引数リストから定数を削除する場合は、定数を強調表示して、[—] ボタンをクリックします。
注 記 : このダイアログ ボックスで、リストからパッケージ属性を削除することはできません。パッ
ケージ属性を削除するには、マッピング画面に戻り、左側の列から属性を削除します。
次の表は、使用可能な関数のリストです。
表8
データ マッピング関数
関数
入力引数
結果
足し算
2 つ以上の数字。
入力引数の和。
営業日の追加
整数の日付値、カレンダーの文
字列、noOfDays の整数。
営業日を noOfDays 値に追加し
ます。営業日の値は、選択したビ
ジネス カレンダーに基づきます。
日数の追加
整数の日付値と noOfDays の整
数。
指定した日数を日付に追加した
後の日付を返します。
バイトから文字列に
バイナリ データを表す最初の文
字列と、UTF-8 や UNICODE な
どのエンコード値を指定する 2 番
目の文字列からなる 2 つの文字
列。デフォルトのエンコード値は
UTF-8 です。
文字列としてのデータ。
連結
2 つ以上の文字列。
入力引数が順列する連結文字
列。
コピー
任意のタイプの 1 つの引数。
入力引数のまま変更なし。
数
オブジェクト param[]):
複数値入力の値の数を返しま
す。単数値入力の場合、1 を返
します。
140
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス データ要素をマップする
関数
入力引数
結果
日付を文字列に変換
有効な日付パターンを表す日付
と文字列。日付パターンは、Java
SimpleDateFormat 標準に準拠し
ている必要があります。詳細につ
いては、Java API および Sun 開
発者 web サイト内の開発者参照
ドキュメントを参照してください。
指定したパターンの文字列によ
る日付値
割り算
2 つ以上の数字。
1 番目の入力引数を 2 番目の引
数で割った商。引数が 3 つ以上
ある場合は、後続の数字を使用
して直前の結果を割ります。
日の取得
整数。
日付の日の部分を表す整数を
返します。
電子メール アドレスの取得
文字列。
dm_user にクエリを実行し、ユー
ザの電子メール アドレスを返し
ます。
月の取得
整数。
日付の月の部分を表す整数を
返します。
チケットの取得
文字列。
実行時の特定のユーザ名に対す
るログイン チケットを生成します。
構文 (ユーザ名、スコープ、タイム
アウト、使い捨て、およびサーバ
名) を使用します。この関数の詳
細については、「ログイン チケッ
トを生成する (142ページ) 」を参
照してください。
値を取得
オブジェクトとインデックス位置の
数値を指定する文字列パラメー
タ。
インデックス内の指定された位置
にある値を返します。
年の取得
整数。
日付の年の部分を表す整数を
返します。
結合
2 つ以上の文字列配列。
選択した複数の入力の結合を作
成します。
掛け算
2 つ以上の数字。
入力引数の積。
分割
オプションのインデックス位置の
値を格納できる文字列。
オプションのインデックス位置が
使用される場合に、繰り返しの
文字列または繰り返しの値を返
します。
文字列からバイトに
データを表す最初の文字列と、
UTF-8 や UNICODE などのエン
コード値を指定する 2 番目の文
字列からなる 2 つの文字列。デ
フォルトのエンコード値は UTF-8
です。
バイナリ データ。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
141
プロセス データ要素をマップする
関数
入力引数
結果
文字列を日付に変換
2 つの文字列。1 番目は日付を
表し、2 番目はパターンを指定し
ます。日付パターンは標準 Java
SimpleDateFormat に準拠する必
要があります。詳細については、
Java API および Sun 開発者 web
サイト内の開発者参照ドキュメン
トを参照してください。
日付データ タイプの値
部分列
1 つの文字列と、文字列から最
初の何文字を削除するかを表す
1 つの数字。オプションで、部分
列に含める最後の文字の位置を
示すもう 1 つの数字を加えること
もできます。
1 番目の入力引数の文字のうち、
指定の開始位置から指定の終了
位置までの文字列。
たとえば、入力引数が “unhappy”
と 2 の場合、結果は文字列
“happy” になります。入力引数が
“unhappy” と 2 と 5 の場合、結果
は “hap” になります。
引き算
2 つ以上の数字。
1 番目の数字から 2 番目の数字
を引いた差。数字が 3 つ以上あ
る場合は、直前の結果から後続
の数字を引きます。
小文字に変換
文字列。
文字列を小文字に変換します。
大文字に変換
文字列。
文字列を大文字に変換します。
ログイン チケットを生成する
チケットの取得関数により、システムは、特定のユーザのセキュア ログインを生成できます。このチ
ケットは 1 つ以上のリポジトリで設定でき、複数回使用できます。また、指定した時間の経過後に
期限切れにすることができます。アクティビティの実行者には、スーパーユーザ権限が必要です。
注 記 : プロセス設計者が、アクティビティの実行者にスーパーユーザ権限を付与するに
は、スーパーユーザ権限が必要です。
チケットの取得関数では、次の引数を使用できます。
表9
チケットの取得関数エディタの値
パラメータ
タイプ
値
ユーザ名
文字列
作成するチケットの対象となるユーザの名前。
スコープ
文字列
取得されるログイン チケットのスコープ。有効な値は、docbase、
server、および global です。
タイムアウト
142
整数
取得済みのログイン チケットが有効な期間 (分単位)。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス データ要素をマップする
パラメータ
タイプ
値
使い捨て
ブール
ログイン チケットを使用できる回数
サーバ名
文字列
チケットを受け入れるリポジトリの名前。"使い捨て" パラメータが
true に設定されている場合、ログイン チケットは、その特定サーバ
でのみ有効です。
プロセス データ マッパ アクティビティを使用してグローバル ログイン チケットを生成する
プロセス データ マッピング アクティビティを使用して、複数使用リポジトリにおいて、特定の
ユーザ名、スコープ、タイムアウト、使い捨て、およびリポジトリ名を指定したグローバル ログイ
ン チケットを生成します。
複数使用リポジトリですべてのパラメータを使用してグローバル ログイン チケットを生成するには
1.
2.
3.
4.
プロセス データ マッピング アクティビティ テンプレートをプロセスに追加します。
アクティビティの実行者にスーパーユーザ権限があることを確認します。
入力データ マッパで、[チケットの取得] 関数を選択します。
関数エディタで、5 つの定数パラメータを追加し、それぞれの値に「ユーザ名」、「スコープ」、
「タイムアウト」、「使い捨て」、および「サーバ名」を指定します。
5. [OK] をクリックして、プロセスを保存します。
6. このチケットをプロセス変数にマップします。
7. SMTP 送信アクティビティを追加し、チケットをマップして、電子メール添付ファイルとして送
信します。
電子メールの受信者は、そのチケットを使用して、同じリポジトリにログインしたり、指定
された有効な期間内に特定のユーザ名に対して使用される信頼された各種リポジト
リにログインしたりすることができます。
動 的 Web サ ー ビ ス ア ク テ ィ ビ テ ィ を 使 用 し て 、 信 頼 さ れ た 各 種 リ ポ ジ ト リ の グ ロ ー バ
ル ログイン チケットを生成する
動的 Web サービス アクティビティを使用して、信頼された各種リポジトリのグローバル ログイ
ン チケットを作成します。
動 的 Web サ ー ビ ス を 使 用 し て 、 各 種 リ ポ ジ ト リ の グ ロ ー バ ル ロ グ イ ン チ ケ ッ ト を 生 成 す る に は
1. 動的 Web サービス アクティビティをプロセスに追加し、[Web サービスの設定] タブを選
択します。
2. アクティビティの実行者にスーパーユーザ権限があることを確認します。
3. DFS ContextRegistryService Web サービスの URL を指定し、これを呼び出します。
動的 Web サービス アクティビティ テンプレートの詳細については、「動的 Web サービ
ス (184ページ) 」を参照してください。
4. 入力データ マッパで、[チケットの取得] 関数を選択します。
5. 関数エディタで、5 つの定数パラメータを追加し、それぞれの値に「ユーザ名」、「スコープ」、
「タイムアウト」、「使い捨て」、および「リポジトリメ名」を指定します。
6. SOAP 本体の RepositoryIdentity ノードにあるパスワード フィールドに、このチケットをマッ
プします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
143
プロセス データ要素をマップする
7. [OK] をクリックして、アクティビティを保存します。
メッセージ相関を理解する
Process Builder は、入力データを処理するために、受信メッセージをワークフローの一意のインス
タンスに対してマッチングできる必要があります。Process Builder では、固有のデータから成る相
関識別子および相関セットを使用し、応答を元の要求に一致させます。
たとえば、購入プロセス内の 1 つのアクティビティで、購買発注書のアイテムが発送されたかど
うかに関する情報を要求する JMS メッセージがサプライヤに送信される場合があります。この
メッセージには、ベンダ ID 番号と該当アイテムの購買発注書番号が示されています。システム
は、これらの番号を使用してメッセージとプロセス インスタンスを一致させます。後に、ベンダの
システムでは、ベンダ ID 番号と購買発注書番号の両方が含まれている注文の入荷状況メッ
セージを返信します。これらの識別子が適切なプロセス データにマップされると、システムでは
要求が応答にマッチングされ、ワークフローが続行されます。
相関識別子を使用する
プロセス インスタンスが始まると、プロセス エンジンは dm_workflow に一意の correlation_identifier
属性を作成して、プロセスを識別します。受信経過アクティビティがメッセージ内でこの識別子を
受信すると、相関セットを使用することなくこの値に基づいてメッセージをプロセス インスタ
ンスに一致させることができます。
このメッセージ プロパティを使用するには、メッセージの受信者の応答には同じ識別子が含まれる
必要があります。つまり、システムが入力メッセージで correlation_identifier を受信するためには、
correlation_identifier はプロセスの早い段階のある時点で送信されている必要があります。たとえ
ば、購買発注書に関する情報を要求するベンダにメッセージが送信される場合、出力したメッ
セージでシステムが生成する相関識別子が送信されます。受信メッセージにも同じ相関識別子が
含まれている場合、システムはそれを使用してメッセージをプロセス インスタンスに一致させます。
相関識別子を含むフィールドは、接続、プロトコル、および処理命令を定義する設定ページ上の
各受信経過アクティビティ テンプレートで設定します。この識別子はメッセージのプロトコルに対し
て固有です。多くの受信メッセージにおいて、一意のファイル名またはメッセージ ヘッダー内の
データなどのメッセージ固有のプロパティは、メッセージをプロセス インスタンスに一致させるため
に相関識別子を含むことができます。これらの値の間に一致が存在しない場合、システムは指定
の相関セットを使用して、メッセージをプロセス インスタンスに一致させます。
表 10
相 関 ID の 設 定 に 使 用 す る フ ィ ー ル ド
アクティビティ テンプレート
フィールド名
例
JMS インバウンド ステップ
－
JMS ヘッダー CorrelationId の使用
HTTP インバウンド ステップ
相関プロパティ
MessageID
電子メール インバウンド ステップ
相関ヘッダー
件名
FTP インバウンド ステップ
相関パターン
po_$id$.txt
Web サービス インバウンド ス
テップ
－
WS アドレス指定ヘッダー MessageID の
使用
144
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス データ要素をマップする
相関セットを使用する
アクティビティに相関 ID が設定されていない、または、に相関 ID がない場合、システムは相関
セット マッピングを検索し、そのメッセージをワークフローに一致させます。相関セットは、アクティ
ビティに定義するプロセス変数のコレクションです。ほとんどのビジネス プロセスの場合、プロセス
データには入力データをプロセス インスタンスに一致させるために識別および使用される一意の
属性があります。これらのマッピングは、入力メッセージ データを既存のプロセス データに一致さ
せることができる、アクティビティ テンプレート内のデータ マッピング ツールを使用して作成します。
相関セットは、[プロセスのプロパティ] コンポーネントの [高度] タブで、プロセス レベルで定義しま
す。ワークフローに関連付けられているプロセス変数のリストから相関セットを指定し、相関マッピ
ングに使用する属性をその相関セットに追加します。たとえば、一意の購買発注書番号および名
前を使用して、メッセージとプロセス インスタンスを一致させることができます。プロセスのインスタ
ンスとの間で送受信されるすべてのメッセージに購買発注書および名前が渡される場合は、要
求と応答のメッセージを一致させるためにそれらの値を使用できます。「購買発注書」という名
前の相関セットを作成し、その中で、購買発注書番号および住所用のプロセス変数を選択で
きます。そして、データ マッピング ツールにおいて、入力メッセージ属性の購買発注書番号と
住所の属性をリンクさせることができます。
相関セットには複数の相関識別子を含めることができます。また、必要な場合は 1 つのプロセスに
複数の相関セットを使用できます。アクティビティ内のマッピングに選択できる相関セットは 1 つの
みです。たとえば、ベンダからの発注を管理するプロセス フローの場合、相関セット 1 (発注番
号およびベンダ ID) と相関セット 2 (住所および郵便番号) を作成し、受信アクティビティ内の
メッセージをマップする際にこれらの相関セットを使用します。
相関セットで使用されるデータは、相関セットを使用するアクティビティにワークフローが到達
する前に、プロセス内に存在しているか、設定されている必要があります。データは、そのプロ
セス以前の段階で、初期化アクティビティまたは別の経過アクティビティを使用したアクティビ
ティによって設定できます。
注 記 : 相関セットで使用されるプロセス変数には、デフォルトの値を設定しないでくださ
い。デフォルト値が設定されたプロセス変数は、プロセスの 1 つのインスタンスに入力メッ
セージを一致させるために必要な一意の属性特性を持ちません。システムで一意の一致
が見つからない場合、実行時プロセスはエラーにより停止します。
プロセスに使用する相関セットの定義の詳細については、「相関セットを作成する (66ペー
ジ) 」を参照してください。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
145
第9章
プロセス テンプレートをデバッグする
この章では、 次のトピックについて説明します。
•
プロセス デバッガを理解する
•
プロセスのデバッグを準備する
•
デバッガでワークフローを開始する
•
デバッガでプロセスをテストする
•
自動ワークフロー メソッドをデバッグする
プロセス デバッガを理解する
Process Builder のデバッガを使用すると、ブレークポイントの設定、プロセスの実行、プロセス
データの調査と変更、統合のテスト、プロセス内のタスクの取得と実行によって、プロセス テン
プレートの設計を対話式にテストできます。
プロセスを運用環境に配置する前にデバッグすることにより、設計したプロセス フローが設計時に
基準とした元のビジネス要件を満たすことを確認できます。デバッガを使用してプロセスのトラブル
シューティングを行うと、プロセスの保存、検証、またはインストールを実行せずに、プロセス設計
環境でプロセスをテストできます。また、開発中のアクティビティをテストして、複雑なプロセス フ
ローが正しく設定されているかどうかを確認することもできます。フロー内の特定のパスを実行する
ことによっても、開発プロセス中に重要なフィードバックを得ることができます。
デバッグは、ローカル環境で実行されます。プロセスをデバッグ モードで実行する場合、サーバ
は実際の作業項目やキュー項目を作成しません。プロセス変数に対して行った変更は、デバッグ
セッションが存続している間、ローカル システムでのみ保持されます。セッションが終了した後には
保存されません。ただし、デバッグ セッション中にパッケージまたは添付ファイル内のオブジェ
クトに対して行った変更はサーバに保存され、既存の属性データが上書きされます。システム
は、マッピンング規則に従って作成されるレンディションや添付ファイルなど、プロセス内の自動
アクティビティに必要なすべてのオブジェクトも作成します。
手動アクティビティを実行する場合、システムで自動的にアクティビティを取得して完了するため、
特定のアクティビティで停止することなくプロセス全体を実行することができます。アクティビティを
手動で完了する場合や、アクティビティで別の手動機能を実行する場合には、アクティビティにブ
レークポイントを設定できます。これにより、移行における次のアクティビティの選択やプロセス
データの変更など、実行者が行う可能性のある機能をユーザが実行できるようになります。
自動アクティビティにブレークポイントを設定してアクティビティのステップインを選択すると、入力
メッセージおよび出力メッセージの表示、失敗したタスクの再実行、アクティビティに関連付けられ
たプロセス データの変更が可能になります。
デバッガがプロセス フローの別のアクティビティを実行すると、進行状況が太い線でマークされま
す。これは、さまざまなパスの移行を持つフローの進行状況を確認する際に特に便利です。デ
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
147
プロセス テンプレートをデバッグする
バッガでアクティビティが実行できるようになると、作業項目が作成されて実行者により取得された
ことを示す緑の矢印がそのアクティビティの上部に表示されます。
図8
デバッガでの手動アクティビティ
システムによってプロセス全体が実行され終わると、ワークフローが完了したことを示すメッセー
ジが [Task Manager] タブと [コンソール] タブの両方に表示されます。この時点では、デバッグ
モードでプロセスにアクセス可能であり、プロセス エンジンからのメッセージを [コンソール] タ
ブで表示できます。
プロセス デバッグ環境を使用する
プロセス デバッガのウィンドウは、2 つのペインに分かれています。
• 上のペインには、プロセス テンプレートがグラフィック表示され、デバッグ プロセスの進行状況、
およびプロセスに追加されているブレークポイントが表示されます。
• 下部のペインには次のタブがあります。
– [タスク マネージャ] タブ: 手動タスクおよび自動タスクの実行オプションを管理します。
– [プロセス データ] タブ: パッケージの追加、プロセス データの表示および編集を行えます。
– [コンソール] タブ: プロセス エンジンからのメッセージを表示します。
– [ワークフローの管理] タブ: ワークフローにイベントを送信できます。
2 つのペインのサイズは、その間の境界にカーソルを置いてドラッグすることにより、制御できます。
次の表は、ボタンなどのインターフェイス要素に使用されるアイコンのリストです。
148
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートをデバッグする
表 11
プロセス デバッガのグラフィック要素とその目的
グラフィック要素
目的
プロセスをデバッグ モードで起動または再実行し
ます。
ブレークポイントを追加または削除します。
ワークフローに含まれる現在のすべてのアクティビ
ティを識別します。作業項目が作成され実行者に
よって取得されています。手動作業が必要なアクティ
ビティやブレークポイントを持つアクティビティに対
してのみ、矢印が表示されます。
デバッガで既に実行済みのアクティビティを識別
します。
ブレークポイントが設定されたアクティビティを識
別します。
プロセスのデバッグを準備する
Documentum リポジトリに保存されたプロセスをデバッグしたり、設計中にプロセスをデバッグしたり
できます。プロセスは、プロセス デバッガでテストするために保存する必要はありません。
ブレークポイントを使用する
ブレークポイントにより、特定のアクティビティでプロセス フローを停止して、プロセス デー
タの変更、パッケージの追加、タスクの実行情報の表示を行うことができます。ブレークポイン
トは、自動アクティビティおよび手動アクティビティのいずれにも追加可能で、追加先のアク
ティビティ数に制限はありません。
プロセスをデバッグ モードで実行する場合、ブレークポイントのある各アクティビティの前でプロセ
スが停止するので、アクティビティを実行する前にアクティビティを開いてコンテンツをパッケー
ジに追加したり、プロセス データの表示や変更を行ったりできます。アクティビティが手動の場
合、アクティビティを終了することも却下することも、または完了して、フローを続行することもで
きます。自動アクティビティでは、アクティビティを開いて、タスクを実行したり、エラー メッセー
ジやアクティビティの入力および出力を表示したりできます。
ブレークポイントを追加するには
1. プロセス内のアクティビティを選択します。
複数のアクティビティを選択するには、Shift キーを押しながら各アクティビティをク
リックします。
2. [ブレークポイントの切り替え] ボタンをクリックして、アクティビティにブレークポイントを設
定します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
149
プロセス テンプレートをデバッグする
ブレークポイントを削除するには
1. プロセス内のブレークポイントが設定されたアクティビティを選択します。
2. [ブレークポイントの切り替え] ボタンをクリックして、アクティビティからブレークポイントを削
除します。
デバッガでワークフローを開始する
リポジトリから保存されたプロセス テンプレートをデバッグしたり、設計中のプロセスを保存する前
にデバッグしたりできます。プロセス エディタでプロセスが開いたら、デバッガを起動し、初期化
アクティビティを選択してプロセスを開始します。パッケージや添付ファイルをプロセスに追加
し、パッケージ データおよびプロセス変数を編集して、プロセス フロー内のさまざまな組み合
わせのデータをテストすることができます。
注 記 : プロセスは一度に 1 つしかデバッグできません。タブでデバッガを開くと、プロセス名の横
のタブにデバッガ アイコンが表示されます。現在のデバッグ セッションを終了するまでは、新し
いデバッガ インスタンスは起動されません。
手動初期化アクティビティでデバッグ セッションを開始する
手動初期化アクティビティを使用してデバッグ セッションを開始するには
1. プロセス テンプレート エディタでプロセス テンプレートを開きます。
2. デバッグ プロセス アイコン
をクリックするか、[デバッグ] > [プロセス デバッグの開始] を選
択して、[デバッグ プロセス] ダイアログ ボックスを起動します。
3. [ワークフロー名] テキスト ボックスにワークフローの名前を入力します。
4. [手動の初期化を使用してワークフローを開始] するアクティビティを選択します。
5. [パッケージ] ノードで、[添付] をクリックして、テストする各パッケージのコンテンツを選択します。
各必須パッケージにコンテンツを追加する必要があります。
6. 必要に応じて属性を編集できます。その場合、ノードを展開し、編集可能な属性をクリックし
て、テキスト ボックスに新しい値を入力します。
r_object_id などの一部の属性は、編集できないため淡色表示されています。
注 記 : デバッガでパッケージ属性に対して行った変更はリポジトリに保存され、既存の
パッケージ属性データが上書きされます。
7. 値を編集するには、[変数] ノードを展開し、編集可能フィールドを右クリックして [値の編
集] を選択します。
プロセス変数に対して行った変更は、デバッグ プロセスが存続している間、ローカル システム
でのみ保持されます。プロセス デバッガ セッションが終了した後には保存されません。
8. 一時的な添付ファイルをワークフローに割り当てるには、[添付] をクリックします。
9. [ワークフローの開始] をクリックしてデバッグ プロセスを開始します。
[プロセス デバッグ] ウィンドウが表示され、プロセスの表示およびテストが可能になり
ます。プロセスのテストの手順の詳細については、「デバッガでプロセスをテストす
る (151ページ) 」を参照してください。
150
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートをデバッグする
インバウンド初期化アクティビティでデバッグ セッションを
開始する
HTTP 受信アクティビティまたは Web サービス 受信初期化アクティビティをデバッグする前に、
[プレファレンス] ダイアログ ボックスで、リスナに使用されるポート番号を指定する必要がありま
す。ポート番号の設定手順については、「受信アクティビティをデバッグするためのポート番号を
設定する (38ページ) 」を参照してください。その他の受信アクティビティは、アクティビティの設
定時に指定されているポーラを使用します。
インバウンド初期化アクティビティを使用してデバッグ セッションを開始するには
1. プロセス テンプレート エディタでプロセス テンプレートを開きます。
2. デバッグ プロセス アイコン
をクリックするか、[デバッグ] > [プロセス デバッグの開始] を選
択して、[デバッグ プロセス] ダイアログ ボックスを起動します。
3. 受信初期化アクティビティを使用してプロセスをデバッグする場合は、[受信初期化リスナを使
用してワークフローを開始] を選択します。
アクティビティに関連付けられたメッセージ タイプのリスナが開始され、そのプロトコル
に固有のメッセージ開始要求のリッスンが開始されます。
4. [リスナの開始] をクリックしてデバッグ プロセスを開始します。
[プロセス デバッグ] ウィンドウが表示され、プロセス フローの表示が可能になります。
プロセスがメッセージを受信すると、ワークフローが開始されます。
プロセスのテストの手順の詳細については、「デバッガでプロセスをテストする (151ペー
ジ) 」を参照してください。
デバッガでプロセスをテストする
ブレークポイントなしでプロセスを連続して実行することも、ブレークポイントを定義したアクティビ
ティでプロセスを停止して [プロセス デバッグ] ウィンドウでアクティビティを対話式にテストすること
も可能です。手動タスクや自動タスクを実行する、プロセス変数やパッケージに異なる値を設定す
る、イベントをワークフローに送信するなどの操作を行えます。[コンソール] タブを使用すると、プ
ロセスのトラブルシューティングに役立つ、プロセス エンジンからのメッセージを表示できます。
また、[プロセス デバッグ] ウィンドウには、さまざまな機能を有効にするツールバー ボタンが
あります。
表 12
ボタン
プロセス デバッガのボタン
目的
[次のアクティビティにステップ オーバー]: ブレークポイン
トが設定されていない場合でもデバッガを次のアクティビ
ティに進めます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
151
プロセス テンプレートをデバッグする
ボタン
目的
[現在のアクティビティのステップイン実行]: 自動アクティビ
ティの詳細を表示できます。アクティビティは実行されます
が、次のアクティビティは続行されません。アクティビティの
実行に関連付けられたサービス メッセージを表示するに
は、自動アクティビティにステップインする必要があります。
アクティビティのマッピングや設定を変更したり、アクティビ
ティが失敗した場合にアクティビティを返したり、その他のト
ラブルシューティング機能を実行したりできます。
[デバッグの再実行]: プロセス データをロードし直さなくても
フローの最初からプロセスを再実行します。
• パッケージや添付ファイルの場合は、ワークフローの
終了時と同じデータを使用してプロセスが実行され
ます。ワークフロー内でパッケージや添付ファイル
に対して変更が行われた場合、これらの変更はリポ
ジトリに保存され、変更された属性を使用してプロ
セスが再実行されます。
• プロセス変数の場合は、最初にデバッガにフロント
ロードされた属性を使用してプロセスが実行されま
す。プロセス変数に対して変更が行われた場合、こ
れらの変更は保存されないため、プロセスは元の
値で実行されます。
このオプションは、プロセスの完了後でないと使用できませ
ん。部分的にしか完了していないプロセスを再実行するこ
とはできません。
[次のブレークポイントまで続行]: プロセス内の次のブレーク
ポイントまで処理を進めます。
[デバッグの停止]: デバッグ プロセスを終了し、デバッグ
セッションで作成されたワークフローおよび作業項目を削
除します。
[デバッグ セッションの終了]: デバッガを終了してプロセス
テンプレート エディタに戻ります。デバッグ セッションで作成
されたワークフローとすべての作業項目が削除されます。
タス ク マ ネ ー ジ ャ ] タ ブ を 使 用 す る
[タ
[タスク マネージャ] タブを使用すると、手動アクティビティおよび自動アクティビティの両方につい
てさまざまなタスクを実行できます。このタブには、アクティビティの作業項目の状態 (「取得済
み」など) が表示されます。
152
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートをデバッグする
手動タスクを管理する
デフォルトでは、手動タスクはシステムにより取得されて完了するため、デバッグ プロセスを通して
ユーザが操作することなくプロセスを実行できます。手動アクティビティにブレークポイントを設定
する場合、パッケージ用のコンテンツの選択、プロセス変数の変更、アクティビティに基づくタスク
関連機能の実行が可能です。これらの機能の一例としては、次のものがあります。
• タスクを却下します。
• タスクの取得および完了
• 実行者が決定した移行条件が存在する場合の次のアクティビティの選択
• 作業項目のスキル名およびスキル値の詳細の表示
• 複数の実行者と作業項目を持つタスクの作業項目 ID および実行者名の表示
• タスクを強制的に完了します。
• 複数の作業項目を持つタスクのすべての作業項目の終了
手動タスクのマップに使用可能なさまざまなアクションの詳細については、『Documentum Webtop
ユーザ ガイド』、『Documentum TaskSpace ユーザ ガイド』、『Documentum TaskSpace 設定ガ
イド』に示されています。
自動タスクを管理する
自動アクティビティにステップインする場合、デバッガは現在のアクティビティを実行し、例外
メッセージの他にプロトコル固有の入力メッセージおよび出力メッセージを表示します。これら
のメッセージを使用すると、外部 Web サービス データベースなどでプロセスが統合しているシ
ステム間の通信を確認できるため、問題解決に役立ちます。
また、アクティビティ インスペクタを開いて、例外のあるアクティビティのプロパティを編集できま
す。例外を持つアクティビティを編集した後、そのアクティビティを再実行して、エラーなしで完了
することを確認できます。
自分で修正できないエラーが含まれているアクティビティを完了するには、[強制的にタスクを完
了] をクリックすると、システムはアクティビティを完了してプロセスを先に進めます。
自動アクティビティ上にブレークポイントを設定すると、次の機能を実行できます。
• アクティビティのステップイン実行。
• アクティビティの実行前の、パッケージや添付ファイルの追加や更新。
注 記: [現在のアクティビティのステップイン実行] を選択すると、アクティビティが直ちに実行さ
れ、パッケージも添付ファイルも変更することはできません。
• タスクの実行と、プロセス エンジンの例外メッセージおよび入力/出力メッセージの表示。
• 失敗したタスクの再実行。
• タスクの強制終了 (アクティビティが失敗した場合も含む)。
• 次のブレークポイントまで実行。
自動アクティビティ上にブレークポイントを設定すると、アクティビティにステップインしてアクティビ
ティの実行をトリガできます。これにより、入力メッセージ、出力メッセージ、エラー、例外などを確
認できます。たとえば、Web サービスを起動する場合は、要求および応答情報を表示できます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
153
プロセス テンプレートをデバッグする
同様に、各プロトコルの入力メッセージを表示できます。たとえば、SOAP 要求のテキストがメッ
セージ ウィンドウに表示されるため、そのテキストをコピーしてテキスト エディタに貼り付けることが
できます。また、応答メッセージ (SOAP 応答) のテキストやプロセス データに対するそれ以降
のすべての更新を表示することもできます。
自動ワークフロー メソッドをデバッグする
Process Builder で提供されているアクティビティ テンプレートの一部は、WorkflowMethod から拡張
された自動メソッドを実行します。 これらのアクティビティ テンプレートを以下に示します。
• フォルダの作成
• フォルダにリンク
• XSLT 変換
これらの自動メソッドのコードは、bpsintegration.jar ファイルに記述されています。インストール プロ
セスの中で、Process Builder インストーラは、これらのファイルをプロセス デバッガで使用できるよう
に、<Process Builder のインストール場所>/classes/custom ディレクトリに配置します。
カスタム メソッドがある場合、デバッガは JAR ファイルを検索し、次の場所からメソッドをロー
ドします。
• <Process Builder のインストール場所>/classes/custom directory
• Content Server と Process Builder が同じマシンにインストールされている場合は
%Documentum%//dba/java_methods ディレクトリ
• メソッドが BOF モジュールとして展開されている場合は Documentum リポジトリ
カスタム Java メソッドは、WorkflowMethod から拡張する必要があります。Java メソッドを
WorkflowMethod から拡張せずに IDfMethod として実装した場合、デバッガからこれらのメソッドを
実行することはできず、エラーが発生します。[強制的にタスクを完了] ボタンを使用してタスクを完
了させ、プロセスのデバッグを続行します。
カ ス タ ム Java メ ソ ッ ド を 実 行 す る に は 、 次 の 手 順 に 従 い ま す 。
1. WorkflowMethod から拡張したカスタム Java メソッドを書き込む。
2. リポジトリ内に dm_method オブジェクトを作成する。
こうすると、自動メソッドがドロップダウン リストに表示され、アクティビティ インスペクタ
で選択できます。
3. カスタム Java コード用の .jar ファイル (またはフル パッケージ構造を持つクラス) を作成し、
その .jar ファイル (またはクラス) を C:\Program Files\Documentum\bpm\classes\custom ディレ
クトリに保存する。
これにより、デバッガは .jar ファイルまたはクラスをロードしてカスタム メソッドを実行
できるようになります。
4. プロセス デバッガを起動してプロセスを実行する。
注 記: PrintWriter に書き込まれたデバッグ メッセージが、[コンソール] タブに表
示されます。
154
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
プロセス テンプレートをデバッグする
プロ セ ス デ ー タ ] タ ブ を 使 用 す る
[プ
[プロセス データ] タブを使用すると、アクティビティに関連するデータの属性を表示したりプロセス
データのインライン編集を実行したりできます。パッケージの追加や更新、プロセスの現在のイン
スタンスの変数の変更も可能です。[プロセス データの更新]
ボタンをクリックして、別の並行ア
クティビティがプロセス データ内で行った変更のイベントに含まれるデータを取得します。
プロセス データを編集するには
1. パッケージ属性またはプロセス変数をクリックして、新しい値を入力します。
2. キーボードの Enter キーを押すか、[保存] を選択します。
3. 添付ファイルまたはパッケージのコンテンツを表示するには、[コンテンツ] ノードに移動し、[コ
ンテンツを表示] へのリンクをクリックします。
デバッガは、対応するエディタやアプリケーションのコンテンツを別のウィンドウに
表示します。
注 記 : デバッガでパッケージ属性に対して行った変更はリポジトリに保存され、既存の
パッケージ属性データが上書きされます。プロセス変数に対して行った変更は、デ
バッグ プロセスが存続している間、ローカル システムでのみ保持されます。プロセス
デバッガ セッションが終了した後には保存されません。
コン ソ ー ル ] タ ブ を 使 用 す る
[コ
[コンソール] タブには、プロセスのステータスについてのプロセス エンジンからのメッセージが表
示されます。これらのメッセージには、ワークフローがいつ開始されたか、どの作業項目が作成、
取得、完了されたか、電子メール通知が送信されたかどうかなどが含まれます。また、[コンソール]
タブには、プロセスで使用されるサービスからのデバッグ メッセージも表示されます。
プロトコル メッセージには、サービスとプロセスの間で交換されたメッセージが表示されます。
• 送信メッセージの場合、[入力メッセージ] テキスト ボックスにはプロセスから外部サービスに送
信されたメッセージが表示され、[出力メッセージ] テキスト ボックスにはサービスからのメッ
セージが表示されます。
• 受信メッセージの場合、[入力メッセージ] テキスト ボックスにはプロセスが外部サービスから受
信したメッセージが表示され、[出力メッセージ] テキスト ボックスにはプロセスからサービス
に送信されたメッセージが表示されます。
HTTP と Web サービス プロトコルの場合のメッセージは、ネットワーク経由で送信されるメッセージ
ときわめて似ています。 その他のサービスの場合は、データ マッピングのツリー構造を示すこ
とができるよう、メッセージには XML 形式が使用されます。
バイナリ データの場合、メッセージは、コンテンツが格納されているファイル システム内のﾌｧｲﾙの
場所を示します。デバッガでワークフローが完了すると、ファイルは削除されます。
たとえば、次のとおりです。
<Attachment>
<Name>test2<Name>
<Content-Type>text/plain<Content-Type>
<Data>C:\Documents and Settings\meenar\
message_files\7bafbf6f-baae-4a16-b240-8335fb7f2d65.dat<Data>
</Attachment>
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
155
プロセス テンプレートをデバッグする
注 記 : メッセージング エラーはこのタブには表示されませんが、メッセージングを使用する自動ア
クティビティの [タスク マネージャ] タブにある [例外] テキスト ボックスで確認できます。
ワー ク フ ロ ー の 管 理 ] タ ブ を 使 用 す る
[ワ
[ワークフローの管理] タブを使用すると、タスクを完了したり、プロセスのデバッグを続行したりする
ために、ワークフローにイベントを送信できます。
この名前は、ワークフローが待ち受けているイベントの名前と一致している必要があります (ワー
クフローが待ち受けるアクティビティの [トリガ] タブで指定)。
ワークフローにイベントを送信するには
1. [イベントをワークフローに送信] フィールドにイベント名を入力します。
2. [送信] をクリックします。
プロセス デバッガを使用してカスタム メソッドをデバッグする
ワークフローでカスタム メソッドを使用している場合、プロセス デバッガを使用してデバッグ
できます。
カスタム メソッドをデバッグするには
1. Process Builder をデバッグ モードで起動します。
2. ショートカットを変更してデバッグ オプションを追加し、特定のポートを使用したデバッグを
有効にします。
たとえば、次のとおりです。
-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n
変更後のショートカットは、次のようになります。
C:\Program Files\Documentum\java\1.5.0_12\jre\bin\java.exe"
-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n
-Xms128m -Xmx256m -Dswing.aatext=true -cp ".;lib\bpm.jar;..\..\dctm.jar;
C:\Documentum\config" WorkflowEditor -locale en_US
3. 統合開発環境 (IDE) では、新しいデバッグ設定を追加して、ホストとポートの接続を行います。
4. コード内にブレークポイントを配置し、IDE からこのデバッグ設定を実行して、Process Builder
からプロセスのデバッグを開始します。
カスタム メソッドを使用するアクティビティに達した場合、カスタム メソッド コードでデバッ
グを実行できます。
注 記 : プロセス デバッガがメソッド コードを使用できるようにするためには、メソッド コードは適
切なディレクトリ構造に配置されたクラスであるか、Process Builder のインストール ディレクトリの
\classes\custom フォルダにある JAR ファイルである必要があります。
156
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
第 10 章
トラブルシューティング
この章では、 次のトピックについて説明します。
•
ログ ファイルを理解する
•
カスタム アプリケーションから構造化データ タイプにアクセスする
ログ ファイルを理解する
Process Builder のデバッグおよびトラブルシューティングを行う必要がある場合、ログ ファイルの
メッセージに有用な情報が示されている場合があります。システムがリポジトリからプロセスを読み
取る際、またはプロセスをリポジトリに保存する際に問題が発生した場合、Process Builder は、有
用なメッセージおよびエラー スタック トレースをログ ファイルに記録します。
Process Builder は、log4j を使用してメッセージを記録します。標準コンソール出力 (System.out お
よび System.err) も、ログ ファイルに転記されます。
既存の log4j.properties ファイルには、Process Builder でのロギング用の次のアペンダがあります。
log4j.rootCategory=ERROR, A1, F1
log4j.logger.com.documentum.bpd=ERROR, bpdappender
log4j.additivity.com.documentum.bpd=false
log4j.appender.bpdappender=org.apache.log4j.RollingFileAppender
log4j.appender.bpdappender.File=processbuilder.log
log4j.appender.bpdappender.MaxFileSize=100KB
log4j.appender.bpdappender.layout=org.apache.log4j.PatternLayout
log4j.appender.bpdappender.layout.ConversionPattern=%5p %c - %m%n
ファイルは、アペンダが [ERROR] に設定されて配信されます。
ア ペ ン ダ レ ベ ル を DEBUG に 変 更 す る
ア ペ ン ダ レ ベ ル を DEBUG に 変 更 す る に は
1. デバッグ レベル メッセージを表示するには、次のように log4j.properties ファイル内のアペ
ンダのレベルを [DEBUG] に変更します。
log4j.logger.com.documentum.bpd=DEBUG, bpdappender
2. Process Builder を再起動します。
Process Builder が、メッセージを processbuilder.log ファイルに出力します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
157
トラブルシューティング
ログ メッセージは、Process Builder がインストールされているディレクトリの processbuilder.log
ファイルにあります。たとえば、次のとおりです。
C:\Program Files\Documentum\bpm\classes
カスタム アプリケーションから構造化データ タイプ
にアクセスする
構造化データ タイプの属性へのアクセス権を取得するには、IDfWorkitemEx および
IDfWorkflowEx API を使用します。
詳細については、Program Files\Documentum\help\bpm\api にある JavaDoc ファイルを参照して
ください。
注記: インストール プロセス中に、開発者ドキュメントをインストールするオプションを選択し
てください。このオプションにより、JavaDocs がローカル システムにインストールされます。
158
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
第 11 章
事前定義のアクティビティ テンプレート
この章では、 次のトピックについて説明します。
•
事前定義のアクティビティ テンプレート
•
コンテンツ サービスのアクティビティ テンプレート
•
フロー
•
統合
•
検索パターンの例
•
セ キ ュ リ テ ィ 保 護 さ れ て い な い Web サ ー ビ ス を 呼 び 出 す に は
•
HTTP 認 証 で 保 護 さ れ た Web サ ー ビ ス を 呼 び 出 す
•
SOAP ヘ ッ ダ ー 認 証 で 保 護 さ れ た Web サ ー ビ ス を 呼 び 出 す
•
Secure Socket Layer (SSL) で 保 護 さ れ て い る Web サ ー ビ ス を 呼 び 出 す
•
Web サ ー ビ ス パ ラ メ ー タ を マ ッ プ す る
•
Windows で HTTP プ ロ キ シ パ ラ メ ー タ を 設 定 す る
•
UNIX ベ ー ス の シ ス テ ム で HTTP プ ロ キ シ パ ラ メ ー タ を 設 定 す る
•
連鎖サービスのリポジトリを登録する
•
連鎖サービスのリポジトリの登録を解除する
•
単一 ま た は 連 鎖 ) を 呼 び 出 す
一 般 的 な DFS サ ー ビ ス (単
•
添付ファイル用のカスタム オブジェクト タイプを設定する
•
ファックス送信を使用してクエリ要求を送信する
•
廃止予定のアクティビティ テンプレート
•
サンプル
事前定義のアクティビティ テンプレート
Process Builder には、共通のビジネス プロセス タスクで使用する、事前定義された一連のアクティ
ビティ テンプレートが付属しています。これらのテンプレートは、[リソース ナビゲータ] の [アクティ
ビティ テンプレート] ウィンドウで利用でき、それぞれが表すタスクのタイプに基づいたツリー構
造で分類されています。たとえば、[コンテンツ サービス] ノードには基本的なコンテンツ管理
機能に関連付けられたアクティビティ テンプレートが含まれ、[統合] ノードには Documentum
Process Integrator のメッセージング機能を使用して外部の参加者にワークフローのプロセス デー
タを送信するアクティビティ テンプレートが含まれています。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
159
事前定義のアクティビティ テンプレート
事前定義されたテンプレートを補完するカスタム アクティビティ テンプレートを作成することもでき
ます。「アクティビティ テンプレートを作成する (90ページ) 」を参照してください。Process Builder に
は、サンプル アクティビティ テンプレートが用意されています。これは、アクティビティ テンプレート
の XML ファイルのフォーマット例を示すもので、カスタム アクティビティ テンプレートを作成する
際の参考になります。このテンプレートはサンプル アクティビティ ノードに表示されます。
この付録では、これらの各アクティビティ テンプレートについて説明するほか、そこからアクティビ
ティを作成するときに入力が必要になる特別なパラメータについても説明します。
注 記 : 受信アクティビティ テンプレートを使用するには、アプリケーション サーバに BPS.war ファ
イルを配置する必要があります。
コンテンツ サービスのアクティビティ テンプレート
[コンテンツ サービス] ウィンドウのアクティビティ テンプレートを使用すると、基本的なコンテン
ツ管理タスクをビジネス プロセスに組み込むことができます。
これらのテンプレートに基づくアクティビティについては、[アクティビティ インスペクタ] には 3 つの
タブ、つまり、[実行者] タブ (実行するワークフロー メソッドを指定する)、[定義] タブ、およびカスタ
ム タブしか表示されません。[アクティビティ インスペクタ] のその他の標準タブは、コンテンツ
サービス アクティビティには関係ありません。
BOF モ ジ ュ ー ル
このテンプレートに基づくアクティビティは、Documentum の Business Object Framework (BOF)
を使用してモジュールとしてパッケージ化されている Java メソッドを実行します。データ マッピ
ング ツールでは、メソッドの入力パラメータの値を指定し、戻り値がある場合は後続のアクティ
ビティで利用できるようプロセス データにマップします。BOF モジュール アクティビティ テンプ
レートは、入力および出力の両方のメッセージ マッピングにおいて、単純な繰り返し属性と複雑
な繰り返し属性をサポートします。
注 記 : パラメータのデータ タイプおよび戻り値は、Java プリミティブ型、Byte[] (または byte[])、
データ ソース オブジェクト、または JavaBean オブジェクトにする必要があります。BLOB (バイ
ナリ ラージ オブジェクト) とバイナリ データは、バイト配列として表されます。文字データ タイプ
は現在サポートされていません。
BOF モジュールとしての Java メソッドのパッケージ化については、『Documentum Foundation
Classes Development Guide (Documentum Foundation Classes 開発ガイド)』を参照してください。
BOF モ ジ ュ ー ル ア ク テ ィ ビ テ ィ を 設 定 す る に は
1. [アクティビティ インスペクタ] で [BOF モジュールの設定] タブをクリックします。
2. 実行する BOF モジュールを選択します。
a. [選択] をクリックします。
選択ダイアログ ボックスが開き、\System\Modules フォルダのコンテンツが表示さ
れます。
b. 実行するモジュールに移動して反転表示します。
c. [OK] をクリックします。
160
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
ダイアログ ボックスが閉じ、[BOF モジュール] ボックスにモジュールの名前が表示されま
す。選択したモジュールに基づき、Process Builder により [インターフェイス] リスト ボックスと
[メソッド] リスト ボックスに値が入力されます。
3. 実行するインターフェイスとメソッドを、リスト ボックスから選択します。
4. [次へ] をクリックします。
現在のページのすべての必須フィールドへの値の入力が完了するまで、[次へ] ボタ
ンは使用できません。
5. 選択したメソッドに入力パラメータがある場合は、データ マッピング ツールを使用してパラ
メータの値を指定します。
[入力メッセージ マッピング] 画面のデータ マッピング ツールの右側の列に、メソッドの
入力パラメータが表示されます。左の列は、プロセス データを示しています。パッケー
ジのデータ属性の値を Byte[] (または byte[]) としてメソッドの入力引数としてマップで
きます。メソッド引数または戻り値が配列の場合、入力/出力メッセージ マッピングの画
面で繰り返し属性として表示されます。繰り返し属性のノード/属性タイプは、配列の
型と同じになります。たとえば、String[] の場合、ノードは文字列型になり、boolean[]
の場合、ブール値型のようになります。
また、パッケージのデータとコンテンツ タイプをデータ ソースにマップすることもできます。
データ マッピング ツールの使用方法の詳細については、「データ マッピング ツールを理
解する (129ページ) 」を参照してください。
選択したメソッドに入力パラメータがない場合、[入力メッセージ マッピング] 画面は表示されま
せん。手順 7 に進んでください。
6. [次へ] をクリックします。
選択したメソッドに出力値がない場合、[次へ] ボタンは使用できません。次の手
順は省略してください。
7. データ マッピング ツールを使用して、出力値をパッケージ属性値として保存します。
[出力メッセージ マッピング] 画面のデータ マッピング ツールの左側の列に、メソッドからの出
力値が表示されます。右の列は、プロセス データを示しています。
[出力メッセージ マッピング] では、メソッドから値を Byte[] (または byte[]) としてパッケージに返
すことができます。ただし、パッケージ コンテンツのフォーマットを手動で文字列値に設定する
必要があります。また、データ ソースのデータ属性値をパッケージのデータ属性にマップする
ことによって、データ ソースのコンテンツをパッケージに書き込むこともできます。
8. [OK] または [適用] をクリックして、構成設定を保存します。
実行時にデスティネーション パッケージが存在する場合は、そのパッケージのデータ属性値
がデータ ソースまたは Byte[] (または byte[]) からのデータに置き換えられます。データ ソース
の場合は、デスティネーション パッケージのフォーマット属性値がデータ ソースのフォーマット
値に置き換えられます。デスティネーション パッケージが存在しない場合は、新しいパッケー
ジが作成されます。ソース パッケージのデータおよびフォーマットが、新しいパッケージにコ
ピーされます。ただし、ソース パッケージにフォーマット マッピングがない場合は、デスティ
ネーション パッケージのフォーマット属性の値が “crtext” に設定されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
161
事前定義のアクティビティ テンプレート
フォルダの作成
このテンプレートに基づくアクティビティは、特定のフォルダ名またはフォルダ テンプレートに基づ
いてリポジトリに新しいフォルダを作成します。アクティビティを設定するには、新しいフォルダに名
前を付け、フォルダ階層内のフォルダを作成する場所へのパスを指定します。
• [新しいフォルダ名] - 新しいフォルダの名前を入力します。名前には代替変数を含めることが
できます。[...] ボタンをクリックすると、利用可能な変数を選択するためのダイアログ ボック
スが表示されます。
• [フォルダ テンプレートから作成 (オプション)] - リポジトリから定義済みのフォルダ テンプレート
を選択します。フォルダ テンプレートにより、フォルダ テンプレートのルート名を新しいフォルダ
名として使用して、ネストされているフォルダを含むフォルダのコピーを作成できます。
• [宛先フォルダ] フォルダ - [...] ボタンをクリックして、新しいフォルダを作成する親フォルダに移
動します。ダイアログ ボックスで [OK] をクリックすると、親フォルダの名前がデータ フィール
ドに表示されます。
• [フォルダのパスを入力] - 新しいフォルダを作成する場所の既存の親フォルダへのフル パ
スを入力します。このパスは、バックスラッシュおよび最上位のキャビネット名で始まります
(/System/Workflow など)。フォルダ パスを選択するのではなく入力する場合、パス指定に 1 つ
以上の代替変数を使用できます。ダイアログ ボックスを表示するには、[...] ボタンをクリックしま
す。このダイアログ ボックスから、パッケージ変数など、使用できる変数を選択できます。
注 記 : Documentum Composer を使用してプロセス テンプレートを移行する予定の場
合、フォルダ名とパスを入力して、システムがフォルダのコンテンツとともにフォルダ
をインポートしないようにしてください。
• [フォルダをパッケージにリンク] - ドロップダウン リストから選択したパッケージにフォルダ
全体をリンクします。
エ ン タ ー プ ラ イ ズ コ ン テ ン ツ 統 合 サ ー ビ ス (Enterprise
Content Integration Services: ECIS) 検 索
このアクティビティ テンプレートを使用することで、事前に設定した検索条件に基づいて ECIS 検
索を行うことができます。検索結果には、HTML ページ、Word 文書、PDF ファイル、イメージなど
を含めることができます。検索結果は、[ECIS Search Results (ECIS 検索結果)] フォルダに保存さ
れ、[ランク (0 ～ 1) の ECIS 結果を保存] フィールドに指定した順序で表示されます。
ECIS アクティビティ テンプレートは、FileNet や Open Text のサーバ、外部の Web サイト、ECIS ア
ダプタがアクセスできるその他の Documentum リポジトリなど、複数の対象の検索に使用できます。
事前に設定された ECIS 検索は、次の Web サイトで自動的に [名前] キーワードに基づいて
実行されます。
•
•
•
•
•
•
http://www.google.com
http://www.cnn.com
http://www.interpol.int/
http://www.fbi.gov/
http://www.dhs.gov/dhspublic/
http://europa.eu/pol/cfsp/index_en.htm
162
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
• http://news.bbc.co.uk/
• Factiva
• 現在のリポジトリ
• 開いているディレクトリ
注 記 : これらの検索対象は、ECIS Admin Center で設定されます。検索対象の設定方法
の詳細については、『Documentum ECI Services Administration Guide (Documentum ECI
Services 管理ガイド)』を参照してください。
アクティビティ テンプレートでコンテンツを検索できるようにするには、次のフィールドを設定します。
• [検索文字列] - 検索する情報を定義する検索文字列を入力するか、このフィールドの横に
ある省略符号 (...) ボタンをクリックして、ダイアログ ボックスから事前に設定された検索文
字列を選択します。
• [ECIS 結果の一時ファイルのパス] - 結果の一時ファイルのフル パスを入力します。一時ファイ
ルは、外部ソースのコンテンツを保存するのに使用されます。コンテンツはローカル ファイルに
保存された後、リポジトリにインポートされます。
• [ECIS 結果をキャビネットに保存] - 結果を保存するキャビネットの名前を入力します。
• [ECIS 結果をフォルダに保存] - リポジトリの結果ファイルのフォルダ名を入力します。
• [ランク (0 ～ 1) の ECIS 結果を保存] - 保存する結果を評価するために使用する値を入力しま
す。ここで入力する数値は、システムが保存する関連性順位の最も低いパーセンテージとなり
ます。たとえば、検索条件に 50% ～ 100% 一致する結果を保存するには、「.5」と入力します。
検索条件に 20% 以上一致する結果を保存するには、「.2」と入力します。
プロセスの起動
プロセスの起動アクティビティは、新しいワークフローを起動します。新しいワークフローの開始
時にアクティビティが完了します。
新しいワークフローは論理的には起動するワークフローのサブプロセスですが、ワークフロー オブ
ジェクト間に形式的な関係はなく、独立しています。プロセスが完了するまで現在のワークフローを
一時停止するには、([トリガ] タブで) イベントに基づいて次のアクティビティがトリガされるように定
義し、親プロセスに対するイベントの通知アクティビティ テンプレートに基づいて他のプロセスにア
クティビティを組み込みます。このテンプレートは親プロセスが待ち受けるイベントを通知します。
プロセスの起動 アクティビティを設定する前に、新しいワークフローのワークフロー スーパーバイ
ザにするユーザを選択する必要があります。
プロセスの起動 アクティビティを設定するには
1. [アクティビティ インスペクタ] の [プロセスの起動] タブをクリックします。
2. [プロセス名] リスト ボックスから子プロセスを選択します。選択したテンプレートの必須パッ
ケージの名前とデータ タイプが現在のワークフローのパッケージと一致している必要があり
ます。この一致の必要性は、表示されるパッケージだけでなく、定義済みのすべてのパッ
ケージに適用されます。
3. [アクティビティの開始] リスト ボックスからアクティビティを選択するか、[すべてのアクティビ
ティの開始] を選択します。
これにより、新しいプロセスの選択したアクティビティ、または同じワークフロー ID を持
つプロセスのすべての開始アクティビティが開始されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
163
事前定義のアクティビティ テンプレート
4. [次へ] をクリックします。
5. 子プロセスにパッケージがある場合は、データ マッピング ツールを使用してパッケージ
の値を指定します。
[入力メッセージ マッピング] 画面のデータ マッピング ツールの左側の列には、親プロセスの
パッケージが表示されます。右側の列には子プロセスのパッケージが表示されます。プロセス
内に複数のパッケージがある場合には、太字で表示されている必須パッケージをマップする
必要があります。このような操作を行わないと、エラーが発生します。また、右側の列にはスー
パーバイザの属性も表示されます。この属性の値は文字列データ タイプである必要がありま
す。スーパーバイザを選択しない場合は、親プロセスのスーパーバイザが使用されます。マッ
ピングの間、アクティビティのパッケージは、親ワークフローのパッケージと同一のパッケージ
タイプか上位タイプである必要があります。データ マッピング ツールの使用方法の詳細につい
ては、「データ マッピング ツールを理解する (129ページ) 」を参照してください。
6. [次へ] をクリックします。
7. データ マッピング ツールを使用して、出力値をパッケージ属性値として保存します。
[出力メッセージ マッピング] 画面のデータ マッピング ツールの左側の列には、アクティビティ
のワークフロー ID が表示されます。ユーザは、追跡または監査目的でこの ID をパッケージ属
性にコピーすることもできます。右側の列には、親プロセスのパッケージ属性が表示されます。
8. [OK] または [適用] をクリックして、構成設定を保存します。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必
要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解する
(129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138ペー
ジ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法については、
「パッケージ属性をマップする (131ページ) 」を参照してください。
ライフサイクル
注 記 : このアクティビティ テンプレートは、Documentum Process Builder バージョン 6.5 以
上でのみサポートされます。これより前のバージョンの Process Builder を Documentum 6.5
のリポジトリに対して使用すると、このテンプレートは開きません。
このテンプレートに基づいたアクティビティは、オブジェクトのライフサイクルを別の状態に移行しま
す。オブジェクトに対して、次の 4 つのライフサイクル オペレーションを実行できます。
• 昇格。オブジェクトを、入力マッパーで指定された状態に進めます。
• 降格。オブジェクトを、現在の通常状態から以前の通常状態に、または demote_to_base_state パ
ラメータが true に設定されている場合はベース状態に降格させます。
• 一時中断。割り当てられたライフサイクルの状態を通したオブジェクトの進行を一時的に停
止します。
• 再開。一時停止されたライフサイクルの状態にあるオブジェクトを再開します。
ライフサイクル オペレーションを変更するには
1. オブジェクトの移行先のライフサイクル オペレーションを選択します。
164
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
2. データ マッパを使用して、オブジェクトのライフサイクル状態を変更する属性をマップす
るには、[次へ] をクリックします。
設定ページには、各ライフサイクルに対する必須マッピングと省略可能マッピン
グに関する参考情報が表示されます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
表 13
ライフサイクル テンプレートのマッピング
オペレーション
要件
説明
昇格
必須
r_object_id は、昇格するオブジェクトを示します。
省略可能
state は、目的のターゲットの状態を示します。デフォルトは
次の状態です。
省略可能
override_entry_checks を true に設定すると、設定されてい
るライフサイクル状態のエントリ チェックを無視します。(各
ライフサイクルの状態には一連のエントリの条件があり、通
常、ドキュメントを特定の状態に昇格するには、この条件を
満たしている必要があります。)デフォルトは false です。
必須
r_object_id は、降格するオブジェクトを示します。
省略可能
state は、目的のターゲットの状態を示します。デフォルトは
前の状態です。
省略可能
demote_to_base_state が true に設定されていると、強制的
にベース状態に降格します。デフォルトは false です。状
態を破棄します。
降格
state と demote_to_base_state の両方がマップされている場
合は、demote_to_base_state が state のマッピングに優先し
ます。
一時中断
再開
必須
r_object_id は、一時中断するオブジェクトを示します。
省略可能
state は、目的のターゲットの状態を示します (デフォルトは、
現在の状態に関連付けられている一時中断状態です)。
省略可能
override_entry_checks を true に設定すると、設定されて
いるライフサイクル状態のエントリ チェックを無視します
(デフォルトは false です)。
必須
r_object_id は、再開するオブジェクトを示します。
省略可能
state は、目的のターゲットの状態を識別します (デフォルト
は、現在の状態に関連付けられている再開状態です)。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
165
事前定義のアクティビティ テンプレート
オペレーション
要件
説明
省略可能
override_entry_checks を true に設定すると、設定されて
いるライフサイクル状態のエントリ チェックを無視します
(デフォルトは false です)。
省略可能
resume_from_base_state を true に設定すると、オブジェク
トの状態を強制的にベース状態に移します (デフォルトは
false です)。状態を破棄します。
省略可能
状態と resume_from_base_state の両方がマップされてい
る場合は、resume_from_base_state が状態マッピングより
優先されます。
ライフサイクルの適用
注 記 : このアクティビティ テンプレートは、Documentum Process Builder バージョン 6.5 以
上でのみサポートされます。これより前のバージョンの Process Builder を Documentum 6.5
のリポジトリに対して使用すると、このテンプレートは開きません。
このテンプレートに基づくアクティビティは、ビジネス プロセス内の 1 つのパッケージにドキュメント
ライフサイクルを適用します。ライフサイクルは、ドキュメントの存在期間の各段階に対応した、
序列化された状態を定義します。
ライフサイクルの適用アクティビティを設定するには、適用するライフサイクルと、プロセス データ
に適用されるライフサイクルを選択します。また、ライフサイクルの初期状態、およびライフサイクル
にエイリアスが関連付けられている場合にそのエイリアスを解決するのに使用するスコープを指定
します。ライフサイクルの作成と使用方法の詳細については、『Documentum Composer User Guide
(Documentum Composer ユーザ ガイド)』を参照してください。
1. リスト ボックスから、パッケージに適用するライフサイクルを選択します。
2. 選択したライフサイクルにエイリアスが関連付けられている場合、エイリアスを解決するために
ス コ ー プ を選択します。
使用するス
これは、そこで定義されているエイリアス値のマッピングを取得するための dm_alias_set
タイプに対するキーです。ドロップダウン リスト ボックスには、ライフサイクルに基づい
た値が表示されます。
パッケージに対して設定する初期状態がテキスト ボックスに表示されます。
3. データ マッパを使用して、オブジェクトにライフサイクルを適用する属性をマップするには、
[次へ] をクリックします。
必要なマッピング
r_object_id
は、ライフサイクルが適用されるオブジェクトを示します。
フォルダにリンク
このテンプレートに基づくアクティビティは、1 つまたは複数のパッケージのオブジェクトをリポジトリ
内の指定したフォルダに追加します。アクティビティを設定するには、フォルダの名前と場所を指
定します。このアクティビティは、指定したパッケージをフォルダにコピー (他のフォルダへのリンク
を保持) するか、パッケージをフォルダに移動 (他のフォルダへのリンクを解除) します。指定した
フォルダが存在しない場合は、アクティビティによりフォルダが作成されます。
166
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
• [フォルダのパスを入力] - 新しいフォルダを作成する場所の既存の親フォルダへのフル パ
スを入力します。このパスは、バックスラッシュおよび最上位のキャビネット名で始まります
(/System/Workflow など)。フォルダ パスを選択するのではなく入力する場合、パス指定に 1 つ
以上の代替変数を使用できます。ダイアログ ボックスを表示するには、[...] ボタンをクリックしま
す。このダイアログ ボックスから、パッケージ変数など、使用できる変数を選択できます。
注 記: Documentum Composer を使用してプロセス テンプレートを移行する予定の場
合、フォルダ名とパスを入力して、システムがフォルダのコンテンツとともにフォルダ
をインポートしないようにしてください。
• [フォルダをパッケージにリンク] - ドロップダウン リストから選択したパッケージにフォルダ
全体をリンクします。
• [パッケージ] — [...] ボタンをクリックすると、コンテンツをリポジトリ フォルダにリンクさせるプ
ロセス パッケージを選択するためのダイアログ ボックスが表示されます。左側のリストのパッ
ケージ名を反転表示してから [追加] ボタンをクリックし、パッケージを右側の選択パッケー
ジ リストに移動します。ダイアログ ボックスで [OK] をクリックすると、選択したパッケージの
名前がデータ フィールドに表示されます。
• [新しいフォルダ名] - 新しいフォルダの名前を入力します。名前には代替変数を含めることが
できます。[...] ボタンをクリックすると、利用可能な変数を選択するためのダイアログ ボック
スが表示されます。
• [存在しない場合は新しいフォルダを作成] — 指定した名前のフォルダが存在しないときにシス
テムでフォルダを作成する場合は、[はい] を選択します。
• [フォルダ テンプレートから作成 (オプション)] - リポジトリから定義済みのフォルダ テンプレート
を選択します。フォルダ テンプレートにより、フォルダ テンプレートのルート名を新しいフォルダ
名として使用して、ネストされているフォルダを含むフォルダのコピーを作成できます。
• [宛先フォルダ] — [...] ボタンをクリックして、新しいフォルダをリンクする親フォルダに移動
します。ダイアログ ボックスで [OK] をクリックすると、親フォルダの名前がデータ フィール
ドに表示されます。
• [フォルダのパスを入力] — コンテンツをリンクさせるフォルダの親フォルダへのフル パスを
入力します。このパスは、バックスラッシュと最上位のキャビネット名で始まります。フォルダ
パスを選択するのではなく入力する場合、パスの指定に 1 つまたは複数の代替変数を含め
ることができます。[...] ボタンをクリックすると、利用可能な変数を選択するためのダイアログ
ボックスが表示されます。
• [元のフォルダのリンクを解除] — アクティビティで、指定したフォルダにパッケージを移動 (他の
フォルダへのリンクを解除) する場合は [はい] を、指定したフォルダにパッケージをコピー (他
のフォルダへのリンクを保持) する場合は [いいえ] を選択します。デフォルトは [いいえ] です。
• [フォルダをパッケージにリンク] — ビジネス プロセスにフォルダ オブジェクトを添付するには、
添付するパッケージをリスト ボックスから選択します。
テンプレートから新しいケースを作成
[テンプレートから新しいケースを作成] アクティビティ テンプレートを使用して、あらかじめ定
義されているテンプレートからフォルダとフォルダ コンテンツを作成します。このフォルダは、
Documentum TaskSpace または Webtop で表示されるフォルダのコンテンツと共に添付ファイルま
たはパッケージとしてプロセスに含められます。たとえば、[テンプレートから新しいケースを作
成] アクティビティ テンプレートを使用して、サブフォルダと関連ドキュメントを含むフォルダを
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
167
事前定義のアクティビティ テンプレート
作成できます。次に、データ マッパを使用して、プロセス データに基づいてこれらのドキュメン
トの属性の一部を設定できます。
テン プ レ ー ト か ら 新 し い ケ ー ス を 作 成 ] ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
[テ
1. [フォルダの作成] タブで、新しいフォルダとそのコンテンツの作成に使用されるリポジトリから
フォルダ テンプレートに移動して選択します。
2. [ACL を子オブジェクトにプロパゲート] を選択することで、フォルダ内のすべてのオブジェクト
が、フォルダ ACL を使用するようにできます。
3. [次へ] をクリックし、入力マッピング ページを使用して、プロセス データにフォルダ属性を
マップします。
これには、選択したテンプレートが dm_folder のサブタイプの場合に設定できるカスタ
ム属性がすべて含まれます。
必要なマッピング
object_name
新しいフォルダの名前にマップします。
r_folder_path
新しいフォルダの場所にマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
4. [次へ] をクリックし、出力マッピング ページを使用して新しいフォルダとそのコンテンツをパッ
ケージまたは添付ファイルとしてプロセスに添付します。
フロー
[フロー] ノードのアクティビティ テンプレートは、ビジネス プロセス全体のワークフローを管理す
るのに使用します。
決定分岐
決定分岐アクティビティ テンプレートを使用すると、ビジネス プロセス テンプレートの決定ポイン
トを明示的に表示できるようになります。他のいくつかのアクションを実行するアクティビティの
[移行] タブで分岐ロジックを指定するのではなく、唯一のアクションとして分岐ロジックの評価
と適切なパッケージの転送のみを行うアクティビティを追加します。決定とその他のアクション
を分離することで、プロセス フローがわかりやすくなります。
168
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
図9
決定分岐アクティビティがある場合とない場合の承認プロセス
決定分岐アクティビティを追加する場合は、先行するアクティビティを決定分岐アクティビティ
にリンクし、その移行を [すべての接続されたアクティビティを選択] に設定します。決定分岐
アクティビティの [移行] タブで、分岐ロジックを設定します。
決定分岐アクティビティ テンプレートには、カスタムのタブやフィールドは含まれません。決定分岐
テンプレートで作成したアクティビティを [アクティビティ インスペクタ] に表示する場合は、[タイ
マ]、[移行]、[データ]、[表示] の各タブのみが表示されます。これらのタブには、決定ポイント
アクティビティに関連するすべての設定が含まれています。
注 記 : システムは、実行時にメソッドを起動するのではなく、dm_bpm_noop_method を使
用してリポジトリに接続しアクティビティを完了させます。
結合
結合アクティビティ テンプレートを使用すると、ビジネス プロセスに複数のフローがある場合に、ト
リガ条件を評価するアクティビティを挿入できるようになります。他のいくつかのアクションを実行
するアクティビティの [トリガ] タブでトリガ条件を指定するのではなく、唯一のアクションとして
トリガ条件の評価と適切なパッケージの転送のみを行うアクティビティを追加します。結合アク
ティビティは、一定の数の先行アクティビティが完了するのを待機してから、パッケージを次の
アクティビティに転送します。結合アクティビティでトリガ条件を既に評価しているため、次のア
クティビティで評価する必要はありません。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
169
事前定義のアクティビティ テンプレート
図 10
結合アクティビティがある場合とない場合の確認プロセス
結合アクティビティ テンプレートには、カスタムのタブやフィールドは含まれません。結合テンプ
レートで作成したアクティビティを [アクティビティ インスペクタ] に表示する場合は、[トリガ]、[タイ
マ]、[データ]、[表示] の各タブのみが表示されます。これらのタブには、結合アクティビティに
関連するすべての設定が含まれています。
注 記 : システムは、実行時にメソッドを起動するのではなく、dm_bpm_noop_method を使
用してリポジトリに接続しアクティビティを完了させます。
親プロセスに対するイベントの通知
親プロセスに対するイベントの通知テンプレートに基づくアクティビティは、プロセスの起動 アク
ティビティと結合することによって同期サブプロセスを実現します。親ワークフローは、プロセスの
起動 アクティビティを使用して新しいサブプロセスを起動し、特定のイベントの通知を待ち受け、
通知後に続行されます。子サブプロセスは、親プロセスに対するイベントの通知アクティビティを使
用してイベントを通知し、親プロセスの続行を可能にします。
• [イベント名] — 親ワークフローに通知するイベントの名前です。この名前は、親ワークフロー
が待ち受けているイベントの名前と一致している必要があります (親ワークフローが待ち受
けるアクティビティの [トリガ] タブで指定)。
• [スーパーバイザ名] — 代わりにイベントが通知されるユーザを選択します。
XSL 変 換
XSL 変換アクティビティ テンプレートは、XML ファイルの変換を実行するアクティビティを作成
します。このテンプレートに基づくアクティビティは、ワークフロー パッケージから XML コンテ
ンツを取得し、それを XSL ファイルに適用して、変換されたファイルを別のワークフロー パッ
ケージとして添付します。
• [パッケージ内のコンテンツの変換] — XML コンテンツを含むワークフロー パッケージの名前。
170
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
• [この XSL ファイルを使用して変換する] — このフィールドの横にあるボタンをクリックして、XML
コンテンツの変換に使用する XSL ファイルを選択します。この XSL ファイルはリポジトリに
格納されている必要があります。
• [結果をパッケージ内のコンテンツとして添付する] — 変換されたコンテンツが書き込まれるワーク
フロー パッケージの名前。プロセスに定義された有効なパッケージを指定する必要があります。
• [変換済み出力フォーマット] — 変換後の出力を XML 形式と HTML 形式のいずれで保
存するかを指定します。
統合
[統合] ウィンドウのアクティビティ テンプレートは、ビジネス プロセスと外部システムまたは外
部実行者との間で、データを交換するための手段を提供します。1 つのデータ ソースから別
のデータ ソースへのデータの通信方法を定義する、ウィザードのようなインターフェイスを備
えているテンプレートもあります。
注 記 : 受信アクティビティ テンプレートを使用するには、アプリケーション サーバに
BPS.war ファイルを配置する必要があります。
アク セ ス 制 御 リ ス ト ) を 作 成 す る
ACL (ア
ACL アクティビティ テンプレートを使用して ACL テンプレートから Documentum ACL オブジェクト
を作成し、プロセス インスタンス内のオブジェクトに適用します。ACL テンプレートは、既にリポジト
リ内に存在していて、ユーザとグループのプレースホルダまたはエイリアスを含められるように作成
されている必要があります。システムは、ACL を作成するアクティビティ テンプレートを使用し
てプレースホルダとエイリアスの値をプロセス データに基づいて入力し、エイリアスを解決した
後にテンプレートから新しい ACL オブジェクトを作成します。
たとえば、Documentum Composer を使用して、スーパーバイザにパッケージに対する書き込みと
削除のアクセス権を許可し、プロセッサには書き込みアクセス権のみを許可する顧客用の ACL テ
ンプレートを作成できます。ACL テンプレートにはユーザとグループに対して異なるエイリアス
を含めることができ、それらに異なるアクセス権を許可することができます。また、所属する
ユーザやグループに対して異なるアクセス権セットを必要とする部署に対して個別の ACL を
作成することもできます。
ACL テ ン プ レ ー ト に 基 づ い て ACL ア ク テ ィ ビ テ ィ を 設 定 す る に は 、 次 の 手 順 に 従 い ま す 。
1. [ACL テンプレートの選択] フィールドで、リポジトリ内にある ACL テンプレートを選択します。
2. [次へ] をクリックし、ACL テンプレートの属性にプロセス データをマップします。
次の属性をプロセス データにマップする必要があります。
必要なマッピング
acl_name
新しい ACL オブジェクトの名前にマップします。
acl_domain
新しい ACL オブジェクトの所有者にマップします。
acl_class
有効な値は次のとおりです。
• 0: プライベート ACL
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
171
事前定義のアクティビティ テンプレート
プライベート ACL は、作成したユーザのみが使用できる ACL です。プライベート ACL の所有
者またはスーパーユーザ権限を持つユーザのみが、この ACL を変更または削除できます。
• 3: パブリック ACL
パブリック ACL はリポジトリ内のすべてのユーザが使用できる ACL です。パブリック ACL の
所有者、または Sysadmin 権限か Superuser 権限を持つユーザのみが、この ACL を変更ま
たは削除できます。
、%Usercat、
、 グループ、ユーザ、およびユーザやグループのカテゴリ用の
%grpcat、
お よ び %usrgrpcat
個別のエイリアス名にマップします。これらの値を、プロセ
ス データ内の正しいユーザまたはグループ名の値にマッ
プしてください。
Content Server がエイリアスを解決する方法の詳細については、『Content Server Fundamentals
(Content Server の基本操作)』のエイリアスに関する付録を参照してください。
注 記 : アクセス権セット、キャビネットのパス、フォルダのパスなどのカテゴリに属するエイリアス
は、データ マッパでのこのアクションではサポートされません。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
3. [次へ] をクリックして、出力 ACL パラメータをプロセス データにマップします。これにより、ACL
がパッケージまたは添付ファイルに適用されます。
必要なマッピング
r_object_id
新しい ACL オブジェクトのオブジェクト ID にマップします。
acl_domain
新しい ACL オブジェクトの所有者にマップします。
acl_name
新しい ACL オブジェクトの名前にマップします。
iCalendar イ ベ ン ト の 作 成
iCalendar イベントの作成アクティビティ テンプレートを使用すると、カレンダー イベントを作成した
り、iCalendar ファイル タイプをサポートする任意のクライアントでミーティングを作成したりすること
ができる、カレンダー データ交換 (.ics) ファイルを作成できます。このアクティビティ テンプレー
トは、.ics ファイルで値に割り当てる入力マッピングに基づいてファイルを作成します。次に、
SMTP アクティビティ テンプレートや HTTP 送信アクティビティ テンプレートを使用して、このファイ
ルを受信者や会議出席者に送信できます。
このアクティビティ テンプレートでサポートされるのは iCalendar イベント (VEVENT) のみです。
このアクティビティ テンプレートでは、プロセス データにカレンダー イベントは書き込まれませ
ん。つまり、外部のクライアントによってイベントが変更またはキャンセルされても、プロセス
データはその変更内容で更新されません。
172
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
注 記 : iCalendar イベントの作成アクティビティ テンプレートでは、TaskSpace のビジネス カ
レンダー機能はサポートされません。このアクティビティは、標準カレンダーに基づい
て ICS ファイルを作成します。
iCalendar イ ベ ン ト フ ァ イ ル を 作 成 す る に は
注 記 : iCalendar イベントの作成アクティビティ テンプレートには、設定ページはありません。
1. データ マッパ ツールを使用して、プロセス データをカレンダー ファイルの属性に関連付け
ます。
プロセス データからの既存の UID を宛先カレンダー属性の uid に関連付け、既存のカレン
ダー イベントを更新します。新しい情報で既存のイベントを更新するには、ファイルの UID と
して既存の識別子を使用します。これにより、以降のアクティビティで ICS ファイルが送信
されるときにイベントが変更されます。このシステムは、既存の UID を使用して既存のカ
レンダー イベントを見つけて更新します。
UID が値にマップされていない場合は、メソッド サーバが UID を生成し、システムはこの UID
を ICS ファイルに割り当てます。ICS ファイルが作成される場合、メソッド サーバはイベント
の一意な識別子を生成します。
他のすべてのプロセス データをカレンダーの属性に関連付けます。
iCalendar ファイルのさまざまなプロパティの詳細については、Internet Engineering Task
Force (インターネット特別技術調査委員会:IETF) が発行している『Internet Calendaring and
Scheduling Core Object Specification (インターネット カレンダリングおよびスケジューリング
のコア オブジェクト仕様) (iCalendar)』に示されています。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
2. [次へ] をクリックし、カレンダー招待ファイルを、パッケージまたは添付ファイルとしてプロセ
ス データに添付します。
DB 受 信 - 初 期 化 お よ び 手 順
データベース テーブルからの行の取得、ワークフローの表示や作成、またはアクティビティの完了
を行うには、データベース受信アクティビティ テンプレートを使用します。システムは、指定され
た select ステートメントを実行して処理対象の行を取得するリスナを実行時に作成します。行
を処理した後は、その行が複数回処理されることがないように、ユーザ定義 SQL ステートメン
トが行を更新または削除します。
たとえば、在庫補充が必要な品目を見つけるために、在庫テーブルにクエリするデータベース ア
プリケーションを使用しているとします。データベース受信 アクティビティでは、必要な品目の購買
発注プロセスを開始するために、在庫補充が必要な品目を在庫テーブルにクエリできます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
173
事前定義のアクティビティ テンプレート
DB 受信アクティビティ テンプレートは、1 つのテーブルまたは 1 つのビューからのみレコードを取
得します。各行は、新しいプロセス インスタンスを開始するか、経過アクティビティを完了します。各
レコードには、レコードを一意に識別するために使用できる列がある必要があります。また、データ
ベースの 1 つの行は 1 つのイベントにのみ対応している必要があります。たとえば、清算書にいくつ
かの行アイテムが関連付けられている場合、それらは別々のテーブルに保存する必要があります。
DB 受 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
1. DB 受信アクティビティ テンプレートを開きます。
2. [JDBC ドライバ] リスト ボックスから、使用する JDBC ドライバを選択します。
3. [接続文字列] ボックスに、データベースへの接続で使用する JDBC 接続文字列を入力します。
JDBC ドライバを選択すると、接続文字列の予測される構文が、ボックスの下に表
示されます。
4. データベースへの接続で使用するユーザ名とパスワードを入力します。
5. [接続のテスト] をクリックして、Process Builder からデータベースに接続します。
Process Builder が、手順 2 ～ 4 で指定した情報を使用してデータベースに接続で
きる場合は、[接続文字列] ボックスの下に緑色のメッセージが表示されます。接続
が失敗した場合は、ボックスの下に赤色のメッセージが表示されます。値を修正し
て再試行してください。
6. [実行するクエリ] ボックスに、Select ステートメントを入力します。
ステートメントの始めは、SQL キーワードの Select にする必要があります。
7. [クエリの検証] ボタンをクリックします。
クエリの妥当性が Process Builder でチェックされ、クエリのテキスト ボックスのすぐ下
にメッセージが表示されます。
クエリが妥当でない場合は、データベースからのエラー メッセージが表示されます。クエリが妥
当になるように修正してください。
8. 経過アクティビティの場合のみ、取得したデータとワークフローを一致させるためにシステムが
使用する [相関 ID] として列名を選択します。
列には、特定のワークフロー インスタンスに関連する適切な相関 ID が含まれています。
相関 ID は、各プロセス インスタンスに関連付けられた一意の文字列であり、ワークフローを識
別してメッセージを一致させるのに使用されます。相関 ID は、データベースの書き込みアク
ティビティなどの先行するアクティビティで設定する必要があります。メッセージでの相関の使
用方法については、「相関識別子を使用する (144ページ) 」を参照してください。
9. [ポスト処理するステートメント] として、レコードを処理済みとマークする SQL の delete または
update ステートメントを入力します。
パッケージ属性または実行時のワークフロー変数からの値を持つパラメータを使用して、クエリ
を作成するには、値を置き換える場所に疑問符 (?) を入力します。疑問符は、アクティビティが
実行時に挿入する値のパラメータを表します。
たとえば、顧客レコードを処理した後に、社会保障番号を基にレコードを更新するクエリの場
合、次のように、特定の SSN 値 (米国社会保障番号) の代わりに疑問符を使用します。
UPDATE from CUSTOMER WHERE ssn=?
Update ステートメントには任意の数のパラメータを含めることができ、その各々を疑問符で表し
ます。各パラメータは、データ マッピング ページでプロセス データにマップする必要があり
ます。疑問符の前後には、引用符を付けないでください。
174
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
注 記 : システムで単一の行のみが処理されるように、ポスト プロセス中に行を一意に識別
できるようにします。
10. 代替パラメータを含むクエリの場合、各パラメータについてエイリアス名または列名を指
定します。
クエリに代替パラメータがない場合は、この手順を省略します。
a. [パラメータ タイプの設定] ボタンをクリックします。ダイアログ ボックスが開き、クエリ内の疑
問符の数に対応したパラメータのリストが表示されます。パラメータの名前は、param1、
param2 などとなります。
b. 1 つのパラメータの行を反転表示します。
c. [列名/エイリアス] 列の値をクリックし、リスト ボックスからパラメータの列名または列エイリア
スを選択します。パラメータの列名または列エイリアスは、ポスト プロセス クエリでパラメータ
がマップされる対応するデータベース列と一致している必要があります。
d. パラメータごとに、手順 b と c を繰り返します。
e. [OK] をクリックしてダイアログ ボックスを閉じます。
11. 各ポーリング サイクルで複数の行を処理する必要がある場合は、JDBC ドライバが取り出す行
の数を指定する [取り出しサイズ] を入力します。
12. システムがテーブルに新しいレコードがないかどうかをチェックする際の [ポーリング頻度] とし
て使用する時間 (秒) を入力します。
13. レコードを同時に処理するスレッドの数を設定する [プロセッサの数] を入力します。
14. [次へ] をクリックし、結果セットのデータをプロセス データ モデルにマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
15. [OK] または [適用] をクリックして、構成設定を保存します。
DQL 受 信 - 初 期 化 お よ び 手 順
注 記 : このアクティビティ テンプレートは、Documentum Process Builder バージョン 6.5 以
上でのみサポートされます。これより前のバージョンの Process Builder を Documentum 6.5
のリポジトリに対して使用すると、このテンプレートは開きません。
このテンプレートを使用して、Documentum リポジトリ内にあるオブジェクトを処理します。システム
は、新しいオブジェクトを取得すると、新しいプロセス インスタンスを作成するか、またはそのオブ
ジェクトを使用して実行中のアクティビティまたは作業項目を完了します。
DQL 受信アクティビティで、リスナが受信プロセスをリッスンするように設定されます。リスナは起動
すると、DQL 認定で指定した DQL 選択クエリを実行するポーラ スレッドを作成します。ポーラ
は、アクティビティ テンプレートで指定した時間間隔を使用して、クエリと一致する新しいオブ
ジェクトがないかをリポジトリに問い合わせます。クエリから返されるオブジェクト ID ごとに、オブ
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
175
事前定義のアクティビティ テンプレート
ジェクトで指定されたオプションを実行するポスト プロセッサにオブジェクトを委任する新しい
スレッドがシステムによって作成されます。
DQL 受 信 ア ク テ ィ ビ テ ィ を 設 定 す る に は 、 次 の 手 順 に 従 い ま す 。
1. [アクティビティ インスペクタ] で [DQL 設定] タブをクリックします。
2. 別のリポジトリから情報にアクセスする場合は、[別のリポジトリに接続] オプションを選択します。
3. [リポジトリ名] を入力するか、ドロップダウン リスト ボックスから選択します。
このリストには、Process Builder のこのインスタンスが dfc.properties 設定ファイルを
介して接続するすべてのリポジトリが含まれています。
4. 別のリポジトリに接続することを選択した場合、リポジトリへの接続に必要なユーザ名を入
力します。
5. 別のリポジトリに接続することを選択した場合、リポジトリへの接続に必要なパスワードを入
力します。
6. [接続のテスト] ボタンをクリックして、接続パラメータが正しく入力されていることを確認します。
接続が失敗した場合は、テキスト ボックスの下に赤色のメッセージが表示されま
す。値を修正して再試行してください。
7. テキスト ボックスに、オブジェクトを取得するための DQL 資格情報を入力します。
キーワード FROM で始まる SELECT ステートメントの一部からなる DQL 認定を入力し
ます。DQL 認定は、リポジトリ内のオブジェクトを一意に特定します。
8. [クエリの検証] をクリックしてクエリが有効であることを確認します。
9. 経過アクティビティのみには、DQL 認定で指定されたオブジェクト タイプに属する属性の一
覧から [相関 ID] を選択します。
10. 取得した後でオブジェクトを管理するための [ポスト プロセス オプション] を選択します。
有効な値により、クエリで取得したオブジェクトを削除したり、指定したフォルダにオブ
ジェクトを移動したり、入力したクエリに基づいて属性を更新したりできます。
11. アーカイブ フォルダにオブジェクトを移動するように選択した場合は、アーカイブ フォル
ダのパスを入力します。
12. 属性値を更新するように選択した場合は、テキスト ボックスにオブジェクト属性を更新するク
エリを入力します。
13. ポーリング頻度として使用する値を秒単位で入力します。
[ポーリング頻度] で設定した時間が経過すると、プロセッサはリポジトリに問い合わせ、
指定された DQL 選択ステートメントに一致する新しいエントリがあれば取得します。
14. 利用可能なプロセッサの数を入力します。
これは、このエンドポイントでデータを監視可能な同時実行プロセッサの合計数です。
15. [次へ] をクリックし、オブジェクトをプロセス データ属性にマップします。
DQL 読 み 取 り
注 記 : このアクティビティ テンプレートは、Documentum Process Builder バージョン 6.5 以
上でのみサポートされます。これより前のバージョンの Process Builder を Documentum 6.5
のリポジトリに対して使用すると、このテンプレートは開きません。
176
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
このテンプレートに基づくアクティビティは、指定されたリポジトリで DQL クエリを実行します。たと
えば、DQL 読み取りアクティビティ テンプレートを使用して、ある期間内に送信されたローン書類
や、融資額または信用度に基づいたローン書類をリポジトリから選択することができます。
DQL 読 み 取 り ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は 、 次 の 手 順 に 従 い ま す 。
1. [アクティビティ インスペクタ] で [DQL 設定] タブをクリックします。
2. 別のリポジトリから情報にアクセスする場合は、[別のリポジトリに接続] オプションを選択します。
3. [リポジトリ名] を入力するか、ドロップダウン リスト ボックスから選択します。
このリストには、Process Builder のこのインスタンスが dfc.properties 設定ファイルを
介して接続するすべてのリポジトリが含まれています。
4. 別のリポジトリに接続することを選択した場合、リポジトリへの接続に必要なユーザ名を入
力します。
5. 別のリポジトリに接続することを選択した場合、リポジトリへの接続に必要なパスワードを入
力します。
6. [接続のテスト] ボタンをクリックして、接続パラメータが正しく入力されていることを確認します。
接続が失敗した場合は、テキスト ボックスの下に赤色のメッセージが表示されま
す。値を修正して再試行してください。
7. テキスト ボックスに [実行するクエリ] を入力します。
プレースホルダ値を使用するクエリを作成するには、値を置き換える場所に疑問符
(?) を入力します。疑問符は、アクティビティが実行時に挿入する値のパラメータ
を表します。
8. [パラメータのタイプの設定] ボタンをクリックして、DQL クエリで指定するパラメータのデー
タ タイプを選択します。
9. [パラメータ タイプの設定] ボタンをクリックします。ダイアログ ボックスが開き、クエリ内の疑問
符の数に対応したパラメータのリストが表示されます。
パラメータの名前は、param1、param2 などとなります。
10. いずれかのパラメータの行を選択し、[パラメータのタイプ] 列をクリックしてタイプを選択します。
11. [OK] をクリックします。
12. [クエリの検証] をクリックしてクエリが有効であることを確認します。
13. [次へ] をクリックし、データ マッパを使用してプロセス データをクエリのパラメータにマッ
プします。
DQL 書 き 込 み
注 記: このアクティビティ テンプレートは、Documentum Process Builder バージョン 6.5 以
上でのみサポートされます。これより前のバージョンの Process Builder を Documentum 6.5
のリポジトリに対して使用すると、このテンプレートは開きません。
このテンプレートに基づくアクティビティは、指定されたリポジトリでオブジェクト DQL クエリの作
成、更新、または削除を実行します。たとえば、DQL 書き込みアクティビティ テンプレートを使用し
て、リポジトリ内にあるローン書類に信用度を設定できます。
DQL 書 き 込 み ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は 、 次 の 手 順 に 従 い ま す 。
1. [アクティビティ インスペクタ] で [DQL 設定] タブをクリックします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
177
事前定義のアクティビティ テンプレート
2. 別のリポジトリから情報にアクセスする場合は、[別のリポジトリに接続] オプションを選択します。
3. [リポジトリ名] を入力するか、ドロップダウン リスト ボックスから選択します。
このリストには、Process Builder のこのインスタンスが dfc.properties 設定ファイルを
介して接続するすべてのリポジトリが含まれています。
4. 別のリポジトリに接続することを選択した場合、リポジトリへの接続に必要なユーザ名を入
力します。
5. 別のリポジトリに接続することを選択した場合、リポジトリへの接続に必要なパスワードを入
力します。
6. [接続のテスト] ボタンをクリックして、接続パラメータが正しく入力されていることを確認します。
接続が失敗した場合は、テキスト ボックスの下に赤色のメッセージが表示されま
す。値を修正して再試行してください。
7. テキスト ボックスに [実行するクエリ] を入力します。
プレースホルダ値を使用するクエリを作成するには、値を置き換える場所に疑問符
(?) を入力します。疑問符は、アクティビティが実行時に挿入する値のパラメータ
を表します。
8. [パラメータのタイプの設定] ボタンをクリックして、DQL クエリで指定するパラメータのデー
タ タイプを選択します。
9. [パラメータ タイプの設定] ボタンをクリックします。
ダイアログ ボックスが開き、クエリ内の疑問符の数に対応したパラメータのリストが表示されます。
パラメータの名前は、param1、param2 などとなります。
10. いずれかのパラメータの行を選択します。
11. [パラメータのタイプ] 列をクリックして、タイプを選択します。
12. [OK] をクリックします。
13. [クエリの検証] をクリックしてクエリが有効であることを確認します。
14. [次へ] をクリックし、データ マッパを使用してプロセス データをクエリのパラメータにマッ
プします。
データベースの読み取り
このテンプレートに基づくアクティビティは、外部データベースに接続して SQL の Select ステートメン
トの結果を返します。また、データベースの読み取りアクティビティでは、Oracle の BLOB データ タ
イプおよび Microsoft SQL Server の Byte データ タイプのコンテンツをパッケージに変換できます。
注 記 : データベース パラメータのサポートされているデータ タイプは、CHAR、
VARCHAR、NVARCHAR_TYPE、BIGINT、INTEGER、SMALLINT、TINYINT、BIT、
DOUBLE、FLOAT、NUMERIC、DECIMAL、REAL、DATE、TIME、TIMESTAMP、
BOOLEAN、BINARY、BLOB、LONGVARBINARY、VARBINARY です。
アクティビティを定義するには、データベースへの接続で使用する JDBC ドライバを識別し、実行
する Select ステートメントを指定します。Select ステートメントに代替変数がある場合、データ マッピ
ング ツールを使用してその値を指定し、クエリの結果をパッケージ属性にコピーします。
データベースの読み取りアクティビティを設定するには
178
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
1. [アクティビティ インスペクタ] で [データベースの設定] タブをクリックします。
2. [JDBC ドライバ] リスト ボックスから、使用する JDBC ドライバを選択します。
3. [接続文字列] ボックスに、データベースへの接続で使用する JDBC 接続文字列を入力します。
JDBC ドライバを選択すると、接続文字列の予測される構文が、ボックスの下に表
示されます。
4. データベースへの接続で使用するユーザ名とパスワードを入力します。
5. [接続のテスト] をクリックして、Process Builder からデータベースに接続します。
• Process Builder が、手順 2 ～ 4 で指定した情報を使用してデータベースに接続でき
る場合は、[接続文字列] ボックスの下に緑色のメッセージが表示されます。
• 接続が失敗した場合は、ボックスの下に赤色のメッセージが表示されますので、値
を修正して再試行してください。
6. [実行するクエリ] ボックスに、Select ステートメントを入力します。
ステートメントの始めは、SQL キーワードの Select にする必要があります。パッケージ
属性または実行時のワークフロー変数からの値を持つパラメータを使用して、クエリを
作成するには、値を置き換える場所に疑問符 (?) を入力します。疑問符は、アクティビ
ティが実行時に挿入する値のパラメータを表します。たとえば、社会保障番号を基
に顧客記録を調べるクエリの場合、次のように、特定の SSN 値 (米国社会保障番
号) の代わりに疑問符を使用します。
Select * from CUSTOMER where ssn=?
Select ステートメントには任意の数のパラメータを含めることができ、その各々を疑問符で表し
ます。疑問符の前後には、引用符を付けないでください。
7. 代替パラメータのあるクエリの場合、パラメータごとにデータ タイプを指定します。
クエリに代替パラメータがない場合は、この手順を省略します。
a. [パラメータ タイプの設定] ボタンをクリックします。ダイアログ ボックスが開き、クエリ内の疑
問符の数に対応したパラメータのリストが表示されます。パラメータの名前は、param1、
param2 などとなります。
b. 1 つのパラメータの行を反転表示します。
c. [データ タイプ] 列の値をクリックし、リスト ボックスからパラメータのデータ タイプを選択しま
す。パラメータのデータ タイプは、対応するデータベース列のデータ タイプと一致している
必要があります。Oracle データベースの場合は、データ タイプとして [BLOB] を選択しま
す。Microsoft SQL の場合は、パラメータのデータ タイプとして [バイナリ] を選択します。
d. パラメータごとに、手順 b と c を繰り返します。
e. [OK] をクリックしてダイアログ ボックスを閉じます。
8. [クエリの検証] ボタンをクリックします。
クエリの妥当性が Process Builder でチェックされ、クエリのテキスト ボックスのすぐ下にメッ
セージが表示されます。
クエリが妥当でない場合は、データベースからのエラー メッセージが表示されます。クエリが妥
当になるように修正してください。
9. [次へ] をクリックします。
現在のページのすべての必須フィールドへの値の入力が完了するまで、[次へ] ボタ
ンは使用できません。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
179
事前定義のアクティビティ テンプレート
10. クエリに代替パラメータがある場合は、データ マッピング ツールを使用してパラメータの値
を指定します。
[入力メッセージ マッピング] 画面のデータ マッピング ツールの右側の列に、クエリの
代替パラメータが表示されます。左側の列には、パッケージ属性およびワークフロー
の代替変数が表示されます。
クエリに代替パラメータがない場合、[入力メッセージ マッピング] 画面は表示されません。手
順 12 に進んでください。
データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解する
(129ページ) 」を参照してください。
11. [次へ] をクリックします。
12. データ マッピング ツールを使用して、クエリの結果をパッケージ属性値として保存します。
[出力メッセージ マッピング] 画面のデータ マッピング ツールの左側の列に、クエリ
から返された値が表示されます。右側の列には、パッケージ属性が表示されます。
BLOB データ タイプを使用する場合は、BLOB コンテンツをパッケージのデータ
属性としてマップする必要があります。
クエリが 2 行以上のデータを返す場合、アクティビティは最初に返された行の値を、関連付
けられたパッケージ属性にマップします。
13. [OK] または [適用] をクリックして、構成設定を保存します。
データベースのストアド プロシージャ
このテンプレートに基づくアクティビティは外部データベースに接続し、ストアド プロシージャまた
は関数を実行します。アクティビティを定義するには、データベースへの接続で使用する JDBC
ドライバを識別し、実行するストアド プロシージャまたは関数を指定します。ストアド プロシー
ジャに IN または IN/OUT パラメータがある場合、データ マッピング ツールを使用してその値を
指定します。アクティビティによって、ストアド プロシージャの OUT および IN/OUT パラメータ
の値または結果セット、あるいは関数の戻り値が返されます。
注 記 : IN、OUT、および IN/OUT パラメータのサポートされているデータ タイプは、
CHAR、VARCHAR、NVARCHAR_TYPE、BIGINT、INTEGER、SMALLINT、TINYINT、
BIT、DOUBLE、FLOAT、NUMERIC、DECIMAL、REAL、DATE、TIME、TIMESTAMP、
BOOLEAN、BINARY、BLOB、LONGVARBINARY、VARBINARY です。
データベースのストアド プロシージャ アクティビティを設定するには
1. [アクティビティ インスペクタ] で [データベースの設定] タブをクリックします。
2. [JDBC ドライバ] リスト ボックスから、使用する JDBC ドライバを選択します。
3. [接続文字列] ボックスに、データベースへの接続で使用する JDBC 接続文字列を入力します。
JDBC ドライバを選択すると、接続文字列の予測される構文が、ボックスの下に表
示されます。
4. データベースへの接続で使用するユーザ名とパスワードを入力します。
5. [接続のテスト] をクリックして、Process Builder からデータベースに接続します。
Process Builder が、手順 2 ～ 4 で指定した情報を使用してデータベースに接続できる場合
は、[接続文字列] ボックスの下に緑色のメッセージが表示されます。接続が失敗した場合は、
ボックスの下に赤色のメッセージが表示されます。値を修正して再試行してください。
180
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
6. ストアド プロシージャまたは関数の名前を入力するための、表示されたボックスに、ストアド プ
ロシージャまたは関数の名前を入力します。オプションで、ストアド プロシージャの完全修飾名
を次のいずれかの形式で入力できます。
<カタログ名>.<スキーマ名>.<プロシージャ名> または <スキーマ名>.<プロシージャ名> また
は <プロシージャ名>手順 8 に進みます。
注 記 : カタログ名、スキーマ名、およびプロシージャ名または関数名では、大文字と小文
字が区別されます。
7. ストアド プロシージャ名または関数名がわからない場合は、次の手順でストアド プロシー
ジャまたは関数を検索できます。
a. ストアド プロシージャまたは関数を検索するために [検索] をクリックします。[検索] ウィ
ンドウが表示されます。
b. [検索パターンを入力してください] ボックスに、ストアド プロシージャ名または関数名を入
力します。ストアド プロシージャ名または関数名では大文字と小文字が区別されます。ま
た、完全修飾名を指定することもできます。ストアド プロシージャまたは関数の検索に
は、% ワイルドカードも使用できます。% ワイルドカードの使用方法の詳細については、
[What’s this?] (ヒント) をクリックしてください。
c. [検索] をクリックします。
Process Builder は、データベース内のすべてのスキーマおよびパッケージにわたっ
てストアド プロシージャまたは関数を検索し、プロシージャまたは関数の完全修飾
名を取得します。たとえば、検索ボックスに「CALCULATE_TAX」というプロシー
ジャ名を入力すると、STANDARD.SYS.CALCULATE_TAX などのストアド プロ
シージャ名と共にカタログ名およびスキーマ名も取得されます。
異なる検索パターンの使用方法については、「検索パターンの例 (182ページ) 」を参照
してください。
d. リスト ボックスからストアド プロシージャまたは関数を選択します。
リスト ボックスからストアド プロシージャまたは関数を選択すると、リスト ボックスの
下に、選択したストアド プロシージャまたは関数の入力パラメータや戻り値など
の追加情報が表示されます。
e. [OK] をクリックすると [データベースの設定] タブに戻ります。
選択したストアド プロシージャまたは関数がボックスに表示されます。
8. [次へ] をクリックします。
9. ストアド プロシージャまたは関数に入力パラメータがある場合は、データ マッピング ツール
を使用してパラメータの値を指定します。
[入力メッセージ マッピング] 画面の左側の列には、パッケージ属性とワークフローの代替
変数が表示されます。データ マッピング ツールの右側の列には、ストアド プロシージャの
IN および IN/OUT パラメータまたは関数の引数がすべて表示されます。複数の入力パラ
メータがあり、1 つのパラメータだけをマップする場合、他のパラメータは NULL に設定され
るか、あるいはストアド プロシージャまたは関数で定義されたとおりに設定されます。デー
タ マッピング ツールを使用する手順については、「データ マッピング ツールを理解する
(129ページ) 」を参照してください。
ストアド プロシージャまたは関数に入力パラメータまたは引数がない場合、[入力メッセージ
マッピング] 画面は表示されません。手順 11 に進んでください。
10. [次へ] をクリックします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
181
事前定義のアクティビティ テンプレート
11. データ マッピング ツールを使用して、関数またはプロシージャの戻り値をパッケージ属性
として保存します。
[出力メッセージ マッピング] 画面のデータ マッピング ツールの左側の列には、ス
トアド プロシージャの OUT および IN/OUT パラメータの値または返される結果セッ
ト、あるいは関数の戻り値が表示されます。右側の列には、パッケージ属性が表示さ
れます。データ マッピング ツールを使用する手順については、「データ マッピング
ツールを理解する (129ページ) 」を参照してください。
12. [OK] または [適用] をクリックして、構成設定を保存します。
検索パターンの例
[検索パターンを入力してください] ボックスで、次の検索パターンを使用できます。
注 記 : 検索パターンでは、大文字と小文字が区別されます。
• ス ト ア ド プ ロ シ ー ジ ャ 名 ま た は 関 数 名 - 入力したストアド プロシージャまたは関数に一致する箇
所のみを検索するには、次の形式を使用します。
<プロシージャ名>
たとえば、「ADD_EMPLOYEE」という名前のストアド プロシージャを検索すると、
「ADD_EMPLOYEE」ストアド プロシージャと共に「STANDARD.SYS.ADD_EMPLOYEE」など
のカタログ名およびスキーマ名も取得されます。「ADD_」を検索すると、名前が ADD_ で始まる
すべてのストアド プロシージャまたは関数が取得されます。
• 完 全 修 飾 名 - 完全修飾名として入力したストアド プロシージャまたは関数に一致する箇所
のみを検索するには、次のいずれかの形式を使用します。
<カタログ名>.<スキーマ名>.<プロシージャ名>
または <スキーマ名>.<プロシージャ名>
たとえば、ストアド プロシージャ「ORDSOURCE.ORDSYS.WRITE」で検索すると、
ORDSOURCE カタログの ORDSYS スキーマの WRITE ストアド プロシージャが取得されま
す。その他のカタログまたはスキーマにある WRITE ストアド プロシージャは取得されません。
「SCOTT.ADD_EMPLOYEE」で検索すると、SCOTT スキーマの ADD_EMPLOYEE ストア
ド プロシージャが取得されます。
• ワ イ ル ド カ ー ド - データベース内のすべてのカタログおよびスキーマにわたってストアド プロ
シージャまたは関数を検索するには、次の検索パターンを使用します。
– % または空白 - データベース内のすべてのストアド プロシージャまたは関数が取得されます。
– B% - 名前が「B」で始まるストアド プロシージャがすべて取得されます。
– A.% - 「A」という名前のスキーマのストアド プロシージャがすべて取得されます。
– A.B% - 「A」という名前のスキーマの、名前が「B」で始まるストアド プロシージャがすべて
取得されます。
– C.A.B% - カタログ「C」のスキーマ「A」から、名前が「B」で始まるストアド プロシージャ
がすべて取得されます。
– A%.B% — 名前が「A」で始まるスキーマから、名前が「B」で始まるストアド プロシージャ
がすべて取得されます。
182
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
データベースの書き込み
このテンプレートに基づくアクティビティは、外部データベースに接続して、SQL の Insert、Update、
Delete のいずれかのステートメントを実行します。また、データベースの書き込みアクティビティで
は、パッケージのコンテンツをデータベース パラメータに変換できます。つまり、パッケージのバイ
ナリ データまたは BLOB データをデータベースに挿入したり更新したりできます。
注 記 : データベース パラメータのサポートされているデータ タイプは、CHAR、
VARCHAR、NVARCHAR_TYPE、BIGINT、INTEGER、SMALLINT、TINYINT、BIT、
DOUBLE、FLOAT、NUMERIC、DECIMAL、REAL、DATE、TIME、TIMESTAMP、
BOOLEAN、BINARY、BLOB、LONGVARBINARY、VARBINARY です。
アクティビティを定義するには、データベースへの接続で使用する JDBC ドライバを識別し、実行
するステートメントを指定します。SQL ステートメントに代替変数がある場合、データ マッピング ツー
ルを使用してその値を指定します。アクティビティから、作成または更新された行数が返されます。
データベースの書き込みアクティビティを設定するには
1. [アクティビティ インスペクタ] で [データベースの設定] タブをクリックします。
2. [JDBC ドライバ] リスト ボックスから、使用する JDBC ドライバを選択します。
3. [接続文字列] ボックスに、データベースへの接続で使用する JDBC 接続文字列を入力します。
JDBC ドライバを選択すると、接続文字列の予測される構文が、ボックスの下に表
示されます。
4. データベースへの接続で使用するユーザ名とパスワードを入力します。
5. [接続のテスト] をクリックして、Process Builder からデータベースに接続します。
Process Builder が、手順 2 ～ 4 で指定した情報を使用してデータベースに接続で
きる場合は、[接続文字列] ボックスの下に緑色のメッセージが表示されます。接続
が失敗した場合は、ボックスの下に赤色のメッセージが表示されます。値を修正し
て再試行してください。
6. [実行するクエリ] ボックスに、有効な SQL の Insert、Update、または Delete ステートメント
を入力します。
ステートメントの始めは、SQL キーワードの Insert、Update、Delete のいずれかにする必要
があります。パッケージ属性または実行時のワークフロー変数からの値を持つパラメータを
使用して、SQL ステートメントを作成するには、値を置き換える場所に疑問符 (?) を入力し
ます。疑問符は、アクティビティが実行時に挿入する値のパラメータを表します。たとえば、
社会保障番号を基に顧客の姓を更新するステートメントの場合、次のように、特定の SSN
値 (米国社会保障番号) の代わりに疑問符を使用します。
Update CUSTOMER Set Lastname=’Smith’ where ssn=?
SQL ステートメントには任意の数のパラメータを含めることができ、その各々を疑問符で表し
ます。疑問符の前後には、引用符を付けないでください。
7. 代替パラメータがある SQL ステートメントの場合、パラメータごとにデータ タイプを指定します。
ステートメントに代替パラメータがない場合は、この手順を省略します。
1. [パラメータ タイプの設定] をクリックします。ダイアログ ボックスが開き、クエリ内の疑問
符の数に対応したパラメータのリストが表示されます。パラメータの名前は、param1、
param2 などとなります。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
183
事前定義のアクティビティ テンプレート
2. 1 つのパラメータの行を反転表示します。
3. [データ タイプ] 列の値をクリックし、リスト ボックスからパラメータのデータ タイプを選択しま
す。パラメータのデータ タイプは、対応するデータベース列のデータ タイプと一致している
必要があります。Oracle データベースの場合は、データ タイプとして [BLOB] を選択しま
す。Microsoft SQL の場合は、パラメータのデータ タイプとして [バイナリ] を選択します。
4. パラメータごとに、手順 b と c を繰り返します。
5. [OK] をクリックしてダイアログ ボックスを閉じます。
8. [次へ] をクリックします。
現在のページのすべての必須フィールドへの値の入力が完了するまで、[次へ] ボタ
ンは使用できません。
9. SQL ステートメントに代替パラメータがある場合は、データ マッピング ツールを使用してパラ
メータの値を指定します。
[入力メッセージ マッピング] 画面のデータ マッピング ツールの右側の列に、SQL ステートメ
ントの代替パラメータが表示されます。左側の列には、パッケージ属性およびワークフロー
の代替変数が表示されます。BLOB データ タイプを使用する場合は、BLOB コンテンツを
パッケージのデータ属性としてマップする必要があります。
SQL ステートメントに代替パラメータがない場合、[入力メッセージ マッピング] 画面は表
示されません。手順 11 に進んでください。
10. [次へ] をクリックします。
11. データ マッピング ツールを使用して、返された行の数をパッケージ属性値として保存します。
[出力メッセージ マッピング] 画面の、データ マッピング ツールの左側の列に、SQL ス
テートメントから返された単一値が表示されます。この値は、挿入または更新された行
数を表します。右側の列には、パッケージ属性が表示されます。
データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解する
(129ページ) 」を参照してください。
12. [OK] または [適用] をクリックして、構成設定を保存します。
動 的 Web サ ー ビ ス
このテンプレートに基づくアクティビティは、Web サービス オペレーションを実行します。Web
サービス テンプレートとは異なり、このアクティビティ テンプレートを使用すると、ビジネス プロ
セス属性と Web サービス パラメータとの間で対話式にデータをマップできます。このアクティ
ビティ テンプレートは、セキュリティ保護された Web サービスとセキュリティ保護されていな
い Web サービスの両方をサポートします。
注 記 : 以下の条件を満たす場合、このアクティビティでは WSDL に列挙される処理が
表示されません。
• バインドにおいて定義された処理が SOAP 1.1 または SOAP 1.2 でサポートされて
いない。
• WSDL で定義された処理において、binding および port の input と output メッセージ タ
グ (/binding/operation/input と /binding/operation/output および /portType/operation/input
と /portType/operation/output) の間で名前属性の不一致が発生している。
184
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
セ キ ュ リ テ ィ 保 護 さ れ て い な い Web サ ー ビ ス を 呼 び 出 す に は
このセクションでは、セキュリティ保護されていない Web サービス アクティビティの設定方法に
ついて説明します。
セ キ ュ リ テ ィ 保 護 さ れ て い な い 動 的 Web サ ー ビ ス ア ク テ ィ ビ テ ィ を 呼 び 出 す に は
1. [アクティビティ インスペクタ] で [Web サービスの設定] タブをクリックします。
2. [WSDL ファイルへの URL パス] ボックスに、実行するオペレーションが含まれている WSDL
ファイルの完全修飾 URL を入力します。
3. [WSDL ファイルの読み取り] をクリックします。
Process Builder が指定の WSDL ファイルを読み取り、画面上の残りのフィールドに
値を入力します。
4. 指定の WSDL ファイルで利用可能なポート タイプから選択します。
[WSDL ファイルの読み取り] をクリックするまで、[ポート タイプ] リスト ボックスは空
白です。
5. 指定の WSDL ファイルで利用可能なオペレーションから選択します。
6. [次へ] をクリックします。
有効な WSDL ファイルからオペレーションを選択するまで、[次へ] ボタンは使用で
きません。ビジネス プロセス用のパッケージが指定されていない場合、あるいは
選択した Web サービス オペレーションに入力パラメータまたは戻り値がない場合
も、ボタンは使用できません。
7. 選択した Web サービス オペレーションに入力パラメータがある場合は、データ マッピング ツー
ルを使用してパラメータの値を指定します。
[入力メッセージ マッピング] 画面のデータ マッピング ツールの右側の列に、オペレーションの
入力パラメータが表示されます。左側の列には、プロセス データおよびワークフローの代替変
数が表示されます。データ マッピング ツールを使用する手順については、「データ マッピ
ング ツールを理解する (129ページ) 」を参照してください。
選択した Web サービス オペレーションに入力パラメータがない場合、[入力メッセージ マッピ
ング] 画面は表示されません。手順 9 に進んでください。
8. [次へ] をクリックします。
選択した Web サービス オペレーションに出力値がない場合、[次へ] ボタンは使用できませ
ん。次の手順は省略してください。
9. データ マッピング ツールを使用して、出力値をパッケージ属性値として保存します。
[出力メッセージ マッピング] 画面のデータ マッピング ツールの左側の列に、オペレーションか
らの出力値が表示されます。右側の列には、パッケージ属性が表示されます。データ マッピ
ング ツールを使用する手順については、「データ マッピング ツールを理解する (129ペー
ジ) 」を参照してください。
10. [OK] または [適用] をクリックして、構成設定を保存します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
185
事前定義のアクティビティ テンプレート
セ キ ュ リ テ ィ 保 護 さ れ た Web サ ー ビ ス を 呼 び 出 す
このテンプレートに基づくアクティビティは、3 種類のセキュリティをサポートしています。サ
ポートされるセキュリティは次のとおりです。
• HTTP プロキシ サポート
• HTTP 基本認証
• SOAP ヘッダーベースの認証
セキュリティ保護された Web サービスを設定する前に、HTTP プロキシ サーバを設定できます。
HTTP プロキシ サーバの設定については、HTTP プロキシ サーバを設定する (189ページ)
を参照してください。
HTTP 基本認証および SOAP ヘッダーベースの認証で保護された Web サービスを設定す
る方法は次のとおりです。
セキュリティ保護された Web サービス アクティビティを設定するには、[アクティビティ インスペクタ]
の [Web サービスの設定] タブをクリックします。
HTTP 認 証 で 保 護 さ れ た Web サ ー ビ ス を 呼 び 出 す
開 始 さ れ る Web サ ー ビ ス が HTTP 基 本 認 証 で 保 護 さ れ て い る 場 合 、 次 の 手 順 を 実 行 し ま す 。
1. [WSDL ファイルへの URL パス] ボックスに、実行するオペレーションが含まれている WSDL
ファイルの完全修飾 URL を入力します。
2. [WSDL ファイルの読み取り] をクリックします。
Process Builder が指定の WSDL ファイルを読み取り、画面上の残りのフィールドに
値を入力します。
3. 指定の WSDL ファイルで利用可能なポート タイプから選択します。
[WSDL ファイルの読み取り] をクリックするまで、[ポート タイプ] リスト ボックスは空
白です。
4.
5.
6.
7.
8.
指定の WSDL ファイルで利用可能なオペレーションから選択します。
[HTTP 基本認証を使用] を選択します。
[ユーザ名] ボックスに、ユーザ名を入力します。
[パスワード] ボックスに、指定したユーザのパスワードを入力します。
「Web サービス パラメータをマップする (188ページ) 」に進みます。
SOAP ヘ ッ ダ ー 認 証 で 保 護 さ れ た Web サ ー ビ ス を 呼 び 出 す
開 始 さ れ る Web サ ー ビ ス が SOAP ヘ ッ ダ ー ベ ー ス の 認 証 に よ っ て 保 護 さ れ て い る 場 合 :
1. [WSDL ファイルへの URL パス] ボックスに、実行するオペレーションが含まれている WSDL
ファイルの完全修飾 URL を入力します。
たとえば、Documentum Web Services Framework (WSF) を使用する場合、リポジトリ認証情
報サービスには次の URL を使用します。
http://localhost:8080/ws/services/DocbaseCredentials?wsdl
ここで、
186
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
• localhost:8080 - アプリケーション サーバのホスト アドレスです。
• ws/services - Web Services Framework (WSF) がインストールされているアプリケーション
サーバのディレクトリの名前です。
2. [WSDL ファイルの読み取り] をクリックします。
Process Builder が指定の WSDL ファイルを読み取り、画面上の残りのフィールドに
値を入力します。
3. 指定の WSDL ファイルで利用可能なポート タイプから選択します。
[WSDL ファイルの読み取り] をクリックするまで、[ポート タイプ] リスト ボックスは空
白です。
4. 指定の WSDL ファイルで利用可能なオペレーションから選択します。
注 記 : 認証情報サービスのタイプやオペレーションの詳細については、『Documentum Web
Services Framework Development Guide (Documentum Web Services Framework 開発ガイ
ド)』を参照してください。
5. 一般的な SOAP ベースでセキュリティ保護された Web サービスの場合、セキュリティ トーク
ンが生成されます。
6. SOAP ベースの認証情報をマップするには、「Web サービス パラメータをマップする (188ペー
ジ) 」に進みます。
Secure Socket Layer (SSL) で 保 護 さ れ て い る Web サ ー ビ ス を 呼 び 出 す
Web サービスは保護されているため、使用する環境に SSL 証明書が必要であり、Process Builder
と Java メソッド サーバの両方に存在する必要があります。
Web サ ー ビ ス が 展 開 さ れ て い る サ ー バ か ら 証 明 書 を エ ク ス ポ ー ト す る に は
1. Web サービスの URL をブラウザで入力します。
2. ブラウザから証明書をエクスポートします。
注 記 : 証明書をエクスポートする方法については、Web ブラウザのヘルプまたはドキュメントを
参照してください。 証明書を Process Builder および JBoss サーバにインポートするには
a. 証明書を正常にエクスポートしており、その場所をメモしていることを確認します。
b. コマンド プロンプトで次の keytool コマンドを使用して、証明書をインポートします。
keytool -import -noprompt -trustcacerts -alias <alias> -file
<certificate-location>
-keystore <Process Builder or Method Server (jboss) bundled
java trust store>
-storepass changeit
ここで、
• <alias> は、エイリアスの一意の名前です。
• <certificate-location> は、証明書の場所です。
• <Process Builder or Method Server (JBoss) bundled java trust store> は、Java トラスト
ストアがバンドルされた Process Builder およびメソッド サーバ (JBoss) の場所です。
Process Builder の 場 合 、 次 の よ う に な り ま す 。
<drive>\PROGRA~1\Documentum\java\1.5.0_12\jre\lib\security\cacerts
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
187
事前定義のアクティビティ テンプレート
メソッド サーバ (JBoss) の場合、次のようになります。
• %Documentum%\jboss4.2.0\jdk\jre\lib\security\cacerts (Windows)
• $DOCUMENTUM_SHARED$/jboss4.2.0/jdk/jre/lib/security/cacerts (UNIX/Linux)
3. 証明書が正常にインポートされたことを確認します。
システムにより、トラスト ストアへの証明書のインポート後に、証明書がキーストアに追加さ
れたことを示すメッセージが表示されます。インポートされたコンテンツをリストするには、次
のコマンドを使用します。
keytool -v -list -alias <alias> -keystore <Process Builder or
Method Server (jboss)bundled java trust store> -storepass changeit
Web サ ー ビ ス パ ラ メ ー タ を マ ッ プ す る
Web サービスの入力値と出力値をマップするには次の手順を実行します。ただし、次の手順を実
行する前に、動的 Web サービスを設定する初期手順を完了しておく必要があります (「セキュリ
ティ保護された Web サービスを呼び出す (186ページ) 」を参照)。
Web サ ー ビ ス パ ラ メ ー タ を マ ッ プ す る に は
1. [次へ] をクリックします。
有効な WSDL ファイルからオペレーションを選択するまで、[次へ] ボタンは使用で
きません。ビジネス プロセス用のパッケージが指定されていない場合、あるいは
選択した Web サービス オペレーションに入力パラメータまたは戻り値がない場合
も、ボタンは使用できません。
2. 選択した Web サービス オペレーションに入力パラメータがある場合は、データ マッピング ツー
ルを使用してパラメータの値を指定します。
[入力メッセージ マッピング] 画面のデータ マッピング ツールの右側の列に、オペレー
ションの入力パラメータが表示されます。左側の列には、パッケージ属性およびワー
クフローの代替変数が表示されます。
データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解する
(129ページ) 」を参照してください。
Web サービスが SOAP ヘッダーベースの認証で保護されている場合、セキュリティ トーク
ンおよび SOAP ベースでセキュリティ保護されたパラメータをマップする必要があります。
Documentum WSF ベースの認証情報サービスを使用する場合、認証情報サービスのタイプや
オペレーションに基づくパラメータの値をマップする必要があります。
注 記 : 認証情報サービスのタイプやオペレーションの詳細については、『Documentum Web
Services Framework Development Guide (Documentum Web Services Framework 開発ガイ
ド)』を参照してください。
選択した Web サービス オペレーションに入力パラメータがない場合、[入力メッセージ マッピ
ング] 画面は表示されません。手順 3 に進んでください。
3. [次へ] をクリックします。
選択した Web サービス オペレーションに出力値がない場合、[次へ] ボタンは使用できませ
ん。次の手順は省略してください。
4. データ マッピング ツールを使用して、出力値をパッケージ属性値として保存します。
188
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
[出力メッセージ マッピング] 画面のデータ マッピング ツールの左側の列に、オペレー
ションからの出力値が表示されます。右側の列には、パッケージ属性が表示されます。
データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解する
(129ページ) 」を参照してください。
5. [OK] または [適用] をクリックして、構成設定を保存します。
HTTP プ ロ キ シ サ ー バ を 設 定 す る
HTTP プロキシ サーバ経由でファイアウォールの外部にある Web サービスにアクセスするに
は、HTTP プロキシ パラメータを設定する必要があります。そのためには、Process Builder の
ショートカットおよび Content Server Java メソッド サーバのスタートアップ パラメータを変更しま
す。次のセクションでは、Windows システムおよび UNIX ベースのシステムでスタートアップ パラ
メータを設定する方法について説明します。
Windows で HTTP プ ロ キ シ パ ラ メ ー タ を 設 定 す る
このセクションでは、Process Builder のショートカットおよび Content Server Java メソッド サーバ用の
HTTP プロキシ開始パラメータを Windows システムで設定する方法について説明します。
1. まず、次の手順を実行して、Process Builder のショートカットを設定します。
a. デスクトップで、Process Builder のショートカットを右クリックして、[プロパティ] を選択します。
注記: デスクトップに Process Builder のショートカットがない場合、[スタート] > [プログラム] >
[Documentum] を選択し、[Process Builder] を右クリックしてから [プロパティ] を選択します。
b. [リンク先] ボックスで、javaw.exe パスを次のように変更します。
• HTTP 基本認証
"C:\Program Files\Documentum\java\1.5.0_12\jre\bin\javaw.exe
-Dhttp.proxyHost=localhost -Dhttp.proxyPort=<port-number>
-Dhttp.nonProxyHosts"
ここで、
– http.proxyHost — プロキシ サーバのホスト名です。
– http.proxyPort — ポート番号で、デフォルト値は 80 です。
– http.nonProxyHosts — プロキシ サーバを経由せずに、直接アクセスする必要がある
ホストのリストです。これは「|」で区切られた正規表現のリストです。これらの正規表現の
いずれかに一致するホストは、プロキシを経由せずに直接接続でアクセスされます。
• SSL 経由の HTTP:
"C:\Program Files\Documentum\java\1.5.0_12\jre\bin\javaw.exe
-Dhttps.proxyHost=localhost -Dhttps.proxyPort=<port-number>
-Dhttps.nonProxyHosts"
ここで、
– https.proxyHost — プロキシ サーバのホスト名です。
– https.proxyPort — ポート番号で、デフォルト値は 443 です。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
189
事前定義のアクティビティ テンプレート
– http.nonProxyHosts — プロキシ サーバを経由せずに、直接アクセスする必要がある
ホストのリストです。これは「|」で区切られた正規表現のリストです。これらの正規表現の
いずれかに一致するホストは、プロキシを経由せずに直接接続でアクセスされます。
2. 次に、以下の手順を実行して、Java メソッド サーバの開始パラメータを設定します。
a. $DOCUMENTUM$ から StartMethodServer.cmd ファイルを開きます。
b. 基本認証、または SSL 経由の HTTP の HTTP プロキシ パラメータを JAVA_OPTIONS に
追加します。
たとえば、HTTP 基本認証をサポートする次の行を追加します。
-Dhttp.proxyHost=<proxy_host>-Dhttp.proxyPort=<port_number>
ここで、
proxy_host はプロキシ サーバの名前です。
port_number はポート番号です。デフォルトは 80 です。
UNIX ベ ー ス の シ ス テ ム で HTTP プ ロ キ シ パ ラ メ ー タ を 設 定 す る
このセクションでは、UNIX ベースのシステムで Content Server Java メソッド サーバのスタートアッ
プ パラメータを設定する方法を説明します。
Java メ ソ ッ ド サ ー バ の ス タ ー ト ア ッ プ パ ラ メ ー タ を 設 定 す る に は
1. $DOCUMENTUM$ から StartMethodServer.cmd ファイルを開きます。
2. 基本認証、または SSL 経由の HTTP の HTTP プロキシ パラメータを JAVA_OPTIONS に追
加します。
たとえば、HTTP 基本認証をサポートする次の行を追加します。
-Dhttp.proxyHost=<proxy_host>-Dhttp.proxyPort=<port_number>
ここで、
proxy_host はプロキシ サーバの名前です。
port_number はポート番号です。デフォルトは 80 です。
Process Builder か ら DFS (Documentum Foundation Services) サ ー ビ ス
を呼び出す
DFS サービスは次のいずれかの方法で Process Builder から呼び出すことができます。
• 単一サービスとして呼び出す。つまり、1 つのプロセスには、DFS Web サービスの呼び出しを 1
回実行する 1 つの動的 Web サービス アクティビティ テンプレートが含まれます。
• 連鎖サービスとして呼び出す。つまり、1 つのプロセスに、複数の DFS Web サービスを呼び出
す動的 Web サービス アクティビティ テンプレートが複数含まれます。各アクティビティ テンプ
レートが使用するトークンにリポジトリ ID 情報が登録されます。
注 記: 動的 Web サービス アクティビティ テンプレートでは、コンテンツの転送に base64 お
よび MTOM をサポートしています。
連鎖サービスのリポジトリを登録する
連 鎖 サ ー ビ ス の リ ポ ジ ト リ ID を 登 録 す る に は
1. DFS が提供する ContextRegistryService を使用してリポジトリを登録します。
190
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
ContextRegistryService の詳細については、『Documentum Foundation Services Development
Guide (Documentum Foundation Services 開発ガイド)』を参照してください。
2. 動的 Web サービス アクティビティ テンプレートの [Web サービスの設定] タブで、WSDL への
完全修飾 URL パスを入力します。
以下に例を示します。
http://yourserver:port/services/core/runtime/ContextRegistryService?wsdl
注 記 : WSDL はローカル ファイルとして存在する場合もあります。
3.
4.
5.
6.
7.
[ポート タイプ] として [ContextRegistryServicePort] を選択します。
[オペレーション] として [登録] を選択します。
[WSDL ファイルの読み取り] をクリックします。
[次へ] をクリックします。
[入力メッセージ マッピング] ページで、次のマッピングを作成します。
• [リポジトリ名] を次のようにマップします。
SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity
[0]/@repositoryName
• [ユーザ名] を次のようにマップします。
SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity
[0]/@userName
• [パスワード] を次のようにマップします。
SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity
[0]/@password
• [ドメイン] を次のようにマップします。
SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity
[0]/@domain
注 記 : RepositoryIdentity は繰り返しノードです。複数の ID を単一のトークンに登録できます。
8. [次へ] をクリックします。
9. [出力メッセージ マッピング] ページに、作成されたトークンが次のように表示されます。
SOAPEnvelope/SOAPBody/parameters/registerResponse/return
連鎖サービスのリポジトリの登録を解除する
連 鎖 サ ー ビ ス の リ ポ ジ ト リ ID の 登 録 を 解 除 す る に は
1. DFS が提供する ContextRegistryService を使用してリポジトリを登録します。
ContextRegistryService の詳細については、『Documentum Foundation Services
Development Guide (Documentum Foundation Services 開発ガイド)』を参照してくださ
い。
2. 動的 Web サービス アクティビティ テンプレートの [Web サービスの設定] タブで、WSDL への
完全修飾 URL パスを入力します。
以下に例を示します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
191
事前定義のアクティビティ テンプレート
http://yourserver:port/services/core/runtime/ContextRegistryService?wsdl
注 記: WSDL はローカル ファイルとして存在する場合もあります。
3.
4.
5.
6.
7.
[ポート タイプ] として [ContextRegistryServicePort] を選択します。
[オペレーション] として [登録解除] を選択します。
[WSDL ファイルの読み取り] をクリックします。
[次へ] をクリックします。
[入力メッセージ マッピング] ページで、登録を解除する必要があるトークンを
[SOAPEnvelope/SOAPBody/parameters/unregister/token] に追加します。
単一 ま た は 連 鎖 ) を 呼 び 出 す
一 般 的 な DFS サ ー ビ ス (単
一般的な DFS サービス (単一または連鎖) を呼び出すには、次の手順を実行します。
1. 動的 Web サービス アクティビティ テンプレートのアクティビティ インスペクタを開きます。
2. [Web サービスの設定] タブを選択します。
3. 特定の DFS サービスの WSDL の完全修飾 URL を入力します。
4. WSDL ファイルで利用可能な値に基づいて、[ポート タイプ] および [オペレーション] を選
択します。
5. [次へ] をクリックします。
6. [入力メッセージ マッピング] ページで、任意の DFS サービスを認証するための次のデータ
マッピングを追加します。
連結機能を使用してマッピングの文字列を構築します。
注 記 : 次のマッピングは、DFS サービスの認証のみに使用されます。DFS の機能の詳細に
ついては、『Documentum Foundation Services Development Guide (Documentum Foundation
Services 開発ガイド)』を参照してください。
連鎖サービスの場合は、次を
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/
oasis-200401-wss-wssecurity-secext-1.0.xsd"><wsse:BinarySecurityToken
QualificationValueType="http://schemas.emc.com/documentum#Resource
AccessToken" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/
oasis-200401-wss-wssecurity-utility-1.0.xsd"
wsu:Id="RAD">someToken</wsse:BinarySecurityToken></wsse:Security>
SOAPHeader にマップします。
(SOAPEnvelope/SOAPHeader/SOAPHeaderElement[0])
単一サービスの場合は、次を
<ServiceContext
xmlns="http://context.core.datamodel.fs.documentum.emc.com/"
xmlns:ns2="http://properties.core.datamodel.fs.documentum.emc.com/"
xmlns:ns3=http://profiles.core.datamodel.fs.documentum.emc.com/">
<Identities xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
repositoryName="docbaseName" password="docbasePassword"
userName="docbaseUsername"
192
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
xsi:type="RepositoryIdentity"/></ServiceContext>
SOAPHeader にマップします。
(SOAPEnvelope/SOAPHeader/SOAPHeaderElement[0])
注 記 : 複数のリポジトリを認証に使用する場合は、<Identities/> を複数使用します。
受信電子メール - 初期化および手順
電子メール アクティビティ テンプレートは、について電子メール サーバへのポーリングを行い、指
定したビジネス ロジックに従って処理します。受信電子メール アクティビティ テンプレートでは、電
子メール サーバへの接続を定義し、既読のメッセージを処理するオプションを選択して、受信メッ
セージのデータをプロセスで使用するプロセス データにマップします。
たとえば、顧客クレームにかかわるビジネス プロセスでは、受信電子メール テンプレートをプロセ
スの初期化アクティビティとして設定できます。このアクティビティは、電子メール サーバへの
ポーリングを行い、顧客クレームの電子メール メッセージを受信した場合に新しいワークフロー
を開始します。次に示すプロセスの手順で、電子メールは手動のアクティビティにより、クレー
ムの確認および問題の解決を行う担当者に送信されます。
注 記 : マルチバイト文字を使用するメッセージの送信中および読み取り中は、電子メール
クライアントのエンコードは UTF-8 に設定されている必要があります。
1. [電子メール サーバ タイプ] フィールドで、電子メール サーバに接続するためのプロトコル
を選択します。
有効な値は、[IMAP] または [POP] です。
2. [ホスト名] フィールドに、電子メール サーバの名前または IP アドレスを入力します。
3. 電子メール サーバがプロトコル (IMAP または POP) 要求をリッスンする [ポート番号] を入
力します。
デフォルト値は、選択したプロトコルに基づいて提供されます。
4. 電子メール サーバのユーザ名とパスワードを入力します。
5. [接続のテスト] ボタンをクリックして、接続パラメータが正しく入力されていることを確認します。
接続が失敗した場合は、テキスト ボックスの下に赤色のメッセージが表示されます。値を修正
して再試行してください。
6. メッセージの処理が行われる電子メールの [フォルダ名] (「受信」など) を入力します。
[フォルダ リストの取得...] をクリックして、電子メール サーバで利用可能な電子メール フォルダ
のリストを表示し、選択することもできます。
7. 経過アクティビティの場合、相関 ID を含む電子メール メッセージのヘッダー名を [相関ヘッ
ダー名] に入力できます。
相関 ID は、各プロセス インスタンスに関連付けられた一意の文字列であり、ワークフローを識
別してメッセージを一致させるのに使用されます。
注 記 : このフィールドの情報が、メッセージをワークフローに一致させるのに使用できない場
合、手順 15 で作成するマッピングを使用して応答を要求メッセージに一致させます。
8. メッセージの [優先 MIME タイプ] を選択するか、入力します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
193
事前定義のアクティビティ テンプレート
multipart/alternative メッセージの電子メール本文の一部および multipart/alternative 電
子メール本文について、MIME タイプを選択するか、入力します。
9. [ポスト プロセス オプション] リスト ボックスで、処理後のメッセージの管理オプションを選
択します。
このオプションは、選択した電子メール サーバのタイプによって異なります。
POP3 電子メール サーバの場合、有効なポスト プロセス オプションは、[電子メール
メッセージを削除] のみです。
IMAP サーバの場合、有効なオプションは、[既読として電子メール メッセージをマー
ク]、[電子メール メッセージを削除]、または [電子メール メッセージをアーカイブ
フォルダに移動] です。
10. 前述のフィールドで、メッセージをアーカイブ フォルダに移動することを選択した場合、アー
カイブ フォルダの名前を入力するか、[フォルダ リストの取得...]をクリックしてアーカイブ
フォルダを参照して選択します。
11. リスナが新しいメッセージをチェックするまでの経過時間を秒数で入力します。
12. 電子メール メッセージの処理に使用できる電子メール セッション数を入力します。
13. [次へ] をクリックすると、データ マッピング ツールが表示され、メッセージ データをプロセス
データにマップできます。
インバウンド電子メール アクティビティ テンプレートには、電子メール ヘッダーに固有の追加
ノードがあります。これにより、電子メール ヘッダーから値を取得するマッピングを作成できます。
表 14
インバウンド電子メール アクティビティの追加属性
属性名
電子メール ヘッダー名
Received-Date
Importance
キーワード
194
目的
アクション
システムが電子メール
メッセージを受信した日
付。
取得
X-Priority 、
Importance、Priority、
X-MSMail-Priority
メッセージの関連重要度
を示す、送信者により設
定されたステータス。有
効な値は、(1) High、(3)
Normal、および (5) Low
です。この値がマップさ
れない場合、システムは
デフォルト値 3 (Normal)
を使用します。
キーワード
電子メールの検索または
並べ替えを行う際に使用
できる単語またはフレー
ズ。
取得
取得
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
属性名
電子メール ヘッダー名
目的
Expiry-Date
Expiry-Date
電子メールが無効になる
期日。
Sensitivity
アクション
取得
Sensitivity
電子メールの特性を受信
者に通知し、指定された
受信者以外に内容を開
示できるかどうかの機密
度を示します。
取得
有効な値は、
Personal 、 Private 、
Company-Confidential
です。
値がこれらの属性にマップされない場合、値は受信メッセージから取得されません。
また、アクティビティ テンプレートにより、電子メール メッセージの Additional Headers ノードに
属性を追加することもできます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
14. [次へ] をクリックすると、データ マッピング ツールが表示され、相関セット属性をメッセージ
属性に一致させる規則を指定できます。
15. ページ上部のリストから、マップする [相関セット] を選択します。
16. 相関セットを使用して外部ソースからのメッセージをプロセス データに一致させる方法につい
ては、「メッセージ相関を理解する (144ページ) 」を参照してください。プロセスに使用する相
関セットの定義の詳細については、「相関セットを作成する (66ページ) 」を参照してください。
添付ファイル用のカスタム オブジェクト タイプを設
定する
デフォルトの dm_document を使用するのではなく、インバウンド電子メール アクティビティ テンプ
レートの添付ファイル用のカスタム オブジェクト タイプを設定できます。データ マッパで、プロセス
データの Attachments ノードの ObjectType 属性を、リポジトリに有効なタイプに設定します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
195
事前定義のアクティビティ テンプレート
FTP 受 信 - 初 期 化 お よ び 手 順
FTP アクティビティ テンプレートは、指定したベース フォルダに転送されるファイルおよびフォルダ
を監視します。たとえば、受信した購買発注書を処理するワークフローでこのアクティビティ テンプ
レートを使用すると、ベース フォルダに XML ファイルとして受信される購買発注書を監視できま
す。マッピングに基づいて、システムは、XML スキーマで設定した注文タイプに該当するすべて
のファイルについてプロセスを開始します。
このアクティビティ テンプレートで、FTP サーバ情報の設定、接続の確認、ポスト プロセス オ
プション (処理済みのファイルまたはフォルダの削除やアーカイブなど) の指定を行います。
XML スキーマを使用する場合、データ マッピング ツールを使用して、ファイルをデータまたは
XML ドキュメントとしてさらに処理できます。
FTP 受 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
1. 接続のための [プロトコル] を選択します。
サポートされている標準プロトコルは、[FTP]、[SFTP] (SSH FTP)、[FTPS] (FTP over SSL)、
および [ローカル ファイル] です。
注 記 : [ローカル ファイル] を選択した場合は、手順 5 にスキップしてください。
2. FTP サーバのホスト名または IP アドレスを入力します。
3. 接続に使用するポート番号を入力します。
• FTP および FTPS のデフォルトのポート番号は 21 です。
• SFTP のデフォルトのポート番号は 22 です。
4. サーバが認証を必要とする場合、接続先の FTP サーバについてユーザ名とパスワード
を入力します。
注 記 : ユーザには、手順 11 で設定する必須のポスト プロセス オプションを実行するための
十分な権限が必要です。
5. サーバが認証を必要とする場合、接続先の FTP サーバのユーザ名とパスワードを入力します。
6. [パブリック キー認証の使用] を行うには、チェックボックスをオンにします。
a. [プライベート キーのインポート] をクリックして [プライベート キーの選択] ダイアログ ボック
スを起動し、プライベート キー ファイルの場所に移動します。
b. プライベート キー ファイルを選択し、[OK] をクリックします。
システムがプライベート キー ファイルをアップロードし、コンテンツは Base64 に暗号
化され、サービス定義に書き込まれます。
c. パスフレーズを有効にしてプライベート キーが作成されていた場合、[プライベート キー
のパスフレーズ] を入力します。
7. [ベース フォルダ] フィールドに、監視対象の FTP サーバのフォルダへのパスを入力します。
8. [メッセージ タイプ] フィールドで、ファイルのダウンロードのオプションを選択します。
有効なオプションは次のとおりです。
• [圧縮ファイル]: システムがアーカイブ内の複数のファイルを監視できるようにします。
• [ディレクトリ]: システムがフォルダ内の複数のファイルを監視できるようにします。
• [ファイル]: システムがファイルを監視できるようにします。
196
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
9. [検証] ボタンをクリックして、接続パラメータおよびベース フォルダのパスが正しく入力され
ていることを確認します。
10. [含まれるファイル/ディレクトリ名パターン] フィールドに、監視に含めるファイル タイプおよび
ディレクトリ名の変数を入力します。
たとえば、XML ファイルを監視するには、「*.xml」と入力します。
11. [除外されるファイル/ディレクトリ名パターン] フィールドに、監視から除外するファイル タイプ
およびディレクトリ名の変数を入力します。
たとえば、sam で始まるファイルをすべて除外するには、「sam*」と入力します。
12. 経過アクティビティの場合のみ、ファイル名から相関 ID を決定するファイル名形式であ
る [相関パターン] を入力します。
たとえば、ファイル sam_956d77f734b6d7fb97771be.xml は、(ドル記号「$」をプレースホルダ値
として使用して) sam_$id$.xml と表すことができます。プレースホルダ値「$id$」は、相関 ID
956d77f734b6d7fb97771be を表しています。
プレースホルダ値は、スペースを含まない英数字である必要があります。プレースホルダ トー
クンは、ドル記号「$」の後から始まり、最初の英数字以外の文字で終わります。
注記: 要求および応答のメッセージを一致させるために [相関パターン] フィールドを使用でき
ない場合、相関 ID と手順 17 で定義するマッピングが使用されます。
13. 次の [ポスト プロセス オプション] のいずれかを選択して、ダウンロードおよび処理済みのファ
イルの管理を行います。
[アーカイブ] または [削除] により、ファイル、フォルダ、またはアーカイブのアーカイブ
や削除を行うことができます。
14. 手順 12 でメッセージをアーカイブ フォルダに移動することを選択した場合、[アーカイブ
フォルダ] の名前を入力します。
15. 利用可能な [FTP プロセッサの数] を入力します。
これは、エンドポイントでデータの監視を行う同時に実行可能なプロセッサの総数であり、FTP
サーバでサポートされる同時接続数に基づいて決定します。
注 記 : FTP プロセッサの数は、1 以上である必要があります。この数は 1 つのポーラが存在す
ることを想定しているため、3 つのプロセッサを設定する場合には、このフィールドに「3」と入力
します。FTP サーバを設定する際には、同時接続数の合計は 4 となります。
16. システムが受信ファイルをチェックする際の [ポーリング間隔] として使用する時間 (分)
を入力します。
たとえば、ポーリングの頻度を 45 に設定した場合、45 分ごとに FTP サーバへのポーリ
ングが行われてファイルをチェックします。
注 記 : 大きなファイルを処理する可能性がある場合は、ポーリング間隔を長めにすること
を推奨します。
17. [次へ] をクリックして、FTP ソース属性をプロセス データ属性にマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
197
事前定義のアクティビティ テンプレート
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
18. [次へ] をクリックすると、データ マッピング ツールが表示され、相関セット属性を FTP メッセー
ジ属性に一致させる規則を指定できます。
相関セットを使用して外部ソースからのメッセージをプロセス データに一致させる方法につい
ては、「メッセージ相関を理解する (144ページ) 」を参照してください。プロセスに使用する相
関セットの定義の詳細については、「相関セットを作成する (66ページ) 」を参照してください。
注 記 : メッセージには、相関セット属性をメッセージ属性にマップできるように構成化データを
含める必要があります。
19. ページ上部のリスト ボックスから、マップする [相関セット] を選択し、アクティビティのマッピ
ングを設定します。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
XML スキーマをメッセージ マッピングに追加する方法については、「XML スキーマをアクティ
ビティ コンテンツに追加する (132ページ) 」を参照してください。
FTP 送 信
FTP 送信アクティビティ テンプレートは、ファイルからメッセージを読み取るアクティビティに使用し
ます。このアクティビティ テンプレートは、財務諸表監査プロセスなどファイルベースのトランザ
クションに大きく依存するプロセスの場合に特に便利です。
FTP 送 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
1. メッセージのための [プロトコル] を選択します。
サポートされている標準プロトコルは、[FTP]、[SFTP] (FTP over SSH)、[FTPS] (FTP over SSL)、
および [ローカル ファイル] です。
注 記 : [ローカル ファイル] を選択した場合は、手順 5 にスキップしてください。
2. FTP サーバのホスト名または IP アドレスを入力します。
3. 接続に使用する [ポート] の番号を入力します。
• FTP および FTPS のデフォルトのポート番号は 21 です。
• SFTP のデフォルトのポート番号は 22 です。
4. サーバが認証を必要とする場合、接続先の FTP サーバについてユーザ名とパスワード
を入力します。
5. サーバが認証を必要とする場合、接続先の FTP サーバのユーザ名とパスワードを入力します。
6. [パブリック キー認証の使用] を行うには、チェックボックスをオンにします。
a. [プライベート キーのインポート] をクリックして [プライベート キーの選択] ダイアログ ボック
スを起動し、プライベート キー ファイルの場所に移動します。
b. プライベート キー ファイルを選択し、[OK] をクリックします。
システムがプライベート キー ファイルをアップロードし、コンテンツは Base64 に暗号
化され、サービス定義に書き込まれます。
c. パスフレーズを有効にしてプライベート キーが作成されていた場合、[プライベート キー
のパスフレーズ] を入力します。
198
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
7. ファイルのアップロード先であるマシンの [ベース フォルダ] へのパスを入力します。
8. [メッセージ タイプ] を選択します。
有効なオプションは次のとおりです。
• [ファイル]: システムがシンプル ファイルを送信できるようにします。
• [圧縮ファイル]: ファイルを Zip フォルダに配置します。このファイルは、データ マッ
パで設定したアーカイブ名に基づいて実行時に名前が付けられ、宛先ディレ
クトリに配置されます。
• [ディレクトリ]: 宛先ディレクトリに基づくサブフォルダにファイルを配置します。サ
ブフォルダ名は、データ マッパで設定したディレクトリ名に基づいて実行時に決
定されます。
9. [検証] ボタンをクリックして、接続パラメータが正しく入力されていることを確認します。
注 記 : 検証ボタンは、[ローカル ファイル] オプションでは使用できません。受信アクティビ
ティ テンプレートが配置されているマシンにベース フォルダが存在していることを手動で確
認する必要があります。
10. システムが同一の既存のファイル (または、手順 6 で [ディレクトリ] を選択した場合はサブフォ
ルダ) を上書きできるようにするには、[既存の場合は上書きする] を選択します。
空白のままにしておくと、ファイルにはファイル名 (またはサブフォルダ) に増分番
号を追加した一意の名前が付けられ、既存のファイル (またはサブフォルダ) は上
書きされません。
11. [次へ] をクリックして、プロセス データ属性を FTP 属性にマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
選択したファイル タイプに基づいて、次のマッピングを完成させる必要があります。
• ファイルをサブフォルダにアップロードすることを選択した場合、データ マッピング画面の右
側で、プロセス データをサブフォルダにマップする必要があります。
• ファイルを圧縮ファイルにアップロードすることを選択した場合、プロセスを [アーカイ
ブ] ノードにマップする必要があります。
• また、プロセス データから [添付ファイル] ノードへのマッピングが、少なくとも 1 つ存在する
必要があります。また、このマッピング内では、[コンテンツ名]、[コンテンツ タイプ]、および
[データ] 属性を設定しなければなりません。
注 記 : [コンテンツ タイプ] 属性のマッピングは、データを FTP サーバに転送する際のモー
ドを決定します。テキスト文字列にマップされている場合、ASCII テキストとして転送されま
す。他のファイルはすべて、バイナリ モードで転送されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
199
事前定義のアクティビティ テンプレート
FTP に よ る 読 み 込 み
このテンプレートに応じて、アクティビティは FTP サーバに接続し、プロセス データで指定されて
いる条件に従ってファイルまたはフォルダを返します。たとえば、入力 XML ファイルは FTP サー
バ上にありダウンロードが必要なイメージ ファイルを参照する場合があります。 このアクティビティ
テンプレートは、ファイルを取得してファイルをアクティビティに関連付けます。
注 記 : このアクティビティ テンプレートが FTP 受信と異なる点は、FTP 読み取りアクティビ
ティ テンプレートでは作業項目が作成されたときに検索基準を使用してファイルを取得す
ることです。FTP 受信は、検索基準が満たされた場合にトリガされます。
FTP 読 み 取 り ア ク テ ィ ビ テ ィ を 設 定 す る に は 、 次 の 手 順 に 従 い ま す 。
1. 接続のための [プロトコル] を選択します。
サポートされている標準プロトコルは、FTP、SFTP (SSH FTP)、FTPS (FTP over SSL)、および
ローカル ファイル システムです。
注 記 : [ローカル ファイル システム] を選択する場合は、手順 5 にスキップしてください。
2. FTP サーバのホスト名または IP アドレスを入力します。
3. 接続用のポート番号を入力します。
• FTP および FTPS のデフォルトのポート番号は 21 です。
• SFTP のデフォルトのポート番号は 22 です。
4. サーバが認証を必要とする場合、接続先の FTP サーバのユーザ名とパスワードを入力します。
5. [パブリック キー認証の使用] を行うには、チェックボックスをオンにします。
a. [プライベート キーのインポート] をクリックして [プライベート キーの選択] ダイアログ ボック
スを起動し、プライベート キー ファイルの場所に移動します。
b. プライベート キー ファイルを選択し、[OK] をクリックします。
システムがプライベート キー ファイルをアップロードし、コンテンツは Base64 に暗号化
され、サービス定義に書き込まれます。
c. パスフレーズを有効にしてプライベート キーが作成されていた場合、[プライベート キー
のパスフレーズ] を入力します。
6. [ベース フォルダ] フィールドに、読み取る FTP サーバのフォルダへのパスを入力します。
7. [メッセージ タイプ] フィールドで、ファイルのダウンロードのオプションを選択します。
有効なオプションは次のとおりです。
• [ファイル]: システムがファイルを取り出せるようにします。
• [圧縮ファイル]: システムがアーカイブ内の複数のファイルを取り出せるようにします。
• [ディレクトリ]: システムがフォルダ内の複数のファイルを取り出せるようにします。
8. [検証] ボタンをクリックして、接続パラメータおよび太字フォルダのパスが正しく入力され
ていることを確認します。
9. [次へ] をクリックし、FTP サーバから取得するパターン、正確なファイル、またはディレクト
リ名を指定します。
必要なマッピング
200
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
名前
Name は、FTP サーバが設定ページで指定した設定を使用し
て、この属性にマップされるファイルまたはフォルダを調べるよ
うにマップする必要があります。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
10. [次へ] をクリックし、ルールを指定するデータ マッピング ツールを使用して、ダウンロードし
たファイルからの属性をプロセス データに一致させます。
ファックス送信
注 記 : Captaris RightFax は、プロセス スイート バンドルには含まれていません。Captaris
から購入してライセンス.されている必要があります。Captaris RightFax サーバのインス
トール方法および設定方法については、RightFax のドキュメントを参照してください。
ファックス送信アクティビティ テンプレートを使用する前に、次の必須の手順を実行す
る必要があります。
1. RightFax のドキュメントを参照して RightFax Java API (RFJavaInt.zip) のパスを調
べます。
2. メソッド サーバ展開ディレクトリ内のパス bpm.ear\bpm.war\WEB-INF\lib に
RFJavaInt.zip をコピーします。
3. ファイル名を RFJavaInt.zip から RFJavaInt.jar に変更します。
4. メソッド サーバを再起動します。
一方向メッセージを Captaris RightFax ファクシミリ サーバに送信するには、ファックス送信 アクティ
ビティ テンプレートを使用します。これらのメッセージは、プロセスから送信されたファックス要求の
場合や、1 つまたは複数のファックス要求のステータスを要求するクエリの場合があります。クエリ
の結果は、アクティビティ実行者の受信ボックスに表示されます。
フ ァ ッ ク ス 送 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 使 用 し て Fax 要 求 を 送 信 す る に は
1. ファックス送信アクティビティ テンプレートを開きます。
2. RightFax サーバの URL を入力します。
以下に例を示します。
http://<FaxServer_IP>
3. RightFax サーバのユーザ名を入力します。
4. ドロップダウン リスト ボックスから、RightFax サーバに Fax 要求を送信するための [送信] オペ
レーションを選択します。
[送信] は、RightFax サーバに Fax 要求を送信します。[クエリ] は、一意の識別子に基づいて、
RightFax サーバに送信した Fax 要求のステータスを取得します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
201
事前定義のアクティビティ テンプレート
5. [RightFax サーバ URL のテスト] ボタンをクリックして、RightFax サーバがアクティビティ テンプ
レートからアクセス可能であることを確認します。
6. [次へ] をクリックして、プロセス データ属性をファックス要求属性にマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
7. データ マッパ画面でプロセス データを使用して、[Recipient Details (受信者の詳細)] の
マッピングを作成します。
a. [ID] を要求の一意の ID にマップします。
要求の ID を指定しない場合、RightFax サーバによって ID が生成されます。
b.
c.
d.
e.
[名前] を受信者の名前にマップします。
[会社] を受信者の会社名にマップします。
[Fax 番号] を宛先 Fax 番号にマップします。
[表紙名] を RightFax サーバ上にある表紙テンプレートの名前にマップします。
RightFax システムは、次の 2 種類の表紙をサポートしています。
• ファイル拡張子 .cov を使用する Production 表紙。この表紙は、複数の受信
者にファックスを送信する場合には使用できません。通常、表紙は C:\Program
Files\RightFax\Production\Covers にあります。
• 次のファイル拡張子を使用する Enterprise 表紙。
.pcl (プリンタ制御言語ドキュメント)
.doc (Microsoft Word ドキュメント)
.html (HTML ドキュメント)
.mht (メタ HTML ドキュメント)
これらの表紙は、C:\Program Files\RightFax\FCS に格納されます。
注記: ファクシミリの表紙は、特定の基準を使用して作成する必要があり、RightFax サーバ
上の指定された場所に保存されている必要があります。ファクシミリの表紙の作成方法およ
び保存方法については、RightFax のドキュメントを参照してください。
8. データ マッパ画面でプロセス データを使用して、[Cover Page Notes (カバー ページのメ
モ)] のマッピングを作成します。
a. [タイプ] をプレーン テキストまたは HTML の表紙形式にマップします。
b. [テキスト] を表紙のメッセージの内容にマップします。
注 記 : RightFax サーバのワードラップ長を超えたテキスト ファイルは、システムで切り詰
められます。RightFax サーバ レジストリのワードラップ長を手動で設定する方法の詳細
については、RightFax のドキュメントを確認してください。
9. データ マッパ画面でプロセス データを使用して、[Attachments (添付ファイル)] のマッピ
ングを作成します。
a. [コンテンツ タイプ] を添付ファイルのコンテンツ タイプにマップします。
202
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
サポートされるコンテンツ タイプについては、RightFax のドキュメントを参照し
てください。
b. [データ] を Fax メッセージの実際の内容にマップします。
注 記: アクティビティ テンプレートを使用して大きい添付ファイルを送信する場合、[実行
者] タブで [メソッドのタイムアウト時間] フィールドの値の調整が必要になることがあります。
10. [次へ] をクリックして、送信要求に関連付けられたプロセス データに RightFax サーバの応答
をマップし、次の属性のマッピングを作成します。
a. [ID] を、プロセスで送信した Fax 要求の一意の ID にマップします。
b. [コード] を要求のステータス コードにマップします。
c. [メッセージ] を、ステータス コードに関連付けられたステータス メッセージにマップします。
ファックス送信を使用してクエリ要求を送信する
フ ァ ッ ク ス 送 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 使 用 し て ク エ リ 要 求 を RightFax サ ー バ に
送信するには
1. RightFax サーバの URL を入力します。
2. RightFax サーバのユーザ名を入力します。
3. ドロップダウン リスト ボックスから、[クエリ] オペレーションを選択して、一意の識別子に基づい
て、RightFax サーバに送信した Fax 要求のステータスを取得します。
4. [RightFax サーバ URL のテスト] ボタンをクリックして、RightFax サーバがアクティビティ テンプ
レートからアクセス可能であることを確認します。
5. [次へ] をクリックして、プロセス データ属性を Fax 要求属性にマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
6. 次の変数を使用して、RightFax サーバの応答をクエリにマップします。
a. [ID] は、プロセスで送信した Fax 要求の一意の ID です。
b. [コード] は、要求のステータス コードです。
c. [メッセージ] は、ステータス コードに関連付けられたステータス メッセージです。
一般的なメッセージには次のものがあります。
• 電話回線の問題
• スケジュールされた送信
• Fax 本文または表紙の変換の問題
メッセージの一覧については、RightFax のドキュメントを参照してください。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
203
事前定義のアクティビティ テンプレート
HTTP 受 信 - 初 期 化 お よ び 手 順
外部のクライアントによって送信された HTTP メッセージを受信および処理するには、HTTP 受信
アクティビティ テンプレートを使用します。HTTP リスナを設定して特定の URL をリッスンした
後、入力メッセージを読み取って処理します。入力メッセージは、データ マッパを使用してプ
ロセス データにマップできます。
その後、システムは、アクティビティ テンプレートで指定した応答タイプを使用して、クライアント
に同期応答を返します。
注 記 : マルチバイト文字が使用されている場合、HTTP 受信リスナに要求を送信するとき
は、ブラウザのエンコードが UTF-8 に設定されている必要があります。
HTTP 受 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
1. URL 要求が送信される [URL 接尾辞] を入力します。
た と え ば 、 ク ラ イ ア ン ト か ら 送 信 さ れ る HTTP 要 求 URL が
http://eng076:8001/bps/http/ReceivePO である場合、接尾辞は ReceivePO
です。
2. 受信アクティビティ テンプレートが認証を必要とする場合、[認証] を選択してユーザ名
とパスワードを求めます。
3. 受信アクティビティへのアクセスに必要なユーザ名とパスワードを入力します。
これは、アクティビティにアクセスするためにブラウザの認証ダイアログ ボックスにユー
ザが入力する値です。この要求は、HTTP 要求のユーザ名およびパスワードと共に
再び送信されます。認証が選択されていて、ユーザ名とパスワードの URL パラメー
タが送信されない場合、受信アクティビティ テンプレートはアクティビティへのア
クセスを許可しません。
4. 受信する要求のタイプを指定する [リクエスト タイプ] を選択します。
有効な値は、[GET]、[POST]、および [PUT] です。
• 要求に添付ファイルがない場合、GET メッセージを選択します。
• POST メッセージおよび PUT メッセージには添付ファイルを含めることができます。添付ファ
イルのある要求と添付ファイルのない要求が混在している場合、要求タイプとして [POST] を
選択すれば、GET 要求も送信できます。
注記: GET メソッドを使用する場合、要求情報を指定するためのフィールドは使用できません。
5. アクティビティ テンプレートが経過アクティビティである場合、[相関プロパティ名] を入力します。
HTTP 要求のこのプロパティ名は、ワークフローの識別に使用されます。この属性は、データ
マッパで、[本文] ノードの URL パラメータ ノードに表示されます。この値は、プロセス データ
の名前の値のいずれかに一致する必要があります。
注 記 : 要求を応答メッセージに一致させるために、システムは相関プロパティ名を最初に使用
します。マップされた相関セット値があっても、それらの値が使用されるのは相関プロパティ名
へのマッピングが失敗した場合のみです。
6. 要求メッセージに添付ファイルを含めるには、[添付ファイル付き] を選択します。添付ファイル
は、要求タイプが POST および PUT の場合のみ使用できます。
7. XML の検証を強制的に行うには、[XML ドキュメントの検証] を選択します。
8. 応答メッセージのテキスト テンプレートを作成するには、[テンプレート応答] を選択します。
204
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
9. [応答テンプレート] を使用する場合、テキスト ボックスに応答の本文を入力します。
静的テキスト、HTML、プロセス データにマッピング可能なプレースホルダ値を含めるこ
とができます。
• プレースホルダの前には、ドル記号「$」(たとえば: ${tokenname})が付きます。
• 複数値のプレースホルダを作成するには、2 つのドル記号「$$」を使用します。
• 電子メール本文でリテラルのドル記号を使用するには、「\$」を使用します (たとえば、500 ド
ルは「\$500.00」と表されます)。
注 記: プレースホルダ値は、スペースを含まない英数字である必要があります。プレースホ
ルダ トークンは、ドル記号「$」の後から始まり、最初の英数字以外の文字で終わります。
たとえば、購買発注書が正常に処理されたことを示すメッセージを送信するために、「購買発
注書 $orderno は正常に処理されました」というテンプレート テキストを使用するとします。プ
レースホルダ "orderno" がデータ マッピング画面に表示され、パッケージまたはプロセス変数
にマップすることができます。送信される応答は、「購買発注書 0896523 は正常に処理され
ました」というメッセージを含む HTML ページとなります。ここで、"0896523" は応答データ
マッピングにより置き換えられた値です。
注 記 : プレースホルダ値はすべて、プロセス データにマップする必要があります。
10. [次へ] をクリックして、入力した要求メッセージをプロセス データにマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
• マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加する方法
については、「メッセージ プロパティを追加する (132ページ) 」を参照してください。
選択したプロトコルのタイプに応じて、次のマッピングを完成させます。
• GET メソッドを使用するメッセージには添付ファイルがないため、ヘッダーおよび URL パラ
メータの属性のみがマッピング ツールに表示されます。
• POST メソッドを使用するメッセージには、前の画面で添付ファイルを使用できるように設定
した場合、ヘッダー、本文属性、および添付ファイルのマッピング属性が表示されます。
• PUT メソッドを使用するメッセージには、前の画面で添付ファイルを使用できるように設定し
た場合、本文の添付ファイルおよびヘッダーのマッピング属性が表示されます。
11. [次へ] をクリックして、プロセス データを応答メッセージにマップします。
データ マッパを使用して、プロセス データをステータス、ヘッダー、および本文の属性
に関連付けます。プレースホルダ値がデータ マッパに表示され、値をマップしてクラ
イアントへの応答として送信できます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
205
事前定義のアクティビティ テンプレート
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
12. [次へ] をクリックし、データ マッパを使用して、要求メッセージ属性を次の手順で選択する相
関セットに関連付けます。
13. ページ上部のリスト ボックスから、マップする [相関セット] を選択し、アクティビティのマッピ
ングを設定します。
相関セットを使用して外部ソースからのメッセージをプロセス データに一致させる方
法については、「メッセージ相関を理解する (144ページ) 」を参照してください。プ
ロセスに使用する相関セットの定義の詳細については、「相関セットを作成する (66
ページ) 」を参照してください。
HTTP 送 信
HTTP 送信アクティビティ テンプレートは、特定の URL に HTTP 要求を送信し、サーバからの応
答を受信できます。このアクティビティ テンプレートの各フィールドを使用して、プロセス データ モ
デルにマッピングされるデータを指定できます。
HTTP 送 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
1. アクティビティがコンテンツを投稿するサイトの完全な URL (http:// というプロトコル接頭辞
で始まる) を入力します。
2. サーバが認証を必要とする場合、[認証] を選択してユーザ名とパスワードを求めます。
注 記 : HTTP 送信アクティビティ テンプレートでサポートされるのは、基本認証のみです。
3. 認証を必要とする場合、[ユーザ名] と [パスワード] を入力します。
4. サーバに送信する要求のタイプを指定する [リクエスト メソッド] を選択します。
有効な値は、[GET]、[POST]、および [PUT] です。
注記: GET メソッドを使用する場合、要求情報を指定するためのフィールドは使用できません。
5. [接続のテスト] ボタンをクリックして、接続パラメータが正しく入力されていることを確認します。
接続が失敗した場合は、テキスト ボックスの下に赤色のメッセージが表示されます。値を修正
して再試行してください。
6. [接続タイムアウト (分)] フィールドに、システムがアイドル接続を終了するまでに許容される
時間 (分) を入力します。
7. 要求メッセージに添付ファイルを含めるには、[添付ファイルを許可] を選択します。
添付ファイルは、要求タイプが POST および PUT の場合のみ使用できます。
8. [次へ] をクリックして、プロセス データを要求メッセージにマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
206
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
• マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加する方法
については、「メッセージ プロパティを追加する (132ページ) 」を参照してください。
GET メソッドを使用するメッセージには添付ファイルがないため、ヘッダーおよび URL
パラメータの属性のみがマッピング ツールに表示されます。
POST メソッドを使用するメッセージには、前の画面で添付ファイルを使用できるよう
に設定した場合、ヘッダー、本文属性、または添付ファイルのマッピング属性が表
示されます。
PUT メソッドを使用するメッセージには、前の画面で添付ファイルを使用できるように設
定した場合、本文の添付ファイルおよびヘッダーのマッピング属性が表示されます。
9. [次へ] をクリックして、応答メッセージをプロセス データにマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
• XML スキーマをメッセージ マッピングに追加する方法については、「XML スキーマ
をアクティビティ コンテンツに追加する (132ページ) 」を参照してください。
• マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加する方法
については、「メッセージ プロパティを追加する (132ページ) 」を参照してください。
JMS 受 信 - 初 期 化 お よ び 手 順
JMS 受信アクティビティ テンプレートは、キューまたはトピックに送信される JMS メッセージを受
信および処理する際に使用します。たとえば、クレーム処理のワークフローでは、JMS 初期化
アクティビティを設定してクレームのキューをリッスンできます。メッセージがキューに到達する
と、アクティビティはワークフローを開始します。その後、システムは、指定した宛先にメッセー
ジのデータを送信します。
このアクティビティ テンプレートで接続や処理のオプションを指定し、データ マッピング ツール
を使用して JMS ヘッダーや他のプロパティなどのメッセージ パラメータをプロセス データに
マップします。
JMS 受 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
1. メッセージング サーバの初期コンテキストを設定します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
207
事前定義のアクティビティ テンプレート
a. システムがメッセージング サーバの JNDI (Java Naming and Directory Interface) コンテキス
トにアクセスする際に使用する初期 [ContextFactory] を選択します。Process Builder では、
WebSphere、TIBCO、および WebLogic の ContextFactory を使用できます。
b. メッセージ サーバの [プロバイダ URL] を入力します。
c. メッセージ サーバのユーザ名とパスワードを入力します。
d. 設定された JMS サーバからのメッセージへのアクセスに必要になる可能性がある [追
加のプロパティ] を入力します。
実行時、これらの属性は InitialContextFactory によって使用され、InitialContext を
構成します。
2. キュー/トピックへの接続について設定します。
a. [キュー] または [トピック] のどちらかの接続オプションを選択します。
b. キューまたはトピックへのアクセスに使用する [接続ファクトリ] の名前を入力します。
c. メッセージの監視に必要なキューまたはトピックの名前を入力します。
d. 必要に応じて、トピックまたはキューにアクセスする際に使用するユーザ名とパスワードを
入力します。
e. オプションの [メッセージ セレクタ] クエリを入力し、JMS メッセージで送信された特定の
プロパティの値に基づいて受信リスナによって読み取られるメッセージをフィルタリン
グする際に使用します。
たとえば、メッセージで使用する特定のベンダ ID についてフィルタを設定すると、このアク
ティビティ テンプレートでは、そのベンダ ID を持つメッセージのみが処理されます。
f. [メッセージ タイプ] を選択します。
有効な値は、[Message]、[MapMessage]、[TextMessage]、[BytesMessage]、[ObjectMessage]、
および [StreamMessage] です。
g. [接続のテスト] ボタンをクリックして、接続パラメータが正しく入力されていることを確
認します。
接続が失敗した場合は、テキスト ボックスの下に赤色のメッセージが表示されます。値を
修正して再試行してください。
3. 実行時にシステムで任意の XML スキーマの有効性がチェックされるようにするには、[スキー
マの検証] を選択します。
4. JMS メッセージの処理に使用する [スレッド数] を入力します。
注 記 : トピック接続の場合、デフォルトのスレッド数は常に 1 に設定されます。
5. [次へ] をクリックすると、データ マッピング ツールが表示され、メッセージ データを入力メッ
セージのプロセス データにマップできます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
208
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
• XML スキーマをメッセージ マッピングに追加する方法については、「XML スキーマ
をアクティビティ コンテンツに追加する (132ページ) 」を参照してください。
• マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加する方法
については、「メッセージ プロパティを追加する (132ページ) 」を参照してください。
6. [次へ] をクリックすると、データ マッピング ツールが表示され、メッセージ データを相関
セットにマップできます。
7. ページ上部のリスト ボックスから、マップする [相関セット] を選択し、アクティビティのマッピ
ングを設定します。
8. 場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• XML スキーマをメッセージ マッピングに追加する方法については、「XML スキーマ
をアクティビティ コンテンツに追加する (132ページ) 」を参照してください。
• マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加する方法
については、「メッセージ プロパティを追加する (132ページ) 」を参照してください。
• 相関セットを使用して外部ソースからのメッセージをプロセス データに一致させる方
法については、「メッセージ相関を理解する (144ページ) 」を参照してください。
プロセスに使用する相関セットの定義の詳細については、「相関セットを作成す
る (66ページ) 」を参照してください。
JMS 送 信
JMS 送信アクティビティ テンプレートを使用すると、Process Builder で、外部のアプリケーション
にメッセージを送信して、そのアプリケーションからの応答を受信できます。このテンプレート
は、XML メッセージ、バイナリ メッセージ、およびその他の構造形式のメッセージ (.CSV ファイ
ルなど) を送信できます。
JMS 送 信 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
1. メッセージング サーバの初期コンテキストを設定します。
a. システムがメッセージング サーバの JNDI (Java Naming and Directory Interface) コンテキス
トにアクセスする際に使用する初期 [ContextFactory] を選択します。Process Builder では、
WebSphere、TIBCO、および WebLogic の ContextFactory を使用できます。
b. メッセージ サーバの [プロバイダ URL] を入力します。
c. メッセージ サーバのユーザ名とパスワードを入力します。
d. 設定された JMS サーバからのメッセージへのアクセスに必要になる可能性がある [追
加のプロパティ] を入力します。
実行時、これらの属性は InitialContextFactory によって使用され、InitialContext を
構成します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
209
事前定義のアクティビティ テンプレート
2. キュー/トピックへの接続について設定します。
a. [キュー] または [トピック] のどちらかの接続オプションを選択します。
b. キューまたはトピックへのアクセスに使用する [接続ファクトリ] の名前を入力します。
c. メッセージの監視に必要なキューまたはトピックの名前を入力します。
d. 必要に応じて、トピックまたはキューにアクセスする際に使用するユーザ名とパスワードを
入力します。
e. [メッセージ タイプ] を選択します。
有効な値は、[Message]、[MapMessage]、[TextMessage]、[BytesMessage]、[ObjectMessage]、
および [StreamMessage] です。
3. [接続のテスト] ボタンをクリックして、接続パラメータが正しく入力されていることを確認します。
接続が失敗した場合は、テキスト ボックスの下に赤色のメッセージが表示されま
す。値を修正して再試行してください。
4. [次へ] をクリックすると、データ マッピング ツールが表示され、プロセス データを入力メッセー
ジのメッセージ データにマップできます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
• マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加する方法
については、「メッセージ プロパティを追加する (132ページ) 」を参照してください。
5. [次へ] をクリックして、メッセージ応答属性を出力メッセージのプロセス データにマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
プロセス データ マッピング
このテンプレートに基づくアクティビティは、ビジネス プロセスの 1 つのパッケージのデータを別の
パッケージにコピーするか、1 つのパッケージ属性のデータを別のパッケージ属性にコピーしま
す。また、あるパッケージのコンテンツを別のパッケージにコピーすることもできます。
プロセス データ マッピング アクティビティを設定するには
1. [アクティビティ インスペクタ] の [プロセス データ マッピング] タブをクリックします。
左右両方の列に、プロセス パッケージのリストと共にデータ マッピング ツールが表示さ
れます。左列には、ワークフローの代替変数も表示されます。
2. データ マッピング ツールを使用して、パッケージまたは実行データの値を他のパッケージまた
はパッケージ属性に転送するか、あるいは左側の列にあるパッケージのコンテンツを右側の列
にあるパッケージにコピーします。また、繰り返し属性をマップすることもできます。
210
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
コンテンツが関連付けられているパッケージ オブジェクトには、コンテンツ ノードの下に次
の属性が表示されます。
• content-type: コンテンツの MIME タイプを指定します。
• format: コンテンツに関連付けられているフォーマット オブジェクト (dm_format) の名前を
指定します。
• data: 実際のコンテンツを指定します。
コンテンツをパッケージにコピーするには、次の目的のためのマッピング規則を作成す
る必要があります。
• ソース ノードのデータをパッケージのデータ ノードにコピーします。
• フォーマットまたはデータ ノードの値を設定します。これは、定数値を指定するか、また
はソース ノードから値をマップすることによって行います。
フォーマットまたはデータ ノードの値が指定されていない場合は、次の検証エラーが
表示されます。
パッケージのマッピング規則にコンテンツ タイプやフォーマットが見つかりませんでした:
<ターゲット パッケージ>
パッケージ コンテンツをコピーするために、利用可能な正規の関数を使用できます。また、文
字列型のデータ タイプへのコンテンツの変換をサポートする「文字列からバイトに」関数や「バ
イトから文字列に」関数を使用することもできます。これらの関数の詳細については、「データ
マッピング関数を使用する (139ページ) 」を参照してください。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
3. [OK] または [適用] をクリックして、構成設定を保存します。
実行時にデスティネーション パッケージが存在する場合は、パッケージのコンテンツ
およびフォーマットがソース パッケージのコンテンツおよびフォーマットに置き換えられ
ます。デスティネーション パッケージが存在しない場合は、新しいパッケージが作成さ
れます。コンテンツ タイプを含むソース パッケージのコンテンツが、新しいパッケージ
にコピーされます。ただし、ソース パッケージにフォーマット マッピングまたはコンテン
ツ タイプがない場合、デスティネーション パッケージのフォーマット属性の値は crtext
に設定され、コンテンツ タイプは text/plain として設定されます。
SMTP ア ク テ ィ ビ テ ィ テ ン プ レ ー ト
ユーザのリストに電子メール メッセージおよび添付ファイルを送信するには、SMTP アクティビティ
テンプレートを使用します。たとえば、アクティビティ テンプレートを追加することにより、顧客ク
レームに対する応答として電子メール メッセージを送信したり、承認用に電子メール メッセー
ジの本文で清算書を送信したりできます。
SMTP ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は
1. SMTP サーバ ホスト マシンの名前か、その IP アドレスを入力します。
2. SMTP サーバの [ポート番号] を識別するパラメータを入力します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
211
事前定義のアクティビティ テンプレート
値を設定しなかった場合、アクティビティは標準の SMTP ポート 25 を使用します。
3. サーバが認証用のユーザ名とパスワードを必要とする場合、[認証は必須です] を選択します。
4. サーバが認証を必要とする場合、ユーザ名とパスワードを入力します。
5. [接続のテスト] ボタンをクリックして、接続パラメータが正しく入力されていることを確認します。
接続が失敗した場合は、テキスト ボックスの下に赤色のメッセージが表示されます。値を修正
して再試行してください。
6. 電子メールの件名テンプレートを [件名テンプレート] フィールドに入力します。
件名テンプレートには、静的テキストだけでなく、プロセス データにマッピング可能なプレース
ホルダ値も含まれます。
プレースホルダ値は、スペースを含まない英数字である必要があります。プレースホル
ダ トークンは、ドル記号「$」の後から始まり、最初の英数字以外の文字で終わります。
また、プレースホルダ値はすべて、プロセス データにマップする必要があります。
• プレースホルダの前には、ドル記号「$」(たとえば: ${tokenname})が付きます。
• 複数値のプレースホルダを作成するには、2 つのドル記号「$$」を使用します。
• 電子メール本文でリテラルのドル記号を使用するには、「\$」を使用します (たとえば、500 ド
ルは「\$500.00」と表されます)。
注記: 電子メールの件名または本文でアポストロフィまたは単一引用符を使用するには、エ
スケープ文字として単一引用符を追加する必要があります。たとえば、テキストに「EMC’s
product」を含めるには、 「EMC”s product」と入力する必要があります。
7. 電子メール テンプレートのテキストを [本文テンプレート] テキスト ボックスに入力します。
静的テキスト、サード パーティの HTML エディタからコピーされた HTML、プロセス データに
マッピングされるプレースホルダ値を含めることができます。
電子メール本文に HTML マークアップを使用する場合は、電子メール メッセージの [本
文] ノードの [コンテンツ タイプ] に、定数値「text/html」をマップする必要があります。[コン
テンツ タイプ] が特定の値にマップされていない場合、コンテンツ タイプはデフォルトで
text/plain が使用されます。
プレースホルダ値は、スペースを含まない英数字である必要があります。プレースホルダ トー
クンは、ドル記号「$」の後から始まり、最初の英数字以外の文字で終わります。また、プレース
ホルダ値はすべて、プロセス データにマップする必要があります。
• プレースホルダの前には、ドル記号「$」(たとえば: ${tokenname})が付きます。
• 複数値のプレースホルダを作成するには、2 つのドル記号「$$」を使用します。
• 電子メール本文でリテラルのドル記号を使用するには、「\$」を使用します (たとえば、500 ド
ルは「\$500.00」と表されます)。
注記: 電子メールの件名または本文でアポストロフィまたは単一引用符を使用するには、エ
スケープ文字として単一引用符を追加する必要があります。たとえば、テキストに「EMC’s
product」を含めるには、 「EMC”s product」と入力する必要があります。
8. [次へ] をクリックして、プロセス データを電子メール メッセージに関連付ける入力メッセージ
マッピングを作成します。
右側のペインに電子メール メッセージ構造、左側のペインにプロセス データが表示されま
す。電子メール メッセージ属性をプロセス データ モデルの属性からマップすることにより、そ
212
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
の値を設定できます。電子メールの添付ファイルが複数ある場合、[添付ファイル] ノードの
[追加] をクリックしてさらに添付ファイルを追加できます。
SMTP アクティビティ テンプレートには、電子メール ヘッダーに固有の追加属性があります。こ
れを使用して、電子メール ヘッダーの次の値を設定するマッピングを作成できます。
表 15
SMTP ア ク テ ィ ビ テ ィ の 追 加 属 性
属性名
電子メール ヘッダー名
目的
Importance
X-Priority 、
Importance、Priority、
X-MSMail-Priority
メッセージの関連重要
度を示す、送信者によ
り設定されたヒント。有
効な値は、(1) High、(3)
Normal、および (5) Low
です。
キーワード
電子メールの検索または
並べ替えを行う際に使用
できる単語またはフレー
ズ。
キーワード
Expiry-Date
Sensitivity
Expiry-Date
電子メールが無効になる
日付。
アクション
設定
設定
設定
Sensitivity
電子メールの特性を受信
者に通知し、指定された
受信者以外に内容を開
示できるかどうかの機密
度を示します。
設定
有効な値は、
Personal 、 Private 、
Company-Confidential
です。
また、アクティビティ テンプレートにより、電子メール メッセージの Additional Headers ノードに
属性を追加することもできます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
注 記 : 少なくとも 1 つの受信者ノード (宛先、Bcc、または Cc) をプロセス データまたは定数
値からマップする必要があります。また、[件名] ノードおよび [本文] ノードのプレースホル
ダ ノードはすべて、この時点でマップする必要があります。
9. [次へ] をクリックして出力メッセージをマップします。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
213
事前定義のアクティビティ テンプレート
たとえば、プロセス変数 emailMsgId を追加した場合、ソース メッセージの電子メール メッセー
ジ ID 属性をそのプロセス変数にマップできます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
• XML スキーマをメッセージ マッピングに追加する方法については、「XML スキーマ
をアクティビティ コンテンツに追加する (132ページ) 」を参照してください。
• マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加する方法
については、「メッセージ プロパティを追加する (132ページ) 」を参照してください。
WS 受 信 - 初 期 化 お よ び 手 順
このアクティビティ テンプレートは、Documentum Process Builder バージョン 6.5 以上のリ
リースでのみサポートされます。これより前のバージョンの Process Builder を Documentum
6.5 のリポジトリに対して使用すると、このテンプレートは開きません。
注 記 : URL で WSDL にアクセスするには、Web サービス受信リスナを作成する必要があ
ります。 WSDL にアクセスするための有効な URL フォーマットを以下に示します。
http://<hostname>:<port>/bps/webservice/<processID>?WSDL
http://<hostname>:<port>/bps/webservice/<processName>?WSDL
http://<hostname>:<port>/bps/webservice/<processName>/<version>?WSDL
外部システムに統合ポイントおよび WSDL を提供する必要のあるアクティビティ用に新しい Web
サービス エンドポイントを作成するには、Web サービス受信を使用します。
たとえば、ローン申込プロセスで Web サービス受信アクティビティ テンプレートを使用して、入力さ
れた申込の受信後にプロセスを開始できます。WS セキュリティを使用してアクティビティを設定す
ることにより、申込者にユーザ名とパスワードの入力を要求して Web サービスをセキュリティ保護す
ることが可能です。ローン申込に大きいドキュメントが含まれている場合、アクティビティの MTOM
サポートを有効化して、最適化されたバイナリ データを添付ファイルとして送受信できます。
プロセスの手順として、Web サービス受信経過アクティビティを使用して、外部ソースから情報を
受信できます。また、このアクティビティにより、収入の確認や、外部ソースからのその他の関
連情報の取得も可能です。権限のあるユーザのみがプロセスを開始できるようにセキュリティ
を有効化できます。
各ワークフローに対して生成される一意な ID である相関識別子を使用して、メッセージの相関
を有効にすることができます。次の例のように、この相関 ID を WS アドレス指定規格で定義さ
れたフォーマットで SOAP ヘッダに追加する必要があります。
<SOAPENV:header>
<wsa:RelatesTo xmlns:wsa={WS-AddressingSchema}>{correlationid}
<wsa:/RelatesTo>
</SOAPENV:header>
214
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
Web サービスの定義には、次の 2 つの方法があります。
• [プロセス ファースト] オプションでは、ポートとオペレーションを定義し、プロセス定義から
WSDL が作成されます。1 つのプロセスに対し 1 つの WSDL が、プロセスに含まれている各
Web サービス受信アクティビティのセクションに作成されます。
注 記 : アクティビティ インスペクタでアクティビティに関連するプロセス変数がアクティビ
ティに表示されるように選択されている場合、作成される WSDL には、アクティビティに
関連するこれらのプロセス変数しか含めることができません。アクティビティにプロセ
ス変数を可視的にする方法については、「アクティビティ内のプロセス データを変更
する (125ページ) 」を参照してください。
• [WSDL ファースト] オプションでは、プロセスで使用するシステムの既存の WSDL を指定します。
Web サービス受信アクティビティをプロセスに追加する前に、[プロセスのプロパティ] ダイ
アログ ボックスの [高度] タブでターゲット名前空間 URI を設定してください。ターゲット名
前空間がない場合、システムでプロセスの検証や保存ができません。
XML スキーマをインポートして作成された構造化データ タイプは、ターゲット名前空間が定義さ
れていない場合があります。このような構造化データ タイプをプロセス ファースト モデルで使
用するには、次のいずれかを実行します。
• 構造化データ タイプが使用中である場合は、別の名前で新しい構造化データ タイプを作成し、
構造化データ タイプの作成に使用したスキーマでターゲット名前空間を定義します。
• 構造化データ タイプが使用中でない場合は、スキーマを編集してターゲット名前空間を
定義し、データ タイプを作成し直します。
Web サービス受信を設定するには
1. [アクティビティ インスペクタ] で [Web サービス受信] タブをクリックします。
2. [プロセス ファースト] オプションを選択した場合、プロセスがアクティビティ テンプレートに記述
され、読み込まれた後に、プロセス定義から WSDL が作成されます。
a. ポート タイプを入力します。
b. クライアントで使用されるオペレーションの名前を入力します。
c. 相関セットに基づいてシステムがメッセージを相関させるには、[コンテンツ ベースの相
関] を選択します。
d. [相関セット] リストで、相関セット名を選択します。
注 記 : プロセス ファースト モデルでは、暗黙的にマッピングが行われるため、データと相
関セットをマップする必要はありません。
3. 既存の WSDL を使用して Web サービスを定義する場合は、[WSDL ファースト] を選択します。
a. アクティビティに使用する WSDL の [WSDL File URL/Path (WSDL ファイル URL/パス)] を
入力します。
b. [読み取り] をクリックして、指定した場所から WSDL を取得します。
c. リストからポート タイプを選択します。
d. クライアントで使用されるオペレーションの名前を選択します。
4. [WS セキュリティのユーザ名トークン] 認証を有効にするには、チェックボックスをオンに
してユーザ名とパスワードを入力します。
WS セキュリティ ハンドラにより、アクティビティやプロセス (初期化アクティビティで使用
する場合) への認証情報ベースのアクセスが可能となります。有効化すると、アクティビ
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
215
事前定義のアクティビティ テンプレート
ティやプロセスへのアクセスを許可するために、このアクティビティに対するすべてのク
ライアント要求について、(ユーザ トークンの WS セキュリティ スキーマで定義される構
造の) 要求ヘッダーに同一の認証情報を含める必要があります。
5. 応答の送信時にシステムが添付ファイルを最適化できるようにするには、[MTOM] を選
択します。
注 記 : MTOM は [プロセス ファースト] オプションでは使用できません。
6. [次へ] をクリックして、プロセス データをメッセージに関連付ける入力メッセージ マッピ
ングを作成します。
左側のペインに SOAP メッセージ構造、右側のペインにプロセス データが表示されます。プロセ
ス データ モデルの属性の値は、SOAP メッセージ属性からマップすることにより設定できます。
必要なマッピング
添付ファイルには次のマッピングが必要です。
• ドキュメント コンテンツ
• ファイル フォーマット
添付ファイルが複数ある場合、[添付ファイル] ノードの [追加] をクリックしてさらに
添付ファイルを追加できます。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
7. [次へ] をクリックして出力メッセージをマップします。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を
追加する必要が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• XML スキーマをメッセージ マッピングに追加する方法については、「XML スキーマ
をアクティビティ コンテンツに追加する (132ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• マッピングを完成させるために、サービスに固有のプロパティをメッセージに追加する方法
については、「メッセージ プロパティを追加する (132ページ) 」を参照してください。
• 相関セットを使用して外部ソースからのメッセージをプロセス データに一致させる
方法については、「相関セットを使用する (145ページ) 」を参照してください。プ
ロセスに使用する相関セットの定義の詳細については、「相関セットを作成す
る (66ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
216
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
Web サ ー ビ ス
このアクティビティ テンプレートを使用すると、ドキュメントリテラル形式の Web サービスを呼び
出すことができます。Web サービス アクティビティは、2 つの主要な点で他の統合アクティビ
ティとは異なります。
• Web サービスに送信するコンテンツは、それ自体で名前空間となる整形式の XML ファイ
ルでなくてはなりません。
• Web サービスは、自分宛てに送信されたメッセージに応答するので、アクティビティが応
答を処理できるようにする必要があります。
Web サービスを呼び出すには、サービスへのアクセスに必要な情報を提供する Web Services
Description Language (WSDL) ドキュメントが必要です。Web サービス アクティビティのカスタム
パラメータは、WSDL ドキュメントと XML コンテンツを識別してサービスに送信します。また、
Web サービスからの応答の処理方法についても指定します。
• [WSDL ドキュメント] この必須パラメータは、Web サービスの WSDL コンテンツを格納したファイ
ルを指します。このファイルは、リポジトリに保存されている整形式の WSDL ドキュメントでなくて
はなりません。テキスト ボックスの横のボタンをクリックすると、このファイルに移動できます。
• [サービス名] — 多くの場合、WSDL ドキュメントには、呼び出すアクティビティの Web サービス
の名前が含まれています。Web サービスの名前が含まれていない場合、または WSDL ドキュ
メントに複数のサービス定義が含まれている場合は、この代替用のオプション パラメータに
Web サービス名を入力する必要があります。
• [操作名] — この必須パラメータには、呼び出す Web サービス操作の名前を指定します。
• [ポート名] — WSDL ドキュメントに目的のサービスのポート名が示されていない場合や、複数の
ポート名がある場合には、そのポート名を入力する必要があります。
• [アクティビティ パッケージのコンテンツを送信] — このオプション パラメータでは、アクティビ
ティが Web サービスに渡すコンテンツを識別します。コンテンツは、それ自体で名前空間とな
る整形式の XML ファイルでなくてはなりません。パラメータ値は、アクティビティの受信パッ
ケージのいずれかの名前です。値を設定しない場合、アクティビティは最初の受信パッケージ
(インデックスが 0 のパッケージ) のコンテンツを送信します。
• [Web サービスの応答を保存] — このオプションを [はい] に設定すると、アクティビティは Web
サービスからの応答を XML ドキュメントとして保存します。次の 2 つのパラメータによって、ド
キュメントの名前とリポジトリの保存場所を指定します。このオプションを [いいえ] に設定した場
合、以降のパラメータは関係なくなります。
• [応答をフォルダに保存] — Web サービスからの応答を保存するように選択した場合、この
パラメータによって、アクティビティが XML ドキュメントを保存するリポジトリ フォルダを指定
します。デフォルトの場所は /Temp です。
• [応答ドキュメント名] — Web サービスからの応答を保存するように選択した場合、このパラ
メータによって、XML ドキュメントに付ける名前を指定します。名前を入力しなかった場合、ア
クティビティによって名前が作成されます。このときの名前は、Web サービスの名前の後に
「Response」という単語と応答の日時が続いたものになります。
• [応答ドキュメントをパッケージに添付] — Web サービスからの応答を保存するように選択し
た場合、このパラメータによって、XML ドキュメントを追加する出力パッケージを指定しま
す。出力パッケージにドキュメントを追加すると、アクティビティがワークフロー内の次のアク
ティビティにこのドキュメントを転送します。有効な出力パッケージの名前が入力されていな
いと、XML ドキュメントは転送されません。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
217
事前定義のアクティビティ テンプレート
xPression 発 行 ド キ ュ メ ン ト
xPression 発行アクティビティ テンプレートを使用し、プロセスからのデータを使用して Document
Sciences xPression ドキュメント テンプレートから新しいドキュメントを作成し、パッケージまたは添付
ファイルにマップします。 変数は、ドキュメントが発行されたときのプロセス データに置換されます。
注 記 : xPression 発行ドキュメント アクティビティ テンプレートでは、データ検証はサポート
されません。すべてのランタイム データが有効であることを確認してください。
xPression 発 行 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は 、 次 の 手 順 に 従 い ま す 。
1. [xPression サーバ URL] を入力します。
2. xPression サーバへの接続に使用する [ユーザ名] と [パスワード] を入力します。
注 記 : このユーザを xDesign アクセス権のあるロールに割り当てる必要があります。
3. [接続] をクリックして xPression サーバに接続し、xPression サーバ内の使用可能なカテゴ
リのリストを取得します。
4. リストから、xPression ドキュメントの [カテゴリ] を選択します。
このカテゴリに基づいて、[ドキュメント] フィールドと [出力プロファイル] フィールド
に値が表示されます。
5. 選択したカテゴリに属する [ドキュメント] タイプを選択します。
6. ドキュメントの [出力プロファイル] を選択します。
システムは、このプロファイルを使用して、印刷、電子メール、アーカイブ、Web ベー
スのフォーマットなどのドキュメント出力を発行します。
7. [次へ] をクリックして、プロセス データを入力ドキュメント変数にマップします。
ドキュメント変数はドキュメントのタイプに基づいて決まります。
必要なマッピング
xPression サーバが発行サービスを完了するのに必要なすべての変数をマップする必要があり
ます。実行時に、作成されるドキュメント内では、これらの変数がプロセス データに置換さ
れます。
xDesign ドキュメントを使用すると、ドキュメントで使用される変数のみがマッパに表示されま
す。プライマリ キーがマップされていることを確認します。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、「パッケージ属性をマップする (131ページ) 」を参照してください。
8. ドキュメント プロファイルから出力ドキュメントが得られる場合は、[次へ] をクリックし、出力ド
キュメントをパッケージまたは添付ファイルにマップします。
必要なマッピング
218
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
次の属性をプロセス データにマップする必要があります。
• format は、出力プロファイルで設定されているフォーマット タイプです。たとえば、出力プロ
ファイルが PDF ファイルを発行するよう定義されている場合、対応するパッケージまたは添
付ファイル フォーマットにこの属性をマップする必要があります。
• data は、生成されるドキュメントです。パッケージまたは添付ファイルの対応する属性にマッ
プする必要があります。
xPression 発 行 ド キ ュ メ ン ト - 詳 細
プロセス データにマップすべき定数値が多数ある場合は、xPression 発行ドキュメント - 詳細アク
ティビティ テンプレートを使用します。データ マッパを使用して各変数をマップせずに、定数のマッ
ピングを作成して動的データ用のプレースホルダを追加する XML を入力することもできます。そ
の後、データ マッパを使用して、XML により生成されたプレースホルダの値のみをマップします。
注 記 : xPression 発行ドキュメント - 詳細アクティビティ テンプレートでは、データ検証はサ
ポートされません。すべてのランタイム データが有効であることを確認してください。
xPression 発 行 ア ク テ ィ ビ テ ィ テ ン プ レ ー ト を 設 定 す る に は 、 次 の 手 順 に 従 い ま す 。
1. [xPression サーバ URL] を入力します。
2. xPression サーバへの接続に使用する [ユーザ名] と [パスワード] を入力します。
注 記 : このユーザを xDesign アクセス権のあるロールに割り当てる必要があります。
3. [接続] をクリックして xPression サーバに接続し、xPression サーバ内の使用可能なカテゴ
リのリストを取得します。
4. リストから、xPression ドキュメント カテゴリを選択します。
このカテゴリに基づいて、[ドキュメント] フィールドと [出力プロファイル] フィールド
に値が表示されます。
5. 選択したカテゴリに属する [ドキュメント] タイプを選択します。
6. ドキュメントの [出力プロファイル] を選択します。
システムは、このプロファイルを使用して、印刷、電子メール、アーカイブ、Web ベー
スのフォーマットなどのドキュメント出力を発行します。
7. 定数用のマッピングを生成し動的な値用のプレースホルダを追加する [カスタマ デー
タ XML] を入力します。
この XML には、発行プロセス時にドキュメントをカスタマイズするために xPression ドキュメント
で使用される顧客情報が含まれています。このテキスト ボックス内の XML には、静的なテキス
トと、マップする動的コンテンツ用のプレースホルダの値が含まれていなければなりません。
• プレースホルダの前には、ドル記号「$」が付きます (例: $streetaddress)。
• 複数値のプレースホルダを作成するには、2 つのドル記号「$$」を使用します。
• 電子メール本文でリテラルのドル記号を使用するには、「\$」を使用します (たとえば、500 ド
ルは「\$500.00」と表されます)。
注 記 : プレースホルダ値は、スペースを含まない英数字である必要があります。プレースホ
ルダ トークンは、ドル記号「$」の後から始まり、最初の英数字以外の文字で終わります。
次のサンプル コードは、医療記録解放要求のカスタマ データ XML です。要求番号、要求
日、および電話番号はすべてデータ マッパでマップする必要がある変数です。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
219
事前定義のアクティビティ テンプレート
<dataroot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<CUSTOMER_DATA>
<MedicalRecordReleaseRequest>
<reqNo>$RequestNo</reqNo>
<requestDate>$ReqDate</requestDate>
<patientName>John Doe</patientName>
<patientAddress_street1>1234 Cherry Circle</patientAddress_street1>
<patientAddress_street2></patientAddress_street2>
<patientAddress_city>San Jose</patientAddress_city>
<patientAddress_state>California</patientAddress_state>
<patientAddress_zipCode>95131</patientAddress_zipCode>
<patientDOB>1976-01-01</patientDOB>
<patientSSN>123-12-1234</patientSSN>
<patientHospitalName>Mercy Hospital</patientHospitalName>
<orgName>Mercy Medical Foundation</orgName>
<orgTelNo>$$TelephoneNo</orgTelNo>
</MedicalRecordReleaseRequest>
</CUSTOMER_DATA>
</dataroot>
変数は文字列型でなければならないため、場合によっては日付や時刻の値を DateToString
データ マッパ機能を使用して変換する必要があります。(プロセス データによる日付フォーマッ
トと、xPression サーバで予期される XSD 日付フォーマットは異なる場合があります。)
前のサンプルで、requestDate が XSD dateTime タイプである場合は、次のフォーマットの文
字列を使用します。
yyyy-MM-dd’T’HH:mm:ss.SSSZ
日付と時刻を変換するには次のフォーマットである必要があります。
表 16
必要なフォーマット
XSD タ イ プ
フォーマット
日付
yyyy-MM-dd
日時
yyyy-MM-dd’T’HH:mm:ss.SSSZ
時刻
HH:mm:ss.SSS
8. [次へ] をクリックし、プロセス データを、XML 内のプレースホルダの値であった入力ドキュメ
ント変数にマップします。
注 記 : [カスタマ データ XML] テキスト ボックスを使用して追加した定数値は、データ マッ
パでは表示されません。
必要なマッピング
[カスタマ データ XML] テキスト ボックスで指定した変数の値をマップする必要があります。
場合によっては、マッピングを完成させるために、データの一部に属性や要素を追加する必要
が生じることもあります。
220
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
• データ マッピング ツールを使用する手順については、「データ マッピング ツールを理解
する (129ページ) 」を参照してください。
• 繰り返し属性の追加やマッピングの詳細については、「繰り返し属性を使用する (138
ページ) 」を参照してください。
• 現在ツリーに表示されていない、パッケージの他のソース属性を表示させる方法について
は、パッケージ属性をマップする (131ページ) を参照してください。
9. ドキュメント プロファイルから出力ドキュメントが得られる場合は、[次へ] をクリックし、出力ド
キュメントをパッケージまたは添付ファイルにマップします。
必要なマッピング
次の属性をプロセス データにマップする必要があります。
• name は、ドキュメント名とミリ秒単位の時間で構成されます。
• format は、出力プロファイルで設定されているフォーマット タイプです。
• data は生成されるコンテンツです。
廃止予定のアクティビティ テンプレート
次のセクションで説明するアクティビティ テンプレートは、現在は Process Builder に付属していま
せん。代わりに、機能を増やしたアクティビティ テンプレートが使用できます。新しいアクティビティ
テンプレートは、データ転送を定義するためのウィザードのようなインターフェイスを備えてお
り、これには、データをデータ ソース間でやり取りする方法を指定するグラフィック データ マッ
ピング ツールが含まれています。これらのアクティビティ テンプレートにより、Process Integrator
のメッセージング機能を Process Builder 内からシームレスに使用でき、カスタム開発や処理な
しに最小限の設定を行うだけで済みます。
このセクションは、古いアクティビティ テンプレートを含む古いリリース (5.3x 以前) を使用し
ているユーザ向けです。
注 記 : これらのテンプレートは BPM.dar ファイルの一部としてインストールされるため、Process
Integrator のインストールが必要になります。廃止予定のアクティビティ テンプレートの下位互換性
の詳細については、『Process Integrator Activity Template 6.5 Migration Guide (Process Integrator
アクティビティ テンプレート 6.5 移行ガイド)』を参照してください。
監視ポイント
このアクティビティ テンプレートを使用すると、特定のアクティビティに関連付けられているパッ
ケージを選択し、ビジネス データを Process Analyzer に発行してレポートで使用できます。監
視ポイント アクティビティ テンプレートに先行するアクティビティが、ビジネス データを Process
Analyzer に発行できます。
実行時に、Observation Point (監視ポイント) アクティビティでは、監査記録テーブルに一部の標準
属性とすべてのカスタム属性を挿入します。この監査記録テーブルで、ワークフロー発行イベン
ト ジョブがデータを取得して Process Analyzer に発行します。
ワークフロー発行イベント ジョブでは、監査記録に取り込まれたイベントを ProActivity データベー
スに定期的に発行します。このジョブは、プロセス エンジンの実行環境の一部として提供され
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
221
事前定義のアクティビティ テンプレート
ています。dm_WFPublishEvents ジョブの設定の詳細については、『Process Builder Installation
Guide (Process Builder インストール ガイド)』を参照してください。
属性タイプの定義の一部として発行される標準属性は次のとおりです。
• r_object_id
• object_name
• subject
• keywords
• title
• r_creation_date
• r_modify_date
注 記 : ワークフロー発行イベント ジョブで発行するためには、パッケージ データのプロセ
ス テンプレートで監査記録が有効になっている必要があります。
監視ポイント アクティビティを設定するには:
1. レポートで使用する監視対象パッケージが含まれているプロセス内のアクティビティを特
定します。
2. BAM フォルダから、監視ポイント アクティビティ テンプレートをそのプロセスにドラッグして、監
視対象アクティビティの直後に挿入します。
アクティビティとそれに続く 監視ポイント の間には 1 対 1 対応があります。アクティビティが
Observation Point (監視ポイント) に先行する場合、アクティビティはその他のアクティビティへ
の発信リンクを持つことはできず、Observation Point (監視ポイント) にのみ接続できます。
また、監視ポイントは複数の発信リンクを持つことができますが、アクティビティからの受
信リンクは 1 つしか持つことができません。
監視ポイントのアクティビティ インスペクタを開き、[パッケージの選択] タブをクリックします。
3. プロセスのこのポイントで ProActivity データベースにデータを発行するパッケージを選
択します。
a.
[選択] をクリックします。選択ダイアログ ボックスが開き、プロセス テンプレートに関連付け
られているパッケージが表示されます。
b.
左側のリストでパッケージの名前が反転表示されている状態で [追加] をクリックすると、そ
のパッケージが右側の [選択された項目] リストに追加されます。
c.
追加するパッケージごとに、上記の手順 a ～ b を繰り返します。
d.
選択リストにすべての監視対象パッケージが含まれたら、[OK] をクリックします。
[パッケージの選択] タブに、監視対象としてフラグが付けられたパッケージのリスト
が表示されます。
注 記 : 監視ポイント アクティビティ テンプレートは、Process Analyzer にインポート
すると表示されません。代わりに、そのアクティビティ テンプレートに先行するアク
ティビティには監視対象アクティビティとしてフラグが付けられ、どのパッケージが
レポート用として識別されているかを説明する情報があります。ビジネス プロセス
が Process Builder に再びインポートされると、監視ポイント アクティビティ テンプ
レートがプロセス フローに復元されます。
222
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
FTP
FTP アクティビティ テンプレートは、コンテンツを FTP サイトに投稿したり、ファイル システム
に直接投稿したりする場合に使用します。
• [プロトコル] — このリスト ボックスには、コンテンツの投稿に使用可能なプロトコルが表示
されます。サポートされている標準プロトコルは、FTP、FTPS (FTP over SSL)、SFTP (SSH
FTP)、および File です。
• [サーバ] — コンテンツの投稿先である FTP サーバのホスト名または IP アドレスです。
• [ポート] — FTP サーバに開いているポート番号です。
• [FTP サーバ ユーザ名] — FTP サーバへの接続で使用するユーザ名です。
• [FTP サーバ パスワード] — ユーザ名に対応したパスワードです。
• [リモート ディレクトリ] — コンテンツの投稿先のディレクトリです。
• [転送モード] — コンテンツを投稿する際にアクティビティが使用するメソッドを選択します。
[アーカイブ] オプションを選択すると、すべてのコンテンツが含まれる Zip ファイルが作成され、
指定のリモート ディレクトリに配置されます。[サブディレクトリの作成] を選択すると、指定のリ
モート ディレクトリに独自のサブディレクトリが作成され、すべてのコンテンツがこのサブディレク
トリに配置されます。[ベース ディレクトリのすべてのパッケージ] を選択すると、コンテンツは指
定のリモート ディレクトリに配置されます。
• [アクティビティ パッケージからコンテンツを添付] — このオプション パラメータは、指定された場
所にアクティビティが投稿するコンテンツを識別します。値は、アクティビティの 1 つまたは複数
の受信パッケージの名前です。値を設定しない場合、アクティビティは最初のイ受信パッケージ
(インデックスが 0 のパッケージ) のコンテンツを投稿します。
• [アーカイブ/ディレクトリ名] — [転送モード] で [アーカイブ] または [Create Sub Directory] (サブ
ディレクトリの作成) を選択した場合、アクティビティでは、このフィールドの値を使用して ZIP
ファイルまたはサブディレクトリに名前が付けられます。ディレクトリ名を指定する際、通常は名
前にワークフロー ID などの代替変数を含めます。そのため、アクティビティでは、ワークフ
ローごとの独自のサブディレクトリを作成することができます。
• [フォルダの内容を上書き] — FTP サーバのベース ディレクトリにある既存のファイルまたはフォ
ルダを、転送されるデータで上書きするかどうかを選択します。
HTTP に よ る 投 稿
HTTP を使用してコンテンツを投稿するためのアクティビティ テンプレートは、統合アクティビ
ティ テンプレートのなかで最も直接的なものです。このテンプレートには、必須のカスタム パラ
メータが 1 つと、オプション パラメータが 2 つ含まれています。
• [URL] — この必須パラメータは、アクティビティがコンテンツを投稿するサイトの完全な URL で
す。http:// というプロトコル接頭辞で始まります。
• [タイムアウト (秒)] — このオプション パラメータでは、HTTP 接続のタイムアウト値を秒単位で設
定しますタイムアウト値を設定しないか 0 に設定した場合、接続はタイムアウトしません。
• [アクティビティ パッケージのコンテンツを送信] — このオプション パラメータでは、指定され
た URL に対してアクティビティが投稿するコンテンツを識別します。値は、アクティビティの
受信パッケージのいずれかの名前です。値を設定しない場合、アクティビティは最初の受信
パッケージ (インデックスが 0 のパッケージ) のコンテンツを送信します。コンテンツを投稿で
きるのは 1 つのパッケージからだけです。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
223
事前定義のアクティビティ テンプレート
ラ イ フ サ イ ク ル の 適 用 (5.3x 以 前 )
このテンプレートに基づくアクティビティは、ビジネス プロセスの 1 つまたは複数のパッケージにド
キュメント ライフサイクルを適用します。ライフサイクルは、ドキュメントの存在期間の各段階に
対応した、序列化された状態を定義します。
ライフサイクルの適用アクティビティを設定するには、適用するライフサイクルおよび適用先のパッ
ケージを選択します。また、ライフサイクルの初期状態、およびライフサイクルにエイリアスが関連
付けられている場合にそのエイリアスを解決するのに使用するスコープを指定します。ライフサイ
クルの作成と使用方法の詳細については、『Documentum Composer User Guide (Documentum
Composer ユーザ ガイド)』を参照してください。
• [ライフサイクルを適用するパッケージ] — [...] ボタンをクリックすると、ライフサイクルの適用先の
プロセス パッケージを選択するためのダイアログ ボックスが表示されます。ライフサイクルを適
用するプロセス パッケージごとに、左側のリストでパッケージ名を反転表示してから [追加] ボタ
ンをクリックし、パッケージを右側の選択パッケージ リストに移動します。ダイアログ ボックスで
[OK] をクリックすると、選択したパッケージの名前がデータ フィールドに表示されます。
• [ライフサイクル] — 選択したパッケージに適用するライフサイクルをリスト ボックスから選
択します。
• [初期状態] — 選択したパッケージを配置するライフサイクルの状態の名前を入力します。
• [スコープ] — 選択したライフサイクルにエイリアスが関連付けられている場合、エイリアスを解決
するのに使用するスコープを選択します。
ライフサイクルの降格
このテンプレートに基づくアクティビティは、1 つまたは複数のパッケージを、関連付けられたライフ
サイクルの前の状態に降格します。パッケージをベース状態 (序列化リストの初期状態) に降格す
るか、名前を指定して前のいずれかの状態に降格することができます。
• [降格するパッケージ] — [...] ボタンをクリックすると、ライフサイクルの前の状態に降格するプロ
セス パッケージを選択するためのダイアログ ボックスが表示されます。降格するプロセス パッ
ケージごとに、左側のリストのパッケージ名を反転表示してから [追加] ボタンをクリックし、パッ
ケージを右側の選択パッケージ リストに移動します。ダイアログ ボックスで [OK] をクリックする
と、選択したパッケージの名前がデータ フィールドに表示されます。
• [状態に降格] — 選択したパッケージを特定の状態に降格するには、状態の名前をこの
フィールドに入力します。このフィールドを空白のままにしておくと、パッケージは直前の状
態に降格されます。
• [ベース状態に降格] — 選択したパッケージをライフサイクルのベース状態に降格する場合は、
[はい] オプションを選択します。
ライフサイクルの昇格
このテンプレートに基づくアクティビティは、1 つまたは複数のパッケージを、関連付けられ
たライフサイクルの先の状態に昇格します。
• [昇格するパッケージ] — [...] ボタンをクリックすると、ライフサイクルの先の状態に昇格するプロ
セス パッケージを選択するためのダイアログ ボックスが表示されます。昇格するパッケージごと
224
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
に、左側のリストのパッケージ名を反転表示してから [追加] ボタンをクリックし、パッケージを右
側の選択パッケージ リストに移動します。ダイアログ ボックスで [OK] をクリックすると、選択し
たパッケージの名前がデータ フィールドに表示されます。
• [状態に昇格] — 選択したパッケージを特定の状態に昇格する場合、ライフサイクルの状態
の名前を入力します。このフィールドを空白のままにしておくと、パッケージは直前の状態に
降格されます。
• [昇格の強制] — 各ライフサイクルには一連のエントリの条件があり、通常、ドキュメントを特定の
状態に昇格するには、この条件を満たしている必要があります。ただし、昇格の強制アクティビ
ティ テンプレートを使用すると、パッケージがその状態のエントリの条件を満たしていない場合
でも昇格を「強制」することができます。状態のエントリの条件を満たしているかどうかにかかわら
ず、選択したパッケージを昇格する場合は、[はい] オプションを選択します。
JMS ト ピ ッ ク に 発 行
Java Message Service (JMS) を使用してコンテンツを送信する方法は 2 つあります。JMS キューに
送信する方法と、JMS トピックに発行する方法です。ここでは、アクティビティ テンプレートを使用
して JMS トピックにコンテンツを発行するアクティビティを作成します。
• [JNDI 初期コンテキスト ファクトリ クラス] — この必須パラメータでは、JNDI 初期コンテキスト ファ
クトリ クラスの完全修飾のクラス名を指定します。
• [JMS プロバイダ URL] — この必須パラメータでは、JMS プロバイダに接続するための完
全な URL を指定します。
• [トピック接続ファクトリ JNDI 名] — この必須パラメータでは、指定した JMS プロバイダのトピッ
ク接続ファクトリの JNDI 名を指定します。
• [トピック名] — この必須パラメータでは、コンテンツの発行先のトピックの名前を指定します。
• [アクティビティ パッケージからコンテンツを発行] — このオプション パラメータでは、指定され
た URL に対してアクティビティが投稿するコンテンツを識別します。値は、アクティビティの
受信パッケージのいずれかの名前です。値を設定しない場合、アクティビティは最初の受信
パッケージ (インデックスが 0 のパッケージ) のコンテンツを送信します。コンテンツを投稿で
きるのは 1 つのパッケージからのみです。
SMTP
このアクティビティ テンプレートは、電子メールを使用してコンテンツを配信するために使用しま
す。このテンプレートのパラメータは、メッセージのコンテンツ、メッセージの配信先のアドレス、お
よびメールの送信に使用する SMTP サーバを定義します。
電子メールを使用してコンテンツを送信する場合、コンテンツのファイルがメッセージに添付さ
れて配信されます。
• [宛先] - この必須パラメータは、受信者の電子メール アドレスです。ユーザ名とドメイン
名 (user@domain) の両方が含まれます。カンマで区切って、複数の受信者を指定するこ
とができます。
省略符号 (...) ボタンをクリックして [代替変数] ダイアログ ボックスを表示し、ランタイム変数
を選択します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
225
事前定義のアクティビティ テンプレート
• [Cc] および [Bcc] — これらのオプション パラメータは、電子メール メッセージの追加の受信者
を一覧するもので、フォーマットは [宛先] パラメータと同じです。
• [送信者] — この必須パラメータは、送信者の電子メール アドレスで、配信されたメッセージの
From(送信者) フィールドに表示されます。
• [返信先] — メッセージに対する返信を送る先のアドレスです。Process Integrator のメッセージ
ハンドラで正しくアドレスが指定されるように、このパラメータを使用して返信アドレスの形式
を指定します。通常、返信先のアドレスには、現在のワークフローのワークフロー ID など、
サーバによって実行時に置き換えられる変数が含まれます。
• [主題] — このパラメータに入力したテキストは、配信されたメッセージの主題として表示されま
す。このパラメータを空にしておくと、メッセージは主題の入力されていない状態で配信されます。
• [SMTP サーバ ホスト名または IP] — この必須パラメータでは、メッセージの送信に使用される
SMTP サーバを識別します。ホスト マシンの名前か、その IP アドレスを入力できます。
• [SMTP サーバ ポート番号] — このオプション パラメータでは、SMTP サーバのポート番号を識
別します。値を設定しなかった場合、アクティビティは標準の SMTP ポート 25 を使用します。
• [SMTP サーバ認証ユーザ名] および [SMTP サーバ認証パスワード] — SMTP サーバがユーザ
名とパスワードを必要とする場合に、名前とパスワードを指定します。
• [アクティビティ パッケージのコンテンツを添付] — このオプション パラメータでは、アクティビ
ティが電子メール メッセージに添付するファイルとして指定したコンテンツを識別します。値
は、1 つ以上のアクティビティの受信パッケージの名前で、カンマで区切られます。値を設
定しない場合、アクティビティは最初の受信パッケージ (インデックスが 0 のパッケージ) の
コンテンツを送信します。
• [フォルダ パッケージ内のすべてのコンテンツを添付] — パッケージのいずれかがコンテンツ
フォルダ オブジェクトを送信している場合、アクティビティはフォルダ内のすべてのドキュメントを
送信する ([はい]) か、そのフォルダをスキップする ([いいえ]) ことができます。[はい] をクリックし
た場合、アクティビティは直接そのフォルダ内に存在するドキュメントだけを添付し、他のサブ
フォルダのドキュメントを再帰的に添付することはありません。
• [メッセージのドキュメントに URL を添付] — URL を電子メール メッセージ本文の一部として
表示できるようにします。
• [メッセージのアクティビティ パッケージに URL を添付] — パッケージを追加して、対応する
URL を電子メール メッセージ本文に表示できるようにします。
• [メッセージのワークフロー添付ファイルに URL を添付] — 電子メール メッセージ本文に一時的
な添付ファイルの URL を追加できるようにします。
• [デフォルトの Webtop の URL を使用] — デフォルトの Webtop の URL 以外の URL を使用する
場合は、[いいえ] を選択します。
• [デフォルトを使用しない場合に URL 接頭辞を指定] — デフォルトの Webtop の URL を使用し
ない場合、電子メール メッセージ本文で使用する URL 接頭辞を入力します。
• [デフォルトを使用しない場合に URL 接尾辞を指定] — デフォルトの Webtop の URL を使用し
ない場合、電子メール メッセージ本文で使用する URL 接尾辞を入力します。
JMS キ ュ ー に 送 信
Java Message Service (JMS) を使用してコンテンツを送信する方法は 2 つあります。JMS キューに
送信する方法と、JMS トピックに発行する方法です。ここでは、アクティビティ テンプレートを使
用して JMS キューに送信するアクティビティを作成します。
226
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
注 記 : IBM MQSeries が JMS プロバイダの場合は、[MQ JMS に送信] を使用してキューに
メッセージを送信します。
• [JNDI 初期コンテキスト ファクトリ クラス] — この必須パラメータでは、JNDI 初期コンテキスト ファ
クトリ クラスの完全修飾のクラス名を指定します。
• [JMS プロバイダ URL] — この必須パラメータでは、JMS プロバイダに接続するための完
全な URL を指定します。
• [キュー接続ファクトリ JNDI 名] — この必須パラメータでは、指定した JMS プロバイダのキュー
接続ファクトリの JNDI 名を指定します。
• [キュー名] — この必須パラメータでは、コンテンツの送信先のキュー名を指定します。
• [次のキュー名に返信] — このオプション パラメータでは、応答メッセージの送信先の JMS
キューの名前を指定します。
• [メッセージ相関 ID] — Process Integrator を使用すると、の処理方法を指定できます。メッ
セージ相関 ID は、Process Integrator が、出力したメッセージに対応する応答として受信す
るメッセージの識別に使用する ID です。
• [アクティビティ パッケージのコンテンツを送信] — このオプション パラメータでは、指定され
た URL に対してアクティビティが投稿するコンテンツを識別します。値は、アクティビティの
受信パッケージのいずれかの名前です。値を設定しない場合、アクティビティは最初の受信
パッケージ (インデックスが 0 のパッケージ) のコンテンツを送信します。コンテンツを投稿で
きるのは 1 つのパッケージからのみです。
MQ JMS に 送 信
このアクティビティ テンプレートは、IBM MQ シリーズを JMS プロバイダとして使用している場合
に、Java Message Service (JMS) を使用してコンテンツを送信するのに使用します。パラメータ
はすべて必須です。
注 記 : IBM MQSeries 以外の JMS プロバイダを利用している場合は、[JMS キューに送
信] を使用して JMS キューにメッセージを送信します。
• [サーバ] — WebSphere MQ を実行しているマシンの IP アドレスまたは完全修飾名です。
• [ポート] — Queue Manager に開いているポートです。デフォルトは 1414 です。
• [Queue Manager] — WebSphere Queue Manager の名前です。この名前では、大文字と小文字が
区別されます。通常、名前の形式は WAS_nodename_servername です。
• [キュー名] — コンテンツの送信先のキューの名前です。キューは、指定した Queue Manager で
管理する必要があります。キュー名の形式は WQ_queuename です。キュー名 <キュー名> は、
WebSphere MQ で [サーバ] > [アプリケーション サーバ] > [<サーバ名>] > [サーバ コンポーネ
ント] > [キュー名] を選択して指定できます。
• [チャネル名] — MQ への接続用に WebSphere MQ に作成されたサーバ接続チャネルの名
前です。
• [パッケージ要求] — このパラメータは、指定されたキューにアクティビティが投稿するコンテン
ツを識別します。値は、アクティビティの受信パッケージのいずれかの名前です。コンテンツを
投稿できるのは 1 つのパッケージからだけです。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
227
事前定義のアクティビティ テンプレート
サブプロセスの開始
プロセスの起動アクティビティは、新しいワークフローを起動します。プロセス テンプレートのパッ
ケージ、名前およびデータ タイプが一致するパッケージはすべて、現在のワークフローから新しい
ワークフローに渡されます。新しいワークフローの開始時にアクティビティが完了します。
論理的に新しいワークフローは起動元のワークフローのサブプロセスですが、ワークフロー オブ
ジェクト間に形式的な関係はありません。相互に独立しています。サブプロセスが完了するま
で現在のワークフローを一時停止するには、イベントに基づいて次のアクティビティがトリガさ
れるように定義し ([トリガ] タブ)、親プロセスに対するイベントの通知アクティビティ テンプレー
トに従って、サブプロセスにアクティビティを組み込みます。このテンプレートは親プロセスが
待ち受けるイベントを通知します。
• [このワークフローをサブプロセスとして開始する] — リスト ボックスから新しいワークフローに使
用するプロセス テンプレートを選択します。選択したテンプレートの必須パッケージの名前と
データ タイプが現在のワークフローのパッケージと一致している必要があります。この一致の必
要性は、表示されるパッケージだけでなく、定義済みのすべてのパッケージに適用されます。
• [サブプロセス スーパーバイザ] — 新しいワークフローのワークフローのスーパーバイザにす
るユーザを選択します。
サンプル
[サンプル] ウィンドウには、カスタム アクティビティのデータ エントリ パネルで利用可能な各種ユー
ザ インターフェイス コントロールを示した、サンプル アクティビティ テンプレートが含まれていま
す。[サンプル] ウィンドウには、サンプル アクティビティ テンプレートに加えて、キュー管理に関連
した次の 2 種類のアクティビティ テンプレートも含まれています。
キュー管理の詳細については、『Documentum Webtop ユーザ ガイド』を参照してください。
キュー タスク リワーク決定
キュー タスク リワーク決定は、ワーク キューによって処理されるドキュメントに定期的な品質チェッ
クを実行するアクティビティを作成するための、サンプル アクティビティ テンプレートです。ワー
ク キューの定義には、品質保証チェックのために別のプロセッサに送信するドキュメントの比
率を指定するポリシーが含まれています。
決定分岐アクティビティ テンプレートと同様、キュー タスク リワーク決定テンプレートは、唯一のア
クションとして分岐ロジックの評価と適切なパッケージの転送のみを行うアクティビティを作成しま
す。キュー タスク リワーク決定テンプレートに基づくアクティビティは、パッケージを、次のリワーク
アクティビティと次のリワークなしアクティビティのいずれかに送ります。このアクティビティは、(a)
[チェックするアクティビティ] に関連付けられたワーク キュー ポリシーで規定されている [パーセン
ト クオリティ チェック]、および (b) [必要なスキル レベル] パラメータの 2 つの要素に基づいて、各
パッケージをどちらのアクティビティに送るかを決定します。
• [チェックするアクティビティ] — この必須パラメータでは、最初のドキュメント処理を実行するア
クティビティを指定します。このアクティビティの実行者タイプはカテゴリ 10 (ワーク キュー) であ
る必要があります。アクティビティ名を入力します。
228
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
事前定義のアクティビティ テンプレート
• [必要なスキル レベル] — チェック対象である業務を担当する実行者のスキル レベルです。有
効な値の範囲は、0 (研修者) ～ 10 (上級者) です。
• [次のリワーク アクティビティ名] — この必須パラメータでは、品質チェックを実行するアクティビ
ティを指定します。アクティビティ名を入力します。
• [次のリワーク不要アクティビティ名] — この必須パラメータでは、品質チェックが不要なドキュメ
ントの次のルートであるアクティビティを指定します。アクティビティ名を入力します。
各パッケージの送信ロジックは、次のとおりです。
1. [チェックするアクティビティ] の [パーセント クオリティ チェック] の値が 0 の場合、パッケージは
次のリワークなしアクティビティに送られます。
2. [チェックするアクティビティ] でこのパッケージを処理する実行者のスキル レベルが、[必要
なスキル レベル] のパラメータ値に満たない場合、パッケージは次のリワーク アクティビ
ティに送られます。
3. 残りのすべてのパッケージは、[パーセント クオリティ チェック] 値で指定された割合に応じて、
次のリワーク アクティビティと次のリワークなしアクティビティに送られます。たとえば、[パーセ
ント クオリティ チェック] が 20% の場合、5 つのドキュメントごとに 1 つが、次のリワーク アク
ティビティに送られます。
サンプル アクティビティ テンプレート
Process Builder には、サンプル アクティビティ テンプレートも用意されています。これは、アク
ティビティ テンプレートの XML ファイルのフォーマット例を示すもので、カスタム アクティビ
ティ テンプレートを作成する際の参考になります。このテンプレートはサンプル アクティビティ
テンプレート フォルダに表示されます。サンプル アクティビティ テンプレートの使用方法の詳
細については、『Documentum Process Builder Development Guide (Documentum Process Builder
開発ガイド)』を参照してください。
キュー タスク スキル決定
キュー タスク スキル決定テンプレートから作成したアクティビティは、特定のパッケージを処理する
のに必要な実行者のスキル レベルを設定します。このスキル レベルの値は、それ以前に設定さ
れていたパッケージのスキル レベル要件を上書きするものです。
通常、キュー タスク スキル決定アクティビティに先行するアクティビティには、パッケージの属
性をチェックして、特別な処理が必要かどうかを判断するための移行条件があります。特別な
処理を必要とするパッケージだけがキュー タスク スキル決定アクティビティに送られ、それ以
外のパッケージではこのアクティビティはスキップされます。
• [パッケージ名] — アクティビティで、実行者に必要なスキル レベルを設定するパッケージ
の名前です。
• [スキル レベル] — パッケージに適用するスキル レベルです。有効な値がリスト ボックスに
表示されます。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
229
第 12 章
カスタム アクティビティで代替変数を使用
する
この章では、 次のトピックについて説明します。
•
カスタム アクティビティ テンプレートの属性に代替変数を使用する
カスタム アクティビティ テンプレートの属性に代替変
数を使用する
[アクティビティ インスペクタ] のカスタム タブのフィールドに値を入力するときは、ワークフローやタ
スクの実行者の名前など、実行時現在の環境による値で置換される変数を挿入できます。この変
数は、フィールドの完全値にすることも、リテラル テキストや他の代替変数またはその両方を含む
長い文字列のどこかに使用することもできます。
注 記 : 変数置換を使用できるのは、データ タイプが文字列型のフィールドだけです。
変数を挿入するには、<dmp:param>supported_variable</dmp:param> を入力します。
supported_variable は、下記のテーブルに記載されている変数のいずれかを表します。各変数は 2
つの部分で構成されており、ピリオドで区切られています。1 つはパラメータ タイプ で、値の生成
元であるオブジェクトのタイプを識別します。もう 1 つは属性名 で、実行時に挿入する特定の値を
識別します。たとえば、変数 <dmp:param>workflow.creator</dmp:param> は、実行時にワークフ
ロー オブジェクトの作成者の属性値に置換されます。選択した属性に値が複数ある場合は、使用
する値を指定するインデックスも代替変数によって挿入されます。
フィールドの横に省略符号 (...) ボタンがある場合は、変数を入力するのではなくダイアログ ボック
スから選択することができます。ダイアログ ボックスを閉じると Process Builder によって現在のカー
ソル位置に選択した変数が挿入されます。
ダイアログ ボックスを使用して代替変数を挿入するには
1. フィールド内で変数を挿入する位置にカーソルを置きます。
2. フィールドの横にある省略符号 (...) ボタンをクリックします。
[代替変数] ダイアログ ボックスが表示されます。
3. [パラメータのタイプ] リスト ボックスから、オブジェクト タイプか、必要な値が含まれるパッケー
ジの名前を選択します。
選択した項目に使用可能できる属性が [属性] リストに表示されます。また、パラメータのタイプ
にエイリアスを選択した場合は、[エイリアス セット] と [エイリアス名] リストが表示されます。
4. エイリアスをパラメータのタイプとして選択した場合は、[エイリアス セット] リスト ボックスからエ
イリアス セットを選択し、[エイリアス名] リストから特定のエイリアスを選択します。
5. エイリアス以外のパラメータ タイプを選択した場合は、[属性] リストから文字列で置換する
値の属性を選択します。
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
231
カスタム アクティビティで代替変数を使用する
6. 手順 5 で選択した属性に値が複数ある場合は、[インデックス] リストから [最初] または [最
後] を選択して、使用する値を指定します。
[最初] や [最後] 以外の特定のインデックス位置の値を使用するには、ダイアログ ボックス
を閉じてから変数を編集し、[最初] または [最後] の値を整数値に置換します。[最初] の
位置はインデックス位置 0 に相当します。
7. [OK] をクリックしてダイアログ ボックスを閉じます。
Process Builder によって現在のカーソル位置に選択した変数が挿入されます。
表 17
アクティビティ設定フィールドでサポートされる代替変数
変数
説明
workflow.creator
ワークフローを作成したユーザの名前
workflow.instructions
[プロセスのプロパティ] ダイアログ ボックスに
ある [ワークフローの手順] テキスト ボックス
のテキストです。
workflow.id
ワークフローの ID
workflow.name
ワークフローの名前
workflow.process_id
ワークフローを生成したプロセス テンプレー
トの ID
workflow.start_date
ワークフローの開始日
workflow.supervisor
ワークフロー スーパーバイザとして識別され
るユーザの名前 (デフォルトではワークフロー
の作成者)
workflow.supervisor_address
ワークフロー スーパーバイザの電子メール
アドレス
task.act_id
現在のタスクを生成したアクティビティの ID
task.number
タスクを生成したアクティビティのワークフロー
内のシーケンス番号
task.auto_method_id
自動アクティビティのメソッド定義の ID。タスク
が自動アクティビティでない場合、変数値は
「0000000000000000」になります。
task.creation_date
日付フォーマットは、DFC で設定したデフォル
トの時刻パターンによって指定されます。
task.due_date
日付フォーマットは、DFC で設定したデフォル
トの時刻パターンによって指定されます。タスク
に期限がない場合、変数値は「nulldate」です。
task.performer
タスクの実行者
task.performer_address
タスク実行者の電子メール アドレス
task.priority
タスクに割り当てられた優先度の値
task.state
整数で表現されるタスクの現在の状態
232
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
カスタム アクティビティで代替変数を使用する
変数
説明
packagename.attribute
packagename で指定されるパッケージのいず
れかの単一値属性の値。[代替変数] ダイアロ
グ ボックスから値を選択する際は、カスタム属
性と標準 dm_document 属性で一般的に使用
されるサブセットのすべてがダイアログ ボック
スに表示されます。ただし、任意の属性を使
用することができます。
packagename.attribute[index]
packagename で指定されたパッケージの複数
値属性の値。インデックスは、使用する値を識
別します。[最初]、[最後] または値のリストの
位置を示す整数値です。[代替変数] ダイア
ログ ボックスから変数を選択する際は、カスタ
ム属性と、標準 dm_document 属性で一般的
に使用されるサブセットのすべてがダイアログ
ボックスに表示されます。ただし、任意の属性
を使用することができます。
doc.id
アクティビティで処理される最初のパッケージ
の最初のドキュメントの ID
doc.name
アクティビティで処理される最初のパッケージ
の最初のドキュメントの名前
note.id
ドキュメントに添付された最初のメモの ID (存
在する場合)
note.writer
メモを作成したユーザの名前
note.text
メモのテキスト
note.creation_date
メモの作成日
alias.alias_name または alias.alias_set.alias_name
システム エイリアス。ここで、alias_name は解
決するエイリアスを示します。オプションの
alias_set を含める場合、サーバは指定された
エイリアス セットのエイリアスを使用します。
VarName または VarName.<属性値>
プロセス変数の値
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
233
第 13 章
Process Builder の 設 定 フ ァ イ ル
この章では、 次のトピックについて説明します。
•
Process Builder の 設 定 フ ァ イ ル
Process Builder の 設 定 フ ァ イ ル
Process Builder には、ユーザ インターフェイスの特定の動作を制御する設定ファイルがありま
す。bpmconfig ファイルは、\System\Workflow\Config フォルダにある XML ファイルです。この
ファイルで制御する動作は次のとおりです。
• Process Builder でユーザがオブジェクト タイプやパッケージのバージョンを設定できるよう許
可するかどうか
• リポジトリ内でユーザがプロセス テンプレートを保存する場所
• Process Builder がプロセス テンプレートの一意の名前を必要とするかどうか
• [ファイル] メニューの [最近使用したファイル] リストに表示するプロセス テンプレート名の数
次の表は、設定ファイルのパラメータを示しています。値を変更するには、必要に応じて、
テキスト エディタでファイルを編集します。
表 18
bpmconfig の パ ラ メ ー タ
パラメータ
説明
デフォルト値
unique-template-name
プロセス テンプレート名がリポジトリ全体で一意である
必要がある場合は true に設定します。
false
show-package-version
Process Builder でパッケージのバージョンの選択を
ユーザに許可するかどうかを指定します。false に設
定すると、プロセスでは常に現在のバージョンが使
用されます。
true
show-package-type
Process Builder でパッケージのオブジェクト タイプの
明示的な設定をユーザに許可するかどうかを指定しま
す。false に設定すると、Process Builder では、選択さ
れたフォーム テンプレートに関連付けられたオブジェ
クト タイプを使用します。フォーム テンプレートが選択
されていない場合は、dm_sysobject を使用します。
true
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
235
Process Builder の設定ファイル
パラメータ
説明
デフォルト値
max-recent-file
[最新ファイル] リストに表示するファイル名の最大数
を設定します。
5
template-save-path
このパラメータが存在する場合、Process Builder は、
指定のフォルダまたはサブフォルダにプロセス テン
プレートを保存するようユーザに要求します。パラ
メータが存在しない場合は、適切なセキュリティ アク
セス権のある任意のフォルダにプロセス テンプレー
トを保存できます。
なし
236
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
索引
英数字
ACL
最低限のアクセス権, 64
システム, 65
設定, 64
選択, 65
変数に割り当てる, 62
ユーザ, 65
ACL アクティビティ テンプレートの作成, 171
ACL テンプレート, 171
BAM レポート
BAM 定義の更新, 45
[BAM データ定義の更新] オプション, 40
BAM の更新, 40
BAM レポート
監査記録の設定, 57
構造化データ タイプの公開, 45
サブプロセス, 83
パッケージを公開する, 61, 126
プロセス データの更新, 40
有効化, 15
BOF モジュール アクティビティ テンプレート, 160
Business Activity Monitor, 参照 BAM
content-type, 131
data, 131
dm_changedactivityinstancestate, 58, 123
dm_delegatedworkitem, 58, 123
dm_QmPriorityAging ジョブ, 24
dm_startedworkitem, 58, 123
dm_WfmsTimer ジョブ, 31
dm_workflow, 22
dmi_package, 22
dmi_queue_item, 22
dmi_workitem, 22
DQL 書き込みアクティビティ テンプレート, 177
DQL 受信アクティビティ テンプレート, 175
DQL 読み取りアクティビティ テンプレート, 177
ECIS アクティビティ テンプレート, 162
format, 131
Forms Builder, 13, 29, 60, 66, 98
FTP アクティビティ テンプレート, 223
FTP 受信アクティビティ テンプレート, 196
FTP 送信アクティビティ テンプレート, 198
FTP 読み取りアクティビティ テンプレート, 200
getInitialPriority メソッド, 24
HTTP/Web サービス受信ポート番号, 39
HTTP 掲示アクティビティ テンプレート, 223
HTTP 受信アクティビティ テンプレート, 204
HTTP 送信アクティビティ テンプレート, 206
iCalendar, 172
iCalendar イベントの作成アクティビティ
テンプレート, 172
ICS カレンダー イベント, 172
IDfModule インターフェイス, 25
IWQTaskPriority インターフェイス, 25
JMS キューに送信アクティビティ テンプレート, 226
JMS 受信アクティビティ テンプレート, 207
JMS 送信アクティビティ テンプレート, 209
JMS トピックに発行アクティビティ テンプレート, 225
MQ JMS に送信アクティビティ テンプレート, 227
Process Analyzer
XPDL ファイル, 38
プロセスの共有, 37
SMTP アクティビティ アクティビティ
テンプレート, 211
SMTP アクティビティ テンプレート, 225
task_subject 属性, 23
task_subject 属性, 22
TaskSpace, 28
Web サービス
Web サービス受信アクティビティ
テンプレート, 214
動的 Web サービス アクティビティ
テンプレート, 184
有効化, 67
Web サービス アクティビティ テンプレート, 217
Web サービス受信アクティビティ テンプレート, 214
XML スキーマ
アクティビティ テンプレート インスペクタの, 92
構造化データ タイプで使用する, 46
メッセージへの追加, 133
XPDL
インポートする, 75
エクスポートする, 76
再インポートする, 77
XPDL ファイル, 37
xPression 発行ドキュメント-詳細アクティビティ
テンプレート, 219
xPression 発行ドキュメント アクティビティ
テンプレート, 218
XSD ファイル, 46
XSL 変換アクティビティ テンプレート, 170
ア
アイコン, 36
アクセス権, 64
アクセス制御リスト, 参照 ACL
アクティビティ
移行タイプ, 32
移動する, 47
委任を有効にする, 99
上書きする, 63
置き換える, 48
繰り返し可能, 112
グリッドにスナップする, 48
計画, 18
コピーする, 47
再試行間隔, 100
実行者, 18
実行者ロール, 18
障害対処, 13
条件による選択, 33
初期化, 12
接続する, 81
説明, 12
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
237
索引
トリガの条件, 29
トリガを設定する, 111
配置する, 47
貼り付ける, 47
表示設定を変更する, 128
メッセージ待機, 13
アクティビティ インスペクタ, 96
アクティビティ テンプレート作成
, 90
アンインストール, 93
アンインストールする, 92
インストールする, 92–93
検証する, 92–93
検証とインストールのプロンプトの表示, 40
コピー, 90
作成する, 17, 90
システム内の場所, 41
状態, 42
設定する, 91
プレファレンスの設定, 39
プロンプト メッセージの表示, 40
アクティビティ テンプレート インスペクタ
新しいテンプレートの作成, 90
新しいテンプレートを作成する, 90
設定する, 91
[定義] タブ, 92
[アクティビティ テンプレート] ウィンドウ
概要, 41
カスタム テンプレートをコピーする, 91
テンプレートを追加する, 91
アクティビティ テンプレート フォルダ
アクティビティ テンプレートの削除, 91
削除, 39
追加する, 39
アクティビティ テンプレートをインストールする, 92
アクティビティを移動する, 47
アクティビティを上書きする, 63
アクティビティをコピーする, 47
アクティビティを配置する, 47
アクティビティを貼り付ける, 47
「値の取得」関数, 141
アンインストール
アクティビティ テンプレート, 93
アンインストールする
アクティビティ テンプレート, 92
238
イ
移行規則, 118
移行条件, 33, 120
移行条件ウィザード, 120
移行タイプ, 32
[移行] タブ, 96, 118
[一般] タブ, 56
委任, 21, 99
印刷プレビュー, 78–79
インストール済み状態, 54, 89
インストールする
アクティビティ テンプレート, 93
プロセス テンプレート, 69
インバウンド アクティビティ
Web サービスの有効化, 67
デバッグ, 151
受信電子メール アクティビティ テンプレート, 193
インポートする、プロセス テンプレート, 75
エ
「営業日の追加」関数, 140
エイリアス
エイリアス セットを作成する, 20
実行者エイリアス, 115
ワークフローで使用する, 20
エイリアス セット
デフォルト, 105
特定の, 105
オ
「大文字に変換」関数, 142
オブジェクト
削除する, 47
選択する, 47
オブジェクトを削除する, 47
オブジェクトを選択する, 47
親プロセスに対するイベントの通知アクティビティ
テンプレート, 170
カ
開始アクティビティ, 12
カウント関数, 140
拡張, 21
掛け算関数, 141
カテゴリ, 42
カテゴリの追加, 42
カレンダー, 113
カレンダー イベント, 172
監査記録
サブプロセス, 83
設定, 57
有効にする, 15
ワークフロー発行イベント ジョブ, 222
関数, 140, 180
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
索引
キ
コ
キュー タスク スキル決定アクティビティ
テンプレート, 229
キュー タスク リワーク決定アクティビティ
テンプレート, 228
[強制的にタスクを完了] ボタン, 153
切り替え条件, 31–32, 118, 122
構造化データ タイプ
XML スキーマを使用する, 46
ウィザード, 42
カテゴリ, 42
管理する, 61
[繰り返し可能] オプション, 45–46
グループ, 43
[検索可能] オプション, 45–46
属性, 44
単純, 28
単純データ タイプ, 43
複合タイプ, 43, 46
編集する, 45
要素タイプ, 46
[レポート] オプション, 45–46
構造化データ タイプ ウィザード, 42–43
[構造化データ タイプ] ウィンドウ, 42
[高度] タブ, 64
コピー関数, 140
「小文字に変換」関数, 142
コンテンツ サービス テンプレート
ECIS アクティビティ テンプレート, 162
フォルダにリンク, 166
フォルダの作成, 162
ライフサイクルの降格, 164, 224
ライフサイクルの昇格, 224
ライフサイクルの適用, 166, 224
ク
繰り返し属性
移行条件, 121
タスクの主題, 22
マッピング, 138
グリッドにスナップする, 48
グループに所属する複数のユーザ, 19
グループのすべてのユーザ, 19
グループの単独ユーザ, 19
ケ
経過アクティビティ, 12
警告タイマ, 30, 85, 112
警告メッセージ, 40
結合アクティビティ テンプレート, 169
結合関数, 141
決定分岐アクティビティ テンプレート, 168
現在のバージョン, 54
検証
サーバ, 92
プロンプト メッセージの表示, 40
検証済み状態, 54, 89
検証する
アクティビティ テンプレート, 92–93
プロセス テンプレート, 70
サ
再試行間隔, 100
サインオフの要件, 99
サインオフ要件, 23
作業項目, 12
サブプロセス
アクティビティの削除, 86
折りたたむ, 86
概要, 83
削除, 87
サブプロセス インスペクタ, 84
展開, 86
トップダウン モデリング, 84
表示オプション, 85
プロパティの設定, 85
ボトムアップ モデリング, 84
メモ, 87
サブプロセス インスペクタ, 84–85
サブプロセスの開始アクティビティ
テンプレート, 228
サンプル テンプレート
キュー タスク スキル決定, 229
キュー タスク リワーク決定, 228
サーバの検証, 92
シ
事後タイマ, 30, 85, 112
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
239
索引
事後タイマの有効期限, 58
事前タイマ, 30, 85, 112
事前タイマが期限切れです, 58
下書き状態, 54, 89
実行継続オプション, 100
実行者
委任と拡張の使用, 21
エイリアス, 105, 115
実行時の決定, 20
自動, 99, 110
手動, 99, 101
条件に応じて選択する, 106
選択, 18
プロセス データに基づいて選択する, 108
ロール, 18
実行者エイリアスの定義, 105
[実行者] タブ, 96, 99, 101, 110
実行者の選択, 101, 110
実行者を今すぐ割り当てる, 103
実行者を決定する, 102
実行者を定義する, 102
実行者を割り当てる, 102
実行中断オプション, 100
実行停止オプション, 100
実行データ, 15
実行ログ, 100
自動アクティビティ
実行パラメータ, 99
属性, 12
有効な実行者, 110
優先度の値, 23
自動起動パッケージ, 126–127
自動実行者
選択, 99, 110
自動実行者タスク, 99
自動ワークフロー メソッド, 154
終了アクティビティ, 12
受信アクティビティ
相関セット, 67
ポート番号, 38
手動アクティビティ
委任, 21
拡張, 21
実行者としてのエイリアス, 20
属性, 12
有効な実行者, 18
手動実行者
グループ内のすべてのメンバ, 101
グループに所属する複数のユーザ, 101
グループの単独ユーザ, 101–102
実行者を定義する, 102
条件に基づいて選択する, 102
選択, 99
選択する, 101
直前のアクティビティ実行者, 101–102
特定ユーザ, 101
複数の実行者が順次実行, 101–102
プロセス データに応じて選択する, 102
240
リポジトリの所有者, 101
ワーク キュー, 101
ワークフロー スーパーバイザ, 101
手動実行者タスク, 99
障害対処アクティビティ, 12–13, 55, 81
条件付き実行者, 102, 106
条件付きノード, 135
初期化アクティビティ, 12
ス
スーパーバイザへの通知, 122
スキル セット, 110
ステップイン ボタン, 152
ストアド プロシージャ, 180
すべてのバージョン, 54
スーパーバイザ通知, 30, 122
スーパーバイザに通知する, 30
ズーム オプション, 49
セ
選択
自動実行者, 110
[選択したすべてに適用] オプション, 81, 97
選択する
手動実行者, 101
ソ
相関 ID, 144
相関セット
作成する, 66
使用する, 145
定義されている, 144
属性, 131
タスクの主題, 22
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
索引
タ
テ
代替変数, 231
タイマ
Java メソッドを実行する, 116
Java メソッドの実行, 30
カレンダーとの関連付け, 113
タスクの委任, 30
タスクの完了, 30
タスクを委任する, 117
タスクを完了する, 117
通知, 30
通知の送信, 115
プロセスの開始, 30
プロセスを開始する, 115
[タイマ] タブ, 85, 96, 112
足し算関数, 140
タスク
エージング, 23
タスク自動実行者, 99
タスク手動実行者, 99
タスクのエージング, 23
[タスク マネージャ] タブ, 152
[タスク名], 98
タブ
アクティビティ インスペクタ, 91
非表示にする, 92
表示する, 51
単一セグメント フロー, 81
単純データ タイプ, 28, 43
定義されているメッセージ相関, 144
デジタル署名, 23
[デバッグの再実行] ボタン, 152
デバッグ プロセス環境, 148
デフォルトのエイリアス セット, 56, 105
電子メール アドレスの取得関数, 141
電子メール通知, 31
電子メール テンプレート
作成する, 57, 113, 123
選択する, 58
タイマ用の, 57, 113
[テンプレートから新しいケースを作成]
アクティビティ テンプレート, 168
[データ] タブ, 59, 96
データ定義, 40
データベース受信アクティビティ テンプレート, 173
データベースの書き込みアクティビティ
テンプレート, 183
データベースのストアド プロシージャ
アクティビティ テンプレート, 180
データベースの読み取りアクティビティ
テンプレート, 178
データ マッピング
関数, 140
関数を使用する, 140
繰り返し属性, 138
コンテキストの入力, 139
相関セットの使用, 144
単一値属性, 138
プロシージャ, 136
データ マッピング ツール
XML スキーマの追加, 133
概要, 129
関数エディタ, 140
繰り返し属性の使用, 138
条件付きノードの追加, 135
データのマッピング, 136
パッケージ属性, 131
プロセス データを編集する, 131
メッセージ プロパティを追加する, 132
データ マッピングの概要, 136
チ
チケットの取得関数, 141
直前のアクティビティ実行者, 19
ツ
通知
作成, 31, 122
タイマから, 115
デフォルト, 114
電子メール テンプレート, 57
[通知] タブ, 30, 96, 122
通知テンプレート, 123
通知テンプレート ウィザード, 123
[次のアクティビティにステップ オーバー]
ボタン, 151
「月の取得」関数, 141
ツールバー, 36
ツールバー アイコン, 36
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
241
索引
ト
ハ
統合 templatesService
動的 Web, 184
統合テンプレート
BOF モジュール, 160
FTP, 223
FTP 受信, 196
FTP 送信, 198
HTTP 掲示, 223
HTTP 受信, 204
HTTP 送信, 206
JMS キューに送信, 226
JMS 受信, 207
JMS 送信, 209
JMS トピックに発行, 225
MQ JMS に送信, 227
SMTP, 225
SMTP アクティビティ, 211
Web サービス, 217
受信電子メール , 193
データベース受信, 173
データベースの書き込み, 183
データベースのストアド プロシージャ, 180
データベースの読み取り, 178
ファックス送信, 201
プロセス データ マッピング, 210
プロセスの起動, 163
動的 Web サービス アクティビティ テンプレート, 184
動的な優先度, 97
動的優先度, 25
ドキュメント名を保存する, 57
特定ユーザ, 19
トリガ
イベント, 30
設定, 29
設定する, 111
[トリガ] タブ, 96
「バイトから文字列に」関数, 140
パッケージ
自動起動, 126
自動的に, 127
属性, 131
追加属性を表示する, 131
定義する, 27
テンプレートに追加する, 59
ドキュメント名を保存する, 57
必須, 61
レポート用に公開する, 61
パッケージ データ, 15
パラメータのタイプ, 231
バージョン, 59–60
ナ
ナビゲータ, 52
ニ
「日数の追加」関数, 140
ネ
「年の取得」関数, 141
ノ
ノード
条件の追加, 135
プロセス データ ツリー, 108
マップする, 125, 213
242
ヒ
引き算関数, 142
「日付から文字列に変換」関数, 141
非同期メッセージ, 13
日の取得関数, 141
表示設定
フロー, 82
変更する, 128
[表示] タブ, 82, 85, 96, 128
表示ツールバー, 36
[表示] メニュー, 36
フ
[ファイル] メニュー, 36
ファックス送信アクティビティ テンプレート, 201
フェールオーバ
再試行オプション, 100
実行オプション, 100
メソッドのタイムアウトを設定する, 100
フォルダ
管理, 91
テンプレートからの作成, 168
プロセスを共有する, 38
フォルダにリンク アクティビティ テンプレート, 166
フォルダの作成アクティビティ テンプレート, 162
フォーム
XML での取り込み, 133
アクティビティに追加する, 126
高忠実度フォームを作成する, 134
スキーマ, 133
選択する, 66, 98
追加, 60
パッケージに追加する, 29
プロセスに追加する, 133
プロパティ, 61
複合データ タイプ, 28, 43, 46
複数セグメント フロー, 81
複数タブ表示, 51
複数の実行者が順次実行, 19
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
索引
部分列関数, 142
[プレファレンス] ダイアログ ボックス, 38–41
ブレークポイント, 152
プレースホルダ, 212
プロセス カレンダー, 65, 113
プロセス デバッガ
プロセスのデバッグ, 147
プロセス テンプレート
ACL の設定, 64
Process Analyzer との共有, 37
アンインストールする, 71
アーキテクチャ, 11
印刷する, 78
インストールする, 71
インポートする, 75
エイリアスを追加する, 56–57
エクスポートする, 76
検証する, 70
[高度] タブ, 64
再インポートする, 77
削除する, 75
作成する, 47, 54
状態, 54
ズーム レベルを設定する, 49
説明, 11
チェックアウトする, 72, 74
チェックアウトをキャンセルする, 75
チェックイン, 74
チェックインする, 72
電子メール メッセージを追加する, 58
[データ] タブ, 59
ナビゲータを使用する, 52
バージョン管理を行う, 72
バージョンを指定する, 59
開く, 54
フォームの追加, 60
複数のタブを表示する, 51
プロセス データを追加する, 59
プロセス パラメータの追加, 63
プロセス変数の追加, 61
プロパティの変更, 56
変更する, 72
保存する, 68
メモを追加する, 49
プロセス テンプレート エディタ ペイン
説明, 47
テキスト メモを追加する, 47
プロセス テンプレートの共有, 37
プロセス テンプレートの所有者, 56
プロセス テンプレートをアンインストールする, 71
プロセス テンプレートを印刷する, 78
プロセス テンプレートをインストールする, 71
プロセス テンプレートをエクスポートする, 76
プロセス テンプレートを再インポートする, 77
プロセス テンプレートを保存する, 68
プロセス データ
管理する, 125
説明, 14
定義する, 27
パッケージの定義, 27
プロセス パラメータを定義する, 28
プロセス変数を定義する, 28
ワーク キュー スキル セットにマップする, 110
プロセス データ マッピング アクティビティ
テンプレート, 210
プロセスの起動アクティビティ テンプレート, 163
プロセスのデバッグ
インバウンド初期化アクティビティ, 151
概要, 147
自動ワークフロー メソッド, 154
手動タスク, 153
ポート番号の設定, 38
プロセスのプロパティ
プロセス テンプレート, 56
プロセス パラメータ
概要, 28
管理, 28
管理する, 62
タイプ, 63
定義する, 28
プロセス変数
アクセス権要件, 65
アクセス コントロール リスト, 62
タイプ, 62
定義済み, 14
定義する, 28
フローに追加する, 59
プロセスを共有するフォルダ, 38
プロセスをチェックアウトする, 54
プロセスをデバッグする
アクティビティをステップ オーバーする, 151
環境, 155
強制的にタスクを完了, 153
グラフィック要素, 148
自動アクティビティにステップインする, 152
自動タスク, 153
終了する, 152
手動初期化アクティビティ, 150
[タスク マネージャ] タブ, 152
次のブレークポイントまで続行, 152
停止する, 152
デバッグ セッションを再実行する, 152
ブレークポイントを追加する, 149
ワークフローを開始する, 150
プロセスを表示する, 54
プロパティ
追加する, 22
メッセージに追加する, 132
[プロパティ] タブ, 96–97
プロパティ用フォームの使用, 60
プロンプト
インストールと検証のプロンプトの表示, 40
警告メッセージの表示, 40
フロー
記述, 81
拒絶, 16
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
243
索引
順方向, 15
障害対処, 16
障害対処を追加する, 81
フロー設定, 81
フロー インスペクタ, 81
フロー テンプレート
XSL 変換, 170
親プロセスに対するイベントの通知, 170
結合, 169
決定分岐, 168
サブプロセスの開始, 228
フロー表示設定, 82
分割関数, 141
ユ
優先度
アクティビティ, 23
解決, 24
システムが増加させる方法, 24
実装, 25
初期設定, 23
静的優先度を設定する, 24
動的優先度を設定する, 25
レベルを選択する, 97
優先度モジュール
アクティビティとの関連付け, 100
サンプル, 25
定義済み, 24
ヘ
[編集] メニュー, 36
変数
置換, 161–162, 167, 174, 179, 184, 231
編集, 127
編集する, 127
ページ設定, 78
マ
マッピング データ
わーくきゅーすきるせっとワーク キュー
スキル セット, 110
ワーク キュー スキル セット, 110
ヨ
要素データ タイプ, 46
ラ
ライフサイクルの降格アクティビティ
テンプレート, 164, 224
ライフサイクルの昇格アクティビティ
テンプレート, 224
ライフサイクルの適用アクティビティ
テンプレート, 166, 224
リ
メ
メッセージ
XML スキーマの追加, 133
プロパティ, 132
メッセージ相関
相関識別子, 144
相関セット, 145
メッセージ相関設定フィールド, 144
メッセージ待機アクティビティ, 12–13
メモ インスペクタ, 49
モ
「文字列からバイトに」関数, 141
「文字列を日付に変換」関数, 142
元に戻すフロー, 81
244
[リソース ナビゲータ], 35
リポジトリ エクスプローラ, 90
リポジトリの所有者, 19
レ
列挙, 133
レポート
BAM 定義の更新, 45
監査記録設定の設定, 57
監査記録の設定, 57
構造化データ タイプの公開, 45
サブプロセス, 83
パッケージを公開する, 61, 126
プロセス データの更新, 40
プロセス変数の表示, 28
有効化, 15
連結関数, 140
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
索引
ワ
割り算関数, 141
ワーク キュー, 19
ワーク キュー スキル セット, 110
ワーク キュー優先度モジュール, 100
ワークフロー
概要, 9
計画する, 16
パッケージ, 27
プロセス変数, 28
ワークフロー スーパーバイザ, 18
ワークフロー ツールバー, 36
ワークフローの手順, 57
ワークフローの利用可能性, 21
EMC Documentum Process Builder バージョン 6.6 ユーザ ガイド
245