Trabalhando com tabelas de um aplicativo

Como modificar as tabelas dentro do editor de aplicativos

Veja aqui como ler e escrever em tabelas a partir de aplicações de operações de linha de frente.

Neste guia, você aprenderá...

• Como ler os registros de tabelas existentes 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 baseadas em apps Completions

No App Editor, você pode ler, editar e criar registros de tabelas individuais. Como as Tabelas não exigem nenhum código, você pode executar seus aplicativos no Player e assistir à atualização das Tabelas em tempo real.

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

Ao construir aplicativos, você pode precisar decidir se um dado específico deve ser armazenado em uma variável ou em um registro de tabela.

As variáveis são mais adequadas para dados que são relevantes para o uso individual daquele aplicativo específico. As tabelas são mais adequadas para dados que precisam ser acessados por múltiplas aplicações.

As tabelas são freqüentemente usadas para rastrear conceitos como:

• Ordens de trabalho
• 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 ter uma compreensão completa das capacidades das Tabelas".

Se você gostaria de ver um exemplo completo de uma Tabela e um aplicativo sendo usados juntos, confira este passo-a-passo de uma tabela de ordens de trabalho

Há três passos para ler ou atualizar qualquer registro de tabela:

1- Criar um "Record Placeholder" para dar um nome a esse registro de tabela em particular dentro do aplicativo

2- Carregar (ou criar) o registro em uma ação de gatilho

3a- Se você gostaria de escrever a lógica em torno dos valores no Registro da Tabela, então inclua o Registro da Tabela em uma declaração "Se".

3b- Se você gostaria de atualizar campos individuais no registro, inclua o registro da tabela em uma declaração "Então".

Criação de Registros

Primeiro, você precisará criar um "Record Placeholder" no aplicativo onde você estará acessando o Table Record. Estes são placeholders para registros que serão posteriormente carregados dinamicamente na lógica Trigger.

Por exemplo, se você quiser editar um registro de uma tabela "Ordens de Trabalho" em um aplicativo, você poderá ter um espaço reservado para registros chamado "Ordem de Trabalho Ativa". Mais tarde, você carregaria um Registro dinamicamente baseado na entrada do operador, mas sempre seria referenciado como a "Ordem de Trabalho Ativa".

Para configurar estes espaços reservados, clique na guia Registros ao lado da Lista de Passos.

