Tabelas Gerenciadas¶

Em App Builder Tabelas gerenciadas são como tabelas regulares, exceto que os dados armazenados nelas são gerenciados ou mantidos por App Builder. Elas são gerenciadas por Usuário, Janela ou Sessão, dependendo de como a tabela é configurada quando é criada. Não há limite para o número de Tabelas Gerenciadas que um aplicativo pode ter configurado.

As Tabelas Gerenciadas são projetadas para permitir que os desenvolvedores armazenem essencialmente dados temporários sobre um Usuário, Janela ou Sessão. Os dados para essas tabelas são removidos automaticamente após uma janela de tempo especificada, dependendo do tipo de dados que você está armazenando:

• Usuário = App Builder verifica todas as noites e se o usuário não estiver mais no sistema, ele excluirá de acordo
• Janela = App Builder verifica a cada 2 dias e exclui de acordo
• Session = App Builder verifica uma vez por mês e exclui de acordo

O caso de uso perfeito para Tabelas Gerenciadas é para painéis ou páginas de Pesquisa que precisam armazenar dados temporários antes de criar uma inserção em uma tabela final, como durante um processo de várias etapas, como um Assistente.

Por exemplo: se Usuário for selecionado como o Tipo Gerenciado, os dados nesta tabela existirão apenas para o usuário atual conectado App Builder. Nos bastidores App Builder adiciona uma coluna UserId invisível à Tabela Gerenciada. Sempre que dados são selecionados contra ela, há um UserId na cláusula where, e sempre que dados são inseridos, o UserId é inserido automaticamente.

Tipos Gerenciados¶

App Builder permite que você crie Tabelas Gerenciadas com base nas três opções de critérios a seguir:

1. Usuário = Usuário atual conectado em App Builder.
2. Janela = Cada janela ou aba de um navegador é identificada exclusivamente.
3. Sessão = Cada sessão de navegador de longa duração.

Inserção Automática¶

Auto Insert é uma opção que pode ser configurada ao configurar uma Tabela Gerenciada. Se habilitada, App Builder irá automaticamente "preparar" a tabela com pelo menos um registro.

Para painéis de pesquisa, geralmente é necessário sempre ter uma linha que existirá na tabela. Se Auto Insert estiver marcado ou habilitado, antes de retornar dados App Builder verificará se a tabela está vazia e, se estiver, executará um evento New e, em seguida, Insert. Você pode adicionar ações em Insert e Defaults em New para preencher previamente os dados.

Para Criar uma Tabela Gerenciada¶

1. Navegue até o App Workbench > + Table
2. Selecione a fonte de dados para adicionar a Tabela (se o aplicativo tiver > 1 fonte de dados)
3. Atribua o Nome à tabela. Por exemplo: Pesquisar
4. Clique em Salvar
5. Navegue até Mais > Caso Extremo
6. Defina o Objetivo como Tabela Gerenciada
7. Defina o Tipo Gerenciado como o valor que você deseja criar. Por exemplo: Usuário
8. Decida se você quer App Builder para Inserir automaticamente um registro ou não, se sim, clique para habilitar

9. Clique em Salvar

   

10. Na aba Columns, adicione quaisquer colunas que você queira ao valor Managed Table Type no seu painel. Por exemplo: SearchID, Country

11. Clique em Resultados para visualizar dados em tempo real.

    Nota

    O resultado dinâmico não exibirá um registro preparado

No exemplo descrito aqui, agora você pode usar esta tabela em um painel para Pesquisar por país, por exemplo.

Comportamento de Tabela Gerenciada em Regras¶

Quando uma Tabela Gerenciada é usada em uma regra de negócios, o desenvolvedor tem a capacidade de configurar o comportamento dos registros retornados usando a opção Incluir Vinculações.

A configuração padrão para Incluir Ligações é habilitada, o que instrui App Builder para incluir as ligações para a Sessão/Usuário/Janela ao executar a subconsulta na Tabela Gerenciada. Se você quiser, em vez disso, relatar todos os registros contidos na tabela, sem essa ligação, desmarque a opção Incluir Ligações.

1. Navegue até o App Workbench > Regras
2. Localize a regra com uma tabela gerenciada e clique no ícone de edição de lápis correspondente
3. Na aba Tabelas, clique na região do nome da tabela azul

4. Defina a opção Incluir ligações de acordo com os resultados desejados

   

5. Clique no botão Resultados para validar se os registros retornados são os pretendidos