Uma maneira de armazenar os dados do seu aplicativo Tulip a longo prazo é por meio dos “App Completions”. Este artigo mostrará como fazer isso.
Neste artigo, você aprenderá:* Por que seu aplicativo deve ter um botão “Concluir”* Diferentes tipos de gatilhos para conclusão de aplicativos* Quais dados são salvos ao concluir ou cancelar um aplicativo* Melhores práticas para concluir aplicativos
Read more about [completions](/r230/docs/<span translate=)">Completions data.
Como concluir um aplicativo
Para salvar informações de um aplicativo do Tulip, o operador deve “concluir o aplicativo”. Para habilitar isso, você precisa adicionar um botão “Concluir” ao seu aplicativo.
Sempre que um operador usar o botão “Concluir”, uma nova linha será adicionada na aba “Conclusões”. Cada linha contém os seguintes valores:
- Informações sobre a conclusão do aplicativo, como nome da estação, ID do crachá do operador e data/hora de início e término do aplicativo.
- Todas as variáveis e seus valores no momento em que o aplicativo foi concluído.
- Opcional: opte por incluir quaisquer registros de tabela que tenham sido carregados no aplicativo no momento da conclusão para serem armazenados
Cada variável definida no seu aplicativo (por exemplo, código de barras, operador conectado, tempo gasto, resultado da inspeção) será uma coluna nessa visualização. Quando um operador “conclui o aplicativo”, você cria outra linha na lista.
Os valores em todas as etapas do formulário serão armazenados e apagados quando você concluir um aplicativo.
Na verdade, se você acessar a aba “Conclusões” em cada aplicativo individual, é exatamente isso que você verá.

Existem algumas maneiras de “concluir o aplicativo” quando ele é finalizado por um operador.
Você pode usar o botão “Concluir”, que está integrado ao Editor de Aplicativos, ou criar um gatilho personalizado com uma transição “concluir aplicativo”.
Botão “Concluir”
Selecione “Botões ” na barra de ferramentas e escolha “Concluir”.

Você pode adicionar manualmente a transição de conclusão do aplicativo por meio do botão “Adicionar novas transições”:

Use um gatilho personalizado:
No caso acima, a lógica do botão “Concluir” é definida por padrão como:
- Quando “o botão for pressionado”;
- Então, “Aplicativo” -> “Concluir aplicativo”.

No entanto, você pode adicionar essa transição a qualquer gatilho que corresponda ao final do fluxo de trabalho. Por exemplo:

- Quando, “Dispositivo”, “GPIO”, emite saídas nesta estação com os eventos “pino pressionado”
- Se, “Saída do dispositivo” “pino” “=” “Valor estático” “inteiro” “2”
- Então, “Aplicativo” “Concluir aplicativo”
Neste exemplo, qualquer dispositivo IoT que enviar um sinal de pino pressionado para o pino 2 do GPIO I/O Gateway nesta etapa fará com que o aplicativo seja concluído.
Além de “Concluir o aplicativo”, há outras duas opções:
Concluir e mudar para: Concluir o aplicativo e, em seguida, mudar para outro aplicativo.
Concluir e mudar para etapa: Concluir o aplicativo e, em seguida, mudar para outra etapa dentro do mesmo aplicativo ou para uma etapa específica em um aplicativo diferente.
Concluir e ir para a tela inicial: Conclui o aplicativo e, em seguida, vai para a tela inicial do aplicativo. O aplicativo não será iniciado até que um operador pressione o botão “Iniciar”.
Concluir e, em seguida, fazer logout do usuário atual: conclui o aplicativo e, em seguida, faz o logout do usuário atual
Concluir e mudar de aplicativo por nome: Conclui o aplicativo e, em seguida, vai para outro aplicativo que pode ser especificado por meio de um valor do aplicativo em uma variável, etc.
Concluir e ir para a etapa pelo nome: Conclui o aplicativo e, em seguida, vai para outra etapa no mesmo aplicativo que pode ser especificada por meio de um valor do aplicativo em uma variável, etc.
Observação: os aplicativos só podem ser concluídos quando executados a partir do Tulip Player. Quando um aplicativo for concluído, o operador verá uma mensagem conforme mostrado abaixo.

Cancelar um aplicativo
Digamos que você NÃO queira salvar os dados dessa execução específica de um aplicativo. Nesse caso, você vai querer “cancelar o aplicativo” e, provavelmente, retornar a uma etapa específica. Isso apagará todos os dados desde a última vez em que o aplicativo foi aberto.
Existem 5 transições de acionamento que correspondem diretamente às transições de acionamento de conclusão do aplicativo:

- Cancelar aplicativo
- Cancelar e, em seguida, mudar para
- Cancelar e mudar para a etapa
- Cancelar e ir para a tela inicial
- Cancelar e, em seguida, fazer logout do usuário atual
Detalhes técnicos da conclusão do aplicativo
Aqui estão todos os dados que são salvos automaticamente a cada conclusão ou cancelamento do aplicativo:
- Hora de início: a data e a hora em que o operador abriu a primeira etapa
- Hora de término: a data e a hora em que o operador pressionou o botão “Concluir” ou “Cancelar”
- Duração: O tempo entre a hora de início e a hora de término
- Usuário conectado: com base no ID do crachá da pessoa que fez login no Tulip Player
- Nome da estação: o nome da estação onde o aplicativo foi usado, conforme determinado pela aba “Chão de fábrica”
- Comentários: Quaisquer comentários feitos sobre o aplicativo como um todo no menu do Player
- Versão: A versão do aplicativo no momento em que foi concluído
- Cancelado: Se o aplicativo foi cancelado ou não
- ID de execução: O ID exclusivo dessa execução específica do aplicativo
- Nome da etapa visualizada por último: O nome da etapa visualizada por último antes de um usuário concluir ou cancelar o aplicativo
Melhores práticas
Na configuração do Chão de Fábrica, é prática comum atribuir a “versão publicada mais recentemente” de um aplicativo, seja no nível do Grupo de Estações ou em uma Estação específica.
Para que uma estação comece a executar a versão publicada mais recentemente, uma das seguintes ações deve ocorrer:
- O aplicativo seja reiniciado por meio de Menu / Reiniciar aplicativo.
- É utilizada uma transição “Aplicativo / Concluir aplicativo...”.
- É utilizada uma transição “Aplicativo / Cancelar aplicativo...”.
Por esse motivo, é recomendável garantir que seu aplicativo Tulip utilize essa transição em algum momento durante sua execução.
:::(Aviso) (Use “Aplicativo / Concluir aplicativo” em aplicativos sem interface gráfica)
Se você estiver usando um “aplicativo sem interface gráfica” (por exemplo, para executar gatilhos de Máquinas e Dispositivos), considere adicionar um gatilho de Temporizador para realizar uma transição “Aplicativo / Concluir aplicativo” periodicamente.
Desde que a Tulip Station esteja atribuída a “Mais recente published version ”, isso garantirá que o aplicativo seja executado na instância mais recentepublished version, além de mitigar problemas que possam ser causados por possíveis vazamentos de memória.
:::
Excluir dados de conclusões de aplicativos
Para estar em conformidade com as normas GxP de fabricação, os dados no Tulip não podem ser excluídos.
No entanto, há uma solução alternativa. Você pode copiar o aplicativo e excluir o antigo; assim, terá uma nova tabela sem entradas.
Ocultar dados de conclusões do Analytics
É provável que você queira omitir alguns dados da guia “Conclusões” em suas análises. Agora você pode fazer isso localizando o registro que deseja omitir na guia “Conclusões” e desmarcando a caixa “Incluir nas análises”. Isso filtrará a análise para que esse registro não seja incluído.

Excluir esse registro das análises não o removerá dos dados de conclusões; portanto, as exportações desses dados não serão afetadas.
Leitura complementar
{{snippet.Você encontrou o que estava procurando?}}


