Guide de démarrage rapide sur l'utilisation de Cloud Console

Cette page explique comment utiliser l'API Cloud Healthcare avec Google Cloud Console pour effectuer les tâches suivantes:

  1. Créez un ensemble de données pour l'API Cloud Healthcare.
  2. Créez l'un des datastores suivants dans l'ensemble de données :
    • Magasin DICOM (Digital Imaging and Communications in Medicine)
    • Magasin FHIR (Fast Healthcare Interoperability Resources)
    • Magasin HL7v2 Health Level Seven International
  3. Stockez et inspectez un type particulier de données médicales dans le magasin DICOM ou FHIR.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez Cloud Healthcare API.

    Activer l'API

Créer un ensemble de données

Les ensembles de données contiennent des données médicales dans Google Cloud. Pour utiliser l'API Cloud Healthcare, vous devez créer au moins un ensemble de données.

Pour créer un ensemble de données, procédez comme suit:

  1. Dans Cloud Console, accédez à la page Ensembles de données.

    Accéder à la page Ensembles de données

  2. Cliquez sur Créer un ensemble de données.
  3. Dans le champ Nom, saisissez un identifiant pour l'ensemble de données. L'ID de l'ensemble de données doit comporter l'un des éléments suivants :
    • Un identifiant unique au lieu
    • Chaîne Unicode de 1 à 256 caractères composée des éléments suivants :
      • Numéros
      • Lettres
      • Traits de soulignement
      • Tirets
      • Points
  4. Dans le champ Region (Région), saisissez ou sélectionnez l'emplacement définitivement de l'ensemble de données, puis cliquez sur Create (Créer).

Le nouvel ensemble de données apparaît dans la liste des ensembles de données.

Pour suivre ce guide de démarrage rapide, choisissez l'une des sections suivantes:

Stocker et afficher des instances DICOM

Cette section explique comment effectuer les tâches suivantes:

  1. Créer un magasin DICOM.
  2. Importer une instance DICOM depuis Cloud Storage dans le magasin DICOM.

L'API Cloud Healthcare met en œuvre la norme DICOMweb pour stocker des données d'imagerie médicale et y accéder. Cloud Console n'est pas compatible avec les transactions DICOMweb, telles que l'affichage ou la récupération d'instances.

Créer un magasin DICOM

  1. Les magasins DICOM existent dans des ensembles de données et contiennent des instances DICOM. Pour créer un magasin DICOM, procédez comme suit:

    1. Dans Cloud Console, accédez à la page Ensembles de données.

      Accéder à la page Ensembles de données

    2. Ouvrez l'ensemble de données dans lequel vous souhaitez créer le magasin DICOM.

    3. Cliquez sur Créer un datastore. La page Créer un datastore s'affiche.

    4. Dans le menu Type, sélectionnez DICOM.

    5. Dans le champ ID, saisissez un identifiant pour le magasin DICOM. L'ID de magasin DICOM doit comporter les éléments suivants:

      • Identifiant unique dans l'ensemble de données parent
      • Chaîne Unicode de 1 à 256 caractères composée des éléments suivants :
        • Numéros
        • Lettres
        • Traits de soulignement
        • Tirets
        • Points
    6. Cliquez sur Create (Créer).

    Le nouveau magasin DICOM apparaît dans la liste des magasins de données de l'ensemble de données.

Importer une instance DICOM

  1. Des exemples de données DICOM sont disponibles dans le bucket Cloud Storage gs://gcs-public-data--healthcare-nih-chest-xray. Pour importer une instance DICOM du bucket vers votre magasin DICOM, procédez comme suit:

    1. Dans la liste des datastores de votre ensemble de données, recherchez le magasin DICOM que vous avez créé, puis sélectionnez le menu Actions.
    2. Dans la liste déroulante Actions, sélectionnez Importer.
    3. Sur la page Importer dans le datastore DICOM, sélectionnez le menu Options avancées, puis Remplacer le chemin d'accès à Cloud Storage.
    4. Dans le champ Emplacement du menu Options avancées, saisissez l'emplacement suivant de l'instance DICOM que vous importez:

      gs://gcs-public-data--healthcare-nih-chest-xray/dicom/00000001_000.dcm
      
    5. Cliquez sur Import (Importer).

    6. Pour suivre l'état de l'importation, cliquez sur l'onglet Opérations, puis sur l'ID de l'opération.

      Si des erreurs se produisent, cliquez sur Actions, puis sur Afficher les détails dans Cloud Logging.

