Acionar uma interação de IU a partir de uma ação declarativa

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 3 min. de leitura
  • Acione uma interação de IU a partir de uma ação declarativa para estender uma página sem assumir a propriedade.

    Antes de Iniciar

    Execute as seguintes ações:
    1. Crie uma interação de IU em Construtor de IU. Para obter instruções, consulte Crie uma interação de IU .
    2. Crie uma ação declarativa e adicione o botão a um espaço. Para obter instruções, consulte Criando botões de ação declarativa .
    Função necessária:
    iu_interaction_admin
    Fornece permissões completas de CRUD e é herdado por admin e ui_builder_admin.
    iu_interaction_developer
    Fornece permissões para criar, ler e atualizar, mas não para excluir interações de IU ou suas entradas.

    Por Que e Quando Desempenhar Esta Tarefa

    As interações de IU são fluxos reutilizáveis que combinam elementos de IU e lógica em uma única unidade. Eles ajudam a evitar repetir a mesma fiação em várias páginas e facilitam a manutenção dos seus projetos.

    Uma interação de IU define o que você deseja que aconteça, e como você aplica uma interação de IU define como e quando isso acontece. Você pode acionar interações de IU a partir de eventos de página no Construtor de IU ou de ações declarativas.
    • Acione uma interação de IU a partir de uma ação declarativa se você precisar de um botão em um formulário ou lista sem personalização de página.
    • Acione uma interação de IU a partir de um evento de página do Construtor de IU para personalizar botões e componentes em uma página sua.

    Uma interação de IU pode ser usada em vez de uma ação de cliente UXF para simplificar a configuração, já que não há necessidade de configurar o mapeamento de evento de complemento em um correspondente Construtor de IU página.

    Para obter uma visão geral detalhada das interações de IU, consulte Interações de IU .

    Procedimento

    1. Navegar até Tudo > Estrutura do Now Experience > Ações declarativas e selecione Ações do formulário , Ações da lista , ou Ações da lista relacionada .
      Nota:
      As interações de IU só estão disponíveis para ações de formulário, lista e lista relacionada.
    2. Na lista Atribuição de ação, selecione uma ação.
      Um registro de atribuição de ação é aberto.
    3. No campo Implementado como, selecione Interação de IU .
      Um novo campo chamado Interação de IU é exibido.

      Campo de interação de IU

    4. No campo Interação de IU, selecione uma interação de IU.
      A caixa de diálogo Configurar entradas é aberta com os valores padrão da interação de IU.

      As entradas definem os parâmetros de dados que a interação de IU precisa executar.

      Os campos exibidos na caixa de diálogo Configurar entradas dependem das entradas configuradas para a interação de IU selecionada em Construtor de IU. Se nenhuma entrada tiver sido definida, a caixa de diálogo Configurar entradas não será aberta.

      Por exemplo, uma interação de IU para criar um novo registro pode exigir que você defina uma entrada para a tabela do novo registro.

      Caixa de diálogo Configurar entradas

    5. Opcional: Para definir um valor estático para uma entrada, insira um valor especificado.

      Por exemplo, se a interação de IU selecionada para criar um novo registro definir uma entrada para a tabela do novo registro e você quiser passar dados da tabela Incidente [incidente], insira incidente .

    6. Opcional: Defina um valor dinâmico para uma entrada.
      1. Selecione o ícone de dados ( ícone de dados).
      2. Insira um valor encapsulado por chaves duplas de abertura e fechamento.

        Use valores da tabela Definição do modelo de ação [sys_declarative_action_model_definition] para o tipo de ação que você está configurando, como Formulário, Lista ou Lista relacionada.

      Por exemplo, se a interação de IU selecionada para criar um novo registro definir uma entrada para a tabela do novo registro e você quiser passar dados dinamicamente da tabela atual, insira (tabela) .

    7. Selecione Salvar Para salvar as mudanças e fechar a caixa de diálogo Configurar entradas.
    8. Selecione Atualizar.

    Resultado

    Quando o botão de formulário ou lista é selecionado, as entradas especificadas passam dados para a interação de IU, e a interação de IU executa a ação que foi configurada para executar.