intra-mart Accel Platform IM-Workflow 管理者操作ガイド 第32版 2024-04-01

3.2. ルート定義を登録・設定する

ルートは、申請から最終承認までの処理の流れを保持します。

ルート定義を利用するフロー定義において、ルートに定義された各ノードの設定を使用することができます。
また、ルート定義は期間情報によって区別された「バージョン」によって管理され、バージョン期間情報によって一部の設定を変えることができます。

注意

フロー定義に設定済みのルート定義の変更
バージョンの作成・編集を行った場合は、当コンテンツを利用しているフロー定義も必ず更新してください。
特に、分岐内に存在するノードを変更(ノードIDを追加・変更・削除)した場合、分岐開始ノードにて、分岐開始方法を見直す必要があります。
また、ルートの特定のノードに対して、一度ノードを削除した後に、 同一のノードID でノードの種類が異なるノードを追加してはいけません。
同一のノードIDに対するノード種類の変更を行った場合、正しく動作しない場合があります。

3.2.1. ルート定義を登録する

  1. 「サイトマップ」→「ワークフロー」→「ワークフロー管理者」→「マスタ定義」→「ルート定義」をクリックします。

  2. 「新規作成」をクリックします。

    ../../_images/basic_guide_2_2.png

    コラム

    ルート定義の検索・表示
    ルート定義の一覧画面では、条件を指定してルート定義を検索し、該当するものだけを表示させることができます。
    画面上部の検索条件指定項目に、検索条件を入力します。
    1. 左のプルダウンから、検索対象としたいルート定義の項目を選択します。
    2. 右のテキストボックスに、検索したい文字列を入力します。
    3. [検索]ボタンを押下します。
    選択した検索対象に対して、入力した文字列が部分一致するルート定義のみを表示します。

    コラム

    ルート定義の編集・削除
    すでに登録されているルートの編集を行う場合は、編集したいルートの行の編集欄に表示されている image_common_34 を押下します。
    <ルート定義­編集>画面に遷移しますので、内容を編集後に[更新]ボタンを押下すると、更新が行われます。
    ルートの削除を行う場合も同様に操作し、遷移先の<ルート定義­編集>画面で、[削除]ボタンを押下します。
  3. 基本情報を入力します。

    • ルートID(必須)

      ルートを識別するIDです。自動採番されます。すでに使用されているものでなければ、任意で変更できます。
    • ルート名(必須)

      登録ルートの名称を入力します。
      システムで設定されている全ロケールに対して、入力します。
    • ルート種類(必須)

      登録ルートの種類を選択します。
      • 通常用

        通常のルートを作成します。
      • テンプレート置換用

        テンプレート置換用ノードに設定するためのルートを作成します。
    • 備考

      ルートの説明等を入力できます。
      システムで設定されている全ロケールに対して、入力できます。
  4. 「登録」をクリックします。

    ../../_images/basic_guide_2_3.png
  5. ルート定義情報を登録することができました。

  6. 「新規作成」をクリックします。

    ../../_images/basic_guide_2_4.png
  7. 基本情報を入力します。
    ../../_images/basic_guide_2_5.png
    • バージョン期間(必須)

      ルート定義のバージョンの有効期間を設定します。
      バージョン期間の終了日は、必須入力ではありません。空欄の場合は無期限(システム終了日)に設定されます。
    • バージョン有効/無効(必須)

      ルート定義のバージョンの有効状態を設定します。
    • 備考

      ルート定義のバージョンの説明等を入力できます。
      システムで設定されている全ロケールに対して、入力できます。

    コラム

    • ルート定義の種類が「テンプレート置換用」の場合、バージョンの「基本情報」は入力しません。「ルート詳細」のみ入力します。

    • バージョンは、期間が重複しなければ、1つのルート定義にいくつでも登録することができます。

    • バージョン期間の設定可能範囲(システム開始日~システム終了日)は、[ワークフローパラメータ]で変更することができます。
      (詳細は、別紙「 IM-Workflow 仕様書 」を参照してください。)
  8. 続けて「ルート詳細を設定する」に進んでください。

