Como criar e usar variáveis

Visão geral

Veja como começar a usar as variáveis e utilizá-las em seus aplicativos.

Neste artigo, você aprenderá...

• Como começar a usar as variáveis
• Como utilizar variáveis para obter análises mais detalhadas
• Como usar variáveis juntamente com acionadores

As variáveis são o principal meio de armazenar e referenciar dados em seus aplicativos Tulip.

Quando você quiser armazenar o valor de uma entrada de texto ou acessar uma propriedade predeterminada do aplicativo, precisará de uma variável.

Ou, quando quiser calcular valores específicos com base em decisões anteriores do usuário no aplicativo, precisará de uma variável.

As variáveis podem ser redefinidas após a conclusão do aplicativo ou manter seus valores durante várias conclusões, dependendo do seu caso de uso específico.

Ao projetar um aplicativo, uma variável é frequentemente usada para armazenar a saída de um dispositivo.

Uma variável também pode ser usada como condição para outros acionadores que conduzirão a lógica do aplicativo, seja por

1. Alterar exibições de texto
2. Avançar para outras etapas, ou...
3. Solicitando que o operador execute outra tarefa.

As variáveis também são necessárias para criar relatórios detalhados na ferramenta Analytics. Se quiser obter pontos de dados individuais do operador, você precisará capturá-los em variáveis.

Como criar variáveis

Há duas maneiras principais de criar uma variável no Tulip App Editor:

• Por meio da caixa de diálogo App Variables (Variáveis do aplicativo)
• Por meio da criação de um Trigger

:::(Info) (OBSERVAÇÃO) Consulte a seção "Uso de variáveis em formulários" neste guia de etapas do formulário para ver como adicionar variáveis às etapas do formulário.

:::

Caixa de diálogo App Variables

Para criar uma nova variável por meio da caixa de diálogo App Variables, siga estas etapas:

1. Selecione a guia App no painel de contexto à direita do App Editor.
2. Clique no X ao lado do título "Variables" (Variáveis).

1. A caixa de diálogo que se abre quando você clica no X ao lado de "Variáveis" mostra as variáveis no aplicativo atual, juntamente com os atributos associados, conforme descrito abaixo:

Tipo: O tipo de dados que está sendo armazenado na variável. Isso pode assumir um dos seguintes valores:

• Número (incluindo decimais)
• Booleano (verdadeiro/falso)
• Texto
• Inteiro
• Intervalo (número de segundos)
• Imagem (URL ou upload manual)
• Usuário da tulipa
• Datetime (registro de data e hora)
• Estação
• Máquina
• Matriz (de qualquer tipo de variável listada)
• Objeto
• Cor

Os objetos são variáveis complexas. Eles não podem ser criados na caixa de diálogo App Variables.

As matrizes podem ser criadas por meio de entradas "Mulitselect".

Os objetos podem ser criados armazenando a saída da função Connector em uma variável.

Para obter mais detalhes sobre variáveis complexas, consulte este guia sobre matrizes e objetos.

Quando usado: Uma hierarquia que exibe o nome da etapa e o acionador/ Widget em que a variável está sendo usada.

Limpar na conclusão: Se os dados na variável serão ou não apagados quando o aplicativo for concluído. Observação: essas variáveis serão apagadas após a ação"Concluir e ir para a tela inicial ".

Save for Analytic: essa opção estará ativada por padrão. Se não quiser que uma variável seja enviada para uma análise por qualquer motivo, você pode desmarcar essa caixa. Algumas variáveis podem ser usadas apenas para a lógica do aplicativo e não são necessárias na análise. Nesses casos, é uma prática recomendada não enviá-las para a análise. A desmarcação de variáveis não essenciais também pode ajudar sua análise a carregar mais rapidamente, pois haverá menos dados para carregar em cenários de alto volume.

Valor padrão: Defina um valor inicial para a variável sempre que um operador iniciar o aplicativo

Excluir uma variável: A ação de exclusão só fica visível quando a seção "where used" está vazia para evitar a quebra do fluxo lógico no aplicativo.

