Cette page a été traduite par l'API Cloud Translation.

Consultez les connecteurs compatibles avec Application Integration.

Déclencheur HL7

Le déclencheur HL7 est un déclencheur d'événement du connecteur qui vous permet d'appeler une intégration en fonction des événements HL7 auxquels vous vous êtes abonné dans votre connexion HL7.

Avant de commencer

Créez un sujet Pub/Sub.
Créez un magasin HL7.
Pour recevoir des messages HL7 via des connexions TCP/IP à l'aide du protocole MLLP (Minimal Lower Layer Protocol), vous devez configurer un adaptateur MLLP. Vous n'avez pas besoin de configurer un adaptateur MLLP si vous recevez des messages HL7 via REST (API Google Cloud HealthCare). Pour exécuter l'adaptateur, procédez comme suit:
1. Définissez le projet et la région dans la gcloud CLI:
```
gcloud config set project PROJECT_ID \
gcloud config set compute/region LOCATION
```
  Pour en savoir plus, consultez la section Définir des propriétés.
2. Créez une instance de VM.
```
   gcloud compute instances create VM_NAME \
       --service-account=SERVICE_ACCOUNT_EMAIL \
       --scopes=https://www.googleapis.com/auth/cloud-platform
   
```
  Remplacez les éléments suivants :
  - SERVICE_ACCOUNT_EMAIL: adresse e-mail du compte de service que vous avez créé.
  - VM_NAME : nom de l'instance de VM.
3. Ajoutez un tag à l'instance de VM nouvellement créée.
```
   gcloud compute instances add-tags INSTANCE_NAME \
   --zone ZONE \
   --tags TAGS
   
```
  Remplacez les éléments suivants :
  - INSTANCE_NAME : nom de l'instance de VM.
  - ZONE : zone de l'instance de VM.
  - TAGS: balises à ajouter à l'instance de VM.
4. Ajoutez une règle de pare-feu pour exposer le port sur lequel l'adaptateur MLLP s'exécute.
```
   gcloud compute firewall-rules create FIREWALL_RULE \
   --action=ALLOW \
   --direction=INGRESS \
   --priority=1000 \
   --rules=tcp:PORT\
   --network=default \
   --source-ranges=0.0.0.0/0
```
  Remplacez les éléments suivants :
  - FIREWALL_RULE: nom de la règle de pare-feu.
  - PORT: port sur lequel l'adaptateur MLLP s'exécute.
5. Connectez-vous en SSH à l'instance de VM.
```
   gcloud compute ssh VM_NAME --zone ZONE
 
```
  Remplacez les éléments suivants :
  - VM_NAME : nom de l'instance de VM.
  - ZONE : zone de l'instance de VM.
6. Installez Docker dans la VM à l'aide de la commande suivante:
```
   sudo apt-get update && sudo apt-get install -y docker.io
   
```
7. Démarrez le service Docker en exécutant les commandes suivantes:
```
   sudo systemctl start docker
   sudo systemctl enable docker
   
```
8. Extrayez l'image Docker dans le dépôt de conteneurs.
```
   docker pull gcr.io/cloud-healthcare-containers/mllp-adapter:latest
   
```
9. Exécutez l'adaptateur MLLP sur l'instance de VM.
```
   docker run \
   --network=host \
   -v ~/.config:/root/.config \
   gcr.io/cloud-healthcare-containers/mllp-adapter \
   /usr/mllp_adapter/mllp_adapter \
   --hl7_v2_project_id=PROJECT_ID \
   --hl7_v2_location_id=LOCATION \
   --hl7_v2_dataset_id=DATASET_ID \
   --hl7_v2_store_id=HL7V2_STORE_ID \
   --export_stats=false \
   --receiver_ip=0.0.0.0 \
   --port=PORT \
   --api_addr_prefix=https://healthcare.googleapis.com:443/v1 \
   --logtostderr
 
```
  Remplacez les éléments suivants :
  - PROJECT_ID: ID du projet Google Cloud.
  - LOCATION: emplacement du datastore HL7.
  - DATASET_ID: ID de l'ensemble de données contenant le datastore HL7.
  - HL7V2_STORE_ID: ID du datastore HL7.
  - PORT: port sur lequel l'adaptateur MLLP s'exécute.
