How To

汎用フォームを活用する

こちらではシナリオ作成時に様々なスタイルや入力形式のフォームの追加方法を説明します。

本機能の利用は主に ecforce の「カスタム項目」機能との連携を推奨してます。詳しくはこちらをご確認ください。

当記事では例として、お届け日の指定 (delivery) シナリオに「通信欄」メッセージを設置しているプロファイルで、「通信欄」フォームの後に年月日が入力可能なフォームを追加する方法を説明します。プロファイルの作成に関しては、こちらをご参考ください。

  1. プロファイルの編集画面を開き、左のシナリオフローから「delivery(お届け日の指定)」シナリオを押下します。中央に表示されたメッセージの中から「通信欄」を押下して展開します。
    ※ 標準のフォーマットの delivery(お届け日の指定)シナリオには「通信欄」メッセージは入っていません。通信欄が無い場合は、「メッセージ」横の「+」から「その他 > 通信欄 ( remark )」を選択して追加してください。通信欄メッセージを展開
  2. 「通信欄」の中の「フォーム」右の「+」を押下し、追加メニューから「汎用フォーム > 日付の入力欄 (date) フォーム」を選択します。汎用フォームの追加メニュー
  3. 追加した「日付の入力欄 (date) フォーム」の位置を調整します。
    追加したフォームはリストの先頭に入ります。フォームの右側にある「下へ」アイコン(または左端のつまみのドラッグ)で、「通信欄」フォームの下へ移動してください。下へアイコンで位置を調整 通信欄の後に移動した日付の入力欄フォーム
  4. 追加した「日付の入力欄 (date) フォーム」を押下して展開し、「ラベル」をお客様に見せる項目名(例:ご希望日)に変更してください。
    追加した直後の「デフォルト値」は空欄です。初期表示したい日付がある場合は「デフォルト値」に入力してください。
  5. 続けて、同じフォームの「シナリオ更新時イベント (JS)」の欄を確認します。
    日付の入力欄など、入力用の汎用フォームには、カスタム項目と連携するスクリプトがあらかじめ入っています。欄の右上の鍵アイコンでロックを解除して編集してください。シナリオ更新時イベント (JS) の欄
    スクリプトが入っていない場合は、以下のスクリプト(あらかじめ入っているスクリプトと同じ内容です)を貼り付けます。
    async ({ form, forms, settings, functions }) => {
      // カスタム項目用のフォーム連携スクリプト
      const free_column_category = xx // [必須] カスタム項目のカテゴリ
      const free_column_item = xx // [必須] カスタム項目
    
      let $target = null
      switch (form.element) {
        case 'radio':
          $target = $(`#new-view #order_free_columns_${free_column_category}_0_${free_column_item}_${forms[form.key]}`)
          if (!$target.prop("checked")) $target.click()
          break
        case 'checkbox_multi': {
          $target = $(`#new-view input[name="order[free_columns][${free_column_category}][0][${free_column_item}][]"]`)
          const selectedValues = Array.isArray(forms[form.key]) ? forms[form.key] : [forms[form.key]]
          $target.each(function () {
            const isSelected = selectedValues.includes($(this).val())
            if ($(this).prop("checked") !== isSelected) $(this).click()
          })
          break
        }
        default:
          $target = $(`#new-view #order_free_columns_${free_column_category}_0_${free_column_item}`)
          if ($target.val() != forms[form.key]) $target.val(forms[form.key]).change()
      }
    }
  6. スクリプトの「const free_column_category = xx // [必須] カスタム項目のカテゴリ」には対応させたいカスタム項目のカテゴリIDを、
    「const free_column_item = xx // [必須] カスタム項目」にはカスタム項目IDを「xx」の箇所に入力してください。
    (あらかじめ入っているスクリプトでは「xx」の箇所が「1」になっています)
  7. 編集が完了したら、画面右上の「保存」で保存し、ビルドを実行してください。メモ欄と保存ボタン ビルド & デプロイ
    ビルドの方法はこちらをご確認ください。

※表示イメージスクリーンショット 2024-06-03 12.06.45.png

この記事の目次

このセクションの記事

How To