Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

Esta documentação é para a versão 4 e posterior do App Builder, o novo nome do Vinyl. Acesse a documentação do Vinyl aqui.

Como criar uma tabela de sessão no Jitterbit App Builder

Todas as interações com o App Builder ocorrem dentro do contexto de uma "sessão" da web. Uma sessão é criada quando um Usuário visita o App Builder pela primeira vez, e solicitações subsequentes do mesmo Usuário são associadas à mesma sessão. Este guia mostrará como criar uma tabela de Sessão no App Builder e, em seguida, associá-la a uma Regra e a um Evento.

Casos de uso comercial para sessões

  • Rastreie e diferencie entre Usuários autenticados na mesma conta. Por exemplo, se duas pessoas estiverem conectadas como Usuário Admin, o Sessions permite que você as rastreie individualmente.
  • Rastreie múltiplos Usuários anônimos
  • Filtre os critérios do relatório com base na sessão

Para criar uma tabela de sessão

O primeiro passo é criar a tabela Session na Data Storage Layer.

  1. Navegue até o App Workbench
  2. Clique em + Table
  3. Atribua o Nome como Session e clique em Save
  4. Confirme que uma UUID Primary Key Column foi criada para SessionID
  5. Adicione quaisquer Colunas restantes que você precisa que sejam relativas à sua sessão. Isso é específico para as necessidades do aplicativo.
  6. Clique no botão Enhance Table e Proceed

O segundo passo é criar uma Default Rule para a tabela Session.

Importante

Você não precisa inserir uma Tabela nesta definição de Regra. Isso pode funcionar usando uma tabela de Parâmetros, pois há apenas um registro. Se você usar uma tabela de vários registros, provavelmente quebrará a Regra Padrão.

  1. Navegue até o App Workbench > Regras
  2. Selecione Por tabela e, em seguida, selecione a tabela Sessão no painel Tabelas
  3. Clique no botão + Regra no painel Regras
  4. Defina o propósito como Padrão
  5. Atribua o nome como Sessão (Nova sessão padrão)
  6. Clique em Salvar
  7. O App Builder adicionará automaticamente a tabela Session ao seu Business Object, que deve ser excluído
  8. Clique na aba Colunas
  9. Clique no botão + Column adicione a expressão session(), direcionando SessionID e atribua um Alias como SessionID
  10. Clique em Salvar

O terceiro passo é registrar a Regra Padrão para que, quando um novo registro for inserido, o padrão seja o SessionID.

  1. Navegue até o App Workbench > Regras
  2. Selecione Por tabela, localize a tabela Sessão e clique em Abrir registro
  3. Clique em Mais > Caso Extremo
  4. Clique no botão Padrões
  5. Clique no botão Registrar existente
  6. Defina a regra como Sessão (Nova sessão padrão)
  7. Defina o Tipo de Vinculação como Explícito
  8. Clique no botão Salvar

A quarta etapa é criar um evento personalizado que faça referência a um evento do Intrinsic App Builder que é executado ao consultar a tabela por meio da interface do usuário do aplicativo.

  1. Navegue até o App Workbench > Regras
  2. Selecione Por tabela, localize a tabela Sessão
  3. Clique no ícone Eventos para a Tabela de Sessões
  4. Clique em + Evento de tabela no painel Eventos de armazenamento de dados
  5. Atribua o nome como Filtro
  6. Clique em Salvar e saia da janela
  7. Clique em Registrar existente em Ações
  8. Altere o valor do Tipo para Plugin
  9. Selecione o plugin chamado "Criar linha em tabela vazia". Este plugin criará uma nova linha se o evento de filtro não retornar nenhuma linha.
  10. Insira a descrição da Ajuda Técnica
  11. Clique no botão Salvar