Trabalhar com modelo de dados de formulário

integração de dados

O editor de modelo de dados de formulário fornece uma interface de usuário intuitiva e ferramentas para editar e configurar um modelo de dados de formulário. Usando o editor, é possível adicionar e configurar objetos, propriedades e serviços do modelo de dados de fontes de dados associadas no modelo de dados de formulário. Além disso, permite criar objetos e propriedades de modelo de dados sem fontes de dados e vinculá-los posteriormente aos respectivos objetos e propriedades de modelo de dados. Você também pode gerar e editar dados de amostra para propriedades de objetos de modelo de dados que podem ser usados para preencher previamente formulários adaptáveis e comunicações interativas ao visualizar. É possível testar objetos e serviços de modelo de dados configurados em um modelo de dados de formulário para garantir que eles sejam integrados corretamente às fontes de dados.

Se você for novo na integração de dados da Forms e não tiver configurado uma fonte de dados ou criado um modelo de dados de formulário, consulte os seguintes tópicos:

Leia para obter detalhes sobre várias tarefas e configurações que você pode executar usando o editor de modelo de dados de formulário.

Observação

Você deve ser membro de grupos de fdm-author e de usuários de formulários para poder criar e trabalhar com modelo de dados de formulário. Entre em contato com o administrador do AEM para se tornar membro dos grupos.

Adicionar objetos e serviços do modelo de dados

Se você tiver criado um modelo de dados de formulário com fontes de dados, poderá usar o editor de modelo de dados de formulário para adicionar objetos e serviços de modelo de dados, configurar suas propriedades, criar associações entre objetos de modelo de dados e testar o modelo e os serviços de dados de formulário.

É possível adicionar objetos e serviços de modelo de dados de fontes de dados disponíveis no modelo de dados de formulário. Enquanto objetos de modelo de dados adicionados aparecem na guia Modelo, os serviços adicionados aparecem na guia Serviços.

Para adicionar objetos e serviços de modelo de dados:

  1. Faça logon na instância AEM autor, navegue até Forms > Integrações de dados e abra o modelo de dados de formulário no qual deseja adicionar objetos de modelo de dados.

  2. No painel Fontes de dados, expanda as fontes de dados para visualização de objetos e serviços de modelo de dados disponíveis.

  3. Selecione os objetos e serviços do modelo de dados que deseja adicionar ao modelo de dados do formulário e toque em Adicionar selecionados.

    objetos selecionados

    Objetos e serviços do modelo de dados selecionado

    A guia Modelo exibe uma representação gráfica de todos os objetos do modelo de dados e suas propriedades adicionadas ao modelo de dados do formulário. Cada objeto de modelo de dados é representado por uma caixa no modelo de dados de formulário.

    guia modelo

    A guia Modelo exibe objetos de modelo de dados adicionados

    Observação

    É possível manter e arrastar caixas de objetos de modelo de dados ao redor para organizá-las na área de conteúdo. Todos os objetos de modelo de dados adicionados no modelo de dados de formulário ficam acinzentados no painel Fontes de Dados.

    A guia Serviços lista serviços adicionados.

    guia Serviços

    A guia Serviços exibe os serviços de modelo de dados

    Observação

    Além de objetos e serviços de modelo de dados, o documento de metadados do serviço OData inclui propriedades de navegação que definem a associação entre dois objetos de modelo de dados. Para obter mais informações, consulte Trabalhar com propriedades de navegação dos serviçosOData.

  4. Toque em Salvar para salvar o objeto de modelo de formulário.

    Observação

    Você pode chamar os serviços configurados na guia Serviços de um modelo de dados de formulário usando as regras de formulário adaptáveis. Os serviços configurados estão disponíveis na ação Invocar serviços do editor de regras. Para obter mais informações sobre como usar esses serviços em regras de formulário adaptáveis, consulte Invocar serviços e Definir valor de regras no editor deregras.

Criar objetos de modelo de dados e propriedades secundárias

Criar objetos de modelo de dados

Embora seja possível adicionar objetos de modelo de dados de fontes de dados configuradas, também é possível criar objetos de modelo de dados ou entidades sem fontes de dados. É útil principalmente se você não tiver configurado fontes de dados no modelo de dados de formulário.

