Use tabelas nos aplicativos

Veja a seguir como ler e gravar em tabelas a partir de aplicativos de operações de linha de frente.

Neste guia, você aprenderá...

• Como ler registros existentes de tabelas em um aplicativo
• Como atualizar registros de tabelas existentes em um aplicativo
• Como criar novos registros de tabela em um aplicativo
• Como analisar dados em tabelas com base nas conclusões do aplicativo

No Editor de Aplicativos, você pode ler, editar e criar registros individuais de tabelas. Como as tabelas não exigem nenhum código, você pode executar seus aplicativos no Player e observar as tabelas serem atualizadas em tempo real.

Este guia abordará as várias maneiras pelas quais você pode usar tabelas e aplicativos em conjunto para criar aplicativos mais poderosos.

Existem três etapas para ler ou atualizar qualquer registro de tabela:

1- Crie um “Espaço reservado para registro” para dar um nome a esse registro específico da tabela dentro do aplicativo

2- Carregue (ou crie) o registro em uma ação de gatilho

3a- Se você quiser atualizar campos individuais no registro, inclua o registro da tabela em uma instrução “Then”.

3b- Se você quiser criar uma lógica com base nos valores do registro da tabela, inclua o registro da tabela em uma instrução “If”

Variáveis do aplicativo x Registros de tabela

Ao criar aplicativos, talvez seja necessário decidir se um dado específico deve ser armazenado em uma variável ou em um registro de tabela.

Variáveis são mais adequadas para dados relevantes para o uso individual daquele aplicativo específico. Tabelas são mais adequadas para dados que precisam ser acessados por vários aplicativos.

As tabelas são frequentemente usadas para rastrear conceitos como:* Ordens de serviço* SKUs de produtos individuais* Lista de materiais (BOM)* Matriz de competências* ...e muito mais

Antes de ler este artigo, você deve primeiro ler“Uma visão geral das tabelas ” para compreender plenamente os recursos das tabelas.

Etapa 1 – Criação de um espaço reservado para registro

Primeiro, você precisará criar um**“Espaço reservado para registro”**no aplicativo onde acessará o registro da tabela. Esses são espaços reservados para registros que serão carregados dinamicamente posteriormente na lógica de gatilho.

Por exemplo, se você quiser editar um registro da tabela “Ordens de Serviço” em um aplicativo, poderá ter um Espaço-reservado para Registro chamado “Ordem de Serviço Ativa”.

Posteriormente, você carregaria um registro dinamicamente com base na entrada do operador, mas ele sempre seria referenciado como “Ordem de Serviço Ativa”

Para configurar esses espaços reservados, clique na guia “Registros” ao lado da Lista de Etapas.

Em seguida, escolha “Adicionar uma tabela”. Depois, clique em “Adicionar um ‘Espaço reservado para registro’”. Você poderá dar um nome ao registro que será carregado dinamicamente a partir de um gatilho (por exemplo, “Ordem de serviço ativa”).

Observe que há uma configuração chamada “Salvar para análise”. Quando selecionada, ela salvará o registro da tabela carregado nesse marcador de posição de registro no Registro de Conclusão do aplicativo.

Etapa 2 – Acessando registros no Editor de Gatilhos

Após criar o “Espaço-reservado de Registro”, você pode agora escrever a lógica para carregar ou criar registros dinamicamente com base nas entradas do operador.

Você pode usar as ações de gatilho “Registros da tabela” e “Manipulação de dados” para fazer isso. Veja como proceder.

Adicione uma instrução “Então”

Você pode ler ou modificar registros da tabela com vários tipos de ações de gatilho. Aqui está um resumo rápido.

Registros da tabela/Carregar registro: carrega um registro existente com um ID específico

Registros da tabela/Criar registro: cria um novo registro com um ID específico

Registros da tabela/Criar ou carregar registro: SE um registro com um ID específico não existir, crie-o. Caso contrário, carregue o registro com um ID específico.

Carregamento de registros existentes

Para ler ou editar um registro, você deve primeiro carregá-lo em um aplicativo e atribuir a ele um nome provisório. Isso geralmente é acionado pela abertura de uma etapa ou pelo pressionamento de um botão.

Você pode carregar um registro por vez e deve usar o ID exclusivo (primeiro campo da tabela, valor de texto) para selecionar o registro.

Use a instrução “Carregar Registro” em “Registros da Tabela” para fazer isso.

{height="" width="600px"}* “Registros da tabela”* “Carregar registro”* Por ID: “texto” - 0146* No espaço reservado “active_wo”

Neste exemplo, já existe um registro com o ID “0146” em uma tabela de ordens de serviço.

Como o campo “ID” em cada tabela é um campo de texto, você deve usar texto para acessar registros individuais. Você pode usar todas as opções típicas para selecionar um ID:

• Registro da tabela
• Expressão
• Valor estático
• Informações do aplicativo
• Variável

Aqui está um exemplo em que uma variável é usada:

• “Registros da tabela”
• “Carregar registro”
• por ID: “Variável”
• "text_wo_id"
• em: “Ordem de Serviço Ativa”