Excluir variáveis não utilizadas: A ação de excluir variáveis não utilizadas apaga todas as variáveis com uma seção "where used" vazia. Clique nesses três pontos para abrir a janela "Excluir variáveis não utilizadas".Essa janela será exibida.

1. Clique em Create Variable (Criar variável) e digite um novo nome de variável na caixa de texto do nome da variável e selecione o tipo apropriado no menu suspenso Type (Tipo).

Se quiser que os dados da variável persistam quando o aplicativo for concluído, desative a opção "Clear on Completion" (Limpar na conclusão) e clique no botão "Create" (Criar) quando terminar. Você deverá ver sua nova variável aparecer imediatamente na lista de variáveis abaixo dela, sem nada na coluna "Where Used" e com o botão "Delete" ativo.

Editor de acionadores

Ao criar ou editar um acionador, você pode criar uma variável seguindo estas etapas.

1. Crie um novo acionador.
2. Clique no botão "Adicionar nova ação" para abrir a seção de nova ação da caixa de diálogo.
3. Selecione a opção "Manipulação de dados" no menu suspenso "tipo de ação" junto com a opção "Armazenar".
4. Preencha os campos conforme eles aparecem até que o menu suspenso destacado "location" (local) apareça. A partir daí, selecione a opção "New variable..." (Nova variável...).

1. Digite um nome para a nova variável e clique no botão de seleção verde ao lado do campo da variável. Em seguida, clique no "Botão Salvar" na parte inferior do Trigger Editor. A variável que você criou estará disponível para edição na caixa de diálogo Variáveis do aplicativo.

Mais detalhes sobre variáveis persistentes

As variáveis persistentes permitem que você salve um valor em uma variável em várias conclusões de aplicativos.

As variáveis persistentes salvam valores relativos a cada dispositivo que está executando o aplicativo. Elas não serão sobrescritas se o aplicativo for usado em vários dispositivos simultaneamente.

Portanto, se você tiver um aplicativo visual andon com uma variável persistente que seja executado em 5 linhas de produção, cada supervisor de linha poderá atualizar a variável em seu aplicativo e os valores não serão sobrescritos nem entrarão em conflito. Eles existem de forma independente em cada tablet que estiver executando o Player.

Variáveis em etapas de formulário

A última maneira de criar uma variável é por meio de uma etapa de formulário. Consulte a seção "Uso de variáveis em formulários" neste guia de etapas de formulário para ver como adicionar variáveis às etapas de formulário.

Como usar o texto da variável

Depois que você cria uma variável, ela fica disponível para uso nas ações e condições de acionadores recém-criados e existentes no mesmo aplicativo. Ela também está disponível no widget de texto, que pode ser acessado na barra de ferramentas do App Editor.

Para acessar o valor armazenado em uma variável específica, selecione o nome da variável relevante no menu suspenso Variáveis no Painel de contexto:

Você será solicitado a selecionar sua fonte de dados:

• Variable (Variável): Qualquer variável que você tenha criado em seu aplicativo
• Informações do aplicativo: Variáveis que são registradas automaticamente no seu aplicativo (por exemplo: nome de usuário conectado, tempo decorrido no aplicativo e nome da etapa)

É importante observar que as variáveis são armazenadas por aplicativo, portanto, não há variáveis específicas da etapa e elas não podem ser compartilhadas entre aplicativos.

Como excluir variáveis

Para excluir uma variável, abra a caixa de diálogo Variables Dialog (Variáveis) na seção Variables (Variáveis) na guia App (Aplicativo) do painel de contexto.

Use a caixa de pesquisa Filter By (Filtrar por) para localizar a variável que deseja excluir.

Em seguida, clique no ícone de reticências na extrema direita do modal para excluir a variável.

Observação: para excluir uma variável, você deve removê-la de todos os widgets de texto de Acionadores e Variáveis em que ela estiver sendo usada.

Leitura adicional

• Como criar uma nova análise
• O que são acionadores?
• Adição de acionadores às etapas do formulário.
• Como alterar dinamicamente a cor dos widgets

Encontrou o que estava procurando?

Você também pode acessar community.tulip.co para publicar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!