3.2.2. ルート詳細を設定する

[ワークフロー]-[ワークフローシステム管理者]-[マスタ定義]-[ルート定義]、<ルート定義­バージョン­編集>画面の「ルート詳細」で行う、ルートの作成について説明します。
ルートは、ルートデザイナ上で簡単に作成・編集することができます。ワークフローの処理の1単位である「ノード」を組み合わせて構成します。
ノードの種類については、「 ノード 」を参照してください。
  1. 「ルート詳細」をクリックします。

    ../../_images/basic_guide_2_8.png
  2. 申請ノードを設定します。(開始ノード、申請ノード、終了ノードがあらかじめ配置されています。)

    グリッド上にある申請の「 image_common_2 アイコン」をダブルクリックします。
    ../../_images/basic_guide_2_9.png
  3. 処理対象者の「検索」をクリックします。
    ../../_images/basic_guide_2_10.png

    コラム

    • image_common_63 <基準日>を押下すると、カレンダーが表示されます。
    • 日付を変更すると、変更した日付の時点で有効な対象者には名称が表示されます。
      無効な対象者の場合は 【基準日時点で無効な対象者】 と表示されます。
    • 基準日は、IM-共通マスタ検索画面の<検索基準日>です。
  4. 検索したい処理対象者欄の image_common_19 アイコンをクリックします。

    ../../_images/basic_guide_2_11.png
  5. IM-共通マスタの検索画面から、処理対象者を設定します。

    ../../_images/basic_guide_2_12.png

    コラム

    IM-Workflow 2018Spring から、処理対象者に「ロジックフロー(ユーザ)」が利用可能になりました。
    利用方法は「 ロジックフローを利用する 」を参照してください。
  6. 承認ノードを追加します。([開始]-[申請]-[承認]-[終了]という単純なルートを作成する場合を例にします。)

    上部に並んでいるアイコンから、 image_common_2 アイコンをグリッド上へドラッグします。
    ../../_images/basic_guide_2_13.png
  7. 承認ノードの内容を設定します。
    申請ノードと同様に、配置した「 image_common_2 アイコン」をダブルクリックし、処理対象者を設定します。
    ../../_images/basic_guide_2_14.png
  8. [申請ノード]と[承認ノード]、[承認ノード]と[終了ノード]を矢印で結びます。
    各ノードにマウスを重ねると、アイコンの右上に image_common_23 が表示されるので、ドラッグ&ドロップで次のノードへ接続します。
    ../../_images/basic_guide_2_15.png

    コラム

    • 接続できないノード同士を接続した場合は矢印が太い赤色で表示され、そのままの状態ではルートを登録できません。矢印をクリックすると緑色の■が表示されますので、どちらか片方をドラッグ&ドロップすると、接続元・先を変更できます。緑色の■が表示されている状態でDeleteキーを押すと、矢印を削除することができます。
    • ノードの配置と接続の組み合わせにはルールがあります。詳しくは、別紙「 IM-Workflow 仕様書 」を参照してください。

  9. 「登録」をクリックします。

    ../../_images/basic_guide_2_16.png
  10. 基本情報、ルート詳細情報を登録することができました。

    ../../_images/basic_guide_2_17.png

以上でルート定義の登録が完了しました。

コラム