Para criar um objeto de modelo de dados sem fontes de dados:

  1. Faça logon na instância do autor AEM, navegue até Forms > Integrações de dados e abra o modelo de dados do formulário no qual você deseja criar um objeto ou entidade de modelo de dados.

  2. Toque em Criar entidade.

  3. Na caixa de diálogo Criar modelo de dados, especifique um nome para o objeto de modelo de dados e toque em Adicionar. Um objeto de modelo de dados é adicionado ao modelo de dados do formulário. Observe que o objeto de modelo de dados recém-adicionado não está vinculado a uma fonte de dados e não tem nenhuma propriedade, como mostrado na imagem a seguir.

    nova entidade

Em seguida, é possível adicionar propriedades secundárias em objetos de modelo de dados não vinculados.

Adicionar propriedades secundárias

O editor de modelo de dados de formulário permite criar propriedades secundárias em um objeto de modelo de dados. A propriedade quando criada não está vinculada a nenhuma propriedade em uma fonte de dados. Posteriormente, é possível vincular a propriedade filho a outra propriedade no objeto de modelo de dados contêiner.

Para criar uma propriedade filho:

  1. Em um modelo de dados de formulário, selecione um objeto de modelo de dados e toque em Criar propriedade secundária.

  2. Na caixa de diálogo Criar propriedade secundária, especifique um nome e um tipo de dados para a propriedade nos campos Nome e Tipo , respectivamente. Como opção, você pode especificar um título e uma descrição para a propriedade.

  3. Ative Calculado se a propriedade for uma propriedade calculada. O valor de uma propriedade calculada é avaliado com base em uma regra ou expressão. Para obter mais informações, consulte Editar propriedades.

  4. Se o objeto de modelo de dados estiver vinculado a uma fonte de dados, a propriedade filho adicionada será automaticamente vinculada à propriedade do objeto de modelo de dados pai com o mesmo nome e tipo de dados.

    Para vincular manualmente uma propriedade filho a uma propriedade de objeto de modelo de dados, toque no ícone Procurar ao lado do campo Vincular referência . A caixa de diálogo Selecionar objeto lista todas as propriedades do objeto de modelo de dados pai. Selecione uma propriedade com a qual vincular e toque no ícone de marca de verificação. Observe que você só pode selecionar uma propriedade do mesmo tipo de dados que a propriedade filho.

  5. Toque em Concluído para salvar a propriedade filho e toque em Salvar para salvar o modelo de dados do formulário. A propriedade filho agora é adicionada ao objeto de modelo de dados.

Depois de criar objetos e propriedades do modelo de dados, você pode continuar a criar formulários adaptáveis e comunicações interativas com base no modelo de dados do formulário. Posteriormente, quando fontes de dados estão disponíveis e configuradas, é possível vincular o modelo de dados de formulário a fontes de dados. O vínculo será atualizado automaticamente nos formulários adaptativos associados e nas comunicações interativas. Para obter mais informações sobre como criar formulários adaptáveis e comunicações interativas usando o modelo de dados de formulário, consulte Usar o modelode dados de formulário.

Vincular objetos e propriedades do modelo de dados

Quando as fontes de dados que você deseja integrar ao modelo de dados do formulário estiverem disponíveis, é possível adicioná-las ao modelo de dados do formulário conforme descrito em Atualizar fontesde dados. Em seguida, faça o seguinte para vincular os objetos e as propriedades do modelo de dados não vinculados:

  1. No modelo de dados de formulário, selecione a fonte de dados não vinculada que deseja vincular a uma fonte de dados.

  2. Toque em Editar propriedades.

  3. No painel Editar propriedades , toque no ícone Procurar ao lado do campo Vínculo . Ele abre a caixa de diálogo Selecionar objeto que lista as fontes de dados adicionadas no modelo de dados do formulário.

    select-object

  4. Expanda a árvore de fontes de dados e selecione um objeto de modelo de dados ao qual vincular e toque no ícone de verificação.

  5. Toque em Concluído para salvar as propriedades e toque em Salvar para salvar o modelo de dados do formulário. O objeto de modelo de dados agora está vinculado a uma fonte de dados. Observe que o objeto de modelo de dados não está mais marcado como Não vinculado.

    bound-model-object

Configurar serviços

