自适应表单的标准验证错误消息

自适应表单会根据预设的验证条件验证您在字段中提供的输入。 验证标准是指自适应表单中字段的可接受输入值。 您可以根据与自适应表单一起使用的数据源设置验证标准。 例如，如果使用RESTful Web服务作为数据源，则可以在Swagger定义文件中定义验证条件。

如果输入值符合验证标准，则会将值提交到数据源。 否则，自适应表单会显示一条错误消息。

与这种方法类似，自适应表单现在可以与自定义服务集成以执行数据验证。 如果输入值不符合验证标准且服务器返回的验证错误消息为标准消息格式，则错误消息将在表单的字段级别显示。

如果输入值不满足验证标准并且服务器验证错误消息不是标准消息格式，自适应表单提供一种机制，用于将验证错误消息转换为标准格式，以便它们在表单的字段级别显示。 您可以使用以下两种方法中的任意一种将错误消息转换为标准格式：

• 在自适应表单提交中添加自定义错误处理程序
• 添加自定义处理程序以使用规则编辑器调用服务操作

本文介绍了验证错误消息的标准格式以及将错误消息从自定义格式转换为标准格式的说明。

标准验证错误消息格式

如果服务器验证错误消息采用以下标准格式，则自适应表单会在字段级别显示错误：

   {
    errorCausedBy : "SERVER_SIDE_VALIDATION/SERVICE_INVOCATION_FAILURE"
    errors : [
        {
             somExpression  : <somexpr>
             errorMessage / errorMessages : <validationMsg> / [<validationMsg>, <validationMsg>]

        }
    ]
    originCode : <target error Code>
    originMessage : <unstructured error message returned by service>
}

其中：

• errorCausedBy 描述失败的原因
• errors 提及验证标准失败字段的SOM表达式和验证错误消息
• originCode 包含外部服务返回的错误代码
• originMessage 包含外部服务返回的原始错误数据

配置自适应表单提交以添加自定义处理程序

如果服务器验证错误消息未以标准格式显示，则可以启用异步提交并在自适应表单提交中添加自定义错误处理程序，以将消息转换为标准格式。

配置异步自适应表单提交

添加自定义处理程序之前，必须配置用于异步提交的自适应表单。 执行以下步骤：

1. 在自适应表单创作模式中，选择表单容器对象，然后点按以打开其属性。

2. 在​Submission​属性部分中，启用​使用异步提交。

3. 选择​在服务器​上重新验证，以在提交之前验证服务器上的输入字段值。

4. 选择提交操作：

   • 如果使用基于表单数据模型的RESTful Web服务作为数据源，请选择​使用表单数据模型​提交，然后选择相应的数据模型。
   • 如果您使用RESTful Web服务作为数据源，请选择​提交到REST端点​并指定​重定向URL/路径。

   

5. 点按以保存属性。

在自适应表单提交中添加自定义错误处理程序

AEM Forms为表单提交提供了开箱即用的成功和错误处理程序。 处理程序是基于服务器响应执行的客户端函数。 在提交表单时，数据被传输到服务器进行验证，服务器会向客户端返回响应，其中包含有关提交的成功或错误事件的信息。 该信息作为参数传递给相关处理程序以执行该函数。

执行以下步骤，在自适应表单提交中添加自定义错误处理程序：

1. 在创作模式下打开自适应表单，选择任意表单对象，然后点按以打开规则编辑器。
2. 在“表单对象”树中选择​表单 ，然后点按​创建。
3. 从“事件”下拉列表中选择“提交中的错误”​。
4. 编写规则以将自定义错误结构转换为标准错误结构，然后点按​Done​以保存规则。

以下是将自定义错误结构转换为标准错误结构的示例代码：

var data = $event.data;
var som_map = {
    "id": "guide[0].guide1[0].guideRootPanel[0].Pet[0].id_1[0]",
    "name": "guide[0].guide1[0].guideRootPanel[0].Pet[0].name_2[0]",
    "status": "guide[0].guide1[0].guideRootPanel[0].Pet[0].status[0]"
};

