Neste passo a passo, você verá:* Criar um formulário de entrada em uma etapa usando widgets de entrada* Salvar dados de entrada em variáveis e em uma tabela* Revisar registros de tabela em uma etapa
Neste passo a passo, você aprenderá a armazenar dados em um aplicativo e também a armazenar dados de entrada de um aplicativo em uma tabela.
Ao final dos dois exercícios, você terá um aplicativo de entrada de dados com a seguinte aparência:
Exercício 1: Salvar dados de entrada no aplicativo
Neste exercício, você criará uma etapa básica que salva os dados de entrada em variáveis.
Crie um novo aplicativo
- Na guia Apps, clique em Apps.

- Clique em + Create App (Criar aplicativo ) no canto superior direito.
- Nomeie o aplicativo como "Data Entry Form - Example" (Formulário de entrada de dados - Exemplo). Opcionalmente, você pode adicionar uma descrição para que outros usuários saibam para que serve esse aplicativo.

- Clique em + Create (Criar).
Na página de detalhes do aplicativo, você pode clicar em Edit (Editar ) no canto superior direito ou clicar no nome Untitled Step (Etapa sem título ) para entrar no App Editor.
Adicionar widgets de entrada com fontes de dados variáveis
- Clique na guia Inputs e selecione Checkbox.
- No painel lateral, nomeie o Rótulo: "Work order completed" (Ordem de trabalho concluída).
- Em Datasource, clique na caixa vazia e depois em + Add variable (Adicionar variável).
- Nomeie a variável como "Work order completed" (Ordem de trabalho concluída) e altere o valor Default (Padrão ) para no (não). Clique em + Create.

A configuração do widget terá a seguinte aparência:

- Adicione um widget de seleção de data na guia Inputs (Entradas).
- No painel lateral, nomeie o rótulo: "Date completed" (Data concluída).
- Em Datasource, clique na caixa vazia e depois em + Add variable (Adicionar variável).
- Nomeie a variável como "Date completed" (Data de conclusão) e clique em + Create (Criar).
A configuração do widget terá a seguinte aparência:
Crie um acionador para salvar os dados de entrada
- Clique na guia Buttons (Botões ) e selecione Submit (Enviar).
- No painel lateral, clique no sinal de mais + ao lado de Triggers.
- Dê ao acionador o título "Save app data" (Salvar dados do aplicativo).
- Na seção Then (Depois ), selecione App (Aplicativo ) no menu suspenso. Em seguida, selecione Save All App Data (Salvar todos os dados do aplicativo). Clique em Save (Salvar).

Agora você tem uma etapa básica de entrada de dados que usa variáveis para armazenar valores. Esta é a aparência do aplicativo quando você o testa no modo de desenvolvedor:
Observe que as variáveis armazenam dados de conclusão, que podem ser vistos abaixo da tela da etapa.
Exercício 2: Armazenar dados de entrada em uma tabela
In order to follow this walkthrough, you must first complete the exercises in Build Your First Table.
Neste exercício, você criará uma etapa de entrada de dados que salva valores em uma tabela de ordens de serviço. Também será possível visualizar os registros na tabela a partir da etapa do aplicativo.1. Adicione uma nova etapa e nomeie-a "Exercício 2".
Adicione a tabela ao aplicativo
- Clique na guia Registros e selecione + Adicionar tabela.
- Selecione a tabela Work Orders e clique em Add.

- Clique no ícone + ao lado de Placeholder de registro.
- Nomeie o espaço reservado do registro: "Current Work Orders" (Ordens de trabalho atuais). Clique em Add record placeholder (Adicionar espaço reservado para registro).

Criar as entradas do formulário de dados
- Clique em Inputs e selecione Single select.
- No painel lateral, rotule o widget: "Product" (Produto).
- Em Opções de dados, clique no campo em branco Fonte de dados e, em seguida, em + Adicionar variável.
- Nomeie a variável como "Product" e clique em + Create.

- Em Selection Options (Opções de seleção), adicione as seguintes opções:
- Quadro de bicicleta
- Roda
- Drivetrain

- Adicione um widget Number Input à etapa.
- Nomeie o rótulo: "Quantity" (Quantidade).
- Em Data options (Opções de dados), clique no campo Datasource (Fonte de dados) em branco e, em seguida, em + Add variable (Adicionar variável).
- Nomeie a variável como "Product" e clique em + Create.

- Em Validation Rules (Regras de validação), clique em + para adicionar uma regra.
- Selecione Greater Than (Maior que) e digite "0" como um valor estático.

Criar acionador de botão para armazenar valores de entrada
- Adicione um botão à etapa.
- No painel lateral, adicione o texto: "Create work order" (Criar ordem de serviço).
- Em Triggers, clique em +.
- Nomeie o acionador: "Store input values to new Work order record" (Armazenar valores de entrada no novo registro de ordem de serviço).
- Adicione as seguintes ações ao acionador:
- Registros de tabela → Criar registro → Expressão:
RANDOMSTRING()→ Ordens de trabalho atuais - Manipulação de dados → Store → Variable → Product → Registro de tabela → Current Work Orders → Product
- Manipulação de dados → Store → Variable → Quantity → Registro de tabela → Current Work Orders → Quantity

Exibir a tabela de ordens de serviço na etapa
- Clique em Embed e selecione Tabela interativa.
- No painel lateral, em Datasource, selecione Tulip Table.
- No próximo menu suspenso, selecione a tabela Work Orders (Ordens de trabalho ).
- Em Linked Placeholder, selecione Current Work Orders (Ordens de trabalho atuais).

- Em Fields (Campos), adicione os seguintes campos:
- ID
- Produto
- Quantidade
- Data de criação
- Status
- Cor

- Clique e arraste os quadrados ao redor do widget para ajustar as dimensões e ver todos os campos.

Agora você tem um formulário de entrada de dados que armazena variáveis em um espaço reservado de registro e cria um registro de tabela a partir do espaço reservado atual. Esta é a aparência da etapa quando você a testa no modo de desenvolvedor:

Se você digitar "0" na quantidade, verá uma mensagem de erro que solicita que o usuário insira um valor aceitável. Isso é possível com a regra de validação que você definiu no widget.
Próximas etapas
Agora que você criou um formulário de entrada de dados, aprenda sobre a criação de aplicativos ou como visualizar dados:

