Visão geral dos registros de conclusão

Conheça os prós e contras dos registros de conclusão e saiba como otimizá-los para uso nos dados do seu aplicativo.

Um registro de conclusão é um conjunto imutável de dados que armazena seus valores de um aplicativo Tulip. Os registros são salvos automaticamente quando um aplicativo é concluído. Você também pode usar Triggers para salvar dados em qualquer ponto considerado valioso (por exemplo, quando um processo é concluído).

As conclusões são um método de armazenamento de dados, como as tabelas. Entretanto, diferentemente das tabelas, os registros de conclusão não podem ser alterados ou modificados, garantindo que os dados sejam capturados honestamente. A Tulip recomenda a utilização de conclusões e tabelas em seus métodos de coleta de dados.

Para acessar os registros de conclusão de um aplicativo, navegue até a página Informações do aplicativo e clique na guia Conclusões.

Há vários campos de dados de conclusão que são salvos automaticamente em cada aplicativo quando ele é concluído ou cancelado, tais como

• Duração do aplicativo
• Horário de início e término
• Duração de cada etapa concluída
• Usuário conectado
• Nome da estação
• Comentários
• Versão do aplicativo
• ID de execução
• Cancelado (se o aplicativo foi ou não cancelado)

Os dados de assinatura do widget de assinatura eletrônica também são salvos nos registros de conclusão. Você pode salvar informações adicionais usando variáveis e configurando um acionador para salvá-las.

Quando usar as conclusões

Os registros de conclusão armazenam valores de variáveis, etapas do aplicativo, carimbos de data/hora, informações do usuário, assinaturas eletrônicas e muito mais. Embora também seja possível usar tabelas para armazenar dados, há cenários distintos mais adequados para o uso de registros de conclusão, tais como:

• Valores capturados pelo usuário ou pela máquina, incluindo fotos, resultados registrados para parâmetros críticos do processo, leituras de sensores etc.
• Unidades de medida que combinam com valores capturados. É uma prática recomendada separar as variáveis UoM além das variáveis de medição.
• Informações contextuais para garantir que os registros de histórico sejam legíveis por humanos. Por exemplo, nomes de etapas ou uma ID exclusiva capturada no início de cada ciclo do aplicativo para facilitar a pesquisa
• Para capturar os tempos de ciclo de um aplicativo de processo, até o nível de cada etapa do aplicativo

Como salvar dados de conclusão

:::(Info) (OBSERVAÇÃO) Os dados de conclusão são salvos somente quando você executa um aplicativo. O teste de um aplicativo no modo de desenvolvimento não salvará os registros de conclusão, mas mostrará um registro de conclusão simulado:

Aplicativo completo

Embora os dados de conclusão sejam salvos automaticamente quando um usuário conclui um aplicativo, ainda deve haver um acionador com uma Transição para concluir o aplicativo.

A conclusão de um aplicativo irá...

• Salvar todos os campos de metadados do aplicativo
• Armazenar os valores atuais de todas as variáveis do aplicativo
• Armazenar os valores de campo atuais de todos os registros de tabela carregados com um registro de data e hora
• Redefinir todas as variáveis para seu valor padrão (a menos que estejam definidas para não serem apagadas na conclusão)
• Limpar todos os espaços reservados para registros de tabela
• Carregar a versão publicada mais recente do aplicativo*

*Se a estação estiver configurada para executar a versão publicada mais recente

Cancelar aplicativo

A transição Cancel App (Cancelar aplicativo) executa as mesmas operações que Complete App (Concluir aplicativo ) com a função adicional de que todas as variáveis no aplicativo sejam redefinidas para o valor padrão.

Salvar todos os dados do aplicativo

Essa ação salva os campos de metadados, os valores atuais das variáveis e os valores de campo dos registros da tabela carregada do aplicativo. Diferentemente da transição Complete App, Save All App Data não redefine as variáveis para o valor padrão nem limpa os placeholders de registro de tabela.

Limitações e práticas recomendadas

Os registros de conclusão permitem o armazenamento fácil de registros de dados imutáveis; no entanto, os dados armazenados não podem ser enviados off-line para um sistema de terceiros, como uma plataforma de Business Intelligence. Os registros de conclusão também não podem ser usados como entrada para outra variável ou ação de acionamento.

Em um aplicativo operacional/de processo, um registro de conclusão deve ser salvo no final do processo. Especialmente nos setores GxP, é recomendável usar Salvar todos os dados do aplicativo ao sair de qualquer etapa do processo.

Em casos de uso de processos não operacionais (por exemplo, um aplicativo de gerenciamento de ordens de serviço), um registro de conclusão deve ser criado no final do processo (por exemplo, no final da criação de uma ordem de serviço) para ter uma trilha de auditoria simples do uso do aplicativo. Esses registros de conclusão fornecem respostas imediatas a perguntas como:

• Quando o aplicativo foi usado pela última vez e por quem?
• Com que frequência o aplicativo é usado?
• O aplicativo está sendo cancelado e em que etapa?

É uma prática recomendada limpar os dados nas variáveis assim que um único processo for concluído em um aplicativo. Cada variável também deve seguir boas convenções de nomenclatura, especialmente se você planeja visualizar os dados por meio do widget Histórico de registros.

Uso de registros de conclusão em um aplicativo

Há duas maneiras de usar dados de conclusões em um aplicativo: em uma análise ou no widget de histórico de registros. Observe que os dados nos registros de conclusão não podem ser acessados por meio das APIs da TabelaTulip.

Registros de conclusão em análises

Assim como usar o Analytics para criar análises a partir de dados de tabelas ou máquinas, você também pode criá-las usando dados de aplicativos. Incorpore uma análise em um aplicativo para mostrar informações sobre tempos de ciclo, duração do turno ou unidades concluídas.

Crie uma nova análise a partir de um ou vários aplicativos. Depois de criar a análise, use o widget de análise em um aplicativo e escolha a análise que deseja incorporar.

Widget de histórico de registros

O widget Digital Record History revela os dados do processo associados a cada registro de conclusão. É um widget de rolagem ao qual também é possível aplicar filtros para classificar os registros. Também é possível visualizar dados de assinatura eletrônica. Leia Usando o widget de histórico de registros para visualizar alterações nos registros da tabela para entender como configurar esse widget.

:::(Info) (OBSERVAÇÃO) O widget de histórico de registros está disponível apenas para clientes Enterprise. :::

Leitura adicional

• Armazenamento de dados
• Exemplo funcional de dados da Tulip
• Resumo da Universidade Tulip - Conclusões de aplicativos e tabelas

Encontrou o que estava procurando?

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