var errorJson = {};
errorJson.errors = [];

if (data) {
    if (data.originMessage) {
        var errorData;
        try {
            errorData = JSON.parse(data.originMessage);
        } catch (err) {
            // not in json format
        }

        if (errorData) {
            Object.keys(errorData).forEach(function(key) {
                var som_key = som_map[key];
                if (som_key) {
                    var error = {};
                    error.somExpression = som_key;
                    error.errorMessage = errorData[key];
                    errorJson.errors.push(error);
                }
            });
        }
        window.guideBridge.handleServerValidationError(errorJson);
    } else {
        window.guideBridge.handleServerValidationError(data);
    }
}

var som_map列出了要转换为标准格式的自适应表单字段的SOM表达式。 您可以通过点按自适应表单中的任何字段的SOM表达式，然后选择​查看SOM表达式​来查看该字段的SOM表达式。

自适应表单使用此自定义错误处理程序，将var som_map中列出的字段转换为标准错误消息格式。 因此，验证错误消息会在自适应表单的字段级别显示。

使用调用服务操作添加自定义处理程序

执行以下步骤以添加错误处理程序，以使用规则编辑器的调用服务操作将自定义错误结构转换为标准错误结构：

1. 在创作模式下打开自适应表单，选择任意表单对象，然后点按以打开规则编辑器。
2. 点按​创建。
3. 在规则的​When​部分中创建条件。 例如，更改字段]名称时。 [从​选择状态​下拉列表中选择​已更改​以实现此条件。
4. 在​Then​部分，从​Select Action​下拉列表中选择​Invoke Service。
5. 从​Input​部分选择Post服务及其相应的数据绑定。 例如，如果要验证自适应表单中的​名称、ID​和​状态​字段，请选择帖子服务(pet)，然后在​输入​部分中选择pet.name、pet.id和pet.status。

作为此规则的结果，在第2步中定义的字段发生更改并且您跳出表单中的字段后，即会验证您为​名称、ID​和​状态​字段输入的值。

1. 从模式选择下拉列表中选择​代码编辑器。

2. 点按​编辑代码。

3. 从现有代码中删除以下行：

   guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs);
   

4. 编写规则以将自定义错误结构转换为标准错误结构，然后点按​Done​以保存规则。
   例如，在末尾添加以下示例代码，以将自定义错误结构转换为标准错误结构：

   var errorHandler = function(jqXHR, data) {
   var som_map = {
       "id": "guide[0].guide1[0].guideRootPanel[0].Pet[0].id_1[0]",
       "name": "guide[0].guide1[0].guideRootPanel[0].Pet[0].name_2[0]",
       "status": "guide[0].guide1[0].guideRootPanel[0].Pet[0].status[0]"
   };
   
   
   var errorJson = {};
   errorJson.errors = [];
   
   if (data) {
       if (data.originMessage) {
           var errorData;
           try {
               errorData = JSON.parse(data.originMessage);
           } catch (err) {
               // not in json format
           }
   
           if (errorData) {
               Object.keys(errorData).forEach(function(key) {
                   var som_key = som_map[key];
                   if (som_key) {
                       var error = {};
                       error.somExpression = som_key;
                       error.errorMessage = errorData[key];
                       errorJson.errors.push(error);
                   }
               });
           }
           window.guideBridge.handleServerValidationError(errorJson);
       } else {
           window.guideBridge.handleServerValidationError(data);
       }
     }
   };
   
   guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, null, errorHandler);
   

   var som_map列出了要转换为标准格式的自适应表单字段的SOM表达式。 您可以通过点按自适应表单中的任何字段的SOM表达式，并从​更多选项(…)菜单中选择​查看SOM表达式。

   确保将示例代码的以下行复制到自定义错误处理程序：

   guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, null, errorHandler);
   

   executeOperation API包含基于新自定义错误处理程序的null和errorHandler参数。

   自适应表单使用此自定义错误处理程序，将var som_map中列出的字段转换为标准错误消息格式。 因此，验证错误消息会在自适应表单的字段级别显示。