Para ler e gravar dados de um objeto de modelo de dados, faça o seguinte para configurar os serviços de leitura e gravação:

  1. Marque a caixa de seleção na parte superior de um objeto de modelo de dados para selecioná-lo e toque em Editar propriedades.

    edit-properties

    Editar propriedades para configurar serviços de leitura e gravação para um objeto de modelo de dados

    A caixa de diálogo Editar propriedades é aberta.

    edit-properties-2

    Caixa de diálogo Editar propriedades

    Observação

    Além de objetos e serviços de modelo de dados, o documento de metadados do serviço OData inclui propriedades de navegação que definem a associação entre dois objetos de modelo de dados. Quando você adiciona uma fonte de dados de serviço OData a um Modelo de dados de formulário, há um serviço disponível no Modelo de dados de formulário para todas as propriedades de navegação em um objeto de modelo de dados. Você pode usar esse serviço para ler as propriedades de navegação do objeto de modelo de dados correspondente.

    Para obter mais informações sobre como usar o serviço, consulte Trabalhar com propriedades de navegação dos serviçosOData.

  2. Alterne o objeto de nível superior para especificar se o objeto de modelo de dados é um objeto de modelo de nível superior.

    Objetos de modelo de dados configurados em um modelo de dados de formulário estão disponíveis para uso na guia Objetos de modelo de dados no navegador Conteúdo de um formulário adaptável com base no modelo de dados de formulário. Quando você adiciona associação entre dois objetos de modelo de dados, o objeto de modelo de dados ao qual você está associado é aninhado sob o objeto de modelo de dados ao qual você está associando na guia Objetos de modelo de dados. Se o modelo de dados aninhado for um objeto de nível superior, ele também será exibido separadamente na guia Objetos do modelo de dados. Portanto, você verá duas entradas dela, uma dentro e outra fora da hierarquia aninhada, o que pode confundir os autores de formulários. Para fazer com que o objeto de modelo de dados associado apareça apenas na hierarquia aninhada, desative a propriedade Objeto de nível superior.

  3. Selecione Serviços de leitura e gravação para os objetos de modelo de dados selecionados. Os argumentos para os serviços são exibidos.

    serviços de leitura/gravação

    Serviços de leitura e gravação configurados para a fonte de dados do funcionário

  4. Toque em aem_6_3_edit para que o argumento do serviço de leitura vincule o argumento a um Atributo de Perfil do usuário, Atributo de solicitação ou valor literal e especifique o valor de vínculo.

  5. Toque em Concluído para salvar o argumento, Concluído para salvar as propriedades e, em seguida, em Salvar para salvar o modelo de dados do formulário.

Argumentos do serviço de Leitura de Ligação

Vincule o argumento do serviço de Leitura a um Atributo do Perfil do usuário, Atributo de solicitação ou valor Literal com base em um valor de vínculo. O valor é passado para o serviço como um argumento para buscar detalhes associados ao valor especificado na fonte de dados.

Literal value

Selecione Literal no menu suspenso Vínculo e insira um valor no campo Valor de Vínculo. Os detalhes associados ao valor são recuperados da fonte de dados. Use essa opção para recuperar detalhes associados a um valor estático.

Neste exemplo, os detalhes associados ao 4367655678, como o valor do mobilenum argumento, são recuperados da fonte de dados. Os detalhes associados se você passar o valor para um argumento de número de celular podem incluir propriedades como nome do cliente, endereço do cliente e cidade.

Valor literal

Atributo do perfil do usuário

Selecione Atributo de Perfil de usuário no menu suspenso Vínculo e digite o nome do atributo no campo Valor de vínculo. Os detalhes do usuário conectado à instância AEM são recuperados da fonte de dados com base no nome do atributo.

O nome do atributo especificado no campo Valor de Vínculo deve incluir o caminho de vínculo completo até o nome do atributo do usuário. Abra o seguinte URL para acessar os detalhes do usuário no CRXDE:

https://[server-name]:[port]/crx/de/index.jsp#/home/users/

Perfil de usuário

Neste exemplo, especifique profile.empid o campo Valor de vínculo para o grios usuário.

Editar argumento

O id argumento pega o valor do empid atributo do perfil do usuário e o envia como um argumento para o serviço de Leitura. Ele lê e retorna valores de propriedades associadas do objeto de modelo de dados do funcionário para o empid associado ao usuário conectado.

Solicitar atributo

Use o atributo request para recuperar as propriedades associadas da fonte de dados.

  1. Selecione Atributo de solicitação no menu suspenso Vínculo para e digite o nome do atributo no campo Valor de vínculo.

  2. Crie uma sobreposição para head.jsp. Para criar a sobreposição, abra o CRX DE e copie o arquivo para https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp https://<server-name>:<port number>/crx/de/index.jsp#/apps/fd/af/components/page2/afStaticTemplatePage/head.jsp

    Observação
    • Se você usar um modelo estático, sobreponha head.jsp em:
      /libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
    • Se você usar um modelo editável, sobreponha aftemplatedpage.jsp em:
      /libs/fd/af/components/page2/aftemplatedpage/aftemplatedpage.jsp
  3. Defina paramMap para o atributo de solicitação. Por exemplo, inclua o seguinte código no arquivo .jsp na pasta apps:

    <%Map paraMap = new HashMap();
     paraMap.put("<request_attribute>",request.getParameter("<request_attribute>"));
     request.setAttribute("paramMap",paraMap);
    

    Por exemplo, use o código abaixo para recuperar o valor de petid da fonte de dados:

    <%Map paraMap = new HashMap();
    paraMap.put("petId",request.getParameter("petId"));
    request.setAttribute("paramMap",paraMap);%>
    

Os detalhes são recuperados da fonte de dados com base no nome do atributo especificado na solicitação.

Por exemplo, especificar o atributo como petid=100 na solicitação recupera as propriedades associadas ao valor do atributo da fonte de dados.

Adicionar associações

Normalmente, há associações criadas entre objetos de modelo de dados em uma fonte de dados. A associação pode ser um para um ou um para muitos. Por exemplo, pode haver vários dependentes associados a um funcionário. É chamada de associação de um para muitos e representada por 1:n na linha que conecta objetos de modelo de dados associados. No entanto, se uma associação retornar um nome de funcionário exclusivo para uma determinada ID de funcionário, ela será chamada de associação de um para um.

Quando objetos de modelo de dados associados são adicionados em uma fonte de dados a um modelo de dados de formulário, suas associações são mantidas e exibidas como conectadas por linhas de seta. É possível adicionar associações entre objetos de modelo de dados em diferentes fontes de dados em um modelo de dados de formulário.

Observação

As associações predefinidas em uma fonte de dados JDBC não são retidas no modelo de dados de formulário. Você deve criá-los manualmente.

Para adicionar uma associação:

  1. Marque a caixa de seleção na parte superior de um objeto de modelo de dados para selecioná-lo e toque em Adicionar associação. A caixa de diálogo Adicionar associação é aberta.

    associação de suplementos

    Observação

    Além de objetos e serviços de modelo de dados, o documento de metadados do serviço OData inclui propriedades de navegação que definem a associação entre dois objetos de modelo de dados. É possível usar essas propriedades de navegação ao adicionar associações no Modelo de dados de formulário. Para obter mais informações, consulte Trabalhar com propriedades de navegação dos serviçosOData.

    A caixa de diálogo Adicionar associação é aberta.

    add-Association-2

    Caixa de diálogo Adicionar associação

  2. No painel Adicionar associação:

    • Especifique um título para a associação.
    • Selecione o tipo de associação — Um para um ou um para muitos.
    • Selecione o objeto de modelo de dados ao qual associar.
    • Selecione o serviço de leitura para ler dados do objeto de modelo selecionado. O argumento read service é exibido. Edite para alterar o argumento, se necessário, e vincule-o à propriedade do objeto de modelo de dados a ser associado.

    No exemplo a seguir, o argumento padrão para o serviço de leitura do objeto de modelo de dados Dependents é dependentid.

    add-Association-example

    O argumento padrão para o serviço de leitura Dependentes é dependente

    No entanto, o argumento deve ser uma propriedade comum entre o objeto de modelo de dados associado, que neste exemplo é Employeeid. Portanto, o Employeeid argumento deve ser vinculado à id propriedade do objeto de modelo de dados Funcionário para buscar os detalhes dos dependentes associados do objeto de modelo de dados Dependentes.

    add-Association-example-2

    Argumento e vínculo atualizados

    Toque em Concluído para salvar o argumento.

  3. Toque em Concluído para salvar a associação e, em seguida, em Salvar para salvar o modelo de dados do formulário.

  4. Repita as etapas para criar mais associações, conforme necessário.

Observação

A associação adicionada é exibida na caixa de objetos de modelo de dados com o título especificado e uma linha que conecta os objetos de modelo de dados associados.

Você pode editar uma associação marcando a caixa de seleção e tocando em Editar associação.

associação adicionada

Editar propriedades

