Funções personalizadas no Adaptive Forms (Componentes principais)

Introdução

O AEM Forms 6.5 apresentou a capacidade de definir funções do JavaScript que podem ser usadas na definição de regras de negócios complexas usando o editor de regras. O AEM Forms fornece várias dessas funções personalizadas prontas para uso, mas você terá a necessidade de definir suas próprias funções personalizadas e usá-las em vários formulários.

As funções personalizadas estendem os recursos dos formulários facilitando a manipulação e o processamento dos dados inseridos para atender a requisitos especificados. Elas também permitem a alteração dinâmica do comportamento do formulário com base em critérios predefinidos.
No Adaptive Forms, você pode usar funções personalizadas no editor de regras de um Formulário adaptável para criar regras de validação específicas para campos de formulário.
Vamos entender o uso da função personalizada em que os usuários inserem o endereço de email e você deseja garantir que o endereço de email inserido siga um formato específico (ele contém um símbolo "@" e um nome de domínio). Crie uma função personalizada como "ValidateEmail" que assume o endereço de email como entrada e retorna true se for válido, caso contrário, retorna false.

function ValidateEmail(inputText)
{
    var email = /^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$/;
    if(inputText.value.match(email))
        {
            alert("Valid email address!");
            return true;
        }
    else
    {
        alert("Invalid email address!");
        return false;
    }
}

No exemplo acima, quando o usuário tenta enviar o formulário, a função personalizada "ValidateEmail" é invocada para verificar se o endereço de email inserido é válido.

Usos de funções personalizadas uses-of-custom-function

As vantagens de usar funções personalizadas no Adaptive Forms são:

Anotações JS suportadas

Certifique-se de que a função personalizada que você grava esteja acompanhada pelo jsdoc acima dela; caso contrário, você precisará de configuração e descrição personalizadas. Há várias maneiras de declarar uma função em JavaScript, e os comentários permitem que você acompanhe as funções. Para obter mais informações, consulte usejsdoc.org.

jsdoc marcas com suporte:

Tipos suportados de declaração de função function-declaration-supported-types

Instrução da Função

function area(len) {
    return len*len;
}

Esta função está incluída sem jsdoc comentários.

Expressão de função

var area;
//Some codes later
/** */
area = function(len) {
    return len*len;
};

Expressão e Instrução da Função

var b={};
/** */
b.area = function(len) {
    return len*len;
}

Declaração de função como variável

/** */
var x1,
    area = function(len) {
        return len*len;
    },
    x2 =5, x3 =true;

Limitação: a função personalizada escolhe somente a primeira declaração de função da lista de variáveis, se estiver junto. Você pode usar a expressão de função para cada função declarada.

Declaração de Função como Objeto

var c = {
    b : {
        /** */
        area : function(len) {
            return len*len;
        }
    }
};

Criar função personalizada create-custom-function

Para criar uma função personalizada, execute as seguintes etapas:

Você pode consultar a seguinte pasta função personalizada. Baixe e instale essa pasta na instância do AEM.

Agora, você pode usar a função personalizada no Formulário adaptável adicionando a biblioteca do cliente.

Adicionar biblioteca do cliente em um Formulário adaptável use-custom-function

Depois de implantar a biblioteca do cliente no ambiente do Forms CS, use os recursos dela no Formulário adaptável. Para adicionar a biblioteca do cliente no Formulário adaptável

Agora, é possível criar uma regra para usar funções personalizadas no editor de regras:

Agora, vamos entender como configurar e usar uma função personalizada usando o serviço Chamar do Editor de regras no AEM Forms.