10. Exécutez la commande suivante pour vous assurer que le conteneur est en cours d'exécution:
```
   sudo docker ps
   
```
11. Pour vérifier les journaux du conteneur, exécutez la commande suivante:
```
   sudo docker logs CONTAINER_ID
   
```

Rôles requis

Si vous prévoyez de créer ou de configurer une connexion pour le déclencheur HL7, assurez-vous de disposer du rôle IAM suivant dans le projet:

Administrateur des connecteurs (roles/connectors.admin)

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Attribuez les rôles ou autorisations IAM suivants au compte de service que vous souhaitez utiliser pour le déclencheur HL7:

Demandeur Application Integration (roles/integrations.integrationInvoker)
Consommateur de messages HL7v2 Healthcare (roles/healthcare.hl7V2Consumer)
Ingestion de messages HL7v2 Healthcare (roles/healthcare.hl7V2Ingest)
Autorisation (healthcare.hl7V2Stores.update)
Éditeur Pub/Sub (roles/pubsub.editor)

Pour en savoir plus sur l'attribution d'un rôle à un compte de service, consultez la page Gérer l'accès aux comptes de service.

Ajouter le déclencheur HL7

Pour ajouter un déclencheur HL7 à votre intégration, procédez comme suit:

Dans la console Google Cloud, accédez à la page Application Integration.
Accéder à Application Integration
Dans le menu de navigation, cliquez sur Intégrations.
La page Liste des intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.
Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.
Si vous créez une intégration :
1. Saisissez un nom et une description dans le volet Créer une intégration.
2. Sélectionnez une région pour l'intégration.
  Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment dans le volet Récapitulatif de l'intégration de la barre d'outils d'intégration.
  Remarque:L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
4. Cliquez sur Créer.
Cela entraîne son ouverture dans l'éditeur d'intégrations.
Dans la barre de navigation de l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
Cliquez sur l'élément Déclencheur HL7 et placez-le dans l'éditeur d'intégrations.

Pour configurer le déclencheur HL7, vous pouvez utiliser une connexion HL7 existante avec REST (API Cloud Healthcare) comme protocole de destination disponible dans les Integration Connectors, ou créer une connexion HL7 REST(API Google Cloud Healthcare) à l'aide de l'option de création de connexion intégrée.

Configurer un déclencheur HL7 à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur HL7 à l'aide d'une connexion HL7 existante avec REST (API Cloud Healthcare) comme protocole de destination dans Integration Connectors. Le déclencheur HL7 est un déclencheur d'événement de connecteur. Vous ne pouvez donc utiliser qu'une connexion HL7 REST(API Google Cloud Healthcare) avec l'abonnement aux événements activé pour configurer le déclencheur.

Pour savoir comment configurer un déclencheur HL7 à l'aide d'une nouvelle connexion HL7 REST(API Google Cloud Healthcare), consultez Configurer un déclencheur HL7 à l'aide d'une nouvelle connexion HL7 REST(API Google Cloud Healthcare).

Pour configurer un déclencheur HL7 à l'aide d'une connexion HL7 existante avec REST (API Cloud Healthcare) comme protocole de destination, procédez comme suit:

Cliquez sur l'élément Déclencheur HL7 dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
Cliquez sur Configurer un déclencheur.
Fournissez les informations de configuration suivantes sur la page Éditeur de déclencheur d'événement du connecteur :
1. Région:sélectionnez la région de votre connexion HL7 REST(API Google Cloud Healthcare).
2. Connexion:sélectionnez la connexion HL7 REST(API Google Cloud Healthcare) que vous souhaitez utiliser.
  L'Application Integration n'affiche que les connexions HL7 REST(API Google Cloud Healthcare) actives et pour lesquelles un abonnement aux événements est activé.
