Configurar a adição de registros a uma lista relacionada

Crie um botão Adicionar para que os agentes possam adicionar registros a uma Lista relacionada.

Antes de Iniciar

Função necessária: workspace_admin

Por Que e Quando Desempenhar Esta Tarefa

Você pode criar um botão Adicionar que permite aos agentes adicionar registros a listas. Esta funcionalidade oferece suporte a tabelas um para muitos (o2m) e muitos para muitos (m2m). No exemplo a seguir, usamos as tabelas task_location e criamos o botão Adicionar para incidentes. Portanto, ao abrir um incidente, você pode clicar na nova lista relacionada, Locais afetados, para ver os incidentes (tarefas) que ocorreram no mesmo local. Muitos incidentes podem ocorrer em um local e um incidente pode envolver vários locais.

O procedimento geral é adicionar a Lista relacionada, Locais afetados que estão associados à tabela de muitos para muitos, task_location e, em seguida, criar uma Ação do espaço para criar o botão Adicionar que adiciona, em nosso exemplo, locais a um incidente.

Quando um agente clica em Adicionar, um modal é aberto mostrando os locais do agente onde o incidente pode ser adicionado.

Para entender o exemplo a seguir, insira task_location.list no Navegador de filtro para mostrar a tabela task_location.

A tabela mostra as associações entre as tabelas de local (cmn_location) e de tarefa (tarefa). No exemplo, não há nenhum.

Procedimento

1. Adicione uma nova Lista relacionada, Locais afetados, que é aberta com registros de incidentes.
   1. Abra um incidente navegando até Incidente > Em aberto e clique em um incidente.
   2. Confirme que você está na exibição do espaço clicando no ícone do seu perfil, selecionando Configurar página > Layout do formulário.
   3. Configure uma lista relacionada para a tabela Incidente clicando no ícone do seu perfil (ícone de ), selecionando Configurar página > Listas relacionadas.
   4. No formulário Configuração de listas relacionadas no Incidente, em Nome de exibição, selecione Espaço.
   5. Selecione Locais afetados e use as setas para movê-lo para a coluna Selecionado.
      O valor de task_location é chamado de Locais afetados.
   6. Clique em Salvar.
      Você adicionou Locais afetados como uma lista relacionada para todos os registros de incidentes.

      

2. Use uma Ação do espaço para criar um botão Adicionar que permite que os agentes adicionem locais a um incidente.
   1. Navegar até Estrutura do Now Experience > Ações declarativas > Ações de Lista relacionada e clique em Novo.
   2. No formulário, preencha os campos.

      Tabela 1. Formulário Atribuição de ação

      Campo	Descrição
      Rótulo da ação	Rótulo que aparece no botão na área Listas relacionadas. Faça isso Adicionar. Na imagem anterior, o botão Adicionar aparecerá ao lado do botão Novo.
      Nome da ação	O nome deste registro que aparece na lista de ações da lista relacionada, Estrutura do Now Experience > Ações declarativas > Ações de Lista relacionada. Nota: Este registro é preenchido automaticamente depois que você cria um rótulo de ação.
      Implementados como	Selecione Componente de IU porque você está criando um botão.
      Especificar componente de IU	Selecione sn-multi-record-associator.
      Tipo de botão	Selecione Primário. Os botões primários são verdes. Os botões secundários são cinza.
      Seleção de Registro Solicitada	Caixa de seleção para tornar a seleção de registro obrigatória.
      Dica da ferramenta	Texto que aparece quando os agentes passam o mouse sobre o componente de IU.
      Descrição	Descrição detalhada desta ação do espaço.
      Aplicação	Aplicação à qual este componente se aplica. Global significa que o componente se aplica a todas as aplicações.
      Espaço	Espaço em que este componente de IU aparece.
      Tabela	Tabela em que esta ação de lista relacionada aparece. Para um relacionamento o2m, certifique-se de que a tabela seja sua tabela de lista relacionada o2m. Por exemplo, incidente. Para um relacionamento m2m, certifique-se de que a tabela seja sua tabela m2m. Por exemplo, task_location. Em nosso exemplo, selecione task_location.
      Exibição	Selecione o espaço.
      Ativo	Alterne para ativar (selecionado) e desativar este componente de IU.
      Ordem	A ordem de sequência na qual este componente de IU aparece em uma lista horizontal de componentes de IU. Quanto menor o valor, mais à esquerda o local.

   3. Em Links relacionados, clique em Exibição avançada para fornecer ao componente as propriedades necessárias para funcionar.
   4. Na guia Atributos do componente, preencha os campos.

      Tabela 2. Formulário Atributos do componente

      Campo	Descrição
      rótulo	Nome que aparece na parte superior do modal quando você clica no botão Adicionar.
      extensionPoint	Em nosso exemplo, deixe em branco. Este campo filtra a lista no modal. Quando um agente clica em Adicionar, todas as associações possíveis são mostradas entre as tabelas cmn_location e de tarefa. Este campo impede algumas dessas associações. Para saber como criar um ponto de extensão, consulte Como usar pontos de extensão para estender a funcionalidade da aplicação.
      userGivenTable	Tabela que aparece no modal. Em nosso exemplo, queremos abrir os locais que os agentes podem adicionar, portanto, selecione cmn_location. Selecione task_location para relacionamentos m2m. Para relacionamentos o2m, selecione a tabela associada à parte de muitos do seu o2m. Por exemplo, Incidente.
      hideSelectAll	Campo que permite ocultar Selecionar tudo. Selecione Verdadeiro para ocultar Selecionar tudo.
      referencedfieldName	Campo exibido no modal do userGivenTable. Em nosso exemplo, insira o local (em minúsculas). Para encontrar o nome do campo, clique com o botão direito do mouse no título do campo Local no formulário da tabela de muitos para muitos. Este campo não é usado para relacionamentos o2m.
      tipo	Tipo de relacionamento de registro. Selecione um relacionamento o2m ou m2m para os registros. O o2m permite que um registro primário em uma tabela que pode fazer referência a vários registros secundários. O m2m permite vários registros em uma tabela que estão associados a vários registros em outra tabela.
      parentFieldName	O nome do campo do qual você está fazendo a referência, neste exemplo, é tarefa. Para encontrar o nome do campo, clique com o botão direito do mouse no título do campo.
      colunas	Lista separada por vírgulas de colunas que você deseja exibir no modal. Por exemplo, na tabela cmn_location, você pode querer nome e cidade. Portanto, insira name,city.
      exibição	A exibição da lista. Não adicione um valor; a exibição padrão está correta.

   5. Clique em Atualizar.
      Você criou um botão Adicionar que aparece na área Listas relacionadas quando um registro de incidente é aberto.
