Accel-Mart Quick チュートリアルガイド 第14版 2023-02-08

6.3. ワークフローでWebデータベースのデータを参照する

Webデータベース機能で登録したデータはワークフローのフォームで利用できます。
このチュートリアルでは、作成済みのWebデータベースのデータを参照するワークフローの作成手順を解説します。
例として「Webデータベースを作成する」で作られるWebデータベースを使用します。

6.3.1. ワークフローを作成する

Webデータベースのデータを参照するワークフローを作成します。

6.3.1.1. ワークフローの名前を登録する

作成するワークフローの名前を登録します。
ここで登録した名前は、申請するフローを選択する画面で表示されます。
  1. メニューの「管理」→「ノーコード開発」→「ワークフロー設定」から、「IM-BIS-更新履歴」画面を表示します。

  2. 「新規登録」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_1.png
    図:「IM-BIS-更新履歴」
  3. 「IM-BIS-新規登録」画面が開かれるので、ルート作成方法に「新規にルートを作成する」を選択します。

  4. BIS名に「【チュートリアル】備品購入申請フロー」を入力します。

  5. 「登録」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_2.png
    図:「IM-BIS-新規登録」
  6. 「ルート定義 - バージョン - 新規作成」画面が開かれます。

6.3.1.2. ルート定義を設定する

ルート定義を設定します。
ルートとはワークフローを申請する際に通る経路のことをいいます。
  1. 一番左の「承認」アイコンを図のようにドラッグ&ドロップで配置します。

    ../../../_images/use_data_in_workflow_3.png
    図:ノードの配置方法
  2. 配置した各アイコン同士を接続するために、アイコンの右上にマウスを重ねて「+(プラス)」を表示します。

  3. 「+(プラス)」から次の「承認」までドラッグして、アイコン同士を図のように接続します。

    ../../../_images/use_data_in_workflow_4.png
    図:ノードの接続方法
  4. 「申請」アイコンをクリックします。

  5. 「ノード名」に「申請者」と入力します。

  6. 入力後にフォーカスアウトすると、ルート図上の名称の表示が変わることが確認できます。

  7. 「申請者」の「処理対象者」の下にある「検索」をクリックします。

  8. ロールの虫眼鏡アイコンをクリックします。

    ../../../_images/use_data_in_workflow_5.png
    図:処理対象者の設定方法
  9. 「ロール検索」画面が開かれるので、「検索」ボタンをクリックしてロールを表示します。

  10. 「Accel-Mart Quick 利用者」を選択して、「決定」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_6.png
    図:「ロール検索」
  11. これで、「Accel-Mart Quick 利用者」がこのフローを申請できるようになりました。

  12. 同様の手順で、「承認」をクリックして、ノード名を「承認者」に変更します。

  13. 「承認者」の「処理対象者」に「Accel-Mart Quick 利用者」を設定します。

  14. これで、「Accel-Mart Quick 利用者」がこのフローを承認できるようになりました。

  15. 「登録」ボタンをクリックして、ルート定義を登録します。

    ../../../_images/use_data_in_workflow_7.png
    図:「ルート定義 - バージョン - 新規作成」
  16. 「IM-BIS-フロー編集」画面が開かれます。

    ../../../_images/use_data_in_workflow_8.png
    図:「IM-BIS-フロー編集」

    コラム

    • 処理対象者
    申請経路(ルート)で申請や承認を行えるユーザの条件を表します。
    このチュートリアルでは、ロールを指定していますが、組織や役職、申請者の所属組織の役職など複雑な条件を指定できます。

6.3.1.3. 申請フォームを作成する

「申請者」で申請するための画面を設定します。
  1. 「申請者」アイコンをダブルクリックして、「フォーム-登録」画面を表示します。

  2. フォーム名に「備品購入申請書フォーム」と入力し、「登録」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_9.png
    図:「フォーム-登録」
  3. 「フォーム編集」画面が開かれます。

6.3.1.4. ツールキットのアイテムを配置する

ツールキットのアイテムを利用して、画面で表示されるタイトルや入力項目を設定します。
  1. 「ツールキット」をクリックし、配置できるアイテムの一覧を表示します。

    ../../../_images/use_data_in_workflow_10.png
    図:「ツールキット」

    コラム

    • ツールキット
    作成する画面の項目となる部品を格納したパレットです。
    画面のすべての項目はこのツールキットというパレットからドラッグ&ドロップで配置します。
    利用できるアイテムの詳細は「ツールキットで利用できるアイテム(ワークフロー)」を参照してください。
  2. 「表示アイテム」から「見出し」を選択し、ドラッグ&ドロップで配置します。

    ../../../_images/use_data_in_workflow_11.png
    図:表示アイテムの配置
  3. 同様に「データ連携アイテム」から「一覧選択」、「入力アイテム」から「数値」「関数」「セレクトボックス」を図のように配置します。

    ../../../_images/use_data_in_workflow_12.png
    図:データ連携アイテム、および、入力アイテムの配置

    コラム

    • データ連携アイテム
    Webデータベースのデータを参照する際に使用するアイテムです。
    今回使用した「一覧選択」以外に、以下のアイテムがあります。
    • 明細テーブル
    • チェックボックス
    • ラジオボタン
    • セレクトボックス
    • リストボックス
    利用できるアイテムの詳細は「ツールキットで利用できるアイテム(ワークフロー)」を参照してください。
  4. 同様に「ボタンアイテム」から「ボタン(処理モーダル)」「戻る」を配置します。

    ../../../_images/use_data_in_workflow_13.png
    図:ボタンアイテムの配置
  5. 画面で表示されるタイトルや入力項目を配置できました。

6.3.1.5. アイテムのプロパティを設定する

配置したアイテムの見た目、および、入力時に使われる項目を設定します。
  1. 「見出し」をダブルクリックし、「プロパティ」を表示します。

  2. 「ラベル」に「備品購入情報」と入力します。

    ../../../_images/use_data_in_workflow_14.png
    図:「見出し」-「プロパティ」
  3. 「プロパティ」の外側をクリックしてアイテムの「プロパティ」を閉じます。

  4. 同様の手順で配置したアイテムの「ラベル」を図のように入力します。

    ../../../_images/use_data_in_workflow_15.png
    図:画面の項目のラベル
  5. 配置したアイテムの見た目を設定できました。

  6. 次にフォーム入力時に使われる項目を設定します。「購入可否」をダブルクリックし、「プロパティ」を表示します。

  7. 「基本設定」タブの「先頭に空白行を挿入」からチェックを外します。

  8. 「入力チェック」-「必須入力チェック」にチェックを入れます。

    ../../../_images/use_data_in_workflow_41.png
    図:「プロパティ」-「基本設定」
  9. 「データの定義」タブで以下の通り表示値と送信値を設定します。

    ../../../_images/use_data_in_workflow_42.png
    図:「プロパティ」-「データの定義」
  10. 「詳細設定」タブの「フィールド識別ID」に「propriety」と入力します。

  11. 「フィールド識別名」に「購入可否」と入力します。

    ../../../_images/use_data_in_workflow_43.png
    図:「プロパティ」-「詳細設定」
  12. 同様に各アイテムのプロパティを以下の通り設定します。

    アイテム タブ 設定項目 設定値
    単価 基本設定 [後]ラベル
        入力チェック - 必須入力チェック チェックを入れます
      詳細設定 フィールド識別ID price
        フィールド識別名 単価
    数量 基本設定 [後]ラベル
        入力チェック - 必須入力チェック チェックを入れます
      詳細設定 フィールド識別ID quantity
        フィールド識別名 数量
    合計 基本設定 [後]ラベル
        quantity * price
        入力チェック - 必須入力チェック チェックを入れます
        最大入力値 99999999
      詳細設定 フィールド識別ID sum
        フィールド識別名 合計
    購入可否 基本設定 先頭に空白行を挿入 チェックを外します
        入力チェック - 必須入力チェック チェックを入れます
      データの定義 表示値 - 送信値 可 - 1
          不可 - 0
      詳細設定 フィールド識別ID propriety
        フィールド識別名 購入可否
  13. データ連携アイテムである「備品名」からデータベースに登録されたデータを取得します。
    「備品名」の「プロパティ」-「データソース」を表示します。
  14. 「値の取得元を選択してください」の虫眼鏡アイコンをクリックします。

    ../../../_images/use_data_in_workflow_16.png
    図:「備品名」-「プロパティ」
  15. 「クエリ一覧」画面左上の「登録」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_17.png
    図:「クエリ一覧」
  16. 登録するクエリは、フォーム画面で選択した購入可否の値に応じて、備品選択時に表示する一覧を取得します。
    「クエリ名」に「購入可否に応じた備品情報を取得」と入力します。
  17. 「登録」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_18.png
    図:「クエリ登録」
  18. 「クエリ詳細編集」画面で「クエリビルダを開く」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_19.png
    図:「クエリ詳細編集」
  19. 「データを取得するテーブル」で「備品管理」を選択します。

    ../../../_images/use_data_in_workflow_20.png
    図:「クエリビルダ」
  20. 「取得対象」の「追加」ボタンをクリックします。

  21. 「カラム」で「備品名」を選択します。

    ../../../_images/use_data_in_workflow_21.png
    図:「クエリビルダ」-「取得対象」
  22. 同様に、「取得対象」の「カラム」に「単価」、および、「備考」を追加します。

    ../../../_images/use_data_in_workflow_22.png
    図:「クエリビルダ」-「取得対象」
  23. 「条件」の「追加」ボタンをクリックします。

  24. 「カラム」で「購入可否」を選択します。

  25. 「条件」で「完全一致」を選択します。

  26. 「条件値」の「変数値にする」にチェックを入れます。

    ../../../_images/use_data_in_workflow_23.png
    図:「クエリビルダ」-「条件」
  27. 「SQL生成」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_24.png
    図:「クエリビルダ」-「SQL生成」
  28. 「クエリ詳細編集」画面で「テスト実行値」に「1」を入力します。

  29. 「テスト実行」ボタンをクリックします。

  30. 登録済みのデータが取得されることを確認できたら、「登録」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_25.png
    図:「クエリビルダ」-「テスト実行」-「登録」
  31. 「クエリ一覧」画面を閉じます。

    ../../../_images/use_data_in_workflow_26.png
    図:「クエリ一覧」
  32. 「クエリ一覧」で登録したクエリをクリックし、「データソース名」に反映します。

    ../../../_images/use_data_in_workflow_27.png
    図:「クエリ一覧」
  33. 「パラメータ設定」で「購入可否」のフィールド識別ID「propriety」を入力し、「購入可否」の送信値がパラメータとして使われるようにします。

    コラム

    パラメータ設定に固定値を設定し、常に同じ結果を得ることもできます。
    以下の場合、常に「1」というパラメータが使われます。
    ../../../_images/use_data_in_workflow_40.png
    図:「プロパティ」-「データソース」

    注意

    「パラメータ設定」で固定値を使用する場合、値の前後にダブルクォーテーションを追加する必要があります。
  34. 「取得値設定」で「備品名」を選択します。

  35. 「単価」に「単価(price)」を設定します。

    ../../../_images/use_data_in_workflow_28.png
    図:「プロパティ」-「データソース」

    コラム

    取得値設定のラベルは、選択したデータソースから取得されるデータの項目です。
    このチュートリアルでは、クエリビルダで取得対象として設定した「備品名」、「単価」、「備考」が表示されます。
    ラベル右側のプルダウンで、取得した値を表示させるフォーム内アイテムを選択できます。
    このチュートリアルでは、「備品名」に設定したクエリで取得されたデータのうち、選択されたデータの「単価」をフォーム上の「単価」に反映します。
  36. 最後に「更新」をクリックして、フォームの設定内容を保存します。

    ../../../_images/use_data_in_workflow_31.png
    図:フォームの保存
  37. 画面を閉じます。

  38. これで、入力フォームを作成できました。