グリッド上での便利な操作
  • コピー(複写)、ペースト(貼り付け)、切り取り、削除

    グリッド上の各ノードを右クリックすると、メニューが表示されます。
    メニューから[コピー]を選択すると、対象のノードが一時的に記録されます。
    その状態でグリッド上の何もない場所を右クリックすると[貼り付け]メニューが表示されますので、[貼り付け]を選択することで、先ほど記憶したノードと同じものを配置することができます。
    ../../_images/basic_guide_2_18.png

    ../../_images/basic_guide_2_19.png
    コピー元のノードで設定されていたノードID、位置以外の項目が、コピー先のノードへ転記されますので、再設定が不要です。
    同じような処理を複数配置するルートを作成する場合にコピー&ペーストを行うことで、ルートの作成が容易に行えます。
    ※承認ノードの場合のみ、接続されているノード等の状態に応じて処理対象者がコピーされない場合があります。
    メニューから[切り取り]を選択した場合、選択されていたノードがグリッド上から一時的に削除される動作以外は[コピー]時と同じです。
    ノードはいったん削除されますが、[貼り付け]を選択することでグリッド上にノードが復活します。
    メニューから[削除]を選択した場合は、グリッド上からノードを削除します。
    この場合はノードが記憶されませんので、[貼り付け]操作ができないか、前回[切り取り][コピー]したものが[貼り付け]できます。
    [切り取り]はキーボードの「Ctrl+X」、[コピー]は「Ctrl+C」、[貼り付け]は「Ctrl+V」、[削除]は「Delete」キーを押すことでも同様の作業が行えます。
    ※ブラウザによってはキー入力が効かない場合があります。その際はマウス操作で行ってください。
    ※Macモデルの場合は「Ctrl」の代わりに「Command」を使用できます。
    ※開始ノード、申請ノード、終了ノード([テンプレート置換用]ルートの場合は、テンプレート開始ノード、テンプレート終了ノード)については、ルート1つに対して1つの配置が必須となっているため、これらのノードに対して[切り取り][コピー][削除]操作は行えません。
  • 複数ノードの選択

    グリッド上の何もないところからドラッグを開始すると青色の選択領域が表示されますので、マウスを移動させて任意の矩形範囲でボタンを離すと、囲まれた範囲内にあるノードを一括選択できます。
    例えば、複数のノードをまとめて移動・削除したい場合に便利です。複数のノードを選択した状態で、切り取りやコピーをおこなうこともできます。
    キーボードの「Ctrl」キーを押しながらノードをクリックすることで、選択・非選択の切り替えを行うことができます。

コラム

申請/起票後の処理/確認対象者の変更
案件は案件開始時点のフロー定義、コンテンツ定義、ルート定義を保持します。
そのため、ルート定義の処理/確認対象者を変更しても、申請/起票済み案件の処理/確認対象者には影響を与えません。
申請/起票済み案件の処理/確認対象者を個別で追加・変更したい場合は、案件操作機能を利用してください。
案件操作については、後述の「案件操作」を参照してください。

3.2.2.1. さまざまなルートの作成方法

「ルート詳細を設定する」で使用していないノードの作成方法について説明します。
  • 動的承認

    動的承認ノードをグリッド上にドラッグ&ドロップで配置します。
    [ノードID(必須)][ノード名(必須)][処理対象者(必須)][位置]を設定します。

コラム

