Ir para o conteúdo

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

Introdução

Todas as interações com o App Builder ocorrem dentro do contexto de uma "sessão" web. Uma sessão é criada quando um usuário visita o App Builder pela primeira vez. Solicitações subsequentes do mesmo usuário estão associadas à mesma sessão. Esta página mostra como criar uma tabela de sessão e associá-la a uma regra e a um evento.

Casos de uso de negócios para sessões

As seguintes são algumas das maneiras pelas quais as sessões podem ser usadas:

  • Rastrear e distinguir entre usuários autenticados sob a mesma conta. Por exemplo, se duas pessoas estiverem conectadas como um usuário administrador, as sessões permitem rastreá-las individualmente.

  • Rastrear múltiplos usuários anônimos.

  • Filtrar critérios de relatório com base na sessão.

Criar uma tabela de sessão

Você pode criar uma tabela de sessão a partir da camada de armazenamento de dados da sua aplicação:

  1. Navegue até o App Workbench.

  2. No painel Ações Rápidas, clique em + Tabela.

  3. Dê à nova tabela o nome Sessão e clique em Salvar.

  4. Verifique se uma coluna com o nome SessionID e o tipo de dado UUID foi criada e se foi designada como a chave primária. (Isso deve acontecer automaticamente.)

  5. No painel Tabela, clique em Mais > Caso Especial para ver opções avançadas.

  6. Na seção Configurações Gerenciadas, use o dropdown Finalidade para selecionar Tabela Gerenciada. Outro dropdown, Tipo Gerenciado, se torna visível. Clique nele e selecione Sessão.

  7. Adicione colunas adicionais necessárias para sua sessão.

  8. Clique em Aprimorar Tabela, depois em Prosseguir.

Em seguida, você deve criar um evento personalizado referenciando um evento intrínseco do App Builder que é executado ao consultar a tabela via a interface do usuário da aplicação. Para fazer isso, siga estas etapas:

  1. Navegue até o App Workbench > Regras.

  2. Sob Fontes de Dados do App, selecione Por Tabela. No painel Tabelas, procure na lista de tabelas para encontrar a tabela Sessão que você criou anteriormente.

  3. Na linha da tabela Sessão, clique no ícone sob a coluna Eventos. A caixa de diálogo Eventos de Armazenamento de Dados é aberta.

  4. Clique em + Evento de Tabela. A página Evento é aberta.

  5. Dê ao novo evento o nome "Filtro" e clique em Salvar. Uma página de edição é aberta.

  6. Sob o painel Ações, clique em Registrar. Uma caixa de diálogo Ação é aberta.

  7. No dropdown Tipo, selecione Plugin.

  8. No dropdown Plugin, selecione Criar linha em tabela vazia. Este plugin cria uma nova linha se o evento Filtro não retornar linhas.

  9. (Opcional) Insira uma descrição do evento no campo Ajuda Técnica.

  10. Clique no botão Salvar.