6.3.1.6. 申請画面の画面設定を他の画面と共有する

ここまでの手順で作成した画面を、「承認者」の承認時にも参照できるように設定します。
画面はノードごとに異なる内容を設定できますが、「共有」することで申請する際に入力した内容を保持した画面を承認する際に表示できます。
  1. 「申請者」アイコンを右クリックして、「共有」をクリックします。

    ../../../_images/use_data_in_workflow_32.png
    図:「IM-BIS-フロー編集」
  2. 「承認者」アイコンを右クリックして、「貼り付け」をクリックします。

    ../../../_images/use_data_in_workflow_33.png
    図:「IM-BIS-フロー編集」

    コラム

    • 共有

      フローで同じ画面を申請や承認などで共通して設定するための機能です。
      この機能で設定された画面は共通の内容となるため、1つのノードで変更した内容は、共有を設定した他のノードにも反映されます。
  3. 最後に「定義の反映」をクリックしたら、ワークフローは完成です。

    ../../../_images/use_data_in_workflow_34.png
    図:「IM-BIS-フロー編集」

注意

  • 定義の反映
フローの作成の最後に必要な処理を実行します。
この処理を行わないと、申請や承認したときにエラーが発生する場合があります。
また、作成後に変更した場合も必ず最後に「定義の反映」を実行するようにしてください。

6.3.2. ワークフローを申請する

作成したワークフローの申請画面で、Webデータベースのデータを参照できることを確認します。
  1. メニューの「申請」から、「申請一覧」画面を表示します。

  2. 「【チュートリアル】備品購入申請フロー」を選択します。

  3. 「備品購入申請書」画面が表示されます。

  4. 「備品名」の虫眼鏡アイコンをクリックします。

    ../../../_images/use_data_in_workflow_35.png
    図:「備品購入申請書」
  5. Webデータベースに登録した備品から、購入可能な備品一覧が表示されます。

    ../../../_images/use_data_in_workflow_36.png
    図:「備品購入申請書」
  6. 入力したい備品をクリックすると、フォームに備品名と単価が反映されます。

    ../../../_images/use_data_in_workflow_37.png
    図:「備品購入申請書」
  7. 「数量」に任意の値を入力します。

  8. 「申請」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_38.png
    図:「備品購入申請書」
  9. 「【チュートリアル】備品購入申請フロー-申請者」ダイアログが開かれるので、「申請」ボタンをクリックします。

    ../../../_images/use_data_in_workflow_39.png
    図:「備品購入申請書」
  10. ワークフローが申請され、処理が開始されます。

  11. このように、ワークフローの申請画面でWebデータベースのデータを参照できます。