IM-Workflowでは申請完了後、分岐に到達した時点にて分岐条件の判定をします。
そのため、分岐ノードの直後に動的承認ノードを配置した場合は、分岐前の処理ノード(申請・承認等)で、分岐先に関係なくすべての分岐先に対して処理対象者を指定する必要があります。
  • システム

    システムノードをグリッド上にドラッグ&ドロップで配置します。
    [ノードID(必須)][ノード名(必須)][位置]を設定します。
    動作させるプログラムはここでは設定せず、フロー定義で設定します。
  • 確認

    確認ノードをグリッド上にドラッグ&ドロップで配置し、確認開始の対象としたいノードから、矢印を接続します。
    接続できるノードは、申請ノード、承認ノード、システムノードです。
    接続したノードの処理が終了した時点で、設定した確認対象者が案件の確認を行うことができます。
    [ノードID(必須)][ノード名(必須)][確認対象者(必須)][位置]を設定します。
  • 同期処理(同期開始・同期終了)

    同期開始ノードをグリッド上にドラッグ&ドロップで配置します。
    同期開始ノードから、同期処理を行いたいノードへ向けて、1対nで矢印を接続します。
    同期終了ノードをグリッド上にドラッグ&ドロップで配置します。
    同期処理を終了させたいノードから、同期終了ノードへ向けて、n対1で矢印を接続します。
    ../../_images/basic_guide_2_20.png
    それぞれ[ノードID(必須)][ノード名(必須)][位置]を設定します。
  • 分岐処理(分岐開始・分岐終了)

    分岐開始ノードをグリッド上にドラッグ&ドロップで配置します。
    分岐開始ノードから、分岐処理を行いたいノードへ向けて、矢印を接続します。
    また、直接分岐終了ノードへ接続することもできます。
    分岐終了ノードをグリッド上にドラッグ&ドロップで配置します。
    分岐処理を終了させたいノードから、分岐終了ノードへ向けて、矢印を接続します。
    ../../_images/basic_guide_2_21.png
    それぞれ[ノードID(必須)][ノード名(必須)][位置]を設定します。
    前処理者が進めるルートを選択できるようなフローを作成したい場合も、この分岐処理を使用します。
    分岐条件等はここでは設定せず、フロー定義で設定します。
  • 横配置

    横配置ノードをグリッド上にドラッグ&ドロップで配置します。
    [ノードID(必須)][ノード名(必須)][処理対象者(必須)][位置]を設定します。
    割当可能ノード数や詳細なノード設定が可能な前処理ノード等はここでは設定せず、フロー定義で設定します。
  • 縦配置

    縦配置ノードをグリッド上にドラッグ&ドロップで配置します。
    [ノードID(必須)][ノード名(必須)][処理対象者(必須)][位置]を設定します。
    割当可能ノード数や詳細なノード設定が可能な前処理ノード等はここでは設定せず、フロー定義で設定します。
  • テンプレート置換

    テンプレート置換ノードをグリッド上にドラッグ&ドロップで配置します。
    ただし、テンプレート置換用ルートに配置することはできません。
    [ノードID(必須)][ノード名(必須)][置換ルート(必須)][位置]を設定します。
    [置換ルート]項目には、ルート定義で作成したテンプレート置換用ルートを指定します。
    ../../_images/basic_guide_2_22.png
    image_common_19 <検索>を押下すると、<ルート定義‐検索>画面がポップアップ表示されますので、あらかじめ作成しておいたテンプレート置換用のルート定義を選択します。
  • コメント

    ルート上にコメントを表示させたい場合に使用します。
    グリッド上にドラッグ&ドロップで配置します。
    [コメント名(内容)][位置][サイズ]を設定します。
    [サイズ]は、コメントの四隅をドラッグすることでも設定できます。
    コメント上に表示される[+]から、コメントを紐付けたいノードへ矢印を接続できます。
    また、特定のノードに紐付けず、単独で配置することもできます。
  • スイムレーン

    ルート上の複数のノードを分類し、整理する際に利用します。
    グリッド上にドラッグ&ドロップで配置します。
    [スイムレーン名][位置][サイズ]を設定します。
    [サイズ]は、スイムレーンの四隅をドラッグすることでも設定できます。

コラム

ひとつのルートに配置できるノードの数に上限はありませんが、極端にノード数が多いと申請・承認時の処理で時間がかかることがあります。配置するノードはなるべく少なくなるよう構成してください。

コラム

グリッドのサイズ変更
「ワークフローパラメータ」で設定ファイルを編集することで、ルートの編集を行うルート定義デザイン領域のサイズを変更することができます。
初期設定では、幅[10000]高さ[5000]に設定されています。
※さらに大きなサイズを指定することはできますが、メモリを多く消費することがあります。メモリが不足するとルートの画像ファイルをダウンロードできない場合があります。
※[ワークフローパラメータ]についての詳細は、別紙「 IM-Workflow 仕様書 」を参照してください。

3.2.3. ルート定義の利用状況を確認する

編集中のルート定義が現在どのフロー定義で利用されているかを確認することができます。
  1. <ルート定義­編集>画面で、 image_common_35 <利用状況確認>を押下します。

    ../../_images/route_usage_situation_1.png
  2. <ルート定義­利用状況確認>画面がポップアップ表示されます。

    ../../_images/route_usage_situation_2.png
  3. ルートの基本情報と、現在このルートを利用しているフロー定義が一覧表示されます。

    ../../_images/route_usage_situation_3.png

