Ir para o conteúdo

Como Criar uma Tabela de Sessão

Todas as interações com App Builder ocorrem dentro do contexto de uma "sessão" da web. Uma sessão é criada quando um usuário visita pela primeira vez App Builder, e as solicitações subsequentes do mesmo Usuário são associadas à mesma sessão. Este guia mostrará como criar uma tabela de Sessão em App Builder, e então associá-lo a uma Regra e 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 com vários registros, provavelmente quebrará a Regra Padrão.

  1. Navegue até App Workbench > Rules
  2. Selecione By Table e, em seguida, selecione a tabela Session no painel Tables
  3. Clique no botão + Rule no painel Rules
  4. Defina o Purpose como Default
  5. Atribua o Nome como Session (New Session Default)
  6. Clique em Save
  7. 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 referenciando um intrínseco App Builder evento que é executado ao consultar a tabela por meio da interface do usuário do aplicativo.

  1. Navegue até App Workbench > Rules
  2. Selecione By Table, localize a tabela Session
  3. Clique no ícone Events para a tabela Session
  4. Clique em + Table Event no painel Data Storage Events
  5. Atribua o nome como Filter
  6. Clique em Save e saia da janela
  7. Clique em Register Existing em Actions
  8. Altere o valor Type para Plugin
  9. Selecione o plugin chamado "Create row on empty table". Este plugin criará uma nova linha se o Filter Event não retornar nenhuma linha.
  10. Insira a descrição da Technical Help
  11. Clique no botão Save