Maintenant que vous avez stocké une instance DICOM dans l'API Cloud Healthcare, passez à la section Étapes suivantes pour plus d'informations sur les étapes suivantes, par exemple pour rechercher ou récupérer des images DICOM.

Stocker et afficher des ressources FHIR

Cette section explique comment effectuer les tâches suivantes:

  1. Créez un magasin FHIR.
  2. importer une ressource FHIR dans Cloud Storage dans le magasin FHIR ;
  3. Affichez des informations sur la ressource à l'aide du lecteur FHIR.

L'API Cloud Healthcare met en œuvre la spécification FHIR pour stocker des données FHIR et y accéder. Cloud Console n'accepte pas certaines méthodes de l'API FHIR, telles que la création ou la suppression de ressources FHIR, mais vous pouvez utiliser le lecteur FHIR pour afficher le contenu des ressources FHIR.

Créer un magasin FHIR

  1. Les magasins FHIR existent dans des ensembles de données et contiennent des ressources FHIR. Pour créer un magasin FHIR, procédez comme suit:

    1. Dans Cloud Console, accédez à la page Ensembles de données.

      Accéder à la page Ensembles de données

    2. Ouvrez l'ensemble de données dans lequel vous souhaitez créer le magasin FHIR.

    3. Cliquez sur Créer un datastore. La page Créer un datastore s'affiche.

    4. Dans le menu Type, sélectionnez FHIR.

    5. Dans le champ ID, saisissez un identifiant pour le magasin FHIR. L'ID de magasin FHIR doit comporter les éléments suivants:

      • Identifiant unique dans l'ensemble de données parent
      • Chaîne Unicode de 1 à 256 caractères composée des éléments suivants :
        • Numéros
        • Lettres
        • Traits de soulignement
        • Tirets
        • Points
    6. Dans la section Configuration du magasin FHIR, sélectionnez R4.

    7. Cliquez sur Create (Créer).

    Le nouveau magasin FHIR apparaît dans la liste des datastores de l'ensemble de données.

Importer des ressources FHIR

  1. Des exemples de données FHIR sont disponibles dans le bucket Cloud Storage gs://gcp-public-data--synthea-fhir-data-10-patients. Le bucket contient un répertoire, fhir_r4_ndjson/, qui contient plusieurs types de ressources FHIR. Pour importer les ressources FHIR du bucket dans votre magasin FHIR, procédez comme suit:

    1. Dans la liste des datastores de votre ensemble de données, recherchez le magasin FHIR que vous avez créé, puis sélectionnez le menu Actions.
    2. Dans la liste déroulante Actions, sélectionnez Importer.
    3. Sur la page Importer dans un magasin FHIR, sélectionnez le menu Options avancées, puis Remplacer le chemin d'accès à Cloud Storage.
    4. Dans le champ Emplacement du menu Options avancées, saisissez l'emplacement suivant des ressources FHIR que vous importez:

      gs://gcp-public-data--synthea-fhir-data-10-patients/fhir_r4_ndjson/*.ndjson
      
    5. Dans la section Paramètres d'importation FHIR, sélectionnez Ressource.

    6. Cliquez sur Import (Importer).

    7. Pour suivre l'état de l'importation, cliquez sur l'onglet Opérations, puis sur l'ID de l'opération.

      Si des erreurs se produisent, cliquez sur Actions, puis sur Afficher les détails dans Cloud Logging.

Afficher le contenu des ressources FHIR

Pour afficher le contenu des ressources patient que vous avez importées à partir du bucket Cloud Storage, procédez comme suit:

  1. Dans Cloud Console, accédez à la page Lecteur FHIR.

    Accéder à la visionneuse FHIR

  2. Dans la liste déroulante FHIR Store, sélectionnez l'ensemble de données contenant votre magasin FHIR, puis le magasin FHIR.

  3. Cliquez sur le champ Resource Type (Type de ressource). Dans la liste déroulante Propriétés qui s'affiche, sélectionnez Type de ressource, puis saisissez Patient.

  4. Cliquez sur Patient dans la liste Resource Type (Type de ressource).

  5. Sélectionnez l'une des ressources Patient qui s'affichent. Pour afficher plus d'informations sur le patient, cliquez sur l'onglet Éléments ou sur l'onglet JSON pour afficher les détails du patient au format JSON.

