Cette page explique comment créer, modifier, afficher, répertorier et supprimer des magasins FHIR (Fast Healthcare Interoperability Resources). Les magasins FHIR contiennent des ressources FHIR, telles que des ressources "Claim", des ressources "Patient", des ressources "Medication", etc.
L'API Cloud Healthcare est compatible avec les versions suivantes de FHIR :
Créer un magasin FHIR
Pour pouvoir créer un datastore FHIR, vous devez d'abord créer un ensemble de données.
Les exemples suivants montrent comment créer un magasin FHIR à l'aide de la méthode projects.locations.datasets.fhirStores.create
.
Console
Pour créer un store FHIR, procédez comme suit:
- Dans la console Google Cloud, accédez à la page Ensembles de données.
- Ouvrez l'ensemble de données dans lequel vous souhaitez créer un magasin FHIR.
- Cliquez sur Créer un datastore.
- Sélectionnez FHIR comme type de datastore.
- Saisissez un nom unique dans votre ensemble de données. Si le nom n'est pas unique, la création du magasin FHIR échoue.
- Cliquez sur Suivant.
- Pour configurer votre magasin FHIR, procédez comme suit :
- Choisissez la version FHIR du magasin FHIR (DSTU2, STU3 ou R4).
- Sélectionnez les paramètres avancés applicables parmi les suivants :
- Autoriser la création de mises à jour: cochez cette option pour autoriser la création d'une ressource à l'aide d'une opération de mise à jour avec un ID spécifié par l'utilisateur.
- Vérifications de l'intégrité référentielle: cochez cette case pour activer l'intégrité référentielle dans ce store. Vous ne pourrez plus le modifier une fois le store créé.
- Gestion des versions des ressources: sélectionnez cette option pour enregistrer automatiquement les versions historiques des ressources. Vous ne pourrez plus le modifier une fois le store créé.
- Sélectionnez les paramètres de validation de profil applicables dans les champs suivants. Pour en savoir plus, consultez ValidationConfig :
- Activer la validation de profil: sélectionnez cette option pour activer la validation de profil. Pour appliquer un guide de mise en œuvre activé dans votre magasin FHIR, vous devez activer la validation des profils.
- Activer la validation des champs obligatoires: sélectionnez cette option pour activer la validation des champs de ressources par rapport aux définitions de structure de votre profil FHIR.
- Activer la validation des types de référence: sélectionnez cette option pour activer la validation des types de référence.
- Activer la validation FHIRPath: sélectionnez cette option pour activer la vérification de la compatibilité FHIRPath.
- Cliquez sur Suivant.
- Facultatif: Pour activer les guides d'implémentation dans votre magasin FHIR, procédez comme suit :
- Cliquez sur Activer les guides d'implémentation.
- Cliquez sur la liste Guides d'implémentation et développez-la.
- Sélectionnez les guides d'implémentation applicables dans la liste.
Chaque guide d'implémentation est compatible avec une version spécifique de FHIR. La liste n'affiche que les guides d'implémentation compatibles avec la version du store FHIR sélectionnée.
- Cliquez sur Importer un guide d'implémentation personnalisé à partir de Cloud Storage pour importer un bundle de validation de fiche personnalisé à partir d'un emplacement Cloud Storage.
- Dans le panneau Sélectionner un objet, sélectionnez une ressource de bundle de validation de profil à partir d'un emplacement Cloud Storage. Pour en savoir plus, consultez la page Utiliser la console Google Cloud pour activer les guides d'implémentation.
- Cliquez sur Sélectionner.
- Les guides d'implémentation sélectionnés sont listés dans un tableau avec leur version, leur URL et leur état.
- Si vous avez activé les guides d'implémentation, mais que vous n'avez pas activé la validation des profils, le guide d'implémentation n'entrera pas en vigueur.
- Cliquez sur Suivant.
- Facultatif: Pour exporter les modifications de ressources vers BigQuery chaque fois que les ressources FHIR de votre magasin sont créées, mises à jour, corrigées ou supprimées, procédez comme suit :
- Cliquez sur Diffuser les modifications apportées aux ressources vers BigQuery.
- Cliquez sur Ajouter une configuration de streaming. Pour en savoir plus sur le streaming BigQuery, consultez la section Diffuser les modifications de ressources FHIR dans BigQuery.
- Sélectionnez le niveau de profondeur dans le curseur Profondeur de la structure récursive pour définir la profondeur de toutes les structures récursives dans le schéma de sortie. Par défaut, la valeur de profondeur récursive est 2.
- Cliquez sur OK pour enregistrer la configuration de streaming.
- Cliquez sur Suivant.
- Facultatif: Pour configurer un sujet Pub/Sub pour le magasin FHIR, procédez comme suit :
- Cliquez sur Recevoir des notifications Cloud Pub/Sub.
- Cliquez sur Ajouter un sujet Cloud Pub/Sub, puis sélectionnez le nom du sujet.
Lorsque vous spécifiez un thème Pub/Sub, saisissez l'URI qualifié du thème, comme indiqué dans l'exemple suivant :
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Cliquez sur Suivant.
- Facultatif: Pour ajouter des libellés à la boutique, procédez comme suit :
- Cliquez sur Ajouter des libellés pour organiser vos datastores.
- Saisissez la clé et la valeur du libellé. Pour en savoir plus sur les libellés de ressources, consultez la section Utiliser des libellés de ressources.
- Cliquez sur Créer.
Le nouveau magasin FHIR apparaît dans la liste.
gcloud
Pour créer un data store FHIR dans l'ensemble de données, exécutez la commande gcloud healthcare fhir-stores create
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
- LOCATION : emplacement de l'ensemble de données
- DATASET_ID : ensemble de données parent du magasin FHIR.
- FHIR_STORE_ID : identifiant du magasin FHIR. L'ID du store FHIR doit comporter les éléments suivants :
- Un ID unique dans son ensemble de données
- Une chaîne Unicode de 1 à 256 caractères composée des éléments suivants :
- Numéros
- Lettres
- Traits de soulignement
- Tirets
- Points
- FHIR_STORE_VERSION : version FHIR du store FHIR. Les options disponibles sont DSTU2, STU3 ou R4.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores create FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --version=FHIR_STORE_VERSION
Windows (PowerShell)
gcloud healthcare fhir-stores create FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --version=FHIR_STORE_VERSION
Windows (cmd.exe)
gcloud healthcare fhir-stores create FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --version=FHIR_STORE_VERSION
Vous devriez obtenir un résultat semblable à celui-ci :
Réponse
Created fhirStore [FHIR_STORE_ID].
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- LOCATION : emplacement de l'ensemble de données
- DATASET_ID : ensemble de données parent du magasin FHIR.
- FHIR_STORE_ID : identifiant du magasin FHIR. L'ID du store FHIR doit comporter les éléments suivants :
- Un ID unique dans son ensemble de données
- Une chaîne Unicode de 1 à 256 caractères composée des éléments suivants :
- Numéros
- Lettres
- Traits de soulignement
- Tirets
- Points
- FHIR_STORE_VERSION : version FHIR du store FHIR. Les options disponibles sont DSTU2, STU3 ou R4.
Corps JSON de la requête :
{ "version": "FHIR_STORE_VERSION" }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
cat > request.json << 'EOF' { "version": "FHIR_STORE_VERSION" } EOF
Exécutez ensuite la commande suivante pour envoyer votre requête REST :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "version": "FHIR_STORE_VERSION" } '@ | Out-File -FilePath request.json -Encoding utf8
Exécutez ensuite la commande suivante pour envoyer votre requête REST :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID" | Select-Object -Expand Content
API Explorer
Copiez le corps de la requête et ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Collez le corps de la requête dans cet outil, renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez recevoir une réponse JSON de ce type :
Go
Java
Node.js
Python
Modifier un magasin FHIR
Les exemples suivants montrent comment modifier un data store FHIR. Vous pouvez modifier un store FHIR pour modifier les propriétés telles que les suivantes :
- Le thème Pub/Sub auquel l'API Cloud Healthcare envoie des notifications de modification du store FHIR.
- Étiquettes du store FHIR. Les libellés sont des paires clé/valeur qui vous aident à organiser vos ressources Google Cloud.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Console
Pour modifier un magasin FHIR, procédez comme suit :
Dans la console Google Cloud, accédez à la page Ensembles de données.
Accéder à la page "Ensembles de données"Sélectionnez l'ensemble de données contenant le magasin FHIR que vous souhaitez modifier.
Dans la liste Datastores, sélectionnez le magasin FHIR que vous souhaitez modifier.
Pour modifier la configuration du magasin, cliquez sur
Configuration du magasin FHIR.Pour en savoir plus sur les options de configuration du store FHIR, consultez la section Créer un store FHIR.
Pour modifier les guides d'implémentation de la plate-forme, cliquez sur Utiliser la console Google Cloud pour activer les guides d'implémentation.
Guides d'implémentation, puis sélectionnez les guides d'implémentation applicables ou importez un guide d'implémentation personnalisé à partir de Cloud Storage. Pour en savoir plus, consultez la pagePour modifier les guides de mise en œuvre ou appliquer les guides de mise en œuvre activés, vous devez activer la validation des profils dans la section Configuration du store FHIR.
Pour exporter les modifications de ressources vers BigQuery chaque fois que les ressources FHIR de votre store sont créées, mises à jour, corrigées ou supprimées, cliquez sur Ajouter une configuration de streaming dans le champ Ensemble de données.
Sélectionnez un ensemble de données BigQuery dans lequel les modifications de ressources seront diffusées en continu. Pour en savoir plus sur le streaming BigQuery, consultez la section Diffuser les modifications de ressources FHIR dans BigQuery.
Pour définir la profondeur de toutes les structures récursives dans le schéma de sortie, cliquez sur la profondeur appropriée dans le curseur Profondeur de la structure récursive. Par défaut, la profondeur récursive est 2.
Pour n'exporter des modifications de ressources que pour des types de ressources spécifiques, sélectionnez les types de ressources dans la liste Sélectionner les types de ressources FHIR.
Pour configurer un sujet Pub/Sub pour le data store, sélectionnez un nom de sujet dans la section Notifications Cloud Pub/Sub. Lorsque vous spécifiez un thème Pub/Sub, saisissez l'URI qualifié du thème, comme indiqué dans l'exemple suivant :
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Pour ajouter une ou plusieurs étiquettes au store, cliquez sur Utiliser des étiquettes de ressources.
Étiquettes et Ajouter une étiquette, puis saisissez l'étiquette de clé-valeur. Pour en savoir plus sur les étiquettes des ressources, consultez la pageCliquez sur Enregistrer.
gcloud
Pour modifier un store FHIR, exécutez la commande gcloud healthcare fhir-stores update
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du magasin FHIR.FHIR_STORE_ID
: ID du magasin FHIR.PUBSUB_TOPIC_ID
: sujet Pub/Sub dans lequel les messages sont publiés lorsqu'un événement se produit dans un data store
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores update FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (PowerShell)
gcloud healthcare fhir-stores update FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (cmd.exe)
gcloud healthcare fhir-stores update FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Vous devriez obtenir un résultat semblable à celui-ci :
Réponse
Updated fhirStore [FHIR_STORE_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID version: FHIR_STORE_VERSION
REST
Pour modifier un store FHIR, utilisez la méthode projects.locations.datasets.fhirStores.patch
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du magasin FHIR.FHIR_STORE_ID
: ID du magasin FHIR.PUBSUB_TOPIC_ID
: sujet Pub/Sub dans lequel les messages sont publiés lorsqu'un événement se produit dans un data store. Pour déterminer les données à inclure dans les notifications Pub/Sub, consultez la section Notifications Pub/Sub FHIR.KEY1
: clé de la première étiquetteVALUE1
: valeur de la première étiquetteKEY2
: clé de la deuxième étiquetteVALUE2
: valeur de la deuxième étiquette
Corps JSON de la requête :
{ "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
cat > request.json << 'EOF' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } EOF
Exécutez ensuite la commande suivante pour envoyer votre requête REST :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=notificationConfig,labels"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Exécutez ensuite la commande suivante pour envoyer votre requête REST :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=notificationConfig,labels" | Select-Object -Expand Content
API Explorer
Copiez le corps de la requête et ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Collez le corps de la requête dans cet outil, renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez recevoir une réponse JSON de ce type :
Go
Java
Node.js
Python
Obtenir des détails sur un datastore FHIR
Les exemples suivants montrent comment obtenir des détails sur un datastore FHIR.
Console
Pour afficher les détails d'un magasin FHIR :
- Dans la console Google Cloud, accédez à la page "Ensembles de données".
- Sélectionnez l'ensemble de données contenant le store FHIR.
- Cliquez sur le nom du magasin FHIR.
gcloud
Pour obtenir les détails d'un store FHIR, exécutez la commande gcloud healthcare fhir-stores describe
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
- LOCATION : emplacement de l'ensemble de données
- DATASET_ID : ensemble de données parent du magasin FHIR.
- FHIR_STORE_ID : ID du magasin FHIR.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores describe FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource FhirStore
, ils apparaissent également dans la réponse.
Réponse
... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID ... version: FHIR_STORE_VERSION
REST
Pour obtenir des détails sur un store FHIR, utilisez la méthode projects.locations.datasets.fhirStores.get
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- LOCATION : emplacement de l'ensemble de données
- DATASET_ID : ensemble de données parent du magasin FHIR.
- FHIR_STORE_ID : ID du magasin FHIR.
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID"
PowerShell
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
API Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource FhirStore
, ils apparaissent également dans la réponse.
Go
Java
Node.js
Python
Répertorier les magasins FHIR dans un ensemble de données
Les exemples suivants montrent comment répertorier les datastores FHIR d'un ensemble de données.
Console
Pour afficher les datastores d'un ensemble de données, procédez comme suit :
- Dans la console Google Cloud, accédez à la page Ensembles de données.
- Sélectionnez l'ensemble de données contenant le data store que vous souhaitez afficher.
gcloud
Pour afficher les détails d'un store FHIR, exécutez la commande gcloud healthcare fhir-stores list
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
- DATASET_ID : ensemble de données parent du magasin FHIR.
- LOCATION : emplacement de l'ensemble de données
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource FhirStore
, ils apparaissent également dans la réponse.
ID LOCATION REF_INT RES_VER UPDATE_CREATE TOPIC FHIR_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Pour répertorier les magasins FHIR dans un ensemble de données, utilisez la méthode projects.locations.datasets.fhirStores.list
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- DATASET_ID : ensemble de données parent du magasin FHIR.
- LOCATION : emplacement de l'ensemble de données
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores"
PowerShell
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores" | Select-Object -Expand Content
API Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource FhirStore
, ils apparaissent également dans la réponse.
Go
Java
Node.js
Python
Obtenir la déclaration de capacités ou de conformité d'un magasin FHIR
Les exemples suivants montrent comment obtenir la déclaration de capacités (STU3 ou R4) ou de conformité (DSTU2) pour un magasin FHIR.
Les informations contenues dans la déclaration de capacités ou de conformité reflètent les paramètres du magasin FHIR. Par exemple, si FhirStore.enableUpdateCreate
est défini sur true
, cela se reflète dans le champ CapabilityStatement.rest.resource.updateCreate
de la déclaration de capacités.
Le tableau suivant montre la méthode de l'API Cloud Healthcare pour obtenir la déclaration de capacités ou de conformité d'un magasin FHIR et son interaction de spécification FHIR équivalente :
Méthode de l'API Cloud Healthcare | Interaction de spécification FHIR |
---|---|
projects.locations.datasets.fhirStores.fhir.capabilities |
capacités (STU3, R4) ou conformance (DSTU2) |
Console
La console Google Cloud et gcloud CLI ne permettent pas d'effectuer cette opération. Utilisez plutôt curl
, PowerShell ou le langage de votre choix.
gcloud
La console Google Cloud et gcloud CLI ne permettent pas d'effectuer cette opération. Utilisez plutôt curl
, PowerShell ou le langage de votre choix.
REST
Pour obtenir la déclaration de capacités ou de conformité d'un store FHIR, utilisez la méthode projects.locations.datasets.fhirStores.fhir.capabilities
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- LOCATION : emplacement de l'ensemble de données
- DATASET_ID : ensemble de données parent du magasin FHIR.
- FHIR_STORE_ID : ID du magasin FHIR.
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/metadata"
PowerShell
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/metadata" | Select-Object -Expand Content
API Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.
Vous devriez recevoir une réponse JSON de ce type :
Go
Java
Node.js
Python
Définir le niveau de validation des ressources de base
Par défaut, la validation des ressources de base est appliquée à toutes les ressources de votre magasin FHIR. Cette validation garantit que les conditions suivantes sont remplies lors de la création de la ressource :
- Tous les champs obligatoires sont définis.
- Tous les types de ressources référencés sont valides.
- La ressource répond à toutes les contraintes FHIRPath.
Vous pouvez rendre votre validation de ressource de base moins stricte en désactivant un ou plusieurs de ces types de validation des ressources de base pour votre magasin FHIR.
Console
La console Google Cloud et gcloud CLI ne permettent pas d'effectuer cette opération. Utilisez plutôt curl
, PowerShell ou le langage de votre choix.
gcloud
La console Google Cloud et gcloud CLI ne permettent pas d'effectuer cette opération. Utilisez plutôt curl
, PowerShell ou le langage de votre choix.
REST
Pour désactiver la validation des ressources de base dans un store FHIR existant, utilisez la méthode projects.locations.datasets.fhirStores.patch
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- DATASET_ID : ensemble de données parent du magasin FHIR.
- LOCATION : emplacement de l'ensemble de données
- BASE_RESOURCE_VALIDATION_TYPE : type de validation des ressources de base que vous souhaitez désactiver. Pour désactiver la validation, définissez l'un des champs suivants sur
true
:disableRequiredFieldValidation
disableReferenceTypeValidation
disableFhirpathValidation
Corps JSON de la requête :
{ "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
cat > request.json << 'EOF' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } EOF
Exécutez ensuite la commande suivante pour envoyer votre requête REST :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } '@ | Out-File -FilePath request.json -Encoding utf8
Exécutez ensuite la commande suivante pour envoyer votre requête REST :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig" | Select-Object -Expand Content
API Explorer
Copiez le corps de la requête et ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Collez le corps de la requête dans cet outil, renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource FhirStore
, ils apparaissent également dans la réponse.
Supprimer un datastore FHIR
Les exemples suivants montrent comment supprimer un datastore FHIR.
Console
Pour supprimer un datastore, procédez comme suit :
- Dans la console Google Cloud, accédez à la page Ensembles de données.
- Sélectionnez l'ensemble de données contenant le datastore que vous souhaitez supprimer.
- Choisissez Supprimer dans la liste déroulante Actions du datastore que vous souhaitez supprimer.
- Pour confirmer, saisissez le nom du datastore, puis cliquez sur Supprimer.
gcloud
Pour supprimer un store FHIR, exécutez la commande gcloud healthcare fhir-stores delete
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
- LOCATION : emplacement de l'ensemble de données
- DATASET_ID : ensemble de données parent du magasin FHIR.
- FHIR_STORE_ID : ID du magasin FHIR.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores delete FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Vous devriez obtenir un résultat semblable à celui-ci :
Deleted fhirStore [FHIR_STORE_ID].
REST
Pour supprimer un magasin FHIR, utilisez la méthode projects.locations.datasets.fhirStores.delete
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- LOCATION : emplacement de l'ensemble de données
- DATASET_ID : ensemble de données parent du magasin FHIR.
- FHIR_STORE_ID : ID du magasin FHIR.
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID"
PowerShell
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
API Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.
Vous devriez recevoir une réponse JSON de ce type :
Go
Java
Node.js
Python
Étape suivante
Découvrez comment créer et utiliser des ressources FHIR.