É possível editar propriedades de objetos de modelo de dados, suas propriedades e serviços adicionados no modelo de dados de formulário.

Para editar propriedades:

  1. Marque a caixa de seleção ao lado de um objeto de modelo de dados, uma propriedade ou um serviço no modelo de dados de formulário.

  2. Toque em Editar propriedades. O painel Editar propriedades do objeto, propriedade ou serviço de modelo selecionado é aberto.

    • Objeto de modelo de dados: Especifique os serviços de leitura e gravação e edite argumentos.
    • Propriedade: Especifique o tipo, o subtipo e o formato da propriedade. Você também pode especificar se a propriedade selecionada é a chave primária para o objeto de modelo de dados.
    • Serviço: Especifique o objeto do modelo de entrada, o tipo de saída e os argumentos para o serviço. Para um serviço Get, você pode especificar se é esperado que ele retorne uma matriz.

    edit-properties-service

    Caixa de diálogo Editar propriedades para um serviço get

  3. Toque em Concluído para salvar as propriedades e em Salvar para salvar o modelo de dados do formulário.

Criar propriedades calculadas

Uma propriedade calculada é aquela cujo valor é calculado com base em uma regra ou expressão. Usando uma regra, é possível definir o valor de uma propriedade calculada como uma string literal, um número, resultado de uma expressão matemática ou o valor de outra propriedade no modelo de dados de formulário.

Por exemplo, você pode criar uma propriedade calculada FullName cujo valor é resultado da concatenação das propriedades FirstName e LastName existentes. Para isso:

  1. Crie uma nova propriedade com o nome FullName cujo tipo de dados é String.

  2. Ative Calculado e toque em Concluído para criar a propriedade.

    calculado

    A propriedade calculada FullName é criada. Observe o ícone ao lado da propriedade para descrever uma propriedade calculada.

    computed-prop

  3. Selecione a propriedade FullName e toque em Editar regra. Uma janela do editor de regras é aberta.

  4. Na janela do editor de regras, toque em Criar. Uma janela de regra Definir valor é aberta.

    Na lista suspensa Selecionar opção, selecione Expressão matemática. Outras opções disponíveis são Objeto e String do Modelo de dados de formulário.

  5. Na expressão matemática, selecione FirstName e LastName no primeiro e segundo objetos, respectivamente. Selecione mais como operador.

    Toque em Concluído e, em seguida, toque em Fechar para fechar a janela do editor de regras. A regra é semelhante ao seguinte.

    regra

  6. No modelo de dados de formulário, toque em Salvar. A propriedade calculada está configurada.

Trabalhar com propriedades de navegação de serviços OData

Nos serviços OData, as propriedades de navegação são usadas para definir associações entre dois objetos de modelo de dados. Essas propriedades são definidas em um tipo de entidade ou complexo. Por exemplo, na seguinte extração do arquivo de metadados dos serviços de amostra TripPin OData, a entidade da pessoa contém três propriedades de navegação - Amigos, Melhor Amigo e Percursos.

Para obter mais informações sobre propriedades de navegação, consulte a documentação OData.

<edmx:Edmx xmlns:edmx="https://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
<script/>
<edmx:DataServices>
<Schema xmlns="https://docs.oasis-open.org/odata/ns/edm" Namespace="Microsoft.OData.Service.Sample.TrippinInMemory.Models">
<EntityType Name="Person">
<Key>
<PropertyRef Name="UserName"/>
</Key>
<Property Name="UserName" Type="Edm.String" Nullable="false"/>
<Property Name="FirstName" Type="Edm.String" Nullable="false"/>
<Property Name="LastName" Type="Edm.String"/>
<Property Name="MiddleName" Type="Edm.String"/>
<Property Name="Gender" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonGender" Nullable="false"/>
<Property Name="Age" Type="Edm.Int64"/>
<Property Name="Emails" Type="Collection(Edm.String)"/>
<Property Name="AddressInfo" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location)"/>
<Property Name="HomeAddress" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location"/>
<Property Name="FavoriteFeature" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" Nullable="false"/>
<Property Name="Features" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature)" Nullable="false"/>
<NavigationProperty Name="Friends" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person)"/>
<NavigationProperty Name="BestFriend" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person"/>
<NavigationProperty Name="Trips" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip)"/>
</EntityType>

