How To
汎用フォームを活用する
こちらではシナリオ作成時に様々なスタイルや入力形式のフォームの追加方法を説明します。
本機能の利用は主に ecforce の「カスタム項目」機能との連携を推奨してます。詳しくはこちらをご確認ください。
当記事では例として、お届け日の指定 (delivery) シナリオに「通信欄」メッセージを設置しているプロファイルで、「通信欄」フォームの後に年月日が入力可能なフォームを追加する方法を説明します。プロファイルの作成に関しては、こちらをご参考ください。
- プロファイルの編集画面を開き、左のシナリオフローから「delivery(お届け日の指定)」シナリオを押下します。中央に表示されたメッセージの中から「通信欄」を押下して展開します。
※ 標準のフォーマットの delivery(お届け日の指定)シナリオには「通信欄」メッセージは入っていません。通信欄が無い場合は、「メッセージ」横の「+」から「その他 > 通信欄 ( remark )」を選択して追加してください。 - 「通信欄」の中の「フォーム」右の「+」を押下し、追加メニューから「汎用フォーム > 日付の入力欄 (date) フォーム」を選択します。
- 追加した「日付の入力欄 (date) フォーム」の位置を調整します。
追加したフォームはリストの先頭に入ります。フォームの右側にある「下へ」アイコン(または左端のつまみのドラッグ)で、「通信欄」フォームの下へ移動してください。 - 追加した「日付の入力欄 (date) フォーム」を押下して展開し、「ラベル」をお客様に見せる項目名(例:ご希望日)に変更してください。
追加した直後の「デフォルト値」は空欄です。初期表示したい日付がある場合は「デフォルト値」に入力してください。 - 続けて、同じフォームの「シナリオ更新時イベント (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() } } - スクリプトの「const free_column_category = xx // [必須] カスタム項目のカテゴリ」には対応させたいカスタム項目のカテゴリIDを、
「const free_column_item = xx // [必須] カスタム項目」にはカスタム項目IDを「xx」の箇所に入力してください。
(あらかじめ入っているスクリプトでは「xx」の箇所が「1」になっています) - 編集が完了したら、画面右上の「保存」で保存し、ビルドを実行してください。
ビルドの方法はこちらをご確認ください。
※表示イメージ
この記事の目次
このセクションの記事