教學課程:將規則套用至最適化表單欄位

06-apply-rules-to-adaptive-form_main

本教學課程是建立第一個最適化表單系列中的步驟。 Adobe建議依序依序執行系列,以了解、執行和示範完整的教學課程使用案例。

關於教學課程

您可以使用規則將互動性、商業邏輯和智慧驗證新增至最適化表單。 適用性表單有內建的規則編輯器。 規則編輯器提供拖放功能,類似於引導式導覽。 拖放方法是建立規則最快速且最簡單的方法。 規則編輯器還為有興趣測試其編碼技能或將規則提升到下一級的用戶提供一個代碼窗口。

您可以前往適用性Forms規則編輯器,深入了解規則編輯器。

在教學課程結束前,您將學習如何建立規則,以:

  • 調用表單資料模型服務以從資料庫中檢索資料
  • 調用表單資料模型服務以將資料添加到資料庫
  • 運行驗證檢查並顯示錯誤消息

本教學課程各節結尾的互動式GIF影像可協助您即時學習及驗證您所建立表單的功能。

步驟1:從資料庫中檢索客戶記錄

您遵循create form data model文章建立表單資料模型。 現在,您可以使用規則編輯器叫用Forms資料模型服務,以擷取資訊並新增至資料庫。

每個客戶都獲派一個唯一的客戶ID編號,這有助於識別資料庫中的相關客戶資料。 以下過程使用客戶ID從資料庫中檢索資訊:

  1. 開啟最適化表單以進行編輯。

    http://localhost:4502/editor.html/content/forms/af/change-billing-shipping-address.html

  2. 點選​客戶ID​欄位,然後點選​編輯規則​圖示。 「規則編輯器」窗口隨即開啟。

  3. 點選​+建立​圖示以新增規則。 它會開啟視覺編輯器。

    在可視編輯器中,預設會選取​WHEN​陳述式。 此外,您啟動規則編輯器時所在的表單物件(在此例中為​客戶ID)會在​WHEN​陳述式中指定。

  4. 點選「Select State」下拉式清單,然後選取「已變更」。

    自訂變更時

  5. 在​THEN​語句中,從​Select Action​下拉清單中選擇​Invoke Service

  6. 從​Select​下拉式清單中選擇​Retrieve Shipping Address​服務。

  7. 將​客戶ID​欄位從「表單對象」頁簽拖放到​放置對象,或在​ INPUT ​​框中選擇此處​欄位。

    dropobjectstoinputfield-retrievedata

  8. 從「表單對象」頁簽拖放​「客戶ID」、「名稱」、「發運地址」、「狀態」和「郵遞區號」欄位至「放置對象」或在​OUTPUT​框中選擇此處​欄位。

    dropobjectstooutputfield-retrievedata

    點選​Done​以儲存規則。 在規則編輯器視窗中,點選​關閉

  9. 預覽最適化表單。 在​客戶ID​欄位中輸入ID。 表單現在可以從資料庫擷取客戶詳細資訊。

    檢索資訊

步驟2:將更新的客戶地址添加到資料庫

從資料庫中擷取客戶詳細資訊後,您就可以更新運送地址、狀態和郵遞區號。 以下過程調用表單資料模型服務以將客戶資訊更新到資料庫:

  1. 選取「Submit」欄位,然後點選「Edit Rules」圖示。 「規則編輯器」窗口隨即開啟。

  2. 選取​Submit — 按一下​規則,然後點選​Edit​圖示。 編輯提交規則的選項隨即出現。

    提交規則

    在WHEN選項中,已選擇​Submit​和​被點擊​選項。

    submit-is-clicked

  3. 在​THEN​選項中,點選​+ Add Statement​選項。 從​選擇操作​下拉清單中選擇​調用服務

  4. 從​Select​下拉式清單中選擇​Update Shipping Address​服務。

    update-shipping-address

  5. dropobjectstoinputfield-updatedata

    從「表單對象」頁簽拖放​「運送地址」、「狀態」和「郵遞區號」欄位至「拖放對象」的相應表名。屬性(例如,customerdetails .shippingAddress),或在​INPUT​框中選擇此處​欄位。​所有以tablename為前置詞的欄位(例如,此使用案例中的customerdetails)都用作更新服務的輸入資料。 這些欄位中提供的所有內容都會在資料來源中更新。

    注意

    請勿拖放​Name​和​Customer ID​欄位至對應的tablename.property(例如customerdetails.name)。 有助於避免錯誤更新客戶的名稱和ID。

  6. 從「表單對象」頁簽拖放​「客戶ID」​欄位至​INPUT​方塊中的id欄位。 不含前置詞tablename的欄位(例如,此使用案例中的customerdetails)可作為更新服務的搜尋參數。 此使用案例中的​id​欄位可唯一識別customerdetails表中的記錄。

  7. 點選​Done​以儲存規則。 在規則編輯器視窗中,點選​關閉

  8. 預覽最適化表單。 檢索客戶的詳細資訊、更新發運地址並提交表單。 當您再次檢索同一客戶的詳細資訊時,將顯示更新的發運地址。

步驟3:(額外部分)使用代碼編輯器運行驗證並顯示錯誤消息

您應對表單執行驗證,以確保在表單中輸入的資料正確,並在資料不正確時顯示錯誤訊息。 例如,如果在表單中輸入了非現有客戶ID,則應會顯示錯誤訊息。

適用性表單提供數個內建驗證的元件,例如電子郵件和數值欄位,可用於常見使用案例。 對於高級使用案例,使用規則編輯器可在資料庫返回零(0)條記錄(無記錄)時顯示錯誤消息。

如果在表單中輸入的客戶ID不在資料庫中,則以下過程將說明如何建立規則以顯示錯誤消息。 規則也會將焦點引至並重設客戶ID欄位。 規則使用表單資料模型服務🔗的dataIntegrationUtils API來檢查資料庫中是否存在客戶ID。

  1. 點選​客戶ID​欄位,然後點選Edit Rules圖示。 「規則編輯器」窗口隨即開啟。

  2. 點選​+建立​圖示以新增規則。 它會開啟視覺編輯器。

    在可視編輯器中,預設會選取​WHEN​陳述式。 此外,您啟動規則編輯器時所在的表單物件(在此例中為​客戶ID)會在​WHEN​陳述式中指定。

  3. 點選「Select State」下拉式清單,然後選取「已變更」。

    自訂變更時

    在​THEN​語句中,從​Select Action​下拉清單中選擇​Invoke Service

  4. 從​可視編輯器​切換到​代碼編輯器。 開關控制項位於窗口的右側。 「代碼編輯器」隨即開啟,顯示類似下列的代碼:

    代碼編輯器

  5. 使用下列程式碼取代輸入變數區段:

    var inputs = {
        "id" : this
    };
    
  6. 將guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs)區段取代為下列程式碼:

    guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, function (result) {
      if (result) {
          result = JSON.parse(result);
        customer_Name.value = result.name;
        customer_Shipping_Address = result.shippingAddress;
      } else {
        if(window.confirm("Invalid Customer ID. Provide a valid customer ID")) {
              customer_Name.value = " ";
             guideBridge.setFocus(customer_ID);
        }
      }
    });
    
  7. 預覽最適化表單。 輸入錯誤的客戶ID。 出現錯誤訊息。

    display-validation-error

本頁內容