3. Dans le menu déroulant, sélectionnez Type de contenu du message HL7: texte ou octets.
4. Saisissez le type de message HL7. Par exemple, ADT_A01 ou ADT_02.
Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

Configurer un déclencheur HL7 à l'aide d'une nouvelle connexion

Pour configurer le déclencheur HL7 à l'aide d'une nouvelle connexion HL7 REST(API Google Cloud Healthcare), procédez comme suit:

Cliquez sur l'élément Déclencheur HL7 dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
Cliquez sur Configurer un déclencheur.
Sélectionnez la région pour le déclencheur HL7.
Cliquez sur Connexion, puis sélectionnez l'option Créer une connexion dans le menu déroulant.
Procédez comme suit dans le volet Créer une connexion:
À l'étape Détails de connexion, fournissez les informations suivantes sur la nouvelle connexion HL7 :
1. Version du connecteur:sélectionnez une version disponible du connecteur HL7 dans la liste déroulante.
2. Nom de la connexion:saisissez un nom pour la connexion HL7.
  Remarque:Les noms de connexion doivent répondre aux critères suivants :
  - Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
  - Les lettres doivent être en minuscules.
  - Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
  - Les noms de connexion ne peuvent pas dépasser 49 caractères.
3. (Facultatif) Description : saisissez une description de la connexion.
4. Vous pouvez également activer Cloud Logging, puis sélectionner un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
5. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour la connexion HL7.
6. Activer l'abonnement aux événements:sélectionnez cette option pour activer l'abonnement aux événements pour la connexion HL7.
  Remarque : Ce connecteur n'est pas compatible avec l'option Enable only event subscription.
7. (Facultatif) Saisissez Délai avant expiration de la réception: la valeur SO_TIMEOUT (en millisecondes) est utilisée lorsque vous attendez le début d'une trame. La valeur par défaut est de 15 000 millisecondes.
8. Protocole de destination: sélectionnez le protocole de destination HL7 REST(API Google Cloud Healthcare), puis spécifiez les éléments suivants :
  1. ID du projet: ID du projet Google Cloud dans lequel se trouve le datastore HL7.
  2. Emplacement: emplacement de votre ensemble de données et de votre datastore HL7v2.
  3. ID de l'ensemble de données: ID de l'ensemble de données contenant le datastore HL7v2.
  4. ID du store HL7: ID du store HL7v2 dans lequel vous stockez le message HL7v2.
9. Vous pouvez également configurer les paramètres du nœud de connexion :
  - Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
  - Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.
  Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez la section Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour une meilleure disponibilité) et le nombre maximal sur 50.
10. Vous pouvez également cliquer sur + Ajouter un libellé pour ajouter un libellé à la connexion sous la forme d'une paire clé/valeur.
11. Si vous souhaitez utiliser SSL, sélectionnez Activer SSL. Les détails de la configuration SSL s'affichent.
  1. Sélectionnez un type de truststore. Il peut s'agir de Public, Privé ou Connexion non sécurisée.
  2. Sélectionnez les certificats comme affiché en fonction de votre choix de truststore.
  3. Si vous utilisez mTLS, sélectionnez les certificats du magasin de clés dans la section Magasin de clés.
  4. Si vous le souhaitez, sélectionnez la version TLS.
  5. Saisissez la suite de chiffrement compatible. Saisissez plusieurs suites de chiffrement sous forme de valeurs séparées par des virgules. Pour en savoir plus, consultez la section Suites de chiffrement compatibles.
  Remarque:
  - Tous vos certificats doivent être des certificats X.509 au format PEM (Privacy Enhanced Mail).
  - Vous ne pouvez pas sélectionner directement un certificat lorsque vous configurez SSL. Vous devez stocker tous vos certificats et clés privées en tant que secrets Secret Manager, puis sélectionner le secret requis lors de la configuration SSL.
