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

4.4.3. 入力チェックを利用したフォームを作成する

アイテムに入力チェックを利用することで、項目の入力内容が条件を満たさない場合は申請できないフォームを作成する方法を解説します。
このチュートリアルでは「研修受講報告書」フォームの入力アイテムに、入力チェックの「必須入力チェック」「最大入力文字数」「半角英数字のみ」を設定します。
ワークフローを作成・編集するユーザのロールには「Accel-Mart Quick ワークフロー管理者」を設定する必要があります。
../../../_images/check_the_input_1.png
図:作成するフォーム

コラム

ユーザへのロールの設定方法は以下を参照してください。

4.4.3.1. 想定されるユースケース

申請時や承認時に必ず入力してほしい項目がある場合などにご使用いただけます。
また、文字種の指定や文字数の制限など、入力フォームに所定の方式を設定したい場合などにもご使用いただけます。

4.4.3.2. 事前準備

このチュートリアルでは、「テンプレートを利用せずに簡単なフォームを作成する」で作成した「研修受講報告書」のアイテムに「必須入力チェック」を設定し、追加した入力アイテムに「半角英数字のみ」「最大入力文字数」を設定する例を説明します。
予め「テンプレートを利用せずに簡単なフォームを作成する」の内容を実施するか、任意のルート定義・フォームを作成してください。

4.4.3.3. 作成済みのフォームを編集する

事前に作成した「【チュートリアル】研修報告フロー」の「研修受講報告書」を編集します。
  1. メニューの「管理」→「ノーコード開発」→「ワークフロー設定」から、「IM-BIS-更新履歴」画面を表示します。

  2. 画面左上の「一覧」をクリックして、「IM-BIS-一覧」画面を表示します。

  3. 「【チュートリアル】研修報告フロー」の pencil_icon をクリックします。

    ../../../_images/alter_appearance_3.png
    図:「IM-BIS-一覧」
  4. 「IM-BIS-フロー編集」画面が開きます。

  5. 「申請者」ノードをダブルクリックして、「フォーム編集」画面を表示します。

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

4.4.3.3.1. アイテムを追加する

  1. 「研修名」の上に「研修コード」を配置するため、「受講報告」の位置を上にずらします。

  2. 「ツールキット」をクリックし、「入力アイテム」から「文字列」を配置します。

  3. 追加した「文字列」をダブルクリックして「プロパティ」を表示します。

  4. 「ラベル」に「研修コード」と入力します。

    ../../../_images/check_the_input_5.png
    図:「研修コード」の配置

4.4.3.3.2. アイテムに入力チェックを設定する

「入力チェック」のうち、「半角英数字のみ」「最大入力文字数」「必須入力チェック」を設定します。
  1. 「研修コード」をダブルクリックして、「プロパティ」を表示します。

  2. 「入力チェック」をクリックします。

    コラム

    • 入力チェック

      画面アイテムで利用する入力チェックを設定します。
      「入力アイテム」と「共通マスタアイテム」に対して設定できます。
  3. 「半角英数字のみ」のチェックボックスを有効にします。

  4. 「最大入力文字数」に「10」と入力します。

    ../../../_images/check_the_input_2.png
    図:「研修コード」-「プロパティ」-「基本設定」
  5. 「詳細設定」タブをクリックします。

  6. 「フィールド識別名」に「研修コード」と入力します。

    コラム

    入力チェックでエラーになった際、エラーの理由がメッセージとして表示されます。
    このときメッセージには「フィールド識別名」が使用されます。
  7. 同様の手順で「受講内容」の「プロパティ」を表示して、「必須入力チェック」のチェックボックスを有効にします。

    ../../../_images/check_the_input_3.png
    図:「受講内容」-「プロパティ」-「基本設定」

    コラム

    • 必須入力チェック
    チェックボックスを有効にすると、入力必須項目としてチェックされます。

    コラム

    • 一時保存時の入力チェック設定
    入力チェックを設定した場合、「ボタン(一時保存モーダル)」の「プロパティ」で入力チェックを行うかどうかを選択できます。
    「ボタン(処理モーダル)」の「プロパティ」では選択できません。
    ../../../_images/check_the_input_6.png
    図:「ボタン(一時保存モーダル)」-「プロパティ」-「基本設定」

    注意

    設定できるチェックの種類はアイテムによって異なります。
    アイテムごとの詳細は、「ツールキットで利用できるアイテム(ワークフロー)」か各アイテムの「プロパティ」の help_icon から参照してください。
  8. 「詳細設定」タブをクリックし、「フィールド識別名」に「受講内容」と入力します。

  9. 「更新」をクリックして、フォームの内容を保存します。

    ../../../_images/training_attendance_report_11.png
    図:フォームの保存
  10. 「フォーム編集」画面を閉じて、「IM-BIS-フロー編集」画面に戻ります。

  11. 最後に「定義の反映」をクリックしたら、ワークフローは完成です。

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

注意

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

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

作成したワークフローを実際に申請し、「研修コード」や「受講内容」に対して入力チェックが行われることを確認します。
  1. メニューの「申請」から、「申請一覧」画面を表示します。

  2. 「【チュートリアル】研修報告フロー」を選択します。

  3. 「研修コード」が11文字以上入力できないことを確認します。

  4. 「研修コード」を半角英数字以外で入力したり「受講内容」を入力しない場合、エラーになり申請できないことを確認します。

    ../../../_images/check_the_input_4.png
    図:「研修受講報告書」
  5. 申請内容を全て正しく記載後、「申請」ボタンをクリックして申請します。