Capturando e Compartilhando Relatórios de Medição ao Nível do Paciente via FHIR Usando Da Vinci Risk Adjustment com o HealthShare

Organizações que precisam capturar, armazenar e compartilhar resultados de medidas de ajuste de risco ou qualidade ao nível do paciente via FHIR podem fazê-lo estendendo o HealthShare SDA e habilitando a transformação para o recurso FHIR MeasureReport.

Este artigo descreve como configurar o HealthShare para suportar o Guia de Implementação (IG) Da Vinci Risk Adjustment (RA), habilitando o armazenamento e a troca baseada em FHIR de recursos MeasureReport para pacientes ou membros individuais.

Da Vinci Risk Adjustment IG: https://build.fhir.org/ig/HL7/davinci-ra/index.html
Recurso FHIR MeasureReport (R4): https://hl7.org/fhir/R4/measurereport.html

O resultado desta configuração é a capacidade de persistir dados de MeasureReport no SDA e expô-los via FHIR R4 em conformidade com o perfil Da Vinci RA.

Resumo da Solução

Esta solução introduz um container SDA3 customizado para armazenar dados de MeasureReport para cada paciente e configura o HealthShare para transformar esses dados em um recurso FHIR R4 MeasureReport.

As entregas incluem:

Um container SDA customizado e as classes de suporte relacionadas
Um DTL customizado para transformar SDA para FHIR
Atualizações de configuração para registrar e habilitar a transformação
Um paciente de teste para validar a funcionalidade de ponta a ponta

Uma vez concluído, o HealthShare irá:

Armazenar dados de MeasureReport por paciente no SDA
Usar automaticamente o container customizado
Expor o MeasureReport através do endpoint FHIR R4 no ODS

Passos para Implementação

1. Baixar, Importar e Compilar o Código Customizado

Baixe o arquivo MeasureReportCode.xml do GitHub: https://github.com/smckennaisc/hs-measurereports-example/

Importe e compile o conteúdo do MeasureReportCode.xml no namespace HSCUSTOM nos seguintes ambientes HealthShare:

Registry
Edge Gateway
ODS/FHIR Gateway
Clinical Viewer

Nota: Aplica-se ao HealthShare v2025.1

Componentes incluídos no arquivo

i. Container SDA Customizado

HS.Local.SDA3.ZContainer.cls

ii. Classes SDA3 MeasureReport Customizadas

HS.Local.SDA3.ZMeasureReport.cls
HS.Local.SDA3.ZMeasureReportGroup.cls
HS.Local.SDA3.ZMeasureReportExtension.cls
HS.Local.SDA3.Streamlet.ZMeasureReport.cls
HS.Local.SDA3.CodeTableDetail.ZMeasureReportCategory.cls
HS.Local.SDA3.CodeTableDetail.ZGroupCode.cls
HS.Local.SDA3.CodeTableDetail.ZccRemark.cls

iii. DTL Customizado

HS.Local.FHIR.DTL.SDA3.vR4.MeasureReport.MeasureReport

2. Registrar o Container SDA Customizado

No HSREGISTRY, adicione a seguinte entrada no Configuration Registry:

Isso garante que o HealthShare use o container SDA customizado ao processar dados SDA3.

3. Habilitar a Transformação SDA-para-FHIR

No HSODS, atualize a seguinte global:

set ^HS.XF.Transform("SDA3","vR4", "HS.Local.SDA3.ZMeasureReport", "HS.Local.FHIR.DTL.SDA3.vR4.MeasureReport.MeasureReport") = 1

Isso habilita explicitamente a transformação do container customizado SDA3 MeasureReport para o recurso FHIR R4 MeasureReport.

4. Atualizar o XFTransform.xml

Localize o arquivo XFTransform.xml no diretório da instância:

Pode ser necessário definir temporariamente o arquivo para leitura/escrita.

Adicione o seguinte nó XML após os nós SDA4 e vR4 e antes de HS.SDA3.Address (geralmente por volta da linha 7):

Este passo garante que a transformação seja reconhecida durante o tempo de execução (runtime).

Teste e Validação

Baixar e Carregar Dados SDA de Teste

Baixe o arquivo TestMeasurePatient.txt do GitHub: https://github.com/smckennaisc/hs-measurereports-example/
Se estiver rodando um ambiente demo do HealthShare, coloque o TestMeasurePatient.txt no diretório SDAIn do HSEDGE1
Pode ser qualquer Edge configurado para aceitar mensagens SDA3

Validar via API FHIR

Usando o Postman ou outra ferramenta de teste de API, envie as seguintes requisições:

Consulta por Paciente e Perfil

https://<seu-host>/csp/healthshare/hsods/fhir/r4/MeasureReport ?patient=100000012 &_profile=http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-measurereport

Substitua <seu-host> pela URL do seu HealthShare
Substitua 100000012 pelo MPIID do paciente

Consultar Todos os MeasureReports

https://<seu-host>/csp/healthshare/hsods/fhir/r4/MeasureReport

Resultado Esperado:

Um único recurso MeasureReport deve ser retornado

Validar no Clinical Viewer (CV)

Procure pelo paciente “Test MeasureReport” no Clinical Viewer do HealthShare
Confirme se o registro SDA inclui o container customizado de MeasureReport

Resultado Final

Após concluir estes passos, seu ambiente HealthShare será capaz de:

Persistir dados de MeasureReport ao nível do paciente no SDA
Transformar dados SDA em um recurso FHIR R4 MeasureReport
Compartilhar recursos MeasureReport via FHIR em alinhamento com o Guia de Implementação Da Vinci Risk Adjustment

Isso possibilita relatórios de ajuste de risco baseados em padrões e interoperabilidade com sistemas de análise, pagadores e órgãos regulatórios.

Escrito por