Gerenciamento de histórico e política de controle de versão

A política de controle de versão no serviço FHIR dos Serviços de Dados de Integridade do Azure é uma configuração que determina como o histórico é armazenado para cada tipo de recurso com a opção de configuração específica do recurso. Essa política está diretamente relacionada ao conceito de gerenciamento do histórico de recursos FHIR.

Histórico no FHIR

O histórico no FHIR oferece a capacidade de ver todas as versões anteriores de um recurso. O histórico no FHIR pode ser consultado no nível do recurso, no nível do tipo ou no nível do sistema. A documentação do HL7 FHIR tem mais informações sobre a interação de histórico. O histórico é útil em cenários em que você deseja ver a evolução de um recurso no FHIR ou se deseja ver as informações de um recurso em um ponto específico no tempo.

Todas as versões anteriores de um recurso são consideradas obsoletas e a versão atual de um recurso deve ser usada para operações normais de fluxo de trabalho de negócios. No entanto, pode ser útil ver o estado de um recurso como um ponto no tempo em que uma decisão passada foi tomada.

Política de controle de versão

A política de controle de versão no serviço FHIR permite que você decida como o histórico é armazenado em um nível de serviço FHIR ou em um nível de recurso específico.

Há três níveis diferentes para a política de controle de versão:

• versioned: o histórico é armazenado para operação em recursos. A versão do recurso é incrementada. Esse é o padrão.
• version-update: o histórico é armazenado para operação em recursos. A versão do recurso é incrementada. Atualizações exigir um cabeçalho válidoIf-Match. Para obter mais informações, consulte VersionedUpdateExample.http.
• no-version: o histórico não é criado para recursos. A versão do recurso é incrementada.

Política de controle de versão disponível para definir em como uma configuração em todo o sistema e também para substituir em um nível de recurso. A configuração em todo o sistema é usada para todos os recursos em seu serviço FHIR, a menos que uma política de controle de versão de nível de recurso específica tenha sido adicionada.

Comparação de política de controle de versão

Valor da Política	Comportamento do histórico	meta.versionId Comportamento de atualização	Padrão
versioned	O histórico é armazenado	If-Match não necessário	Sim
version-update	O histórico é armazenado	If-Match necessário	Não
no-version	O histórico não é armazenado	If-Match não necessário	Não

Observação

Alterar a política de controle de versão para no-version não tem nenhum efeito no histórico de recursos existente. Se o histórico precisar ser removido para recursos, use a operação de histórico de $purge .

Configurando a política de controle de versão

Para configurar a política de controle de versão, selecione a folha Configuração da Política de Controle de Versão dentro do serviço FHIR.

Depois de navegar até a Configuração da Política de Controle de Versão, você poderá definir a configuração no nível do sistema e no nível do recurso (como uma substituição do nível do sistema). A configuração no nível do sistema (anotada como 1) será aplicada a todos os recursos em seu serviço FHIR, a menos que uma substituição específica do recurso (anotada em 2) tenha sido configurada.

Ao configurar a configuração no nível do recurso, você poderá selecionar o tipo de recurso FHIR (anotado como 1) e a política de controle de versão específica para esse recurso específico (anotado como 2). Selecione o botão Adicionar (anotado como 3) para enfileirar essa configuração para salvar.

SelecioneSalvar depois de concluir a configuração da política de controle de versão.

Gerenciamento de histórico

O histórico no FHIR é importante para os usuários finais verem como um recurso foi alterado ao longo do tempo. Também é útil em coordenação com logs de auditoria para ver o estado de um recurso antes e depois que um usuário o modificou. Em geral, é recomendável manter o histórico de um recurso, a menos que você saiba que o histórico não é necessário. Atualizações frequentes de recursos podem resultar em uma grande quantidade de armazenamento de dados, que pode ser indesejado em serviços FHIR com uma grande quantidade de dados.

Alterar a política de controle de versão no nível do sistema ou no nível do recurso não removerá o histórico existente de nenhum recurso em seu serviço FHIR. Se você estiver procurando reduzir o tamanho dos dados do histórico em seu serviço FHIR, deverá usar a operação de histórico de $purge .

Próximas etapas

Neste artigo, você aprendeu a limpar o histórico de recursos no serviço FHIR. Para obter mais informações sobre como desabilitar o histórico e alguns conceitos sobre o gerenciamento de histórico, consulte

Operação de histórico de limpeza

FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.