Quando você configura um serviço OData em um Modelo de dados de formulário, todas as propriedades de navegação em um container de entidade são disponibilizadas por meio de um serviço no Modelo de dados de formulário. Neste exemplo do serviço OData do TripPin, as três propriedades de navegação no container da Person entidade podem ser lidas usando um GET LINK serviço no Modelo de dados de formulário.

O seguinte destaca o GET LINK of Person /People serviço no Modelo de dados de formulário, que é um serviço combinado para as três propriedades de navegação na Person entidade do serviço OData do TripPin.

nav-prop-service

Após adicionar o GET LINK serviço à guia Serviços no Modelo de dados de formulário, é possível editar as propriedades para escolher o objeto de modelo de saída e a propriedade de navegação a ser usada no serviço. Por exemplo, o GET LINK of Person /People serviço a seguir no exemplo a seguir usa o Trip como objeto de modelo de saída e a propriedade de navegação como Trips.

edit-prop-nav-prop

Observação

Os valores disponíveis no campo Valor ​padrão do argumento NavigationPropertyName dependem do estado da matriz Return? botão de alternância. Quando ativado, mostra as propriedades de navegação do tipo Coleção.

Neste exemplo, você também pode escolher o objeto de modelo de saída como Pessoa e argumento de propriedade de navegação como Amigos ou Melhor Amigo (dependendo se a matriz Retornar? está ativado ou desativado).

edit-prop-nav-prop2

Da mesma forma, você pode escolher um GET LINK serviço e configurar suas propriedades de navegação ao adicionar associações no Modelo de dados de formulário. No entanto, para poder selecionar uma propriedade de navegação, verifique se o campo Vínculo a está definido como Literal .

add-Association-nav-prop

Gerar e editar dados de amostra

O editor de modelo de dados de formulário permite gerar dados de amostra para todas as propriedades de objetos de modelo de dados, incluindo propriedades calculadas, em um modelo de dados de formulário. É um conjunto de valores aleatórios que está em conformidade com o tipo de dados configurado para cada propriedade. Também é possível editar e salvar dados, que são retidos mesmo se os dados de amostra forem regenerados.

Faça o seguinte para gerar e editar dados de amostra:

  1. Abra um modelo de dados de formulário e toque em Editar dados de amostra. Ele gera e exibe os dados de amostra na janela Editar dados de amostra.

    Gerar dados de amostra

  2. Na janela Editar dados de amostra, edite os dados, conforme necessário, e toque em Salvar.

Em seguida, é possível usar os dados de amostra para pré-preencher e testar as comunicações interativas com base no modelo de dados do formulário. Para obter mais informações, consulte Usar modelode dados de formulário.

Testar objetos e serviços do modelo de dados

Seu modelo de dados de formulário está configurado, mas antes de colocá-lo em uso, talvez você queira testar se os objetos e serviços do modelo de dados configurados estão funcionando como esperado. Para testar objetos e serviços do modelo de dados:

  1. Selecione um objeto de modelo de dados ou um serviço no modelo de dados de formulário e toque em Testar objeto de modelo ou Testar serviço, respectivamente.

    A janela Testar modelo de dados do formulário é aberta.

    test-data-model

  2. Na janela Testar modelo de dados de formulário, selecione o objeto ou serviço de modelo de dados a ser testado no painel Entrada.

  3. Especifique um valor de argumento no código de teste e toque em Testar. Um teste bem-sucedido retorna a saída no painel Saída.

    Resultados de teste

Da mesma forma, é possível testar outros objetos e serviços de modelo de dados no modelo de dados de formulário.

Validação automatizada dos dados de entrada

O modelo de dados de formulário valida os dados recebidos como entrada enquanto invoca a API do DermisBridge (com base nos critérios de validação disponíveis no modelo de dados de formulário). A validação se baseia no sinalizador ValidationOptions definido no objeto de query usado para chamar a API.

O sinalizador pode ser definido para qualquer um dos seguintes valores:

  • COMPLETO: O FDM realiza a validação com base em todas as restrições
  • DESLIGADO: Nenhuma validação
  • BÁSICO: O FDM realiza a validação com base em restrições "obrigatórias" e "anuláveis"

Se nenhum valor for definido para o ValidationOptionssinalizador, a validação BASIC será realizada nos dados de entrada.

Este é um exemplo de como configurar o sinalizador de validação como FULL:

operationOptions.setValidationOptions(ValidationOptions.FULL);
Observação

