Vue d’ensemble de $convert-data

Article
08/04/2023

Notes

Fast Healthcare Interoperability Resources (FHIR®) est une spécification de soins de santé ouverte.

En utilisant l’opération $convert-data dans le service FHIR, vous pouvez convertir des données d’intégrité de différents formats en données FHIR R4 . L’opération $convert-data utilise des modèles Liquid du projet convertisseur FHIR pour la conversion de données FHIR. Vous pouvez personnaliser ces modèles de conversion en fonction de vos besoins. Actuellement, l’opération $convert-data prend en charge quatre types de conversion de données :

HL7v2 à FHIR R4
C-CDA vers FHIR R4
JSON vers FHIR R4 (destiné aux mappages de conversion personnalisés)
FHIR STU3 à FHIR R4

Notes

Vous pouvez utiliser le $convert-data point de terminaison en tant que composant dans un pipeline ETL (extraire, transformer et charger) pour la conversion des données d’intégrité de différents formats (par exemple : HL7v2, CCDA, JSON et FHIR STU3) au format FHIR. Vous pouvez créer un pipeline ETL pour un workflow complet lorsque vous convertissez vos données d’intégrité. Nous vous recommandons d’utiliser un moteur ETL basé sur Azure Logic Apps ou Azure Data Factory. Par exemple, un workflow peut inclure : l’ingestion de données, l’exécution $convert-data d’opérations, la validation, le pré/post-traitement des données, l’enrichissement des données, la déduplication des données et le chargement des données pour la persistance dans le service FHIR.

Utiliser le point de terminaison $convert-data

L’opération $convert-data est intégrée au service FHIR en tant qu’action d’API REST. Vous pouvez appeler le point de $convert-data terminaison comme suit :

POST {{fhirurl}}/$convert-data

Les données d’intégrité pour la conversion sont remises au service FHIR dans le corps de la $convert-data demande. Si la demande réussit, le service FHIR retourne une réponse groupée FHIR avec les données converties en FHIR R4.

Paramètres

Un $convert-data appel d’opération package les données d’intégrité pour la conversion à l’intérieur d’un paramètre au format JSON dans le corps de la demande. Les paramètres sont décrits dans le tableau suivant :

Nom du paramètre	Description	Valeurs acceptées
inputData	Charge utile des données à convertir en FHIR.	Pour `Hl7v2`: chaîne Pour `Ccda`: XML Pour `Json`: JSON Pour `FHIR STU3`: JSON
inputDataType	Type d’entrée de données.	`Hl7v2`, `Ccda`, `Json`, `Fhir`
templateCollectionReference	Référence à une collection de modèles d’images OCI dans Azure Container Registry. La référence est à une image qui contient des modèles Liquid à utiliser pour la conversion. Il peut faire référence à des modèles par défaut ou à une image de modèle personnalisée inscrite dans le service FHIR. Les sections suivantes couvrent la personnalisation des modèles, leur hébergement sur Azure Container Registry et leur inscription au service FHIR.	Pour les modèles par défaut/exemples : Modèles HL7v2 : `microsofthealth/fhirconverter:default` `microsofthealth/hl7v2templates:default` Modèles C-CDA : `microsofthealth/ccdatemplates:default` Modèles JSON : `microsofthealth/jsontemplates:default` Modèles FHIR STU3 : `microsofthealth/stu3tor4templates:default` Pour les modèles personnalisés : `<RegistryServer>/<imageName>@<imageDigest>`, `<RegistryServer>/<imageName>:<imageTag>`
rootTemplate	Modèle racine à utiliser lors de la transformation des données.	Pour HL7v2 : ADT_A01, ADT_A02, ADT_A03, ADT_A04, ADT_A05, ADT_A08, ADT_A11, ADT_A13, ADT_A14, ADT_A15, ADT_A16, ADT_A25, ADT_A26, ADT_A27, ADT_A28, ADT_A29, ADT_A31, ADT_A47, ADT_A60, OML_O21, ORU_R01, ORM_O01, VXU_V04, SIU_S12, SIU_S13, SIU_S14, SIU_S15, SIU_S16, SIU_S17, SIU_S26, MDM_T01, MDM_T02 Pour C-CDA : CCD, ConsultationNote, CongéSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary Pour JSON : ExemplePatient, Stu3ChargeItem Pour FHIR STU3 : Nom de la ressource FHIR STU3 (par exemple : Patient, Observation, Organisation)

