Vue d’ensemble de $convert-data
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înePour Ccda : XMLPour Json : JSONPour 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
Pour savoir comment résoudre les problèmes $convert-data
, consultez
Pour en savoir plus sur les questions fréquemment posées (FAQ) pour $convert-data
, consultez
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.