Criação de novos registros

Se você quiser criar um novo registro em uma tabela, deve usar a opção “Criar” ou “Criar ou Carregar”.

Se você usar “Criar”, deverá criar um novo registro com um ID que ainda não exista na tabela. Se o registro já existir na tabela, o aplicativo exibirá um erro.

Se você usar “Criar ou Carregar”, um registro com um ID específico será carregado, caso já exista, ou criado, caso o ID não exista na tabela.

Nesse caso, usamos o ID “123” para criar um novo registro.

• "Registros da tabela" "Criar registro"
• por ID: “Valor estático” “texto” “123”
• em: “Ordem de Serviço Ativa”

Normalmente, você deve usar um valor dinâmico neste campo, como uma variável, já que toda vez que um operador usar o aplicativo, você vai querer criar um novo valor.

Etapa 3a – Edição de registros no Editor de Gatilhos

Para editar um registro, você usará a ação “Manipulação de dados” e, em seguida, “Armazenar” para editar ou atualizar o valor em um registro.

Para editar um registro, você já deve tê-lo carregado como um espaço reservado de registro por meio de “Registros da tabela” “Carregar” ou “Registros da tabela” “Criar”.

Aqui está um exemplo em que você atualizará o campo “status” de um registro carregado como “active_wo”.

• “Manipulação de dados”
• “Armazenar”
• “Texto”: "Aprovado"
• "Registro da tabela" “active_wo”
• Campo: “status”

Normalmente, você usaria um Gatilho de Widget para fazer isso, por exemplo, quando um operador pressiona um botão para indicar uma alteração.

Você também pode incrementar um valor a partir de um registro da tabela. Consulte este guia sobre tabelas de estoque para saber como fazer isso

Etapa 3b – Uso de lógica condicional com registros de tabela

Você também pode querer alterar a lógica do aplicativo com base no valor de um campo de um registro específico.

Para fazer isso, certifique-se de que um registro já tenha sido carregado. Em seguida, selecione um campo do registro e use a mesma lógica que você usaria em qualquer outra instrução “if”.

Registro da tabela: verifique se há um valor específico no campo de um registro carregado da tabela.

{height="" width=""}* “Registro da tabela” “active_wo” “status”* “Contém”* "Valor estático" "texto" "Aprovado"

Tabela: Verifique se um registro com um ID específico já existe em uma tabela.

• "Tabela" "ordens de serviço" "possui registro com id" "Valor estático" "texto" "001"

Veja como você pode criar uma mensagem de erro que solicite ao operador que insira um número de ordem de serviço diferente.

IF* "Tabela" "ordens de serviço" "tem registro com id"* "Valor estático" "texto" "024dfg45"

ENTÃO* "Mostrar erro" "Valor estático" "texto" "Esta ordem de serviço já existe; insira uma nova".

Etapa 4 – Exibição de registros da tabela nas etapas

Para adicionar esse registro a uma etapa, selecione a opção “Registro da tabela” no botão “Texto” do menu do widget.

Na guia “Widget” do Painel de Contexto, escolha seu espaço reservado para registro entre as opções ao lado de “Registro” para visualizá-lo no Player.

Isso é comumente usado para exibir detalhes de ordens de serviço a um operador, por exemplo.

Para reordenar ou remover campos individuais da exibição, clique no x ou no símbolo de grade na propriedade no Painel de Contexto.

Para alterar o número de colunas, use a opção “Colunas” no painel lateral.

Para alterar a exibição dos rótulos e valores, ajuste a cor e o tamanho da fonte no painel lateral.

Para ver como esses dados serão exibidos ao operador, execute o aplicativo no Player, e você poderá ver o Registro da Tabela completo. Os valores serão incluídos se você carregar um registro primeiro.

Limpar espaços reservados de registro

Às vezes, você pode querer limpar um espaço reservado de registro para que nenhum registro específico seja carregado no aplicativo sob esse espaço reservado.

Veja como fazer isso:

• "Registros da tabela" "Limpar espaço reservado para registro"

Exclusão de marcadores de registro

Para excluir um espaço reservado para registro, selecione-o na Lista de registros, no lado esquerdo da tela. No exemplo abaixo, você selecionaria “Ordem de serviço ativa”.

Em seguida, selecione “Excluir” no menu a seguir.

Exibindo usuários e seus campos

Você também pode criar uma tabela incorporada ( Record Placeholder ) para usuários e seus campos associados e, em seguida, carregar um usuário específico com a tabela incorporada. Para mais detalhes, consulte o guia separado sobre campos de usuário.

Leitura complementar

• Crie sua primeira tabela (guia passo a passo): um guia completo sobre como usar tabelas e aplicativos em conjunto
• Exibindo listas de registros em aplicativos: como usar o widget de tabela interativa para exibir vários registros de tabela de uma só vez

Você encontrou o que estava procurando?

Você também pode acessar community.tulip.co para postar sua pergunta ou verificar se outras pessoas já tiveram uma dúvida semelhante!