Gestão de histórico e política de controlo de versões
A política de controlo de versões no serviço FHIR dos Serviços de Dados de Saúde 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. Esta política está diretamente relacionada com o conceito de gestão do histórico de recursos FHIR.
Histórico no FHIR
O histórico no FHIR dá-lhe a capacidade de ver todas as versões anteriores de um recurso. O histórico no FHIR pode ser consultado ao nível do recurso, ao nível do tipo ou ao nível do sistema. A documentação do HL7 FHIR tem mais informações sobre a interação do histórico. O histórico é útil em cenários em que pretende ver a evolução de um recurso no FHIR ou se quiser ver as informações de um recurso num 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 utilizada para operações normais de fluxo de trabalho empresarial. No entanto, pode ser útil ver o estado de um recurso como um ponto no tempo em que foi tomada uma decisão anterior.
Versioning policy (Política de versões)
A política de controlo de versões no serviço FHIR permite-lhe decidir como o histórico é armazenado ao nível do serviço FHIR ou a um nível de recurso específico.
Existem três níveis diferentes para a política de controlo de versões:
-
versioned: o histórico é armazenado para operação nos recursos. A versão do recurso é incrementada. Esta é a predefinição. -
version-update: o histórico é armazenado para operação nos 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 controlo de versões disponível para configurar como uma definição ao nível do sistema e também para substituir ao nível dos recursos. A definição ao nível do sistema é utilizada para todos os recursos no seu serviço FHIR, a menos que tenha sido adicionada uma política de controlo de versões específica ao nível dos recursos.
Comparação de políticas de controlo de versões
| Valor da Política | Comportamento do Histórico |
meta.versionId Comportamento da Atualização |
Predefinição |
|---|---|---|---|
versioned |
O histórico é armazenado | If-Match não necessário | Yes |
version-update |
O histórico é armazenado | If-Match necessário | No |
no-version |
O histórico não está armazenado | If-Match não necessário | No |
Nota
Alterar a política de controlo de versões para no-version não ter qualquer efeito no histórico de recursos existente. Se o histórico precisar de ser removido para os recursos, utilize a operação de histórico de $purge .
Configurar a política de controlo de versões
Para configurar a política de controlo de versões, selecione o painel Configuração da Política de Controlo de Versões no seu serviço FHIR.
Depois de navegar para a Configuração da Política de Controlo de Versões, poderá configurar a definição ao nível do sistema e ao nível do recurso (como uma substituição do nível do sistema). A configuração ao nível do sistema (anotada como 1) será aplicada a todos os recursos no seu serviço FHIR, a menos que tenha sido configurada uma substituição específica do recurso (anotada em 2).
Ao configurar a configuração ao nível do recurso, poderá selecionar o tipo de recurso FHIR (anotado como 1) e a política de controlo de versões específica para este recurso específico (anotado como 2). Certifique-se de que seleciona o botão Adicionar (anotado como 3) para colocar esta definição em fila para guardar.
Certifique-se de que seleciona Guardar depois de concluir a configuração da política de controlo de versões.
Gestão do histórico
O histórico no FHIR é importante para os utilizadores finais verem como um recurso mudou ao longo do tempo. Também é útil em coordenação com os registos de auditoria para ver o estado de um recurso antes e depois de um utilizador o ter modificado. Em geral, é recomendado manter o histórico de um recurso, a menos que saiba que o histórico não é necessário. As atualizações frequentes de recursos podem resultar numa grande quantidade de armazenamento de dados, que pode não ser desejado nos serviços FHIR com uma grande quantidade de dados.
Alterar a política de controlo de versões ao nível do sistema ou ao nível dos recursos não removerá o histórico existente de quaisquer recursos no seu serviço FHIR. Se quiser reduzir o tamanho dos dados do histórico no serviço FHIR, tem de utilizar a operação de histórico de $purge .
Passos seguintes
Neste artigo, aprendeu a remover o histórico de recursos no serviço FHIR. Para obter mais informações sobre como desativar o histórico e alguns conceitos sobre a gestão do histórico, consulte
FHIR® é uma marca registada do HL7 e é utilizada com a permissão de HL7.