O valor fornecido para um atributo nos dados de entrada deve corresponder ao tipo de dados definido para o atributo no documento de metadados.
Se o valor não corresponder ao tipo de dados definido para o atributo, a API DermisBridge exibirá uma exceção independentemente do valor do ValidationOptions sinalizador. Se o nível de log estiver definido como Depuração, um erro será registrado no arquivo error.log .

O modelo de dados de formulário valida os dados de entrada com base em uma lista de restrições de tipo de dados. A lista de restrições para dados de entrada pode variar com base na fonte de dados.

A tabela a seguir lista as restrições para dados de entrada com base na fonte de dados:

Restrições Descrição Fonte de dados de entrada
required Se verdadeiro, o parâmetro deve ser incluído nos dados de entrada. Swagger, WSDL e banco de dados
nulo Se verdadeiro, o valor do parâmetro pode ser definido como Nulo nos dados de entrada. WSDL, Odata e banco de dados
maximum Especifica o limite superior para valores numéricos. O valor máximo especificado como limite superior também pode ser atribuído ao parâmetro nos dados de entrada. Swagger e WSDL
mínimo Especifica o limite inferior para valores numéricos. O valor mínimo especificado como o limite inferior também pode ser atribuído ao parâmetro nos dados de entrada. Swagger e WSDL
excludeMaximum Especifica o limite superior para valores numéricos. O valor máximo especificado como limite superior não deve ser atribuído ao parâmetro nos dados de entrada. Swagger e WSDL
uniqueMinimum Especifica o limite inferior para valores numéricos. O valor mínimo especificado como o limite inferior não deve ser atribuído ao parâmetro nos dados de entrada. Swagger e WSDL
minLength Especifica o limite inferior para o número de caracteres incluídos em uma string. O valor mínimo especificado como o limite inferior também pode ser atribuído ao parâmetro nos dados de entrada. Swagger e WSDL
maxLength Especifica o limite superior para o número de caracteres incluídos em uma string. O valor máximo especificado como limite superior também pode ser atribuído ao parâmetro nos dados de entrada. Swagger, WSDL, Odata e banco de dados
pattern Especifica uma sequência fixa de caracteres. A cadeia de caracteres de entrada é validada com êxito somente se os caracteres estiverem em conformidade com o padrão especificado. Swagger
minItems Especifica o número mínimo de itens em uma matriz. O valor mínimo especificado como o limite inferior também pode ser atribuído ao parâmetro nos dados de entrada. Swagger e WSDL
maxItems Especifica o número máximo de itens em uma matriz. O valor máximo especificado como limite superior também pode ser atribuído ao parâmetro nos dados de entrada. Swagger e WSDL
uniqueItems Se verdadeiro, todos os elementos da matriz devem ser exclusivos nos dados de entrada. Swagger
enum (string)

Restringe o valor de um parâmetro nos dados de entrada a um conjunto fixo de valores de string. Deve ser um storage com pelo menos um elemento, em que cada elemento é único. Swagger, WSDL e Odata
enum (número)

Restringe o valor de um parâmetro nos dados de entrada a um conjunto fixo de valores numéricos. Deve ser um storage com pelo menos um elemento, em que cada elemento é único. WSDL

Neste exemplo, os dados de entrada são validados com base em restrições máximas, mínimas e obrigatórias definidas no arquivo Swagger. Os dados de entrada atendem aos critérios de validação somente se a ID do pedido estiver presente e seu valor estiver entre 1 e 10.

   parameters: [
   {
   name: "orderId",
   in: "path",
   description: "ID of pet that needs to be fetched",
   required: true,
   type: "integer",
   maximum: 10,
   minimum: 1,
   format: "int64"
   }
   ]

Uma exceção será exibida se os dados de entrada não atenderem aos critérios de validação. Se o nível de log estiver definido como Depuração, um erro será registrado no arquivo error.log . Por exemplo,

21.01.2019 17:26:37.411 *ERROR* com.adobe.aem.dermis.core.validation.JsonSchemaValidator {"errorCode":"AEM-FDM-001-044","errorMessage":"Input validations failed during operation execution.","violations":{"/orderId":["numeric instance is greater than the required maximum (maximum: 10, found: 16)"]}}

Próximos passos

Você tem um modelo de dados de formulário que agora está pronto para uso em formulários adaptáveis e workflows de comunicação interativos. Para obter mais informações, consulte Usar modelode dados de formulário.

Nesta página