[

Em seguida, escolha "Adicionar uma tabela". Em seguida, clique em adicionar um "Record Placeholder". Você poderá dar um nome ao registro que será carregado dinamicamente a partir de um Gatilho (ou seja, "Ordem de Trabalho Ativa").

Note que há um ajuste "Salvar para análise". Quando selecionado, isto salvará o registro da tabela carregado neste registrador no Registro de Conclusão do aplicativo. Nos dados da conclusão, você verá um link para o registro.

Exclusão de espaço reservado ao registro

Para excluir um espaço reservado para registro, selecione o espaço reservado na Lista de Registros, no lado esquerdo da tela. No exemplo abaixo, você escolheria "Test Record Name" (Nome do Registro de Teste).

Em seguida, selecione "Delete" no menu a seguir.

:::(Warning) (Favor observar:)você deve primeiro remover o espaço reservado para registro de todos os gatilhos onde ele é referenciado. Você pode usar a lista de "Passos onde foi usado" para encontrar os passos com os gatilhos que precisam ser modificados.

:::

Agora você está pronto para usar o Editor de Gatilhos para selecionar os registros dinamicamente.

Acesso aos Registros no Editor de Gatilho

Depois de criar o espaço reservado ao registro, você pode agora escrever a lógica para carregar dinamicamente ou criar registros com base na entrada do operador.

Você pode usar as ações "Table Records" e "Data Manipulation" Trigger para realizar isto. Veja como fazer isso.

Em seguida, as afirmações

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

Registros de Tabela/ Registro de Carga: Carregar um registro com uma identificação específica

Tabela de Registros/ Criar Registro: Criar um novo registro com uma identificação específica

Tabela de Registros/ Criar ou Carregar Registro: SE um registro com uma identificação específica não existir, crie-o. Caso contrário, carregue o registro com uma identificação específica.

Carregamento de Registros Existentes

Para ler ou editar um registro, você deve primeiro carregar o registro em um aplicativo e dar-lhe um nome de espaço reservado. Isto é freqüentemente acionado por uma abertura de degrau ou por um aperto de botão.

Você pode carregar um registro de cada vez, e deve usar o ID exclusivo (primeiro campo da Tabela, valor do texto) para escolher o registro.

Use a declaração "Load Record" do "Table Records" para realizar isto.

{height=""" width=""}* "Load Record "* Por ID: "text" - 0146* No espaço "active_wo".

Neste exemplo, já existe um registro com a identificação "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 escolher um ID:

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

Aqui está um exemplo onde uma variável é utilizada:

{altura=""" largura=""}

• "Table Records" "Load Record" por ID: "Variable" "text_wo_id" into: "Active Work Order" (Ordem de Trabalho Ativa)

Você provavelmente precisará usar uma variável quando a entrada é dinâmica, como quando ela está ligada à entrada do operador em um Widget de texto em uma etapa de formulário.

Criação de Novos Registros

Se você quiser criar um novo Registro em uma Tabela, você deve usar a opção "Criar" ou "Criar ou Carregar".

Se você usar "Criar ", você deve criar um novo registro com um ID que ainda não exista na tabela. Se o registro já existir na tabela, o aplicativo irá lançar um erro.

Se você usar "Criar ou Carregar ", um registro com um ID específico será carregado se já existir, ou criado se o ID não existir na tabela.

Neste caso, usamos o ID "newID" para criar um novo registro.

• "Table Records" "Create Record" (Criar Registro)
• por ID: "Valor estático" "texto" "novo ID"
• em: "active_wo" (ativo_wo)

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

Edição de Registros no Editor do Trigger

Para editar um registro, você usará a ação "Manipulação de Dados", depois "Armazenar" para editar ou atualizar o valor em um registro.

Para editar um registro, você já deve tê-lo carregado como um detentor de registro através de "Table Records" "Load" ou "Table Records" "Create".

Aqui está um exemplo onde você atualizará o campo "status" de um registro carregado como "active_wo".

{altura=""" largura=""}

• "Manipulação de dados".
• "Loja".
• "Texto": "Aprovado": "Aprovado".
• "Table Record" "active_wo
• Campo: "status

Você normalmente usaria um gatilho Widget para fazer isso, por exemplo, quando um operador aperta um botão para indicar uma mudança.

Você também pode incrementar um valor a partir de um registro de tabela. Veja este guia de tabelas de inventário para saber como

Uso de lógica condicional com registros de tabela

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

Para isso, certifique-se de que um registro já tenha sido carregado. Então, selecione um campo do registro e use a mesma lógica que você usaria em qualquer outra declaração "se".

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

• "Table Record" "TestImg" "ID" "Contém" ...
• Tabela:* Verificar se já existe um registro com um ID específico em uma Tabela.

• "Tabela" "ordens de trabalho" "tem registro com id" "Valor estático" "texto" "001"

Aqui está um exemplo. Neste caso, vamos verificar se o campo "status" contém algum outro texto.

{height="" width=""}* "Table Record" "active_wo" "status "* "Contains "* "Static Value" "text" "Passed"

Você também pode usar uma declaração "Se" para verificar se um registro com uma determinada identificação já existe, e então lançar uma mensagem de erro específica, por exemplo.

Aqui está como você pode criar uma mensagem de erro que solicita ao operador a entrada de um número de ordem de trabalho diferente.

{altura=""" largura=""}

SE

• "Tabela" "ordens de trabalho" "tem registro com id"
• "Valor estático" "texto" "024dfg45"

ENTÃO

• "Mostrar erro" "Valor estático" "texto" "Esta ordem de trabalho já existe, favor inserir uma nova".

Exibição de registros de tabela em passos

Para adicionar este Registro a um passo, escolha a opção "Registro de Tabela" sob o botão "Texto" no Menu Widget.

[

Na guia Widget do painel de contexto, escolha seu Record Placeholder entre as opções ao lado de "Record" para vê-lo no Player.

[

Isto é comumente usado para exibir detalhes de ordens de trabalho para um operador, por exemplo.

Também é útil quando você está construindo aplicações e não tem certeza dos valores em um registro de tabela específico.

Para reordenar/remover campos individuais do display, 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 de Contexto.

Para alterar a exibição das etiquetas e valores, ajuste a cor e o tamanho da fonte no Painel de Contexto.

Para ver como estes dados serão mostrados ao operador, execute o aplicativo no Player, e você poderá ver todo o registro da tabela. Os valores serão incluídos se você primeiro carregar um registro.

Limpeza de registros

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

Veja como fazer isso:

• "Tabela de Registros" "Limpar Registrador do Local de Registro".

Exibição dos usuários e seus campos

Você também pode criar um espaço de registro para usuários e seus campos associados e depois carregar um usuário específico com a Tabela Embutida. Para mais detalhes, veja o guia separado sobre Campos de Usuário.

Leitura adicional

• Construa sua primeira mesa (Walkthrough)
• Como analisar os dados em registros de tabela
• Exibição de Listas de Registros em Apps

Você encontrou o que estava procurando?

Você também pode ir ao community.tulip.co para postar sua pergunta ou ver se outros enfrentaram uma pergunta semelhante!