Conversione dei dati in FHIR per l'API di Azure per FHIR

L'endpoint personalizzato $convert-data nel servizio FHIR è destinato alla conversione dei dati da diversi tipi di dati a FHIR. Usa il motore modello Liquid e i modelli del progetto Convertitore FHIR come modelli predefiniti. È possibile personalizzare questi modelli di conversione in base alle esigenze.

Attualmente, l'endpoint personalizzato $convert-data supporta i tipi four di conversione dati:

Usare l'endpoint $convert-data

L'operazione $convert-data è integrata nel servizio FHIR ed è eseguita come parte del servizio. Dopo aver abilitato $convert-data nel server, è possibile effettuare chiamate API al server per convertire i dati in FHIR: https://<<FHIR service base URL>>/$convert-data

Risorsa parametro

$convert-data acquisisce una risorsa parametro nel corpo della richiesta, come descritto nella tabella seguente. Nel corpo della richiesta di chiamata API, è necessario includere i parametri seguenti:

Richiesta di esempio

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "inputData",
            "valueString": "MSH|^~\\&|SIMHOSP|SFAC|RAPP|RFAC|20200508131015||ADT^A01|517|T|2.3|||AL||44|ASCII\nEVN|A01|20200508131015|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|\nPID|1|3735064194^^^SIMULATOR MRN^MRN|3735064194^^^SIMULATOR MRN^MRN~2021051528^^^NHSNBR^NHSNMBR||Kinmonth^Joanna^Chelsea^^Ms^^D||19870624000000|F|||89 Transaction House^Handmaiden Street^Wembley^^FV75 4GJ^GBR^HOME||020 3614 5541^PRN|||||||||C^White - Other^^^||||||||\nPD1|||FAMILY PRACTICE^^12345|\nPV1|1|I|OtherWard^MainRoom^Bed 183^Simulated Hospital^^BED^Main Building^4|28b|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|||CAR|||||||||16094728916771313876^^^^visitid||||||||||||||||||||||ARRIVED|||20200508131015||"
        },
        {
            "name": "inputDataType",
            "valueString": "Hl7v2"
        },
        {
            "name": "templateCollectionReference",
            "valueString": "microsofthealth/fhirconverter:default"
        },
        {
            "name": "rootTemplate",
            "valueString": "ADT_A01"
        }
    ]
}

Risposta di esempio

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:9d697ec3-48c3-3e17-db6a-29a1765e22c6",
      "resource": {
        "resourceType": "Patient",
        "id": "9d697ec3-48c3-3e17-db6a-29a1765e22c6",
        ...
        ...
      "request": {
        "method": "PUT",
        "url": "Location/50becdb5-ff56-56c6-40a1-6d554dca80f0"
      }
    }
  ]
}

Personalizzare i modelli

È possibile usare l'estensione Convertitore FHIR per Visual Studio Code per personalizzare i modelli in base alle proprie esigenze. L'estensione offre un'esperienza di modifica interattiva e semplifica il download di modelli e dati campione pubblicati da Microsoft. Per altri dettagli, fare riferimento alla documentazione nell'estensione.

Ospitare e usare modelli

È consigliabile ospitare la propria copia dei modelli in Registro Azure Container. Sono necessari quattro passaggi per ospitare la propria copia dei modelli e usarli nell'operazione $convert-data:

1. Eseguire il push dei modelli nel Registro Azure Container.
2. Abilitare l'identità gestita nell'istanza dell'API di Azure per FHIR.
3. Fornire l'accesso al Registro Azure Container all'identità gestita dell’API di Azure per FHIR.
4. Registrare i server del Registro Azure Container nell'API di Azure per FHIR.
5. Facoltativamente, configurare il firewall del Registro Azure Container per l'accesso sicuro.

Eseguire il push di modelli al Registro Azure Container

Dopo aver creato un'istanza di Registro Azure Container, è possibile usare il comando Convertitore FHIR: Esegui il push di templates nell’estensione Convertitore FHIR per eseguire il push dei modelli personalizzati al Registro Azure Container. In alternativa, è possibile usare lo strumento Gestione modelli dell'interfaccia della riga di comando a questo scopo.

Abilitare l'identità gestita nell'API di Azure per FHIR

Passare all'istanza del servizio API di Azure per FHIR nel portale di Azure e quindi selezionare il pannello Identità. Modificare lo stato a Sì per abilitare l'identità gestita nell'API di Azure per FHIR.

Fornire l'accesso al Registro Azure Container all'API di Azure per FHIR

1. Passare al pannello Controllo di accesso (IAM).

2. Selezionare Aggiungi e quindi Aggiungi assegnazione di ruolo per aprire la pagina Aggiungi assegnazione di ruolo.

3. Assegnare il ruolo AcrPull.

   

Per altre informazioni sull'assegnazione di ruoli nel portale di Azure, vedere Ruoli di Azure integrati.

Registrare i server del Registro Azure Container nell'API di Azure per FHIR

È possibile registrare il server ACR usando il portale di Azure o l'interfaccia della riga di comando.

Registrazione dell’ARC tramite il portale di Azure

Passare al pannello Artefatti in Trasformazione dati nell'istanza dell'API di Azure per FHIR. Verrà visualizzato l'elenco dei server ACR attualmente registrati. Selezionare Aggiungi e quindi selezionare il proprio server del registro dal menu a discesa. È necessario selezionare Salva per rendere effettiva la registrazione. L'applicazione della modifica e il riavvio dell'istanza potrebbero richiedere alcuni minuti.

Registrazione del server ACR tramite l'interfaccia della riga di comando

È possibile registrare fino a 20 server ACR nell'API di Azure per FHIR.

Se necessario, installare l'interfaccia della riga di comando di Servizi per i dati sanitari di Azure da Azure PowerShell:

az extension add -n healthcareapis

Registrare i server ACR nell'API di Azure per FHIR seguendo gli esempi seguenti:

Registrare un singolo server ACR

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

Registrare più server ACR

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io fhiracr2020.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

Configurare il firewall del Registro Azure Container

Selezionare Reti dell'account di archiviazione di Azure dal portale.

Selezionare Reti selezionate.

Nella sezione Firewall, specificare l'indirizzo IP nella casella Intervallo di indirizzi. Aggiungere gli intervalli IP per consentire l'accesso da Internet o dalle reti locali.

Nella tabella seguente, si troverà l'indirizzo IP per l'area di Azure in cui viene effettuato il provisioning del servizio API di Azure per FHIR.

Verificare

Effettuare una chiamata all'API $convert-data specificando il proprio riferimento al modello nel parametro templateCollectionReference.

<RegistryServer>/<imageName>@<imageDigest>

Passaggi successivi

In questo articolo è stata illustrata la conversione dei dati per l'API di Azure per FHIR. Per altre informazioni su progetti GitHub correlati per l'API di Azure per FHIR, vedere

FHIR® è un marchio registrato di HL7 ed è usato con l'autorizzazione di HL7.