Widgets de histórico de registros

Saiba quando usar o widget de histórico de registros e como configurá-lo de acordo com suas necessidades.

Quem pode usar esse recurso

Usuários com planos regulamentados.

O widget de histórico de registros (RHW) exibe dados registrados relativos a um registro de tabela específico. Isso pode incluir:

• Alterações no registro da tabela
• Dados de registros de conclusão
• Assinaturas eletrônicas, caso o registro seja considerado um dado assinado

É importante compreender a coleta de dados GxP no Tulip para saber quando você deve usar o widget de histórico de registros.

O widget pode ser usado em casos em que se deseja capturar o histórico de um determinado item fabricado, como

• Livros de registro
• Conformidade e rastreabilidade
• Registros históricos digitais

Como funciona o widget de histórico de registros?

O widget de histórico de registros oferece visibilidade para um ID de registro específico, reunindo e exibindo dados das seguintes fontes:

• Aplicativos
• API de tabela
• Interface do usuário da tabela (interface de administração)
• Automations

O diagrama acima mostra exemplos de atualizações por diversas fontes.

O widget de histórico de registros exibe os seguintes dados relacionados a um ID de registro.

• Quaisquer alterações nos campos desse registro por meio de um aplicativo, da interface de usuário da tabela, da API da tabela ou de automações
• Quaisquer dados de conclusão indicados por um Placeholder de Registro no momento da conclusão para aplicativos
• Qualquer assinatura que inclua o registro como dados assinados

O widget exibe o histórico cronológico do registro em uma visualização rolável e é atualizado quando é recarregado (por exemplo, alterações de etapa). Essa visualização permite que o usuário veja o que aconteceu com esse registro ou o que está relacionado a ele desde sua criação.

Por exemplo, se um registro for atualizado por meio de um aplicativo, uma automação ou a interface do usuário da Tabela, as alterações são registradas sequencialmente pelo widget.

O diagrama de fluxo de trabalho acima ilustra como diferentes fontes de informações do registro são capturadas pelo widget de histórico do registro. Cada etapa salva uma nova iteração da variável original. O widget de histórico do registro detalha cada atualização feita ao longo da duração do aplicativo.

Como os dados são exibidos no widget de histórico do registro?

Seções

Os dados coletados de cada fonte são visualizados por meio de seções e entradas. Todos os dados são exibidos em ordem cronológica, e as seções agrupam os dados da mesma sessão. A sessão é definida por diferentes elementos, dependendo da fonte de dados:

• Aplicativo: Usuário + Aplicativo (Versão) + Estação
• API: API (Token)
• Interface de tabela: Usuário + Interface de administração
• Automações: Nome da automação

Uma nova seção é exibida quando uma entrada não foi criada na mesma sessão que a anterior. Por exemplo:

• O usuário que está executando um aplicativo foi alterado
• Um registro é atualizado primeiro a partir de um aplicativo e, em seguida, a partir da interface de administração

Entradas

Dentro de cada seção, há uma ou várias entradas. As entradas podem conter informações sobre alterações em registros, assinaturas ou registros de conclusão. Todas as entradas são acompanhadas por um carimbo de data e hora.

Entradas relacionadas a alterações de registros

As entradas relacionadas à alteração de um registro mostram o histórico completo do registro, incluindo as modificações. Entre elas estão:

• Criação de um registro
• Atualização de um registro
• Exclusão de um registro
• Todos os registros excluídos
• Alterações na etapa/no aplicativo (essas entradas ocorrem se houver dados coletados nessa etapa)

O exemplo acima ilustra um cabeçalho de seção com usuário (John Smith) + aplicativo (Assemble History Tester) + estação (Sem nome), juntamente com duas entradas. A primeira indica a etapa do aplicativo e a segunda mostra registros atualizados com valores antigos e novos.

Opcionalmente, conclusões de aplicativos canceladas e com logout automático podem aparecer desativadas com um selo “Cancelado” para diferenciá-las das conclusões normais. Entre em contato com seu CSM ou administrador da Tulip para habilitar esse comportamento da interface do usuário.

Colete diferentes tipos de dados

Registros de conclusão

Os registros de conclusão capturam dados de processo de um aplicativo, como valores de variáveis, placeholders de registros carregados e metadados como usuário, estação etc. Um novo registro de conclusão é criado para o aplicativo sempre que ele é concluído, cancelado ou quando a ação de gatilho “Armazenar todos os dados do aplicativo ” é executada. Os dados coletados são rotulados como “Dados de processo registrados” no widget de histórico de registros.

Requisitos para a inclusão de dados de conclusão no widget de histórico de registros:

• O registro é carregado em qualquer “Placeholder de Registro de Tabela” quando o registro de conclusão é criado
• O placeholder de registro de tabela está configurado como “Salvar para análise”

Dados exibidos no histórico de registros:

• Valores das variáveis: todas as variáveis definidas como “salvar para análise” são incluídas.
• ID do registro: o ID de qualquer registro carregado em um placeholder de registro definido como “salvar para análise”. Isso exclui o registro cujo histórico é exibido.

Alterações nos dados do registro da tabela

As alterações nos dados dos registros da tabela podem ser feitas por meio de três fontes:

• Em um aplicativo, por meio de espaços reservados para registros (Executou o aplicativo X na estação Y)
• Interface do usuário das tabelas (Interface de administração)
• API de tabelas
• Automações

O widget de histórico de registros exibe informações sobre as alterações feitas em um registro da tabela, tais como:

• Qual foi a alteração?
• Quem fez a atualização?
• Por qual canal a atualização ocorreu? (Aplicativos, interface de tabelas, API de tabelas)
• Em qual interface a atualização foi feita?
• Quando a alteração ocorreu?

Alterações no registro por meio de placeholders de registro

“John Smith executou o App X na Estação Y” Todasas alterações feitas na exibição do registro individual no widget aparecem em uma seção com instantâneos do registro da tabela antes e depois. Essas alterações aparecem independentemente do aplicativo que você usar.

Exemplo

Alterações no registro por meio da interface de usuário das tabelas (interface de administração)

“Atualizou o registro por meio da interface de administração” As alteraçõesfeitas por meio da interface de administração das tabelas são exibidas em uma nova seção. Cada alteração aparece em uma entrada separada, incluindo:

• Usuário conectado
• Tipo de alteração
• Valores antigos x novos
• Carimbo de data/hora

Exemplo

Alterações no registro por meio da API da tabela

*“Registro atualizado pela API”*Solicitações de API que alteram o registro especificado na tabela são exibidas em uma nova seção, incluindo:

• Token da API
• Tipo de alteração
• Valores antigos vs. novos
• Carimbo de data/hora

Exemplo

Alterações no registro por meio de automações

*“A automação X atualizou o registro”*As alterações no registro da tabela podem ser feitas por meio de automações. Elas são exibidas em uma nova seção, incluindo:

• Nome da automação
• Tipo de alteração
• Valores antigos vs. novos
• Carimbo de data/hora

Exemplo

Configuração

Adicione o widget de histórico de registros a uma etapa do aplicativo

1. No Editor de Aplicativos, clique em Incorporar na barra de ferramentas.
2. Selecione “Histórico de registros”.

Opções de configuração

Configure o widget de histórico de registros no Painel de Contexto.

Placeholder vinculado

Selecione o espaço reservado de registros que carregará os registros e o histórico de registros.

Ativar impressão

Uma opção para imprimir o histórico de registros a partir do Tulip Player. Quando ativada, um botão de impressão é exibido no cabeçalho do widget.

Classificação padrão

Escolha ordenar os dados no widget por:

• Do mais recente ao mais antigo
• Do mais antigo para o mais recente

Filtros

Você pode filtrar seu histórico de registros dinamicamente (por meio de uma variável, registro de tabela ou Informações do aplicativo) ou por meio de um valor estático determinado pelo seu tipo de filtro. Os tipos de filtro disponíveis são:

• Data e hora
• Nome do aplicativo
• Nome da etapa
• Nome do campo da tabela (campos da tabela à qual o placeholder do registro foi vinculado)
• Usuário (usuário que utiliza o aplicativo)

A Tulip recomenda o uso, no mínimo, dos seguintes filtros, pois eles organizam os dados em uma visualização mais acessível para os usuários:

• Data e hora
• Nome do aplicativo
• Nome da etapa

Ocultar valores “antigos” nas atualizações de registros

Quando ativada, o usuário só pode ver as atualizações e os valores “novos” dos registros.

Ocultar dados do processo

Quando ativada, os dados de variáveis salvos dos aplicativos ficam ocultos no widget. O widget exibirá atualizações da tabela, dados de assinatura, nomes de aplicativos, nomes de etapas e carimbos de data/hora. Isso é útil para obter uma visão geral (sem dados do processo), como em um aplicativo exclusivamente de revisão.

Apenas conclusões assinadas

Quando ativada, o usuário só pode ver registros com assinatura eletrônica.

Perguntas frequentes

Como posso evitar dados granulares do tipo de log?

Quando um registro de tabela é carregado em um campo de entrada e o usuário faz login nesse campo, são gerados dados de log muito detalhados dentro da mesma entrada. Isso pode gerar muitas “entradas” no histórico do registro e, potencialmente, tornar o processo de revisão mais difícil. Usar registros de tabela como fonte de dados para campos de entrada não é a melhor prática, especialmente para clientes GxP. Como alternativa, o campo de entrada pode ser vinculado a uma variável que, em seguida, é salva no registro de conclusão pela etapa “Salvar todos os dados do aplicativo ”.

Por que é importante ter cuidado com o “Filtro de nome de campo da tabela” ao usar um valor estático?

O widget do histórico de registros usará o nome atual do campo para filtrar os dados. Se o usuário alterar o nome do campo da tabela e o filtro ainda usar o nome antigo do campo, isso pode causar inconsistências na revisão dos dados. Como alternativa, o registro da tabela poderia ser usado como filtro.

Como resolver o erro “Dados de conclusão ausentes durante a etapa X”?

Isso pode ocorrer quando os usuários não concluem o aplicativo sempre que realizam uma ação em um registro da tabela, o que significa que os usuários estão lidando com vários registros em uma única conclusão, ou que a opção “Não salvar para análise” está marcada no espaço reservado do registro da tabela.