12. Cliquez sur Suivant.
Ignorez la section Destinations.
Cliquez sur Suivant.
Dans la section Authentification, vous n'avez pas besoin de spécifier d'informations d'authentification, car la connexion HL7 ne nécessite aucune authentification.
Dans la section Détails de l'abonnement à l'événement, configurez les informations associées à l'événement.
- Nom du projet: projet Google Cloud dans lequel réside l'instance Pub/Sub.
- Nom du sujet Pub/Sub: nom du sujet Pub/Sub à associer au datastore HL7v2 auquel les messages de notification seront envoyés.
Vérifiez vos informations de connexion et d'authentification.
Cliquez sur Créer.

Suites de chiffrement compatibles

Version TLS	Suites de chiffrement compatibles
1.2	TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 TLS_DHE_RSA_WITH_AES_128_CBC_SHA TLS_DHE_RSA_WITH_AES_256_CBC_SHA TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
1.3	TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 TLS_AES_128_GCM_SHA256

Version TLS

Suites de chiffrement compatibles

1.2

TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256

1.3

TLS_AES_256_GCM_SHA384
TLS_CHACHA20_POLY1305_SHA256
TLS_AES_128_GCM_SHA256

Sortie du déclencheur

La configuration de l'abonnement aux événements du déclencheur HL7 prend quelques minutes. Vous pouvez consulter l'état de votre abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Le déclencheur HL7 indique l'état d'un abonnement aux événements à l'aide des états suivants:

Creating: indique que le déclencheur s'abonne à l'abonnement aux événements.
Active: indique que le déclencheur est correctement abonné à un abonnement d'événement.
Error: indique qu'un problème est associé à l'abonnement aux événements configuré.

En plus de l'état de l'abonnement aux événements, la section Détails de l'abonnement aux événements affiche également d'autres informations, telles que la région de la connexion, le nom de la connexion et le nom de l'abonnement aux événements.

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur HL7 génère une variable de sortie ConnectorEventPayload (au format JSON) que vous pouvez utiliser dans vos tâches en aval. La variable de sortie contiendra la charge utile de votre événement HL7. Exemple :

 {
 "messageType": "ADT_A01",
 "message": "MSH|^~\\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|20240209120000||ADT^A01|123456789|P|2.3|||NE|AL|||||\rEVN|A02222221|20240209120000|||\rPID|1||123456789|^^^Hospital^MR||Doe^John^^^Mr.||19800101|M|||123 Main St^^New York^NY^10001^USA||(555)555-1234|(555)555-1235\rPV1|1|I|2000^2012^01||||123^Doe^John|||SUR||||ADM|A0||\r",
 "contentType": "text/plain"
}

Afficher les abonnements aux événements

Pour afficher et gérer tous les abonnements aux événements associés à une connexion dans Integration Connectors, procédez comme suit:

Accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions).
Accéder à la page "Connexions"
Cliquez sur la connexion pour laquelle vous souhaitez afficher les abonnements.
Cliquez sur l'onglet Abonnements aux événements.
Tous les abonnements d'événements de la connexion s'affichent.

Modifier le déclencheur HL7

Vous pouvez modifier un déclencheur HL7 pour modifier ou mettre à jour la configuration de la connexion et les informations d'abonnement aux événements.

Pour modifier un déclencheur HL7, procédez comme suit:

Cliquez sur l'élément Déclencheur HL7 dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
Cliquez sur Configurer le déclencheur HL7.
Procédez comme suit sur la page Éditeur du déclencheur d'événement du connecteur :
1. Pour conserver l'abonnement aux événements précédemment configuré, cliquez sur Conserver. Sinon, cliquez sur Supprimer.
  Avertissement:La suppression d'un abonnement à des événements affectera toutes les intégrations publiées qui l'utilisent. Cette tâche est irréversible.
2. Mettez à jour la configuration de la connexion et les détails de l'abonnement aux événements si nécessaire.
3. Cliquez sur OK.

Vous pouvez consulter les informations de connexion et d'abonnement aux événements mises à jour dans le volet de configuration du déclencheur sous Détails de l'abonnement aux événements.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante

Découvrez toutes les tâches et tous les déclencheurs.
Découvrez comment tester et publier une intégration .

En savoir plus sur la gestion des erreurs
Découvrez les journaux d'exécution d'intégration.