Notes

Les modèles FHIR STU3 à FHIR R4 sont des modèles Liquid qui fournissent des mappages de différences de champ uniquement entre une ressource STU3 FHIR et sa ressource équivalente dans la spécification FHIR R4. Certaines des ressources FHIR STU3 sont renommées ou supprimées de FHIR R4. Pour plus d’informations sur les différences et contraintes de ressources pour la conversion de FHIR STU3 en FHIR R4, consultez Différences de ressources et contraintes pour la conversion de FHIR STU3 en FHIR R4.

Notes

Les modèles JSON sont des exemples de modèles à utiliser pour créer vos propres mappages de conversion. Il ne s’agit pas de modèles par défaut qui respectent les types de messages de données d’intégrité prédéfinis. JSON lui-même n’est pas spécifié en tant que format de données d’intégrité, contrairement à HL7v2 ou C-CDA. Par conséquent, au lieu de fournir des modèles JSON par défaut, nous fournissons des exemples de modèles JSON que vous pouvez utiliser comme point de départ pour vos propres mappages personnalisés.

Avertissement

Les modèles par défaut sont publiés sous la licence MIT et ne sont pas pris en charge par Support Microsoft.

Les modèles par défaut sont fournis uniquement pour vous aider à démarrer avec votre workflow de conversion de données. Ces modèles par défaut ne sont pas destinés à la production et peuvent changer lorsque Microsoft publie des mises à jour pour le service FHIR. Pour avoir un comportement de conversion de données cohérent entre différentes versions du service FHIR, vous devez effectuer les opérations suivantes :

Hébergez votre propre copie des modèles dans un Azure Container Registry instance.
Inscrivez les modèles auprès du service FHIR.
Utilisez vos modèles inscrits dans vos appels d’API.
Vérifiez que le comportement de conversion répond à vos besoins.

Pour plus d’informations sur l’hébergement de vos propres modèles, consultez Héberger vos propres modèles

Exemple de requête

{
    "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"
        }
    ]
}

Exemple de réponse

{
    "resourceType": "Bundle",
    "type": "batch",
    "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"
            }
        }
    ]
}

Le résultat de la conversion FHIR est un bundle FHIR sous forme de lot.

L’offre groupée FHIR doit s’aligner sur les attentes de la spécification FHIR R4 - Bundle - FHIR v4.0.1.
Si vous essayez de valider par rapport à un profil spécifique, vous devez effectuer un post-traitement en utilisant l’opération FHIR $validate .

Étapes suivantes

Dans cet article, vous avez découvert l’opération $convert-data et comment utiliser le point de terminaison pour convertir des données d’intégrité en FHIR R4 à l’aide du service FHIR dans Azure Health Data Service.

Pour savoir comment configurer les paramètres d’utilisation $convert-data de l’Portail Azure, consultez

Configurer les paramètres de $convert-data à l’aide de l’Portail Azure

Pour savoir comment résoudre les problèmes $convert-data, consultez

Résoudre les problèmes de $convert-data

Pour en savoir plus sur les questions fréquemment posées (FAQ) pour $convert-data, consultez

Forum aux questions sur $convert-data

FHIR® est une marque déposée de la Health Level Seven International, enregistrée auprès de l’U.S. Trademark Office et utilisée avec leur autorisation.

Vue d’ensemble de $convert-data

Utiliser le point de terminaison $convert-data

Paramètres

Exemple de requête

Exemple de réponse

Étapes suivantes

Ressources supplémentaires