3.2.4. ルート定義のコピーを利用する

ルート定義をコピーすることで、コピー元のバージョン情報を保持した、新たなルート定義を作成することができます。
  1. <ルート定義­バージョン­編集>画面で、画面上部に表示される image_common_36 <ルートコピー>を押下すると、<ルート定義­コピー>画面に遷移します。

    ../../_images/route_copy_1.png
  2. 新規に作成するコピー先のルート定義の基本情報、および、バージョンの期間情報を入力します。

    ../../_images/route_copy_2.png
  3. [登録]ボタンを押下します。

    ../../_images/route_copy_3.png
コピー元のコンテンツ定義のバージョンの、「ルート詳細」の情報が同一のバージョンを1つ保持したルート定義が、指定したバージョン期間で新たに作成されます。
※作成したルート定義に登録されるバージョンは1つです。
コピー元のルート定義に登録されている、その他のバージョンはコピーされません。

3.2.5. ルート定義のバージョンのコピーを利用する

バージョンをコピーすることで、コピー元のバージョンの情報を保持した新たなバージョンを、同一ルート定義内に作成することができます。
  1. <ルート定義­バージョン­編集>画面で、画面上部に表示される image_common_36 <バージョンコピー>を押下すると、<ルート定義­バージョン­コピー>画面に遷移します。
    ../../_images/route_version_copy_1.png
  2. 新規に作成するコピー先のバージョンの期間情報を入力します。
    ../../_images/route_version_copy_2.png
  3. 画面の中ほどに、バージョン期間表が表示されます。
    ../../_images/route_version_copy_3.png
    同じルート定義に登録されている全てのバージョンの期間が示された表です。
    システム期間の範囲が表示され、以下の色分けで表示されます。
       
    コピー元のバージョンの期間です。
    同じルート定義に登録されているバージョンの期間で、バージョン有効/無効設定が「有効」である期間です。
    灰色 同じルート定義に登録されているバージョンの期間で、バージョン有効/無効設定が「無効」である期間です。
    同じルート定義でバージョンが定義されていない期間です。
    コピー元以外の期間に表示される image_common_42 <この期間にコピー>を押下すると、その期間がコピー先のバージョンのバージョン期間として入力されます。
  4. [登録]ボタンを押下します。
    ../../_images/route_version_copy_4.png
コピー元バージョンの、「ルート詳細」の情報が、指定したバージョン期間で新たに作成されます。
※指定した期間に、既存のバージョンの期間の全て、または一部が含まれている場合、コピー先バージョンの期間が最優先で上書きされ、既存バージョンは消去、または期間が変更されます。

コラム

個別設定のコピー
バージョンコピーを行うとバージョンが新たに作成されるため、新規バージョン期間内のフロー定義は初期設定の状態です。
個別設定のコピーを有効にすることで、コピー元バージョン期間内のフロー定義の個別設定を新規バージョン期間内のフロー定義の個別設定として利用できます。
初期設定と個別設定の詳細は、「 IM-Workflow 仕様書 」の「 フローの初期設定と個別設定 」を参照してください。
  • ルート定義をIDで結びつけた全フロー定義が対象です。
  • コピー元バージョン期間内にコンテンツ定義とフロー定義のバージョンの組み合わせが複数存在する場合、最新バージョンの組み合わせの個別設定がコピー対象です。
  • コピー先バージョン期間内に存在するコンテンツ定義とフロー定義のバージョンの全ての組み合わせに対してコピーします。
  • コンテンツ定義とフロー定義のバージョンに「システム無効」属性が存在する組み合わせは、対象外です。
    「システム無効」属性の詳細は、「 IM-Workflow 仕様書 」の「 バージョン 」を参照してください。
個別設定のコピーは IM-Workflow 2018 Summer から利用可能です。