Maintenant que vous avez stocké et affiché une ressource FHIR dans l'API Cloud Healthcare, passez à la section Étapes suivantes pour plus d'informations sur les étapes suivantes.

Créer un magasin HL7v2

Cette section explique comment créer un magasin HL7v2. La mise en œuvre de HL7v2 de l'API Cloud Healthcare dans Cloud Console n'est actuellement pas compatible avec les messages HL7v2. Après avoir créé le magasin HL7v2, passez à la section Créer et gérer des messages HL7v2 pour créer ou ingérer des messages HL7v2.

La mise en œuvre de HL7v2 dans l'API Cloud Healthcare est conforme à la norme HL7v2.

Les magasins HL7v2 existent dans des ensembles de données et contiennent des messages HL7v2. Pour créer un magasin HL7v2, procédez comme suit:

  1. Dans Cloud Console, accédez à la page Ensembles de données.

    Accéder à la page Ensembles de données

  2. Ouvrez l'ensemble de données dans lequel vous souhaitez créer le magasin HL7v2.

  3. Cliquez sur Créer un datastore. La page Créer un datastore s'affiche.

  4. Dans le menu Type, sélectionnez HL7v2.

  5. Dans le champ ID, saisissez un identifiant pour le magasin HL7v2. L'ID de magasin HL7v2 doit comporter les éléments suivants:

    • Identifiant unique dans l'ensemble de données parent
    • Chaîne Unicode de 1 à 256 caractères composée des éléments suivants :
      • Numéros
      • Lettres
      • Traits de soulignement
      • Tirets
      • Points
  6. Cliquez sur Create (Créer).

Le nouveau magasin HL7v2 apparaît dans la liste des datastores de l'ensemble de données.

Maintenant que vous avez créé un magasin HL7v2, passez à la section Étapes suivantes pour obtenir des informations sur les étapes suivantes, telles que l'ingestion et l'affichage des messages HL7v2.

Nettoyer

Pour éviter que les ressources utilisées dans ce tutoriel soient facturées sur votre compte Google Cloud, vous pouvez nettoyer les ressources créées sur Google Cloud. Si vous avez créé un projet pour ce tutoriel, suivez les étapes décrites dans la section Supprimer le projet. Sinon, suivez les étapes décrites dans la section Supprimer l'ensemble de données et le datastore.

Supprimer le projet

  1. Dans Cloud Console, accédez à la page Gérer les ressources.

    Accéder à la page Gérer les ressources

  2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
  3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Supprimer l'ensemble de données et le datastore

Si vous n'avez plus besoin de l'ensemble de données et du datastore créés dans ce guide de démarrage rapide, vous pouvez supprimer l'ensemble de données. La suppression d'un ensemble de données entraîne la suppression définitive de l'ensemble de données et des datastores FHIR, HL7v2 ou DICOM qu'il contient.

Pour supprimer un ensemble de données, procédez comme suit.

  1. Dans Cloud Console, accédez à la page Ensembles de données.

    Accéder à la page Ensembles de données

  2. Sélectionnez l'ensemble de données à supprimer.
  3. Cliquez sur Supprimer, saisissez l'identifiant de l'ensemble de données à confirmer, puis cliquez sur Supprimer.

Comment ça s'est passé ?

Étape suivante

Consultez les pages suivantes pour obtenir des informations générales sur l'API Cloud Healthcare et sur l'outil de ligne de commande gcloud pour effectuer des tâches:

DICOM

Accédez au guide DICOM pour consulter les articles suivants:

Consultez la instruction de conformité DICOM pour en savoir plus sur la manière dont l'API Cloud Healthcare met en œuvre la norme DICOMweb.

FHIR

Accédez au guide FHIR pour passer en revue les rubriques suivantes:

Consultez la Déclaration de conformité FHIR pour en savoir plus sur la manière dont l'API Cloud Healthcare met en œuvre la norme FHIR.

HL7v2

Passez au guide HL7v2 pour passer en revue les rubriques suivantes: