変数とは、ワークフロー全体で繰り返し使用できる特定の値のプレースホルダーです。変数を使用すると、さまざまな入力や条件に基づいて動的な調整が可能になります。
ドキュメントワークフローでは、ドキュメントのインデックスデータの値を使用する必要がある場面が多くあります。たとえば、変数に現在の日時を格納し、ドキュメントへのタイムスタンプ付与や自動アクションのスケジュール設定など、ワークフロー全体で参照できます。
ワークフローでは、グローバル変数とシステム変数の両方を使用できます。グローバル変数はユーザーが定義し、システム変数はあらかじめ設定されています。
グローバル変数
グローバル変数は、1つのワークフロー内の複数のアクティビティで使用できる特定の値のプレースホルダーです。
例：請求書のワークフロータスクフォームで顧客番号が入力されると、外部データベースから顧客名が取得され、ワークフローのグローバル変数に格納されます。この名前は、別のワークフローステップで使用できます。グローバル変数は、Web Clientのタスクリストにも表示できます。
グローバル変数の作成
ワークフローキャンバスに移動し、左側のサイドバーにある変数アイコンをクリックします。
識別用の一意の名前を入力します（例：「MyOrderNumber」）。
ドロップダウンリストから変数の型を選択します。
テキスト：最大長は255文字です。
整数または小数：小数の場合は、小数点以下の桁数を指定します。
日付または日時：日付型の変数に使用します。
キーワード：キーワード変数には複数の値を格納できます（例：複数の注文番号）。
ただし、割り当て時にこの変数から個別の値を選択することはできません。これは、リスト変数として使用できるユーザー、ロール、代理ルールとは異なります。ユーザー、ロール、代理ルール：これらはリスト変数です。1つ以上の値を格納できます。
リスト変数オプションを使用すると、後のステップでそれぞれのリストから個々のユーザーを選択できます。
変数の編集
変数がすでにワークフローで使用されている場合でも、変数リストで変数の名前を編集できます。ただし、型は変更できません。事前に設定から変数を削除する必要はありません。
変数名を変更すると、データの割り当てのフリーSQLコマンドを含め、ワークフロー内で使用されているすべての箇所で自動的に更新されます。
ハイフンは内部的にダブルアンダースコアとして保存されます。選択時には、グローバル変数はリスト上でダブルアンダースコア付きで表示されます。
システム変数
システム変数は、変数の種類に応じてDocuWareシステムによって自動的に設定および更新されるパラメータです。
例：
「最終判定ユーザー」は、自動的に最後に判定を行ったユーザーになります。この変数は更新されます。
一方、「ドキュメントURL」や「組織GUID」は変更されないシステム変数です。
システム変数の一覧：
システム変数 | 説明 |
Workflow name | 新規ワークフローの作成 > 全般ダイアログで指定されたワークフロー名が含まれます |
Start date/time | ワークフローインスタンスが開始された日時が含まれます |
Activity | 現在のアクティビティの名前が含まれます |
Assigned | タスクが割り当てられたユーザー、ロール、または代理ルールの名前が含まれます |
Last error activity | エラーが発生したアクティビティの名前が含まれます |
Last decision user | 最後に判定を行ったユーザーが含まれます |
Last error message | エラーの種類が含まれます |
Current user | 最後にDocuWare Clientでタスクを編集したユーザー、つまり最新のアクティブユーザーが含まれます |
Task user | 現在DocuWare Clientでタスクを編集しているユーザー、つまり現在のアクティブユーザーが含まれます |
Received on | 現在のタスクが担当者のタスクリストに追加された日付が含まれます |
Reminder date | 現在のタスクに対して指定されたリマインダー設定の日時が含まれます |
Pending date | 現在のタスクに対して指定された保留設定の日時が含まれます |
Current date | 現在の日付と時刻が含まれます |
FAQ
条件内で変数を比較するには？
条件内で変数を比較する際は、以下の点に注意してください。変数の比較には、=、>=、>、<、<= の演算子を使用できます。
日付変数
固定の日付値と変数を比較する場合、日付は以下のいずれかの表記で定義する必要があります。
cdate("YYYY/MM/DD")
cdate("YYYY-MM-DD")
cdate("YYYY.MM.DD")
数値変数
数値変数を比較する場合、すべての変数の小数点以下の桁数が同じである必要があります。小数点以下の桁数が異なる2つの変数を比較するには、データの割り当てで別の変数を使用して、桁数を揃える必要があります。
例：
小数点以下の桁数が異なる変数1と変数2を比較する場合を考えます。
1. 以下が設定されています。
変数1（小数点以下0桁）
変数2（小数点以下2桁）
変数3（小数点以下0桁）
2. データの割り当てアクティビティ：
変数3 = 変数2×100
3. 結果：
変数1と変数3の小数点以下の桁数が同じになり、条件内で互いに比較できるようになりました。