Adicione repetidores aos componentes

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Em Construtor de IU, use repetidores para repetir um ou mais componentes com resultados de um recurso de dados.

    Antes de Iniciar

    Função necessária: ui_builder_admin

    Por Que e Quando Desempenhar Esta Tarefa

    O componente repetidor atua como um loop básico que repete os dados fornecidos em vários componentes no Construtor de IU. Os repetidores usam uma matriz ou uma matriz de objetos. Por exemplo, a matriz [Tarefa": "A", "tarefa": "B"] repete o conteúdo dentro dele duas vezes. Os repetidores permitem que você faça isso vincularvalores para uma propriedade de matriz de dados. valor. (property_name) vincula os valores ao componente dentro dos repetidores. Se você quiser vincular uma tarefa, poderá vinculá-la como valor.tarefa.item e o repetidor exibe o valor correto.

    Os componentes dentro de um repetidor repetem o número de itens na fonte de dados, independentemente de a saída do componente se tornar dinâmica ou não. Por exemplo, digamos que você coloque um componente Cabeçalho dentro de um repetidor com três elementos de dados, mas não mude o campo Rótulo. Em seguida, você verá três instâncias do cabeçalho com o mesmo rótulo de saída.

    Procedimento

    1. Navegar até Tudo > 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 IUpara obter mais informações sobre como criar experiências.
    3. Abra o editor da página à qual você deseja adicionar o repetidor.
      Se você não criou uma página para sua experiência, consulte Crie uma página em Construtor de IUpara obter mais informações sobre como criar uma página.
    4. Conete um recurso de dados à sua página.

      Por exemplo, adicione o. Pesquisar vários registros recurso de dados para sua página. Consulte Adicione e configure recursos de dados a uma páginapara obter mais informações sobre como conectar um recurso de dados.

      1. No compartimento de recursos de dados, selecione Adicionar recurso de dados .
      2. No modal, pesquise por Pesquisar vários registros recurso de dados e selecione Adicionar .
      3. Em Tabela campo, insira Incidente .
      4. Em Máximo de resultados campo, insira 5 .

        . Pesquisar vários registros o recurso de dados está configurado.

        Configuração do recurso de dados com a tabela Incidente selecionada, campos de retorno "Aberto" e "Descrição resumida" adicionados, resultados máximos definidos como 5.
      5. Feche o modal.
    5. Selecione um contêiner existente ou crie um layout de coluna.
      Para obter mais informações, consulte Organizar componentes nas páginas do Construtor de IU.
    6. Adicione o componente repetidor à sua página.
      Seta apontando para o componente do repetidor na caixa de ferramentas.

      Para obter informações sobre como adicionar componentes, consulte Adicionar e configurar componentes.

    7. Em Configurar , selecione Nenhum - Configure o componente manualmente .
    8. Em Configurar , adicione uma matriz que defina os dados para componentes repetidos.
      1. Aponte para Matriz de dados E selecione o ícone Vincular dados ( Ícone de vinculação dinâmica de dados.).
      2. Em Tipos de dados , selecione Recurso de dados .
      3. Na próxima coluna, selecione Pesquisar vários registros 1 pílula.
      4. Em Exibição de cápsula , clique duas vezes ou arraste resultados para adicionar o. look_up_multiple_records_1.results saída.
      5. Selecione Aplicar.

        Os resultados do recurso de dados são vinculados ao componente do repetidor. No repetidor, um componente representa cada resultado.

        Configuração de vinculação de dados com data.look_up_multiple_records_1.results adicionados
    9. No repetidor que você adicionou na etapa anterior, selecione - Adicionar conteúdo .
      Árvore de conteúdo com uma seta preta apontando para o link Adicionar conteúdo no componente repetidor.
    10. Adicione um Título componente.
    11. Em Configurar , selecione Nenhum - Configure o componente manualmente .
    12. Configure o componente aninhado no repetidor.

      Por exemplo, vincule o. Valor de exibição para o componente. Para obter mais informações, consulte Conectar dados a seus componentes.

      1. Mova o cursor até Rótulo E selecione o ícone Vincular dados ( Ícone de vinculação dinâmica de dados.).
      2. Em Tipos de dados , selecione Repetidor .
      3. Em Exibição de cápsula , selecione valor pílula.
      4. Na próxima coluna, selecione número pílula.
      5. Na próxima coluna, clique duas vezes ou arraste Valor de exibição para adicionar o. Valor.number.displayValue saída.
      6. Selecione Aplicar.

        . Valor de exibição Está vinculado ao componente de título.

        Configuração de vinculação de dados com item.value.number.displayValue adicionada
    13. Selecione Save (Salvar).

      O componente que você vinculou ao recurso de dados aparece na fase e é repetido cinco vezes, uma vez para cada resultado retornado da tabela Incidente.

      Componente de título exibido cinco vezes, cada um com um valor de exibição diferente da tabela Incidente.
    14. Para exibir e testar sua página, selecione Visualização botão.
      Uma guia é aberta para exibir a visualização da página com dados repetidos.

      A visualização da página exibe todos os dados de componentes repetidos.