Adicionar um recurso de dados do mapeador de ação de exibição da entidade a uma página

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura
  • Adicione um recurso de dados do Entity View Action Mapper (EVAM) à sua página em Construtor de IU para que você possa padronizar como as fontes de dados em seus componentes são exibidas em seus cartões e listas.

    Antes de Iniciar

    Função necessária: ui_builder_admin

    Procedimento

    1. Navegar até Todos > Estrutura do Now Experience > Construtor de IU.
    2. Abra uma experiência para trabalhar ou crie uma experiência selecionando Criar > Experiência.
      Consulte Configure como os usuários interagem com suas aplicações no Construtor de IU para obter mais informações sobre como criar experiências.
    3. Abra ou crie uma página.
      Para obter mais informações, consulte Gerenciar Construtor de IU páginas e variantes de página.
    4. Opcional: Se você não tiver nenhum componente em sua página, adicione um componente de conjunto de dados à sua página.
      Para obter mais informações, consulte Adicionar e configurar componentes.
    5. No painel Dados e scripts, selecione o ícone + e selecione Recurso de dados.
      Seta apontando para a opção de recurso de dados.
    6. Insira evam no campo de pesquisa.
    7. Selecione o recurso de dados do EVAM que você deseja adicionar e repita esta etapa para todos os recursos de dados do EVAM da sua página.
      Recursos de dados do EVAM.
    8. Configure cada recurso de dados do EVAM.
      Tabela 1. Fontes de dados do EVAM
      Fonte de dados do EVAM Descrição
      Recurso de dados de EVAM Adicione uma definição do EVAM e outras informações sobre a fonte de dados.
      • Tipo: composto.
      • Quando avaliar: na lista Quando avaliar este recurso de dados, selecione Imediatamente para que a instância do recurso de dados do EVAM seja avaliada no carregamento da página ou selecione Somente quando invocado para usar um manipulador de eventos para avaliar o recurso de dados do EVAM.
      • Definição do EVAM: no campo Definição do EVAM, adicione o registro de definição do EVAM que está associado ao recurso de dados.
      • Cursor de página: no campo Cursor de página, adicione um cursor de página para a definição do EVAM.
      • Tamanho da página: no campo Tamanho da página, adicione um tamanho para a paginação do EVAM.
      • Número da página: no campo Número da página, adicione o número da página para a paginação do EVAM.
      • Preferência de filtro do EVAM: no campo Preferência de filtro do EVAM, adicione os sys_ids para o filtro de dados do EVAM.

      Para adicionar um manipulador de eventos para quando a busca de dados for iniciada, bem-sucedida ou falhar, selecione Eventos.

      Na seção Editor de código do Now, que fica ao lado do painel Configuração, visualize o script de definição do EVAM.

      Figura 1. Configuração de recursos de dados do EVAM
      Configuração de recursos de dados do EVAM.
      Obter dados do EVAM Para adicionar uma definição do EVAM e outras informações sobre a fonte de dados, selecione Configuração.
      • Tipo: GRAPHQL.
      • Quando avaliar: para que a instância do recurso de dados do EVAM seja avaliada em um carregamento de página, selecione Imediatamente. Para usar um manipulador de eventos para avaliar o recurso de dados do EVAM, selecione Somente quando invocado.
      • Definição do EVAM: no campo Definição do EVAM, adicione o registro de definição do EVAM que está associado ao recurso de dados.
      • Cursor de página: no campo Cursor de página, adicione um cursor de página para a definição do EVAM.
      • Tamanho da página: no campo Tamanho da página, adicione um tamanho para a paginação do EVAM.
      • Número da página: no campo Número da página, adicione o número da página para a paginação do EVAM.
      • Preferência de filtro do EVAM: no campo Preferência de filtro do EVAM, adicione os sys_ids para o filtro de dados do EVAM.

      Para adicionar um manipulador de eventos para quando a busca de dados for iniciada, bem-sucedida ou falhar, selecione Eventos.

      Visualize o script de definição do EVAM no Now Code Editor à direita do painel Configuração.

      Buscar configuração da fonte de dados do EVAM.

      Obter metadados do EVAM Para selecionar quando avaliar o recurso de dados do EVAM e adicionar uma definição do EVAM, selecione Configuração.
      • Tipo: GRAPHQL.
      • Quando avaliar: para que a instância do recurso de dados do EVAM seja avaliada em um carregamento de página, selecione Imediatamente. Para usar um manipulador de eventos para avaliar o recurso de dados do EVAM, selecione Somente quando invocado.
      • Definição do EVAM: no campo Definição do EVAM, adicione o registro de definição do EVAM que está associado ao recurso de dados.

      Para adicionar um manipulador de eventos para quando a busca de dados for iniciada, bem-sucedida ou falhar, selecione Eventos.

      Visualize o script de definição do EVAM no Now Code Editor à direita do painel Configuração.

      Buscar configuração de metadados do EVAM.

      Pesquisar recurso de dados do EVAM Para adicionar uma definição do EVAM e outras informações sobre a fonte de dados, selecione Configuração.
      • Tipo: composto.
      • Quando avaliar: para que a instância do recurso de dados do EVAM seja avaliada em um carregamento de página, selecione Imediatamente. Para usar um manipulador de eventos para avaliar o recurso de dados do EVAM, selecione Somente quando invocado.
      • ID de configuração do EVAM: no campo ID de configuração do EVAM, adicione o ID de configuração do EVAM associado ao registro de dados.
      • ID de configuração do contexto de pesquisa: no campo ID de configuração do contexto de pesquisa, adicione o ID de configuração do contexto de pesquisa que você está procurando.
      • Termo de pesquisa: no campo Termo de pesquisa, adicione os termos de pesquisa que você está procurando
      • Filtros de aspecto: no campo Filtros de aspecto, adicione filtros de aspecto para ajudar a definir sua pesquisa.
      • Filtros de pesquisa: no campo Filtros de pesquisa, adicione filtros de pesquisa para ajudar a definir sua pesquisa.
      • Desabilitar verificação ortográfica: no campo Desabilitar verificação ortográfica, selecione se você deseja que a verificação ortográfica esteja ativada ou desativada durante a pesquisa.
      • Token de paginação: no campo Token de paginação, adicione um token de paginação, se necessário.

      Para adicionar um manipulador de eventos para quando a busca de dados for iniciada, bem-sucedida ou falhar, selecione Eventos.

      Visualize o script de definição do EVAM no Now Code Editor à direita do painel Configuração.

      Configuração de recursos de dados do EVAM de pesquisa.

    9. Configure o componente do conjunto de dados:
      • Vincule um recurso de dados do EVAM ao seu componente.
      • Defina a alternância Mostrar grade/lista como ativada para permitir que os usuários escolham entre a exibição de grade ou de lista das informações do EVAM na página.
      • Defina as outras definições de configuração para os cartões na página.
    10. Selecione Salvar.
    11. Exiba e teste sua página selecionando o botão Visualizar.
      Figura 2. Estado concluído do EVAM
      Estado concluído do EVAM.