3. Verifique se o botão Adicionar aparece e funciona.
   1. Abra um incidente navegando até Incidente > Em aberto e clicando em um incidente.
   2. Clique na Lista relacionada de locais afetados.
      Você deve ver o botão Adicionar em Listas relacionadas.
   3. Clique em Adicionar.
      Um modal aparece para adicionar o local.
   4. Marque várias caixas de seleção para adicionar esses endereços ao registro do incidente e clique em Adicionar.
      Os endereços selecionados aparecem em Locais afetados.
   5. Insira task_location.list no Navegador de filtro para mostrar a tabela task_location.
      Os novos locais devem aparecer na tabela.
4. Adicione uma ação de remoção.

   Você pode criar um botão de remoção que permite aos agentes remover registros de uma lista relacionada e desassociar esse registro da tabela primária. Esta funcionalidade oferece suporte a tabelas o2m e m2m.

   1. Navegar até Experiência de espaço > Ações e Componentes > Ações de Lista relacionada e clique em Novo.
   2. No formulário, preencha os campos.

      Tabela 3. Formulário Atribuição de ação

      Campo	Descrição
      Rótulo da ação	Rótulo que aparece no botão na área Listas relacionadas. Certifique-se de que o rótulo da ação inclua ({{count}}) .
      Nome da ação	O nome deste registro que aparece na lista de ações da lista relacionada, Experiência de espaço > Ações e Componentes > Ações de Lista relacionada.
      Implementados como	Selecione Script de servidor.
      Especificar componente de IU	Selecione sn-multi-record-associator.
      Tipo de botão	Selecione Primário. Os botões primários são verdes. Os botões secundários são cinza.
      Seleção de Registro Solicitada	Caixa de seleção para tornar a seleção de registro obrigatória. Alterne a caixa de seleção.
      Dica da ferramenta	Texto que aparece quando os agentes passam o mouse sobre o componente de IU.
      Descrição	Descrição detalhada desta ação do espaço.
      Aplicação	Aplicação à qual este componente se aplica. Global significa que o componente se aplica a todas as aplicações.
      Espaço	Espaço em que este componente de IU aparece.
      Tabela	Tabela em que esta ação de lista relacionada aparece. Para um relacionamento o2m, certifique-se de que a tabela seja sua tabela de lista relacionada o2m. Por exemplo, incidente. Para um relacionamento m2m, certifique-se de que a tabela seja sua tabela m2m. Por exemplo, task_location. Em nosso exemplo, selecione task_location.
      Exibição	Selecione o espaço.
      Ativo	Alterne para ativar (selecionado) e desativar este componente de IU.
      Ordem	A ordem de sequência na qual este componente de IU aparece em uma lista horizontal de componentes de IU. Quanto menor o valor, mais à esquerda o local.

   3. Clique no ícone de menu (ícone de ) e clique em Salvar.
   4. Em Links relacionados, clique em Exibição avançada.
   5. Clique na guia Script do servidor.
   6. Insira um script de servidor no campo de script. current.deleteRecord(); no campo de script do servidor.
      • Para relacionamentos m2m, insira current.deleteRecord();.
      • Para relacionamentos o2m, insira current.[field_name] = ''; atual.atualização();.
   7. Em Links relacionados, clique em Exibição avançadae clique na guia Configurações de confirmação.
   8. Confirmação de alternância necessária.
   9. Clique em Atualizar.

O que Fazer Depois

Clique em um componente para configurá-lo.

Guias Notificações Cabeçalho do Formulário Ações de IU

Faixa de opções Itens relacionados Painel de formulário Ações e Componentes

Activity Stream Painel Lateral Contextual