Interfaces DPPR / SIH - Boîte Noire DPPR

Transcription

1 Interfaces DPPR / SIH - Boîte Noire DPPR DPPR/SPF_002 / 3.4 Client Entité Projet : GIP RESEAU ONCORA : SWORD/SWL : DPPR Id Projet : DPPR Date (1) : 21 décembre 2005 Etat : à valider validé Diffusion : interne contrôlée libre contrôlée (1) Date d approbation (cf. circuit de validation interne).

2 CIRCUIT DE VALIDATION Version Rédaction Vérification Approbation NOM DATE VISA NOM DATE VISA NOM DATE VISA 1.0 David Grospelier 01/07/04 David Grospelier 04/07/04 David Grospelier 04/07/ David Grospelier 15/02/05 David Grospelier 15/02/05 David Grospelier 15/02/ David Grospelier 08/03/05 David Grospelier 09/03/05 David Grospelier 09/03/ David Grospelier 11/03/05 David Grospelier 11/03/05 David Grospelier 11/03/ David Grospelier 14/03/05 David Grospelier 14/03/05 David Grospelier 14/03/ David Grospelier 21/06/05 David Grospelier 21/06/05 David Grospelier 21/06/ David Grospelier 21/12/ HISTORIQUE DES EVOLUTIONS Version Objet de la version (citer les fiches de réception de document prises en compte) 1.0 Initialisation du document 2.6 Evolutions DPPR V Boîte noire DPPR v2 3.1 Prise en compte des remarques ONCORA du 11/03/ Prise en compte des remarques ONCORA du 14/03/ Ajout d un sur les types mimes pour le service Web, ajout de précisions sur le message d invalidation des pièces 3.4 Utilisation du numéro Adéli pour les auteurs de pièces LISTE DE DIFFUSION Destinataire Fonction Nombre d'exemplaires Support Hervé Spacagna GIP ONCORA 1 Fichier Word Thierry Durand GIP ONCORA 1 Fichier Word Intégrateurs SIH Intégrateurs SIH N Fichier Word SWORD - Nos réf. : DPPR/SPF_002 / 3.4 Diffusion : contrôlée Page : i

3 DOCUMENTS REFERENCES Origine N Titre Référence Usage (*) (*) : indiquer le contexte de citation du document : à lire au préalable, documents de référence, documents complémentaires,... SWORD - Nos réf. : DPPR/SPF_002 / 3.4 Diffusion : contrôlée Page : ii

4 SOMMAIRE 1. INTRODUCTION PRESENTATION DU CONTEXTE TERMINOLOGIE UTILISEE PRINCIPES GENERAUX DES INTERFACES ASYNCHRONES SCHEMA DE PRINCIPE FONCTIONNEL GENERAL : COMMUNICATIONS SIH / BOITE NOIRE DPPR SCHEMA DE PRINCIPES TECHNIQUES GENERAUX DE LA BOITE NOIRE MECANISMES DE COMMUNICATION ENTRE LE SIH ET LA BOITE NOIRE DPPR CINEMATIQUE DE COMMUNICATION SEQUENCE 1 : PRODUCTION D UN FICHIER XML ET ENVOI A LA BOITE NOIRE Echange de fichier Envoi en FTP Envoi MSMQ SEQUENCE 2 : RECEPTION DU MESSAGE PAR LA BOITE NOIRE Scrutation / réception Vérification de l émetteur et du destinataire Vérification de la conformité du message XML Traitement du message Cas des messages non lisibles par la Boite Noire SEQUENCE 3 : ENVOI AU DPPR Principes Préparation du message d envoi Erreur technique Réponse du DPPR SEQUENCE 4 : TRAITEMENT DU MESSAGE PAR LE DPPR SEQUENCE 5 : RECEPTION DE L ACQUITTEMENT DPPR PAR LA BOITE NOIRE SEQUENCE 6 : PRODUCTION DES ACQUITTEMENTS PAR LA BOITE NOIRE SEQUENCE 7 : RECUPERATION DES ACQUITTEMENTS PAR LE SIH Récupération des acquittements par le SIH Particularités MSMQ Notification par messagerie pour les acquittements GESTION DES ETABLISSEMENTS DE LA BOITE NOIRE Table des établissements Administration des établissements Données de configuration globales LES DIFFERENTS REPERTOIRES DE LA BOITE NOIRE Liste des répertoires de la boîte noire Purge des répertoires de la boîte noire Les différentes files d attentes de la boîte noire Conventions de nommage des fichiers en entrée JOURNALISATION DES EVENEMENTS NOTIFICATION PAR MESSAGERIE SEQUENCEMENT DES MESSAGES PARTICULARITE DES ENVOIS DE FLUX RELATIFS AUX PIECES DE DOSSIERS PRESENTATION Mode sans duplication Mode avec duplication GESTION DES TACHES PAR LA BOITE NOIRE REGLES A METTRE EN ŒUVRE SUR LES DISPOSITIFS DE SECURITE LES DIFFERENTS TYPES DE MESSAGES RECAPITULATIF DES MESSAGES CONSTITUTION DES MESSAGES XML SWORD - Nos réf. : DPPR/SPF_002 / 3.4 Diffusion : contrôlée Page : iii

5 5.3 ACQUITTEMENT ATTENDU ENTETES DE MESSAGE XML Description Exemple d un message du SIH vers la BN CARACTERES SPECIAUX «<» ET «>» DONNEES DES PATIENTS Identifiants d un patient MESSAGES D ACQUITTEMENTS RECUS MESSAGES PATIENT Création d un dossier au DPPR Activation / Désactivation d un dossier DPPR pour le SIH demandeur Suppression d un dossier au DPPR (pour tous les SIH) Cas des activations et désactivations par le STIC Fusion centrale STIC Défusion centrale STIC Fusion locale STIC Défusion locale STIC MESSAGES MEDICAUX Ajout d une pièce à un dossier (mode sans duplication) Ajout d une pièce à un dossier (mode avec duplication) Modification d une pièce dans un dossier (mode sans duplication) Modification d une pièce dans un dossier (mode avec duplication) Données évolutives Invalidation d une pièce d un dossier Gestion des équipes INSCRIPTION D UN PROFESSIONNEL DE SANTE AU DPPR FLUX SYNCHRONES ENTRE BN ET SIH PRESENTATION CINEMATIQUE LES SERVICES WEB FONCTIONNEMENT DETAILLE DANS LE PROJET DPPR Présentation Paramètres entrée du service Web Paramètres de sortie du service Web CONTRAINTES DE SYNCHRONISATION DES HEURES ANNEXES CODES ERREURS CODES AVERTISSEMENTS CODES INFORMATIONS PARAMETRES DE LA BOITE NOIRE Les paramètres applicatifs Les paramètres systèmes Particularité des mots de passe SAUVEGARDE DE LA BOITE NOIRE Sauvegarde complète de la base de données Sauvegarde des logs de la base de données ANTIVIRUS PARE-FEU DE LA BOITE NOIRE MISE A JOUR DE LA BOITE NOIRE SERVEUR DE MESSAGERIE CODIFICATION DES TYPES DE PIECES DU DPPR CODIFICATION DES PATHOLOGIES DU DPPR IDENTIFIANT DESTINATAIRE DPPR CONVENTIONS DE NOMMAGE DES PROFESSIONNELS DE SANTE Utiliser le numéro Adéli Utiliser le nom usuel o O o - SWORD - Nos réf. : DPPR/SPF_002 / 3.4 Diffusion : contrôlée Page : iv

6 1. INTRODUCTION 1.1 PRESENTATION DU CONTEXTE Ce document spécifie les modalités d échanges entre les SIH et le DPPR ainsi que la boîte noire DPPR. L objectif du document est à la fois de présenter les concepts généraux relatifs aux échanges mais également d identifier les différents formalismes d échanges (grammaire d échange), les mécanismes de communications mis en œuvre et les fonctionnalités prises en charge par la boîte noire DPPR. Les mécanismes de la boîte noire DPPR présentés dans le présent document, sont implémentés dans le contexte du projet DPPR. Les SIH n ont pas à développer ces mécanismes, ils sont fournis en standard dans la boîte noire. Seul l interfaçage entre le SIH et la boîte noire DPPR est à la charge de chaque SIH. Nous utiliserons le terme «Boîte noire» pour identifier le dispositif informatique que chaque SIH doit posséder pour s interfacer avec le DPPR. 1.2 TERMINOLOGIE UTILISEE BN SIH DPPR Acronyme / Terme Description Boîte noire DPPR Système d information hospitalier Plate forme centrale du DPPR SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 1/89

7 2. PRINCIPES GENERAUX DES INTERFACES ASYNCHRONES 2.1 SCHEMA DE PRINCIPE FONCTIONNEL GENERAL : COMMUNICATIONS SIH / BOITE NOIRE DPPR SIH Mécanismes de production XML Mécanismes d envoi XML à la BN DPPR Mécanismes de scrutation de messages XML de la BN Boîte Noire DPPR Mécanismes de scrutation des flux XML en provenance des SIH Mécanismes d envoi de flux XML vers les SIH Mécanismes de vérification des messages, traitements des messages, journalisation Mécanismes d envoi de flux XML vers le DPPR Mécanismes de réception de flux XML en provenance du DPPR DPPR Mécanismes de réception de flux XML en provenance des SIH Mécanismes d envoi de flux XML vers les SIH Traitements métiers DPPR SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 1/89

8 2.2 SCHEMA DE PRINCIPES TECHNIQUES GENERAUX DE LA BOITE NOIRE SIH Répertoire de dépôt Boîte Noire DPPR Copie de fichier Scrutation Répertoire de travail MSMQ : BN Envoi FTP du fichier Traitement du message Envoi du message au DPPR MSMQ : DPPR Scrutation de la file d attente Site FTP de dépôt MSMQ : BN Acquittements (Informations, avertissements ou erreurs) Réception acquittement MSMQ : BN Succès Erreur Scrutation (et récupération du fichier d acquittement) Répertoire de sortie Scrutation (et récupération du fichier d acquittement) Répertoire des messages traités Répertoire des messages en erreur Site FTP de sortie SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 2/89

9 3. MECANISMES DE COMMUNICATION ENTRE LE SIH ET LA BOITE NOIRE DPPR 3.1 CINEMATIQUE DE COMMUNICATION La cinématique de communication entre les trois acteurs est la suivante : Séquence Sens Description 1 SIH -> BN Le SIH produit un flux XML conforme à la grammaire DPPR et l envoi à la boîte noire DPPR (soit en FTP, soit en dépôt de fichier soit en MSMQ) 2 BN La boîte noire DPPR scrute le répertoire de dépôt, récupère le flux XML, le vérifie et le traite. 3 BN -> DPPR La boîte noire DPPR transmet le flux au DPPR. 4 DPPR Le DPPR réceptionne le flux et le traite. 5 DPPR -> BN Le DPPR envoi à la boîte noire le résultat du traitement (l acquittement) 6 BN La boîte noire réceptionne le résultat et l interprète. 7 BN La boîte noire dépose le fichier d acquittement dans un répertoire ou dans une file d attente MSMQ (selon la configuration) 8 SIH -> BN Le SIH scrute le répertoire ou la file d attente pour récupérer les fichiers d acquittement. 3.2 SEQUENCE 1 : PRODUCTION D UN FICHIER XML ET ENVOI A LA BOITE NOIRE Le SIH doit produire un fichier XML (selon la grammaire du DPPR associée au type de traitement souhaité). Le fichier envoyé (fichier en entrée) doit impérativement être suffixé par «xml». (ex : creationpatient123.xml). Le nom du fichier envoyé doit être unique. Dans le cas d un envoi MSMQ, le titre du message MSMQ (ou label) doit être unique. Afin d éviter toute perte de fichiers, la boîte noire DPPR renomme chaque fichier en entrée de la manière suivante : <NomDuFichierOriginel>_<GUID>.xml ou le champ <GUID> est un numéro unique. L unicité de cet identifiant est garantie par l utilisation d une API du système d exploitation Windows. Contrairement à des identifiants basés sur de l horodatage, la génération d un GUID utilise de nombreux autres paramètres pour assurer l unicité. Le fichier XML peut être envoyé à la boîte noire de trois manières : - Soit par l utilisation d échanges de fichiers (dépôt de fichier dans un répertoire de la boîte noire) ; - Soit par l utilisation du protocole FTP ; - Soit par l utilisation d une file d attente MSMQ (uniquement pour certains types de messages). SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 1/89

10 3.2.1 Echange de fichier Le SIH peut choisir le mode «échange de fichiers» pour dialoguer avec la boîte noire. Dans ce cas, le SIH doit déposer ses messages dans le répertoire «SIH2BNDPPR» de la boîte noire. Ce répertoire est un répertoire partagé. Le nom du fichier déposé dans le répertoire doit être unique, pour éviter d écraser un fichier existant déjà dans ce répertoire. Si une erreur se produit lors du dépôt du fichier (accès refusé, place disque insuffisante, fichier de même nom existant dans le répertoire, ), la boîte noire n est pas en mesure de détecter l erreur. Le SIH doit donc prévoir dans son développement un mécanisme de gestion de ce type d erreur. Après interprétation de l erreur et correction éventuelle, le SIH peut réitérer le dépôt du fichier. A ce jour, le volume de chaque fichier n est pas limité par la boîte noire. Aucun paramètre de la boîte noire n interdit le dépôt de fichiers de grande taille Envoi en FTP Le SIH peut envoyer le fichier en utilisant le protocole FTP. Pour cela, il doit utiliser un client FTP et se connecter au site ftp de la boîte noire. La connexion est effectuée avec les paramètres suivants : Paramètre Nom d hôte Utilisateur Mot de passe Répertoire de dépôt FTP Valeur Adresse IP de la boîte noire du SIH <déterminé par l administrateur de la boîte noire> <déterminé par l administrateur de la boîte noire> sih2bndppr Le nom d utilisateur et le mot de passe d accès au FTP peuvent être modifiés par l administrateur de la boîte noire. Après installation, l accès à l alias FTP est anonyme. Le processus d envoi d un fichier FTP se déroule comme suit : - Connexion au site Ftp (fonction open) ; - Authentification auprès du site Ftp (fonction user); - Accès au répertoire sih2bndppr (fonction cd); - Envoi du fichier (utilisation de la fonction put) ; - Déconnexion (fonction disconnect) ; - Fermeture de la session FTP (fonction bye). Voici un exemple de code (en utilisant le client ftp Microsoft) pour envoyer un fichier nommé creationpatient123.xml à la boîte noire d adresse IP en utilisant le compte ftpbndppr. /** connexion au site FTP de la boîte noire **/ ftp n /** authentification **/ user ftpbndppr ftpbndppr /** accès au répertoire **/ cd sih2bndppr /** envoi du fichier **/ put creationpatient123.xml /** déconnexion **/ disconnect /** fermeture de la session Ftp **/ SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 2/89

11 bye Des erreurs peuvent se produire lors de l envoi du fichier en FTP. Lors de chaque exécution d une commande FTP, le serveur FTP de la boîte noire va retourner un code qui informe le SIH du déroulement de l exécution de la commande. Les codes retournés sont conformes au standard FTP et sont constitués de trois chiffres (xyz). La signification des codes est la suivante. Code FTP Code commençant par 1 Code commençant par 2 Code commençant par 3 Code commençant par 4 Code commençant par 5 Description Réponse préliminaire envoyée par le serveur. Indique que la commande est en cours d exécution. Commande positive de réalisation. Indique le succès de l exécution de la commande. Réponse positive intermédiaire. La commande déclenchée a été exécutée avec succès mais des informations complémentaires doivent être fournies par l utilisateur. Ne devrait pas être rencontré dans le contexte du DPPR. Erreur d exécution. Lié à un problème temporaire. Le client doit réitérer la demande plus tard Erreur d exécution. Problème permanent. La liste des codes erreurs FTP est disponible à l adresse suivante : Le SIH doit interpréter les différents codes erreurs et réitérer éventuellement certaines requêtes en cas d erreur. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 3/89

12 3.2.3 Envoi MSMQ Le SIH peut utiliser une file d attente MSMQ pour envoyer les messages à la boîte noire. La file d attente se nomme «sih2bndppr». Le SIH doit utiliser une API MSMQ pour écrire dans la file d attente. Notons que l utilisation d un envoi MSMQ est possible pour tout les types de messages sauf les créations/modification de pièces avec duplication. Les éléments suivants doivent être respectés pour que l envoi MSMQ fonctionne : - Le SIH doit impérativement utiliser un envoi transactionnel. Ce mode d envoi garanti en effet à la fois la non duplication des messages (le même message envoyé plusieurs fois par erreur ne sera réceptionné qu une seule fois par la boîte noire) et la persistance des messages sur la boîte noire après redémarrage du service MSMQ (évite la perte de message) ; - Le SIH doit utiliser un formatter Binaire pour l envoi du message et non un formatter XML ; - Le titre du message (label du message MSMQ) doit être fixé avec attention par le SIH. Ce titre va en effet ensuite identifier le message pendant tout le cycle de traitement. Le titre doit être unique. Voici un exemple de code (C#) permettant l envoi d un fichier dans une file d attente MSMQ : // Déclaration de la transaction MessageQueueTransaction mqtx = new MessageQueueTransaction(); try { MessageQueue _mq = new MessageQueue(@"FormatName:DIRECT=OS:boitenoire\private$\bndppr2sih"); // Création d'un formatter binaire BinaryMessageFormatter _fmt = new BinaryMessageFormatter(); // Affectation du formatter à la queue _mq.formatter = _fmt; } // on crée un message msmq à partir des données Message _msg = new Message(); _msg.label = "Titre du message"; _msg.body = "Corps du message" ; // Le corps du message est le flux XML // Ouverture de la transaction d écriture mqtx.begin(); // Envoi du message _mq.send(_msg, mqtx); // Validation de la transaction mqtx.commit(); // Fermeture de la file d attente if (_mq=null) _mq.close(); SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 4/89

13 3.3 SEQUENCE 2 : RECEPTION DU MESSAGE PAR LA BOITE NOIRE Scrutation / réception Quel que soit le mode d échange employé par le SIH (dépôt d un fichier, utilisation du protocole FTP ou envoi via MSMQ), le fichier déposé par le SIH est stocké dans le répertoire sih2bndppr. Dans le mode d envoi MSMQ, le message déposé dans la file d attente par le SIH est automatiquement enregistré dans un fichier XML dans le répertoire sih2bndppr. Le fichier porte le nom du label du message MSMQ. Un service Windows, installé sur la boîte noire, est déclenché dès qu un fichier «*.xml» est déposé dans le répertoire sih2bndppr. Les deux premières actions du service de réception de la boîte noire sont : Le renommage du fichier réceptionné : le fichier est renommé <NomFichierOriginel>_<GUID>.xml afin de le rendre unique sans toutefois perdre le nom donné à l origine par le SIH ; Le déplacement du fichier réceptionné dans le répertoire travail_bndppr. Ainsi, le répertoire sih2bndppr ne contient donc que les fichiers qui ne sont pas encore réceptionnés par la boîte noire. Notez que le service Windows de scrutation peut être désactivé manuellement par l administrateur de la boîte noire. La désactivation du service Windows désactive la scrutation du répertoire. Les fichiers déposés par le SIH ne seront donc pas traités. Si des fichiers sont déposés dans le répertoire sih2bndppr alors que le service de scrutation n est pas lancé ils seront traités dès le redémarrage du service. Le service Windows de scrutation vérifie dès son démarrage que la boîte noire est configurée correctement. Les vérifications effectuées sont les suivantes : Vérification qu un répertoire racine de travail est présent dans le fichier de configuration. Le répertoire racine indique notamment au service de scrutation quel est le répertoire à scruter ; Vérification qu au moins un établissement est configuré dans la boîte noire ; Vérification que les paramètres de connexion à la base de données sont renseignés. Si l un des trois éléments n est pas correct, une entrée est écrite dans le journal des erreurs et le service ne démarre pas. L administrateur de la boîte noire doit effectuer la configuration nécessaire pour que le service puisse démarrer. Au lancement et à l arrêt du service de scrutation, un événement est journalisé dans le journal de la boîte noire. Un événement indique le lancement du service, un autre l arrêt du service ainsi que le chemin complet du répertoire écouté. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 5/89

14 3.3.2 Vérification de l émetteur et du destinataire Dans chaque message XML échangé entre le SIH et la BN se trouve l identifiant de l émetteur et du destinataire (contenu dans l entête du message de type entetemessage HPRIM). Dans le cas d un message entrant (du SIH vers le DPPR), l émetteur est le SIH et le destinataire est le DPPR. C est exactement l inverse dans le cas d un message de retour Vérification du code émetteur La boîte noire DPPR v2 peut être associée à plusieurs établissements contrairement à la boîte noire DPPR v1 qui ne peut être associée qu à un seul établissement. La boîte noire contient une liste des établissements (Cf. Erreur Source du renvoi introuvable.) avec laquelle le code émetteur du message XML va être vérifié. Les deux scénarios suivants peuvent donc se produire Code émetteur conforme Le code émetteur du message correspond à un établissement déclaré dans la boîte noire. Le message est accepté et poursuit le traitement Code émetteur non-conforme Le code émetteur du message ne correspond pas à un établissement déclaré dans la boîte noire. Dans ce cas un acquittement «erreur» est envoyé au SIH avec le code ERR501. L acquittement et le message correspondant sont décrits dans le tableau ci-dessous. Code erreur ERR501 Message d erreur L émetteur du message n est pas conforme avec l un des établissements configurés dans la boîte noire. Identifiant du message = <idmessage>, fichier = <fichiermessage>, émetteur envoyé = <idemetteurmessage>, émetteur attendu = <idemetteurattendu> Vérification du code destinataire La boîte noire vérifie la conformité entre l identifiant du destinataire du message et l identifiant du DPPR. L identifiant du DPPR est configuré dans la boîte noire (fichier de configuration de la boîte noire). Si le message n est pas destiné au DPPR, il est rejeté. Notez qu une boîte noire correspond à un seul identifiant destinataire. Le message d erreur suivant est envoyé au SIH (reportez vous au paragraphe 3.5 pour de plus amples renseignements concernant les mécanismes d envoi d erreurs). Code erreur Message d erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté. Identifiant du message = <idmessage>, fichier = <fichiermessage>, destinataire envoyé = <iddestinatairemessage>, destinataire attendu = <identifiantdppr> SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 6/89

15 3.3.3 Vérification de la conformité du message XML Un message est considéré comme conforme s il respecte à la fois la norme XML et la grammaire du DPPR. Si un message n est pas conforme, le message est déplacé dans le répertoire «erreur_bndppr» et un message d acquittement de type «erreur» est déposé dans le répertoire «bndppr2sih» et éventuellement (selon la configuration) envoyé par messagerie (Cf. paragraphe 3.5 pour les mécanismes de communication des erreurs avec le SIH). Le SIH doit ensuite corriger le message et l envoyer de nouveau s il le souhaite. Code erreur ERR503 Message d erreur La grammaire du message XML ou la charte d identification ne sont pas respectées. Identifiant du message = <idmessage>, fichier = <fichiermessage> La grammaire des messages DPPR est formalisée dans des schémas XML (fichiers XSD). Ces fichiers sont déployés dans chaque boîte noire et sont également fournis aux SIH afin qu ils puissent vérifier en amont la conformité de leurs messages. Cependant, les fichiers XSD ne contiennent pas les codifications du DPPR. Dans le processus d inscription d une pièce, le SIH doit préciser dans le flux XML, le type de pièce et la pathologie. Ces deux éléments font l objet d une codification au niveau du DPPR et peuvent évoluer dans le temps. Si le fichier XSD contient les codifications, cela signifie qu il faut le faire évoluer dès qu un changement en central est opéré et cela est très lourd. Ce n est pas souhaitable. De la même manière, certains messages XML du DPPR contiennent des «données complémentaires». Ces structures de données XML permettent au SIH de préciser des données complémentaires et ce de manière facultative (reportez vous au paragraphe 5.9 pour de plus amples renseignements). Aucune codification des données complémentaires n est présente dans les fichiers XSD si bien que les informations envoyées par le SIH ne peuvent être vérifiées au niveau de la boîte noire DPPR. La solution retenue consiste à ne pas vérifier la codification des éléments (types de pièces, pathologies, ) ni les données complémentaires dans les fichiers XSD. Une codification erronée sera détectée par le DPPR et une erreur sera remontée à la boîte noire. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 7/89

16 3.3.4 Traitement du message En fonction du type de message réceptionné, la boîte noire effectue des traitements internes permettant l interprétation des données XML des messages, l enregistrement d informations en base de données et les envois au DPPR Cas des messages non lisibles par la Boite Noire Dans certains cas bien spécifiques, la boite noire peut se trouver dans l incapacité d ouvrir un message déposé par le SIH dans le répertoire «sih2bndpp». Cette situation peut se produire à cause d un problème réseau (le message est corrompu et/ou est incomplet, le nom du fichier est illisible, etc.), ou par exemple dans le cas où le fichier n est pas conforme à la grammaire XML. Etant donné que la Boite Noire est incapable de lire le contenu du fichier, elle n est pas capable non plus de renvoyer un message d erreur de type «métier» et d indiquer au SIH la référence du message d origine. Pour traiter ce genre de situation, il est convenu que la Boite Noire ne renvoie aucun message d acquittement au SIH, mais seulement un à l attention de l administrateur SIH (adresse configurée au niveau de la BN pour les notifications des messages en erreur). Le SIH se charge de mettre en place un processus de renvoi des messages qui n auront pas reçu de réponse de la part du DPPR dans un délai donné (un jour, une semaine, un mois ). SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 8/89

17 3.4 SEQUENCE 3 : ENVOI AU DPPR Principes Chaque message est envoyé au DPPR si aucune erreur ne se produit en amont du processus. L envoi d un message se traduit par le dépôt du message dans une file d attente du DPPR Préparation du message d envoi Le message reçu par le SIH est transformé par la boîte noire car c est la boîte noire qui devient l émetteur à la vue du DPPR. Un nouveau message est donc créé dans lequel les informations sur l émetteur et le destinataire sont modifiées. La boîte noire n altère pas le message mais ajoute des informations complémentaires nécessaires pour le DPPR. Lorsque le nouveau message est créé, il est envoyé au DPPR en utilisant une file d attente MSMQ. Ce traitement est totalement transparent pour le SIH qui ne dialoguera jamais directement avec le DPPR. Plusieurs types d erreurs peuvent se produire lors de la phase d envoi du message au DPPR - Une erreur «technique» : - Une erreur DPPR Erreur technique Une erreur technique traduit l incapacité par la boîte noire de délivrer le message au DPPR. Cette erreur, exceptionnelle, est liée à un problème technique (réseau, MSMQ, indisponibilité du DPPR, ). Le problème technique peut être temporaire, ainsi la boîte noire peut réitérer de nouveau l envoi de messages sans pour autant informer le SIH des erreurs qui interviennent. Le SIH est en effet impuissant par rapport à ce type d erreur. Les mécanismes d envois au DPPR sont basés sur MSMQ. Lorsque la boîte noire envoi des messages MSMQ au DPPR, elle soummet le message au service MSMQ. Le service MSMQ se charge ensuite d envoyer le message au destinataire. Le service tente l envoi du message pendant une durée déterminée (cette durée est paramétrable dans le fichier de configuration de la boîte noire). Passé ce délai d envoi, le service MSMQ dépose les messages dans une file MSMQ système nommée lettres mortes transactionnelles. Le message ne sera ainsi jamais envoyé au DPPR. La boîte noire dispose d un procédé permettant d avertir par messagerie électronique l administrateur de la boîte noire qu un message n a pu être envoyé passé ce délai. Le message électronique contient le fichier XML en question en pièce jointe. Aucun acquittement n est envoyé au SIH pour lui signifier que l envoi n a pas été effectué. Etant donné que le SIH n est pas en mesure de corriger l erreur technique (qui reste cependant exceptionnelle), l administrateur de la boîte noire peut réitérer manuellement l envoi du message sans que le SIH n ait à le faire automatiquement. L administrateur s assure préalablement que le problème technique est résolu et ensuite relance le processus de traitement du message (en copiant le fichier XML du répertoire erreurs_bndppr vers sih2bndppr). Un script est proposé à l administrateur de la boîte noire. Ce script lui permet d indiquer deux créneaux de dates auxquels appartiennent des messages qu il souhaite envoyer. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 9/89

18 3.4.4 Réponse du DPPR Si l envoi se déroule correctement (pas d erreur technique), la boîte noire attend du DPPR une réponse concernant le traitement du message. Trois types de réponses peuvent être reçus par la boîte noire en provenance du DPPR : - Des messages d erreur (codes ERR*): ces messages indiquent à la boîte noire que le traitement demandé n a pas été effectué. Ces messages sont traduits pour le SIH et lui sont envoyés sous forme d acquittement ; - Des messages d avertissement : un message d avertissement indique que le traitement a été réalisé par le DPPR mais informe la boîte noire sur des informations complémentaires relatives au traitement demandé. Le message d avertissement est systématiquement envoyé au SIH sous forme d un acquittement ; - Des messages d information : les messages d information indiquent le succès du traitement. Ils sont journalisés et envoyés aux SIH. 3.5 SEQUENCE 4 : TRAITEMENT DU MESSAGE PAR LE DPPR Après réception du message XML envoyé par la boîte noire, le DPPR déclenche certains traitements, fonction du type de message reçu. Les traitements déclenchés sont les suivants : Création du dossier patient dans la base de données (cas de création de dossier patient par exemple), Création de la pièce dans la base de données (cas de création de pièce). La boîte noire demande systématiquement au DPPR un acquittement des messages envoyés. L acquittement détermine si le traitement s est déroulé correctement ou si au contraire une erreur a été rencontrée. Un acquittement est donc systématiquement renvoyé à la boîte noire par le DPPR. 3.6 SEQUENCE 5 : RECEPTION DE L ACQUITTEMENT DPPR PAR LA BOITE NOIRE La boîte noire réceptionne les acquittements qui proviennent du DPPR. Le mécanisme de réception est basé sur un déclencheur posé sur une file d attente MSMQ de la boîte noire. Le DPPR va en effet écrire directement ses acquittements dans une file d attente de la boîte noire. Lorsque la boîte noire reçoit un acquittement, elle l interprète et détermine le traitement qu il faut déclencher. Les acquittements sont reroutés au SIH pour l informer des erreurs, avertissements ou informations correspondants. Nous détaillons dans le paragraphe 5, les acquittements retournés au SIH et ce pour chaque type de message. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 10/89

19 3.7 SEQUENCE 6 : PRODUCTION DES ACQUITTEMENTS PAR LA BOITE NOIRE Un message d acquittement est produit par la boîte noire. Le message contient l identifiant du message d origine (message à la source de l erreur ou du traitement) et des informations complémentaires sur l acquittement (erreurs éventuelles, avertissements, informations) ainsi que les informations relatives à l événement (patient, pièce, ). Lorsque le message est produit par la boîte noire, la tâche de traitement associée (table des tâches en cours de traitement par la boîte noire) est supprimée. Le message d origine du SIH (stocké dans travail_bndppr) est déplacé soit dans le répertoire «erreur_bndppr» (cas d erreur), «avertissement_bndppr» (cas d avertissement) soit dans «traite_bndppr» (cas de succès du traitement). Trois actions sont réalisées par la boîte noire lorsqu un acquittement doit être envoyé au SIH : - Selon le paramètre «Mode d envoi» configuré dans la boîte noire, le message d acquittement HPRIM est soit déposé dans le répertoire «bndppr2sih» soit dans la file d attente MSMQ «bndppr2sih» ; - L acquittement est également déposé dans le répertoire «acquittements_bndppr» du fichier HPRIM et ce quel que soit la valeur du paramètre «Mode d envoi» ; - Le message d origine est déplacé dans les répertoires avertissements_bndppr ou erreurs_bndppr ou traite_bndppr ; - Si une adresse mail est précisée dans la configuration de la boîte noire pour le type d acquittement (erreur, avertissement ou information), un message électronique est transmis à cette adresse. Le message contient le détail de l erreur. Pour garantir l unicité du message d acquittement, le nom du fichier XML HPRIM envoyé au SIH porte un nom unique composé d un GUID (Globaly Unique Identifier). Ce numéro unique est généré par le système d exploitation et est unique au monde. Le type de message d acquittement peut être : - msgretourcreationpatientdppr ; - msgretouractivationpatientdppr ; - msgretourvenuepatientdppr ; - msgretourcreationpiecedppr ; - msgretouractivationpiecedppr ; - msgretoursuppressionpiecedppr ; - msgretourcreationequipedppr ; - msgretourmodificationequipedppr ; - msgretoursuppressionequipedppr. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 11/89

20 3.8 SEQUENCE 7 : RECUPERATION DES ACQUITTEMENTS PAR LE SIH Récupération des acquittements par le SIH Le SIH doit scruter le répertoire «bndppr2sih» ou la file d attente MSMQ «bndppr2sih» pour récupérer les acquittements. Le mécanisme de scrutation n est pas imposé par le projet DPPR, chaque SIH pouvant utiliser la technologie qu il souhaite. Lorsqu un message est récupéré, le SIH doit supprimer le message afin de ne pas le traiter plusieurs fois. Le contenu du message doit ensuite être interprété par le SIH pour déterminer les actions à déclencher en fonction du type d acquittement reçu. Le message d acquittement contient l identifiant du message à l origine et des données complémentaires sur le message (identifiant du patient par exemple, identifiant de la pièce, ). Le détail du contenu des messages d acquittement est précisé dans le paragraphe 5 pour chaque type de flux. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 12/89

21 3.8.2 Particularités MSMQ Les files d attente MSMQ de la boîte noire sont transactionnelles. L utilisation de files transactionnelles est motivée par la nécessité de persistance des messages sur la boîte noire après un redémarrage de celle-ci. Pour lire le contenu d une file d attente transactionnelle, le SIH doit utiliser une transaction sur la file d attente et valider cette transaction lorsque la récupération du message est terminée. Le SIH doit également réceptionner les flux sous forme binaire (utilisation d un formater Binaire). Le chemin d accès vers une file d attente est au format : FormatName:DIRECT=OS:<nommachineboîtenoire>\private$\<nomfile> Ou FormatName:DIRECT=TCP:<ipmachineboîtenoire>\private$\<nomfile> Voici un exemple de code pour réceptionner un message XML dans une file d attente MSMQ (code C#) : // Instanciation d'un objet de type message MSMQ messagemsmq _omessagemsmq = new messagemsmq(); // Déclaration d une transaction pour lire le message MessageQueueTransaction mqtx = new MessageQueueTransaction(); try { // Connexion à la file d'attente MessageQueue _mq = new MessageQueue(@"FormatName:DIRECT=OS:boitenoire\private$\bndppr2sih"); // Création d un objet Message Message msg; // création d'un formatter binaire (les messages MSMQ du DPPR sont envoyés en binaire) BinaryMessageFormatter _fmt = new BinaryMessageFormatter(); _mq.formatter=_fmt; } // Débute la transaction de lecture mqtx.begin(); // Réceptionne le message msg = _mq.receive(new TimeSpan(0,0,0),mqtx); // Valide la transaction mqtx.commit(); // Récupération des données du message _omessagemsmq.titremessage = msg.label.tostring(); _omessagemsmq.contenumessage = msg.body.tostring(); // Titre // Corps du message (XML) SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 13/89

22 3.8.3 Notification par messagerie pour les acquittements Pour chaque type d acquittement (erreur, avertissement et information), le SIH peut préciser une adresse de notification. Si l adresse n est pas spécifiée pour le type d acquittement, aucune notification par messagerie pour ce type d acquittement ne sera effectuée. Dans le cas contraire (présence d une adresse dans la configuration), le destinataire est averti par messagerie électronique. Reportez vous au paragraphe 3.12 pour de plus amples informations sur la notification par messagerie électronique. Le SIH peut s il le souhaite accéder au répertoire «acquittements_bndppr» pour récupérer le message d acquittement HPRIM correspondant l acquittement qui a été généré. Il peut également récupérer le message à l origine de l erreur en accédant au répertoire «erreurs_bndppr», «avertissements_bndppr» ou «traites_bndppr».. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 14/89

23 3.9 GESTION DES ETABLISSEMENTS DE LA BOITE NOIRE Contrairement à la boîte noire DPPR v1, la boîte noire DPPR v2 peut être associée à plusieurs établissements. La base de données de la boîte noire contient donc une table des établissements dans laquelle sont déclarés les établissements associés à la boîte noire Table des établissements La base de données des établissements de la boîte noire contient les informations suivantes. Champ Description Code établissement Identifiant unique de l établissement. Doit correspondre au code établissement tel qu il est déclaré au STIC. Nom établissement Adresse du service Web de l établissement Nom de l établissement (50 caractères maximum) Adresse http du service WEB de l établissement. Permet l invocation (en mode non duplication) du service Web du SIH Administration des établissements L administration des établissements dans la boîte noire s effectue via un outil en ligne de commande nommé adminets.exe. L outil permet d effectuer les actions suivantes Ajout d un établissement Adminets.exe add id :10 nom :Etablissement1 url : Dans l exemple ci-dessus, un établissement est créé avec les informations suivantes : Identifiant = 10, Nom = Etablissement1, Adresse du service Web = Notez que l adresse du service Web n est pas obligatoire. Notez aussi qu il peut être identique à plusieurs établissements. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 15/89

24 Modification d un établissement Plusieurs modifications peuvent être effectuées Modification du nom de l établissement Adminets.exe edit id :10 nom :Etablissement1 Cette commande modifie l établissement d identifiant 10 en remplaçant le nom actuel par le nouveau nom passé en paramètre Modification de l adresse du service Web Adminets.exe edit id :10 url : Cette commande modifie l établissement d identifiant 10 en remplaçant l adresse actuelle du service Web par la nouvelle adresse Suppression de l adresse du service Web Adminets.exe edit id :10 deleteurl Cette commande modifie l établissement d identifiant 10 en vidant l adresse du service Web de l établissement Modification combinée du nom et de l adresse du service Web Adminets.exe edit id :10 nom :Etablissement1 url : Cette commande modifie à la fois le nom et l url du service web de l établissement Suppression d un établissement Adminets.exe delete id :10 Cette commande supprime un établissement uniquement s il n a ni dossiers ni pièces dans la boîte noire Suppression forcée d un établissement Adminets.exe delete id :10 -force Cette commande supprime un établissement ainsi que toutes les données de la boîte noire qui sont associées à l établissement. Les dossiers et pièces de l établissement qui sont présents dans la base sont supprimés. La suppression est définitive Lister les établissements Adminets.exe list Liste les établissements configurés dans la boîte noire. Affiche l identifiant, le nom et l adresse du service web Données de configuration globales Bien que la boîte noire DPPR v2 soit multi-établissements, certains paramètres de configuration ne sont pas paramétrables par établissement mais globalement. Ainsi, ils s appliquent de la même manière à l ensemble des établissements. Les paramètres «globaux» les plus représentatifs sont les suivants : Adresses de notification en cas d erreur, avertissement ou information, Paramètres de connexion à la base de données, File d attente MSMQ dans laquelle il faut envoyer les acquittements pour le SIH, Répertoire dans lequel il faut déposer les acquittements pour le SIH. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 16/89

25 3.10 LES DIFFERENTS REPERTOIRES DE LA BOITE NOIRE Les fichiers qui sont traités par la boîte noire transitent dans des répertoires en fonction de l état du traitement et du résultat Liste des répertoires de la boîte noire Sih2bndppr Répertoire Sih2bndppr/pieces_jointe s Bndppr2sih travail_bndppr erreurs_bndppr avertissements_bndppr traites_bndppr acquittements_bndppr Description Répertoire en entrée. Permet au SIH de déposer les fichiers XML à traiter par la boîte noire. Ce répertoire est également utilisé par les mécanismes de réception FTP et MSMQ de manière transparente pour le SIH. Répertoire en entrée. Permet au SIH de déposer les pièces jointes lors du l utilisation du mode «avec duplication». Répertoire en sortie. Permet la communication entre la boîte noire et le SIH. La boîte dépose dans ce répertoire les messages d acquittement (erreur, avertissement ou information). Répertoire de travail du DPPR. Contient les fichiers en cours de vérification ou de traitement. Tant qu un fichier est en cours de traitement par la boîte noire, il reste dans ce répertoire. Répertoire de stockage des messages en erreur. Les messages XML pour lesquels un acquittement de type erreur a été envoyé sont stockés dans ce répertoire. Répertoire de stockage des messages en avertissement. Les messages XML pour lesquels un acquittement de type avertissement a été rencontré, sont stockés dans ce répertoire. Répertoire de stockage des messages traités. Les messages traités sans erreur sont déplacés dans ce répertoire. Répertoire de stockage des messages d acquittement. La boîte noire produit systématiquement un message d acquittement stocké dans ce répertoire. Le message (type «information») est copié dans le répertoire «bndppr2sih», les messages de peuvent faire l objet d une notification par messagerie électronique Purge des répertoires de la boîte noire Le stockage systématique de l ensemble des messages qui transitent par la boîte noire induit une occupation disque importante. L administrateur doit donc, lorsque la taille disponible sur le disque se réduit, purger les répertoires (notamment les répertoires erreur_bndppr, traite_bndppr qui stockent les messages qui ont été traités en erreur ou non). La purge peut être effectuée : - Soit manuellement par l administrateur ; - Soit en utilisant un script d administration livré avec la boîte noire ; - Soit déclenchée par l intermédiaire de l outil de sauvegarde que le SIH utilise. L outil peut en effet, archiver les fichiers XML et ensuite les purger de la boîte noire et ce à une fréquence déterminée par le SIH. La boîte ne fournit pas de mécanisme de purge automatique des messages. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 17/89

26 Les différentes files d attentes de la boîte noire Nom sih2bndppr bndppr2sih dppr2bndppr Description File d attente que le SIH utilise pour envoyer des messages à la boîte noire. File d attente utilisée par la boîte noire pour envoyer les acquittements au SIH. File d attente de réception par la boîte noire des acquittements du DPPR. Cette file d attente ne doit pas être accédée par le SIH car véhicule des messages internes entre le DPPR et la boîte noire Conventions de nommage des fichiers en entrée La boîte noire DPPR n impose pas aux SIH de respecter une quelconque convention de nommage des fichiers qu il envoi au DPPR. Les contraintes suivantes sont cependant à respecter par le SIH : - Les messages MSMQ envoyés par le SIH doivent disposer d un titre unique dans le temps et ce pour ne pas écraser des messages existants ; - L identifiant de chaque message doit être unique dans le temps. Cet identifiant est utilisé par la boîte noire pour les communications avec le DPPR et les retours avec le SIH. Attention, la norme HPRIM limite la taille de l identifiant de message à 12 caractères ; - Deux pièces jointes correspondant à une même pièce d un dossier ne doivent pas porter le même nom de fichier sans quoi la boîte noire ne peut les différencier. Nous préconisons que le SIH utilise un compteur incrémental pour nommer les fichiers et pour identifier les messages. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 18/89

27 3.11 JOURNALISATION DES EVENEMENTS La totalité des événements qui se déroulent dans la boîte noire sont journalisés dans le journal des événements de la boîte noire. Un fichier journal spécifique est créé sur la boîte noire, il se nomme «boitenoire.log» et est stocké dans le répertoire <Racine>\Log (le répertoire de stockage est paramétrable). Les messages sont journalisés en respectant les types d événements suivants : - Informations, - Avertissements, - Erreurs, - Erreurs Fatales, - Informations de débogage. L administrateur de la boîte noire est chargé de la gestion des journaux : purge, journal tournant, La configuration est effectuée dans le fichier de configuration de la journalisation (fichier dpprlogger.config du répertoire c:\dppr\config. Le fichier de configuration des logs offre la possibilité aux administrateurs de modifier la localisation du fichier journal, le formalisme des événements qui sont journalisés, et même le type de journal qui est créé (fichiers, fichiers tournants, journal Windows, console, ). La boîte noire utilise le Framework Log4Net pour la journalisation. Vous pouvez consulter le site Internet pour de plus amples renseignements sur la configuration de log4net. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 19/89

28 3.12 NOTIFICATION PAR MESSAGERIE La boîte noire est configurée pour notifier par messagerie un ou plusieurs utilisateurs et ce dès qu un acquittement doit être envoyé au SIH. Une adresse mail par type d acquittement peut être précisée : - Une adresse pour les informations ; - Une adresse pour les erreurs ; - Une adresse pour les avertissements. Si aucune adresse n est précisée pour le type d acquittement, aucun mail n est envoyé. Le SIH peut donc aisément configurer la boîte noire pour recevoir des notifications en fonction du type d acquittement. La ou les personnes (identifiées par l adresse mail configurée dans la boîte noire : peut être une liste de diffusion par exemple), reçoit par messagerie un comme décrit ci-après : De Sujet Corp s Adresse attribué à la boîte noire (Cf. paramètres de la boîte noire) <Erreur> ou <Avertissement> DPPR <Message détaillé de l erreur> (Cf. messages d erreurs du DPPR, 7.1 et d avertissements 0). En cas d erreur, le message est envoyé en priorité haute, en cas d avertissement ou d information, le message est envoyé en priorité normale. Afin que la notification par messagerie soit possible, la boîte noire DPPR doit être paramétrée pour se connecter à un serveur SMTP. Le paramétrage s effectue dans le fichier de configuration (dppr.config). Le fichier de configuration permet également de préciser (si cela est nécessaire) le nom d utilisateur et le mot de passe nécessaires pour l envoi de messages électroniques SEQUENCEMENT DES MESSAGES Dans certains scénarios, le séquencement de l envoi des messages est important. Exemple dans le cas de la création d un dossier au DPPR et de la création de pièces pour le dossier. Si le SIH envoi simultanément les messages de création du dossier et des pièces dans ce même dossier, les messages de création de pièces ne pourront être envoyés au DPPR tant que le dossier n est pas créé. La boîte noire ne peut pas garantir ce séquencement car les processus mis en œuvre pour réitérer sur les envois de messages rendent impossible le séquencement. La boîte noire traite chaque message déposé par le SIH et informera le SIH (pour les messages de création de pièces par exemple) que les pièces ne peuvent être créées car le dossier est en cours d envoi. Le SIH se charge ensuite de réitérer l envoi des pièces lorsqu il aura reçu la confirmation de création du dossier au DPPR. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 20/89

29 4. PARTICULARITE DES ENVOIS DE FLUX RELATIFS AUX PIECES DE DOSSIERS 4.1 PRESENTATION Les dossiers patients du DPPR sont constitués de pièces. Une pièce est un acte, rédigé par un professionnel de santé et qui doit être versé au dossier d un patient. Les pièces d un dossier sont constituées : - de méta données : données d identification et de description de la pièce ; - d un ou de plusieurs fichiers (compte rendu rédigé par le médecin par exemple). Les fichiers qui représentent une pièce ne sont pas stockés sur la plate forme centrale DPPR. Les pièces sont stockées soit par le SIH soit par la boîte noire du SIH. Le DPPR propose donc deux types de stockages : - Stockage par duplication : les pièces sont stockées par la boîte noire du DPPR ; - Stockage par non duplication : le SIH stocke les pièces et la boîte noire l interrogera lorsqu elle souhaite récupérer une pièce. Une boîte noire est configurée pour fonctionner en duplication ou sans duplication. Cette configuration est valable pour l ensemble des pièces, il n y a pas de configuration (duplication ou non) pour chaque pièce ou pour chaque type de pièce. La modification du mode de fonctionnement est prise en compte immédiatement (après redémarrage des services de la boîte noire). Si la boîte noire passe d un mode sans duplication en un mode avec duplication, les pièces versées dans le précédent mode ne pourront pas être accédées par le DPPR car elles n existent pas dans la base de données de la boîte noire Mode sans duplication En mode sans duplication, le SIH centralise les pièces qu il souhaite mettre à disposition dans les dossiers du DPPR. Lorsque le SIH déclare (crée) une pièce dans un dossier du DPPR, il indique les données descriptives de la pièce (dans un fichier XML) mais n envoi pas le ou les fichiers de la pièce. Lorsqu un utilisateur du DPPR souhaite consulter une pièce, le DPPR interroge la boîte noire du SIH pour récupérer la pièce. La boîte noire va à son tour interroger le SIH pour récupérer la pièce. Le SIH doit donc être en mesure de récupérer la pièce et de la transmettre à la boîte noire et ce dans une communication synchrone car le temps de réponse doit être rapide. Le mode sans duplication suppose que le SIH développe un composant (service Web) qui répond aux requêtes de la boîte noire. Un flux (de type http) est envoyé par la boîte noire en direction du SIH. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 21/89

30 4.1.2 Mode avec duplication En mode duplication, le SIH délègue à la boîte noire le stockage des pièces. Lors de la mise à disposition d une pièce, le SIH envoi le ou les fichiers de la pièce à la boîte noire en même temps que le flux XML de description de la pièce. La boîte noire stocke le ou les fichiers correspondants à la pièce. Lorsqu un utilisateur du DPPR souhaite consulter une pièce, la boîte noire est en mesure de la lui fournir sans interroger le SIH. Le mode avec duplication suppose que le SIH fournisse le ou les fichiers de la pièce lors de l envoi du message de création de la pièce (message XML). Par contre, le SIH n a pas besoin d implémenter un mécanisme (service Web) pour la récupération des pièces sur une demande du DPPR. Reportez vous au paragraphe 5.9 pour le détail des flux XML de création / modification d une pièce dans le DPPR. 4.2 GESTION DES TACHES PAR LA BOITE NOIRE Lorsqu un SIH envoi un message à la boîte noire, la boîte noire crée une «tâche» de traitement de ce message. La tâche est créée à partir du moment où le message est capté par le scrutateur de répertoire de la boîte noire. Pour cela, une entrée est créée dans une table de la base de données de la boîte noire. Cette table des tâches actives contient les éléments suivants : Nom de l élément Description Remarque Identifiant de la tâche Identifiant unique de la tâche. Généré automatiquement par la boîte noire. Identifiant du message d origine Date et heure de création de la tâche Date et heure de prochaine tentative d envoi Type de message Identifiant unique du message reçu par la boîte noire. Date et heure de création de la tâche Date et heure à laquelle la prochaine tentative d envoi du message en erreur sera effectuée. Contient le type du message envoyé (evenementpatient ou evenementmedical) Renseigné automatiquement par la boîte noire lors de l arrivée du message. N est pas renseigné si le message est envoyé sans erreur. Statut Contient le statut de la tâche VE = Vérification en cours Identifiant du message envoyé au DPPR Nom du fichier pour le message d origine Contient l identifiant du message envoyé au DPPR Contient uniquement le nom du fichier (pas le chemin complet) TM = Traitement métier en cours EV = En cours d envoi DPPR EN = En attente de message DPPR Renseigné lors de la production du message à destination du DPPR (vide si le statut de la tâche =VE ou TM). Nécessaire pour faire le lien entre un acquittement et le message d'origine La table des tâches contient uniquement les tâches en cours pour lesquelles aucune réponse n a été obtenue du DPPR. La tâche est supprimée de cette table lorsque le traitement du message est terminé pour la boîte noire. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 22/89

31 4.3 REGLES A METTRE EN ŒUVRE SUR LES DISPOSITIFS DE SECURITE Le SIH doit permettre la communication entre son système d information et la boîte noire. Pour cela, les règles suivantes doivent être ouvertes sur ses dispositifs de sécurité : Pour l envoi / réception MSMQ : ouvrir les ports suivants : o o o o o o o Port TCP 135 en direction de la boîte noire, Port TCP 1801 en direction de la boîte noire, Port TCP 2101 en direction de la boîte noire, Port TCP 2103 en direction de la boîte noire, Port TCP 2105 en direction de la boîte noire, Port UDP 1801 dans les deux sens, Port UDP 3527 dans les deux sens Pour l envoi FTP : port 21 en direction de la boîte noire, Pour l envoi / réception Fichier : ports Netbios en direction de la boîte noire ; Pour la communication avec un serveur de messagerie du SIH : port 25 en direction du SIH ; Pour le fonctionnement du mode sans duplication : port 80 en direction du SIH ; Pour la prise en main en Terminal Server : port 3389 en direction de la boîte noire ; SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 23/89

32 5. LES DIFFERENTS TYPES DE MESSAGES 5.1 RECAPITULATIF DES MESSAGES Création d un dossier au DPPR Elément Type de message Type de message d acquittement Activation/Désactivation d un dossier DPPR, pour le SIH uniquement Suppression d un dossier DPPR : est en réalité un message de désactivation d un dossier DPPR pour tous les SIH Création d une pièce dans un dossier DPPR Modification d une pièce dans un dossier DPPR Invalidation d une pièce dans un dossier DPPR Suppression d une pièce d un dossier DPPR Gestion des équipes evenementspatientsdppr DPPR.xsd evenementspatientsdppr DPPRt.xsd evenementspatientsdppr DPPR.xsd evenementsmedicauxdppr DPPR.xsd evenementsmedicauxdppr DPPRPiece.xsd evenementsmedicauxdppr DPPRPiece.xsd evenementsmedicauxdppr DPPRPiece.xsd evenementsequipesdppr DPPREquipe.xsd msgretourcreationpatientdppr msgretourcreationpatientdppr.xsd msgretouractivationpatientdppr msgretouractivationpatientdppr.xsd msgretoursuppressionpatientdppr msgretoursuppressionpatientdppr.xs d msgretourcreationpiecedppr msgretourcreationpiecedppr.xsd msgretourmodificationpiecedppr msgretourmodificationpiecedppr.xsd msgretouractivationpiecedppr msgretouractivationpiecedppr.xsd msgretoursuppressionpiecedppr msgretoursuppressionpiecedppr.xsd msgretourcreationequipedppr msgretourmodificationequipedppr msgretoursuppressionequipedppr Remarque : le message de validation d une pièce disparaît : en effet une pièce invalidée n est pas revalidée par la suite : elle est remplacée par une nouvelle pièce. 5.2 CONSTITUTION DES MESSAGES XML Les messages XML définissent des événements (événements Patient ou Médicaux). La norme HPRIM est utilisée pour les différents échanges, cependant, des manques dans la norme ont été identifiés dans le cadre du projet DPPR. Pour cela des extensions de la norme ont été effectuées spécifiquement pour le projet. Les messages doivent impérativement être encodés en UTF-8. Dans chaque message XML envoyé par le SIH, la référence au fichier XSD (fichier qui formalisme la grammaire utilisée) doit être présente. Exemple : Dans l exemple ci-dessus, le message XML référence la grammaire définie dans le fichier DPPRPatient.xsd. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 24/89

33 5.3 ACQUITTEMENT ATTENDU Les messages envoyés au DPPR doivent tous contenir un attribut «acquittementattendu» positionné à la valeur «oui». Cet attribut détermine si un acquittement est envoyé au SIH suite au traitement du message (cas d échec ou de succès). La valeur contenue dans l attribut n est pas prise en compte par la boîte noire qui générera systématiquement un acquittement à destination du SIH et une notification par messagerie en fonction de la configuration de la boîte noire. 5.4 ENTETES DE MESSAGE XML Chaque message XML échangé dans le cadre du DPPR porte un entête conforme HPRIM. Cet entête définit un certain nombre d attributs que nous détaillons dans ce paragraphe. L élément HPRIM utilisé est «entetemessage». L entête apparaît dans chaque message immédiatement après la déclaration de l élément racine qui détermine le type d événement concerné par le message Description Elément XML Chemin XML Valeur possible Description identifiantmessage entetemessage Identifiant du message. Doit être généré par le SIH. Est ensuite utilisé par le SIH pour rapprocher les messages d acquittement du message d origine. L identifiant doit impérativement être unique, sinon la boîte noire peut générer une erreur à ce sujet. dateheureproduction entetemessage Date Date de production du message par le SIH (renseigné par le SIH) catégorie code entetemessage > émetteur > agents > agent entetemessage > émetteur > agents > agent catégorie entetemessage > destinataire > agents > agent code entetemessage > destinataire > agents > agent «application» Type d émetteur du message. Toujours «application» pour le DPPR. Entier Code d émetteur (code du SIH) «application» Type du DPPR. Toujours «application». Entier Code du destinataire (code du DPPR) SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 25/89

34 5.4.2 Exemple d un message du SIH vers la BN Identifiant unique du message Date et heure de production du message par le SIH "# #"#$%"""# # $ # $#& Code d émetteur (code du SIH) $ # # $#& Code du destinataire (code du DPPR) # SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 26/89

35 5.5 CARACTERES SPECIAUX «<» ET «>» Si un message doit contenir (dans le libellé d une pièce par exemple), un caractère «<» ou «>», les codes correspondants doivent être passés dans le message afin que le message XML soit vérifié. Caractère > > < < Code correspondant 5.6 DONNEES DES PATIENTS Dans chaque message concernant un patient, les données de celui-ci sont présentes. Le type HPRIM «patient» est utilisé pour définir les données d un patient. Vous pouvez vous reportez au fichier «patient.xsd» de la norme HPRIM pour le détail du type patient Identifiants d un patient Un patient dispose, dans le contexte du DPPR, toujours de deux identifiants : - Un identifiant local (IPPL) pour l établissement qui transmet ou reçoit l information - Un identifiant régional (IPPR) commun à l ensemble des établissements Identifiant local Pour définir l identifiant local d un patient, il faut utiliser le code XML suivant (dans patient/identifiant) : $ #%#&& #'(((((((# $ # Identifiant régional Pour définir l identifiant régional d un patient, il faut utiliser le code XML suivant (dans patient/identifiant) : #%#%#)&# # ## #%# SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 27/89

36 Traits stricts et traits étendus Systématiquement, les traits stricts et étendus d un patient sont transmis dans les messages envoyés par le SIH et qui ont un lien avec un patient. Ils sont définis dans l élément XML nommé «personnephysique» (Cf. fichier personnephysique.xsd de la norme HPRIM). %# & Nom usuel du patient '*+,$-.*$' nom de naissance (*+*,-,*/.,$-.*$( prénoms du patient %# %#.*+,$-.*$%# %# Date de naissance ( "# ( Lieu de naissance ( Code Pays de naissance %&%& Code postal de naissance %( ( %# & SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 28/89

37 5.7 MESSAGES D ACQUITTEMENTS RECUS Les messages d acquittements qui sont réceptionnés par le SIH contiennent plusieurs types d informations : - Le statut du message : o o «OK» : c est un message d information ou d avertissement, le traitement demandé s est déroulé correctement ; «Erreur» : le traitement n a pas été réalisé, aucune donnée n a été modifiée dans le DPPR. - Le détail du message (code et libellé) : donne des indications supplémentaires sur l acquittement reçu : o Si le statut vaut «OK», le code commence par INF ou AVT; o Si le statut vaut «Erreur», le code commence par ERR ; - Le détail de l élément concerné : o o o Soit les données du patient si le message d acquittement concerne une action sur un patient ; Soit les données du patient et d une pièce si le message concernent une action sur une pièce d un dossier ; Soit les données de l équipe Reportez vous au paragraphe 7.1, 7.2 et 7.3 pour la liste exhaustive des codes messages. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 29/89

38 5.8 MESSAGES PATIENT Création d un dossier au DPPR Présentation Le message de création d un dossier au sein du DPPR est envoyé par chaque SIH dans les scénarios suivants : - Initialisation du DPPR : phase d initialisation du DPPR qui déclenche la création des dossiers patients du SIH au DPPR ; - Accueil d un nouveau patient dans l établissement : un patient se présente dans l établissement, son dossier est créé dans l établissement. Un nouveau type XML a été créé pour satisfaire aux besoins spécifiques du DPPR (dérivé d un type HPRIM). Le type se nomme «typeevenementpatientdppr» et dérive du type «typeevenementpatient» de la norme HPRIM. L élément XML à utiliser dans les fichiers se nomme «evenementspatientsdppr» (de type typeevenementpatient) Cinématique SIH BN DPPR Envoi à la boîte noire Message XML de type «evenementspatientsdppr» Action= création Contient les données du patient de notification (erreur ou avertissement) Erreur ou avertissement Patient enregistré au DPPR pour l établissement Message XML de type «msgretourcreationpatientdppr» (type=information) SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 30/89

39 Exemple de message de type création patient Identifiant unique du message Date et heure de production du message par le SIH Code de l'emetteur (code du SIH) Code du destinataire (code du DPPR) Action = création d'un dossier dans le DPPR ## ) Données du patient concerné % Identifiants du patient Identifiant local dans l'établissement : IPPL #%#&& #'(((((((# # Identifiant régional : IPPR #%#%#)&# # ## #%# Traits stricts et étendus du patient %# & Nom usuel du patient '*+,$-.*$' nom de naissance (*+*,-,*/.,$-.*$( prénom du patient %#%#.*+,$-.*$%# %# Date de naissance ( "# ( Lieu de naissance ( Pays de naissance %&%& Code postal de naissance %( ( %# & % ## Adresse qualité santé du patient (facultatif) #0&# SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 31/89

40 Acquittements possibles Suite à un message de création de patient, un acquittement de type «msgretourcreationpatientdppr» est créé. Il respecte le format suivant : #)# +1 Identifiant du message d'acquittement date et heure de production de l'acquittement "# #"#$%"""# # # #& code emetteur du dppr # # #& code destinataire (code du SIH) # Identifiant du message qui est acquitté " Liste l'avertissement, l'erreur ou l'information ####* # code de l'erreur, information ou avertissement -*2 libellé du message correlé au code +#/)-34&55))+# ####* # représente le patient concerné par l'erreur, l'avertissement ou l info ## L'identifiant est l'ippl du patient # Identifiant régional du patient (IPPR) ## # #%# Identifiant local du patient (IPPL) #"# #%# ## #)# SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 32/89

41 Erreurs, avertissements et informations Voici la liste des erreurs, avertissements et informations pouvant être envoyées au SIH sous forme d acquittement ou sous forme de message électronique : Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté. Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR600 Erreur inattendue Erreur ERR602 Création du patient d ippr <ippr> et d ippl <ippl> impossible : les traits stricts envoyés dans le message XML diffèrent des traits stricts STIC du dossier dans le DPPR. Erreur ERR700 Erreur inattendue (provient du STIC) Erreur ERR701 L IPPR <ippr> n existe pas ou n est pas correct (erreur en provenance de STIC). Avertissement AVT601 Le dossier d Ippr <ippr> existe déjà pour votre établissement. Avertissement AVT612 Le dossier d ippr <ippr> et d ippl <ippl> a été associé à votre établissement mais il est pour l instant déclaré comme supprimé dans le DPPR. Vous ne pouvez donc pas lui associer des pièces. Information INF601 Création du dossier patient régional d ippr <ippr> et d ippl <ippl> effectué et terminé. Remarque : si l avertissement AVT612 est envoyé au SIH (cas d un dossier supprimé au DPPR et d une demande de création de ce dossier par un SIH), le message d avertissement n est pas suivi d un message OK. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 33/89

42 5.8.2 Activation / Désactivation d un dossier DPPR pour le SIH demandeur Présentation Ce message permet d activer ou de désactiver un dossier patient au sein du DPPR et ce pour l établissement demandeur. Le message est similaire à une création de dossier (sauf bien entendu le champ «action», qui prend comme valeur : «modification»). D autre part, lors de la désactivation d un dossier, les pièces du dossier ne sont pas supprimées ni du DPPR (les liens sont toujours présents) ni de la boîte noire (cas de duplication notamment). Cependant, les pièces issues de l établissement ne sont plus visibles dans le dossier tant que le dossier n est pas réactivé par le SIH. Lors de la réactivation du dossier, les liens existants étant toujours présents au DPPR, ils sont simplement de nouveau affichés dans le dossier et de nouvelles pièces peuvent être envoyées par le SIH. Le SIH peut, s il le souhaite, envoyer tout l historique des pièces du dossier. Les pièces qui existent déjà sortiront en erreur et les pièces inexistantes seront créées. C est une bonne pratique pour s assurer que toutes les pièces ont été versées au dossier du patient y compris les pièces générées par le SIH pendant la période de désactivation du dossier. Remarque : les attributs «accord» et «datevaliditeaccord» sont retirés. Le distinguo entre un message d activation et un message de désactivation se fait par le biais de l attribut «actionspecifique» : Cet attribut «actionspecifique» contient la valeur : - «désactivation» si le dossier doit être désactivé - «activation» si le dossier doit être activé Cinématique SIH BN DPPR Envoi à la boîte noire Message XML de type «evenementspatientsdppr» Action= modification Contient les données du patient Son accord ou son désaccord de notification (erreur ou avertissement) Erreur ou avertissement Patient activé ou désactivé au DPPR Message XML de type «msgretouractivationpatientdppr» (type=information) SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 34/89

43 Exemple de message Identifiant unique du message Date et heure de production du message par le SIH "# #"#$%"""# # # #& Code de l'emetteur (code du SIH) # # #& Code du destinataire (code du DPPR) # Action = modification du dossier patient ## 5 Données du patient concerné % Identifiants du patient Identifiant local dans l'établissement : IPPL #%#&& #'(((((((# # Identifiant régional : IPPR #%#%#)&# # ## #%# Traits stricts et étendus du patient %# & Nom usuel du patient '*+,$-.*$' nom de naissance (*+*,-,*/.,$-.*$( prénoms du patient %# %#.*+,$-.*$%# %# Date de naissance ( "# ( Lieu de naissance ( Pays de naissance %&%& Code postal de naissance %( ( %# & % ##,% 6,% SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 35/89

44 Acquittements possibles Les messages d acquittement reçus par le SIH sont de type «msgretouractivationpatient». Voici un exemple de message d acquittement : # +1 Identifiant du message d'acquittement date et heure de production de l'acquittement "# #"#$%"""# # # #& code emetteur du dppr # # #& code destinataire (code du SIH) # Identifiant du message qui est acquitté " Liste l'avertissement, l'erreur ou l'information ####* # code de l'erreur, information ou avertissement -*2% libellé du message correlé au code +#)))6)&+# ####* # représente le patient concerné par l'err, l'avert ou l'info ## L'identifiant est l'ippl du patient # Identifiant régional du patient (IPPR) ## # #%# Identifiant local du patient (IPPL) #"# #%# ## # SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 36/89

45 Erreurs, avertissements et informations Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté. Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR600 Erreur inattendue Erreur ERR603 Activation / désactivation du dossier d ippr <ippr> et d ippl <ippl> pour votre SIH impossible. Le dossier n existe pas dans le DPPR. Erreur ERR605 Le dossier d ippr <ippr> et d ippl <ippl> ne peut être activé/désactivé pour votre SIH, il n existe pas pour votre établissement. Information INF603 Le dossier patient d ippr <ippr> et d ippl <ippl> a été désactivé correctement pour votre SIH. Information INF604 Le dossier patient d ippr <ippr> et d ippl <ippl> a été activé correctement pour votre SIH. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 37/89

46 5.8.3 Suppression d un dossier au DPPR (pour tous les SIH) Présentation Ce message permet de supprimer (non définitivement) un dossier patient au sein du DPPR et ce pour l établissement demandeur mais aussi pour tous les autres SIH. Le dossier est marqué comme supprimé, il peut être restauré par la suite à la demande de l administrateur du DPPR. Le dossier ne peut pas être restauré par un message SIH. La suppression du dossier est très souvent demandée par le patient lorsque celui-ci ne souhaite plus participer au projet DPPR Suppression : La suppression positionne un indicateur logique sur le dossier du patient et pour l ensemble des SIH. Le dossier est désactivé pour l ensemble des SIH, personne ne pourra ensuite y accéder (ni verser de nouvelles pièces au dossier), cependant, l administrateur du DPPR pourra, s il le souhaite, réactiver le dossier. Remarque : une fois la suppression effectuée pour tous les SIH au niveau du DPPR, aucune information n est envoyée aux SIH pour les informer de la suppression du dossier dans le DPPR Restauration : Le fonctionnement est le suivant : a. Restauration manuellement par un administrateur du DPPR. b. Aucun message n informe les SIH de la réactivation du dossier ; SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 38/89

47 Cinématique SIH BN DPPR Envoi à la boîte noire Message XML de type «evenementspatientsdppr» Action= suppression Contient les données du patient de notification Erreur ou avertissement Patient supprimé du DPPR Message XML de type «msgretoursuppressionpatientdppr» (type=information) SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 39/89

48 Exemple de fichier Identifiant unique du message Date et heure de production du message par le SIH "# #"#$%"""# # # #& Code de l'emetteur (code du SIH) # # #& Code du destinataire (code du DPPR) # ## Données du patient concerné % Identifiants du patient Identifiant local dans l'établissement : IPPL #%#&& #'(((((((# # Identifiant régional : IPPR #%#%#)&# # ## #%# Traits stricts et étendus du patient %# & Nom usuel du patient '*+,$-.*$' nom de naissance (*+*,-,*/.,$-.*$( prénoms du patient %#%#.*+,$-.*$%#%# Date de naissance ("#( Lieu de naissance ( Pays de naissance %&%& Code postal de naissance %( ( %# & % ## Motif d activation/désactivation du dossier dans le DPPR #+$-2..,/$-7,$-+*# -Action à mener : activation ou désactivation,% )6,% SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 40/89

49 Acquittements possibles Le message d acquittement associé est de type «msgretoursuppressionpatient». Voici un exemple du message d acquittement : #,%%# +1 Identifiant du message d'acquittement date et heure de production de l'acquittement "# #"#$%"""# # # #& code emetteur du dppr # # #& code destinataire (code du SIH) # Identifiant du message qui est acquitté " Liste l'avertissement, l'erreur ou l'information ####* # code de l'erreur, information ou avertissement -*2%8 libellé du message correlé au code +#)))6)&+# ####* # ## L'identifiant est l'ippl du patient # Identifiant régional du patient (IPPR) ## # #%# Identifiant local du patient (IPPL) #"# #%# ## #,%%# SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 41/89

50 Erreurs, événements ou informations Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté. Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR600 Erreur inattendue Erreur ERR622 Activation/désactivation du dossier impossible pour le DPPR. Le dossier n existe pas dans le DPPR. Erreur ERR623 Activation/désactivation du dossier impossible pour le DPPR. Les traits stricts envoyés dans le message XML diffèrent des traits stricts STIC du dossier dans le DPPR. Erreur ERR624 Le dossier d ippr <ippr> et d ippl <ippl> n est pas associé à votre établissement, il ne peut donc pas être désactivé au DPPR par votre SIH. Avertissement AVT605 Le dossier d ippr <ippr> a été supprimé du DPPR. Avertissement AVT607 Le dossier d ippr <ippr> a été restauré du DPPR. Information INF605 Le dossier patient d ippr <ippr> et d ippl <ippl> a été désactivé correctement pour le DPPR. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 42/89

51 5.8.4 Cas des activations et désactivations par le STIC Le STIC peut envoyer au DPPR des messages l informant qu un dossier patient a été désactivé ou réactivé Activation d un patient par le STIC Le fonctionnement est le suivant : a. STIC envoie à tous les SIH et au DPPR connaissant le patient un message d activation b. Les SIH réactivent le patient pour STIC c. Le DPPR va restaurer le dossier dans le DPPR. Il va de ce fait déclencher le traitement relatif à la restauration de dossier dans le DPPR (Cf. paragraphe ) Désactivation d un patient par le STIC Le fonctionnement est le suivant : a. STIC envoie à tous les SIH et au DPPR connaissant le patient un message de désactivation b. Les SIH désactivent le patient pour le STIC uniquement c. Le DPPR supprime le dossier patient du DPPR (suppression logique du dossier dans le DPPR) et déclenche donc les traitements associés (en informant chaque boîte noire de la suppression) : Cf. paragraphe ) Fusion centrale STIC Le fonctionnement est le suivant : a. STIC envoie à tous les SIH et au DPPR un message de fusion (le dossier A devient le dossier B) b. Le DPPR effectue un traitement sur le dossier A en transférant les pièces du dossier A vers le dossier B. Les données dynamiques (ex : données administratives) sont déplacées vers le dossier B uniquement si des données de même type n existent pas dans ce dossier ; c. Les boîtes noires concernées sont informées de ce changement et opèrent une modification dans leur base de données d. Les SIH ne sont pas informés par le DPPR de ces changements car ils l ont été en amont par STIC Défusion centrale STIC Le fonctionnement est le suivant : a. STIC envoie à tous les SIH et au DPPR un message de défusion (le dossier A devient, pour certains établissements, le dossier C (nouveau dossier à créer)) b. Le DPPR déplace les pièces des établissements concernés vers un nouveau dossier (dossier C) c. Les boîtes noires des établissements concernés sont informées de ce changement et créent le nouveau dossier. Les pièces du dossier A sont déplacées, sur la boîte noire dans le dossier C. d. Les SIH ne sont pas informés par la boîte noire de ces différentes actions. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 43/89

52 5.8.7 Fusion locale STIC Le fonctionnement est identique à une fusion centrale Défusion locale STIC Le DPPR ne réagit pas aux messages de défusions locales STIC car n est pas en mesure de déclencher des traitements associés. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 44/89

53 5.9 MESSAGES MEDICAUX Ajout d une pièce à un dossier (mode sans duplication) Présentation Lorsqu un SIH souhaite mettre à disposition une pièce dans un dossier du DPPR, il doit constituer un message XML dans lequel il indique les caractéristiques de la pièce. Le message est envoyé à la boîte noire DPPR. En mode «sans duplication», la pièce (le fichier correspondant à la pièce) n est pas envoyée à la boîte noire. Seules les méta données de la pièce (les données descriptives de la pièce) sont envoyées à la boîte noire. Pour renseigner l auteur d une pièce, reportez vous en annexe aux conventions de nommage des professionnels de santé Cinématique SIH BN DPPR Envoi à la boîte noire Message XML de type «evenementsmedicauxdppr» Action= création Contient les données du patient, et de la pièce de notification Erreur ou avertissement Pièce créée dans le dossier DPPR Message XML de type «msgretourcreationpiecedppr» (type=information) SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 45/89

54 Exemple de message Identifiant unique du message Date et heure de production du message par le SIH "# #"#8$%"""# # # #& Code de l'emetteur (code du SIH) # # #& Code du destinataire (code du DPPR) # ) "%#$8" Représente l'auteur de la pièce (le PS) Soit il est identifié par son numéro Adéli, soit par son numéro ordre Soit par son nom + prénom (cas d'un PS non identifié dans le DPPR) # #../0...1# %# '' %#%#9%#%# %# # Représente le patient concerné par la pièce % Identifiant local dans l'établissement : IPPL #%#&& #'(((((((# # Identifiant régional : IPPR #%#%#)&# # ## #%# %# & ')' %#%#:0%#%# ((#8( Lieu de naissance ( Pays de naissance %&%& Code postal de naissance %( ( %# & % Date et heure de réf. obligatoire dans HPRIM mais non utilisée dans le DPPR. "# # "%# "# # Identifiant de l'événément médical. Non utilisé dans le DPPR. Libellé de l'événement médical. Non utilisé dans le DPPR. + SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 46/89

55 Données DPPR de la pièce Identifiant local de la pièce dans le SIH 8%"'( Libellé de la pièce tel qu'il sera affiché dans le DPPR + );%"%"+ Type de pièce. Se référer à la codification des types du DPPR &% '&% Pathologie de la pièce (non obligatoire). Se référer à la codification des pathologies dans le DPPR %% Date à laquelle l'acte a été effectué dans le SIH "% Date de création de l'acte. Peut être différent de la date de l'acte (rédaction d'un CR postérieurement à l'acte lui même) )#"%)# Date de validation de l'acte. 2"%"2 Liste des correspondants de la pièce (non obligatoire). Un correspondant est un PS inscrit au DPPR. ##% Cas d'un correspondant identifié par son numéro adéli ##% ##'"88"## ##% Cas d'un correspondant identifié par son numéro ordre ##% %%8"('8 ##% ##% Liste des données complémentaires pouvant être renseignées par le SIH )%# )%##"" + &9&+ #6&# )%# )%# Commentaire sur la pièce (sera affiché en infobulle à l'écran) #/&# Pièce de synthèse? (facultatif) %,&%,& Pièce de détail? (facultatif) %%,& Pièce d urgence? (facultatif) %'#%,& SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 47/89

56 Acquittements Un acquittement de type «msgretourcreationpiece» est déposé dans le répertoire bndppr2sih en cas de succès. Voici un exemple d acquittement : #)# +1 Identifiant du message d'acquittement date et heure de production de l'acquittement "# #"#$%"""# # # #& code emetteur du dppr # # #& code destinataire (code du SIH) # Identifiant du message qui est acquitté " ####* # code de l'erreur, information ou avertissement -*2%8 libellé du message correlé au code +#<))))&+# ####* # ## L'identifiant est l'ippl du patient # Identifiant régional du patient (IPPR) ## # #%# Identifiant local du patient (IPPL) #"# #%# ## ## + -=...,-./.+ &% &% "# )#"#)# 2"#2 ## #)# SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 48/89

57 Erreurs, avertissements et informations Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté. Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR600 Erreur inattendue Erreur ERR607 Le dossier n existe pas dans le DPPR d ippr <ippr> et d ippl <ippl>. Ajout d une pièce impossible Erreur ERR608 Le dossier d ippr <ippr> et d ippl <ippl> est désactivé dans le DPPR. Ajout d une pièce impossible. Erreur ERR609 Les traits stricts du dossier ne correspondent pas aux traits stricts du dossier du DPPR d ippr <ippr> et d ippl <ippl>. Erreur ERR610 La pièce d identifiant local <idlocal> existe déjà dans le DPPR pour votre établissement. Erreur ERR611 Le professionnel de numéro Adéli <numadeli> n est pas inscrit au DPPR. Erreur ERR612 Le professionnel de numéro d ordre <numordre> n est pas inscrit au DPPR. Erreur ERR613 Le type de pièce <idttypepiece> spécifié n existe pas dans le DPPR. Erreur ERR614 La pathologie <idpathologie> spécifiée pour la pièce n existe pas dans le DPPR. Erreur ERR626 La donnée complémentaire de titre <titre> n est pas autorisée. Erreur ERR627 La valeur associée à la donnée de titre <titre> n est pas conforme. Avertissement AVT604 Les correspondants de numéro adéli <numadéli> ou de numéro d ordre <numordre> ne sont pas inscrits au DPPR. La pièce d identifiant <idlocalpiece> de type <idtypepiece> a tout de même été créée. Information INF606 La pièce d identifiant <idlocalpiece> de type <idtypepiece> a été créée correctement dans le dossier patient DPPR d ippr <ippr> et d ippl <ippl>. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 49/89

58 Particularité des données complémentaires Lors de la création d une pièce, le SIH peut préciser des données complémentaires (tag XML nommé donneescomplementaires). Une donnée complémentaire est une information facultative, plusieurs données complémentaires peuvent être précisées sur une même pièce Liste des données complémentaires La liste des données complémentaires est évolutive. ONCORA peut ajouter de nouvelles données complémentaires. A ce jour, les données complémentaires suivantes peuvent être utilisées. Titre de la donnée complémentaire Valeurs possibles Description piecedynamique oui / non Indique si la pièce mise à disposition par le SIH est dynamique (oui ou non) imagepresente oui / non Indique si une image est présente dans la base de données d imagerie du centre hospitalier. piecesynthese oui / non Détermine si la pièce est de synthèse piecedetail oui / non Détermine si la pièce est de détail pieceurgence oui / non Détermine si la pièce est d urgence. piecemere transfusion Identifiant local de la pièce Numérique supérieur à 0 Définit la pièce mère de la pièce envoyée (liaison basée sur l identifiant local de la pièce) La valeur définit le nombre de poches de sang transfusées au patient. Le code identifie le type de poche. beneficerisque oui / non Indique si la pièce contient une donnée bénéfice risque (information comuniquée au patient) Donnée «piecedynamique» Cette information indique si la pièce mise à disposition par le SIH est dynamique. Aucun traitement particulier hormis le stockage de cette information n en est fait à ce jour Donnée «imagepresente» Cette information indique si une image est associée à la pièce médicale dans la base de données d imagerie du centre hospitalier. Si cette information vaut «oui», un pictogramme indiquant la présence d une image sera affiché dans l écran de visualisation de la pièce au DPPR. Le champ «libellé» de la donnée complémentaire sera utilisé pour l affichage d une infobulle sur le pictogramme. Notez qu il n y a aucun intérêt à envoyer cette donnée complémentaire si la valeur est à «non» SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 50/89

59 Donnée «piecesynthese», «piecedetail» et «pieceurgence» Le SIH peut préciser sur chaque pièce les trois informations suivantes : - La pièce est elle une pièce de synthèse? (donnée piecesynthese) ; - La pièce est elle une pièce de détail? (donnée piecedetail) ; - La pièce est elle une pièce d urgence? (donnée pieceurgence)? Ces trois informations sont facultatives mais, si elles sont précisées, sont prises en compte prioritairement par la plate forme DPPR. En effet, le type d une pièce (précisé lors du versement de la pièce) détermine habituellement si les pièces de ce type sont Synthèse, Détail et Urgence. Si aucune information n est positionnée lors du versement de la pièce au DPPR, ce sont les informations du type qui sont utilisées. Dans le cas contraire, les informations précisées dans le message pièce sont prioritaires même si elles sont contradictoires avec les données du type de pièce. Si une information fournie par le SIH vient en contradiction avec une information du type de pièce (par exemple, le type de pièce est marqué Urgence et la pièce ne l est pas), ce sont les données fournies par le SIH qui sont prises en compte Donnée «piecemere» Le SIH peut préciser un lien de parenté entre pièces en spécifiant lors de la création d une pièce fille l identifiant de la pièce mère qui lui est associée. La valeur est un identifiant de pièce. )%# )%##"" + #888%'"# )%# )%# L identifiant à utiliser pour créer la liaison est l identifiant local de la pièce et non l identifiant de la pièce au DPPR car ce dernier n est pas connu des SIH et n est utilisé que pour des besoins internes au DPPR. Aucune vérification n est effectuée par la plate forme centrale sur l existence de la pièce mère ni même sur le fait que la pièce se référence elle-même Donnée «transfusion» Le SIH peut préciser la quantité et le type de poche transfusée au patient. )%# )%##"5" "8' + ## )%# )%# %34$%## #&%%# $%56(78 $# 89 $#%34##%#:5 %3#4+#%# $5*$# $;#$# %$##<7$#5 SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 51/89

60 Donnée «beneficerisque» Le SIH peut préciser si une pièce contient une information bénéfice risque faite au patient La valeur est oui ou non. )%# )%##"950" + ## )%# )%# Notez qu il n y a aucun intérêt à envoyer cette donnée complémentaire si la valeur est à «non». SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 52/89

61 Implémentation des traitements relatifs aux données complémentaires SWORD met en place un mécanisme générique sur la plate forme centrale permettant le déclenchement de traitements qui sont fonction des données complémentaires fournies dans les messages de création de pièces. Dans la version 2.0 du DPPR, seuls les traitements suivants sont réalisés : Traitement de l image présente (imagepresente) Traitement des informations piecesynthese, piecedetail et pieceurgence. Les autres données complémentaires ne sont pas ignorées par le DPPR mais ne font pas l objectif d un traitement particulier, elles sont simplement stockées dans la base de données du DPPR et pourront être utilisées par la suite Erreurs liées aux données complémentaires Deux erreurs peuvent être rencontrées par le DPPR lors du traitement des données complémentaires Titre de la donnée complémentaire inconnu Lorsque le DPPR traite les données complémentaires associées à une pièce, il se charge de vérifier si le titre de chaque donnée correspond à un titre autorisé. Le DPPR dispose en effet d un référentiel des données complémentaires autorisées. Si le titre ne correspond à aucune donnée complémentaire autorisée, l acquittement d erreur ERR626 est retourné au SIH. Notez que la vérification de la conformité du titre n est pas case sensitive Valeur non-conforme de la donnée complémentaire Si le titre d une donnée complémentaire est valide (il correspond à une donnée complémentaire autorisée), le DPPR effectue une validation du champ «valeur» par rapport à des contraintes paramétrées au niveau du DPPR pour chaque donnée complémentaire. Ces contraintes de validation indiquent par exemple que la valeur doit être «oui/non» ou bien comprise entre deux valeurs numériques. Si la valeur n est pas conforme, un acquittement d erreur ERR627 est retourné au SIH Envoi de la même donnée complémentaire Aucun dispositif n empêche le SIH d envoyer deux fois la même donnée complémentaire dans le même message XML. Dans ce cas, chaque donnée complémentaire est traitée par le DPPR mais seule la dernière valeur sera enregistrée. Si par exemple, le message contient la structure XML suivante : )%# )%##"" + /&0>&?@&&?)A&<+ ## )%# )%##"B" + ## )%# )%##"" + ## )%# )%# Dans cet exemple, la donnée complémentaire imagepresente se trouve deux fois dans le message. C est la valeur non qui sera associée à la pièce et non la valeur oui. Le libellé sera vide. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 53/89

62 5.9.2 Ajout d une pièce à un dossier (mode avec duplication) Présentation En mode duplication, l ajout d une pièce ressemble fortement à l ajout d une pièce en mode sans duplication. Les types de messages envoyés et reçus sont identiques. La seule nuance est la nécessité d associer au message XML une ou plusieurs pièces et les référencer dans le fichier XML. Trois familles de pièces peuvent être envoyées à la boîte noire : - Des pièces de type document : fichiers Word, images Jpeg, fichiers PDF, - Des pièces de type HTML ; - Des pièces structurées en XML Envoi d une pièce de type document Pour envoyer une pièce de type document, il faut : - Produire un fichier XML descriptif de la pièce (de type evenementsmedicauxdppr) : le fichier ne doit pas être déposé tout de suite dans le répertoire en entrée de la boîte noire. Les pièces jointes doivent être déposées dans un premier temps ; - Référencer dans le fichier XML le nom du ou des fichiers de la ou des pièces à dupliquer ; - Créer un sous répertoire dans le répertoire sih2bndppr/pieces_jointes qui porte le nom du fichier XML descriptif de la pièce (sans l extension XML) ; - Copier la ou les pièces à dupliquer dans le sous répertoire qui vient d être créé : attention, deux fichiers pièces jointes ne peuvent porter le même nom, le SIH doit donc garantir l unicité des noms des pièces jointes pour une même pièce. Pour référence la ou les pièces à dupliquer, il faut ajouter (dans l élément evenementmedicaldppr), l élément XML suivant : %= l'attribut naturepiece indique le type de pièce envoyé (doc pour document, img pour image par exemple %=# contient le nom du fichier joint (le fichier doit être déposé en même temps que le flux xml dans un emplacement accessible par la boîte noire) >#=>#= %= %= Dans l exemple ci-dessus, la pièce se nomme piece1.doc et est déposée dans (répertoire sih2bndppr/pieces_jointes/creationpiece0010). L élément «piecesjointes» encapsule une liste de pièces jointes. Chaque pièce jointe (si la pièce médicale est composée de plusieurs fichiers), est identifié par un élément «piecejointe». SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 54/89

63 Pour chaque pièce jointe : - Il faut préciser la nature du fichier (nature de pièce HPRIM) : o img : image ; o vd : video ; o vds : video sonorisée ; o son : son ; o ltt : lettre ; o m : mémo ; o doc : document ; o tab : tableau ; o grp : graphique - Il faut ensuite préciser le nom de fichier de la pièce jointe. Le fichier doit être accessible par la boîte noire. Des erreurs sont déclenchées si la pièce ne peut être récupérée par la boîte noire. Notez que l envoi de pièces en mode duplication n est pas possible via MSMQ Envoi d une pièce de type HTML L envoi d une pièce de type HTML est identique à l envoi d une pièce de type document. La pièce HTML doit être envoyée en pièce jointe : c est en réalité le fichier HTML que le SIH va produire qui va être envoyé en pièce jointe. Le schéma ci-dessous illustre l envoi d une pièce de type HTML : SIH BN DPPR Serveur Web du SIH (1) Accès au site Web du SIH pour récupérer le flux HTML (3) Envoi du fichier XML descriptif de la pièce et du fichier temporaire HTML (2) Création d un fichier temporaire HTML SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 55/89

64 Envoi d une pièce structurée en XML Une pièce structurée en XML est une pièce dont le contenu peut être structuré sous forme de fichier XML. La méthode d envoi de ce type de pièce ne diffère pas de l envoi des autres types. Le SIH doit produire deux fichiers XML : - Un fichier XML de type «evenementsmedicauxdppr» pour décrire la pièce à mettre à disposition : ne pas déposer ce fichier tant que la pièce jointe n est pas déposée.; - Un fichier XML structuré pour représenter le contenu de la pièce (déposé comme une pièce jointe classique sur la boîte noire). La boîte noire et le SIH ne vérifient pas le formalisme de la pièce XML. Le SIH doit garantir que la pièce est conforme («well formed XML» notamment) Exemple de fichier Idem exemple au avec l ajout de l élément piecesjointes dans le fichier Acquittements Idem acquittement SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 56/89

65 Erreurs, avertissements et informations Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR505 La pièce <cheminpiece> associée au message n est pas accessible. Erreur ERR600 Erreur inattendue Erreur ERR607 Le dossier n existe pas dans le DPPR d ippr <ippr> et d ippl <ippl>. Ajout d une pièce impossible Erreur ERR608 Le dossier d ippr <ippr> et d ippl <ippl> est désactivé dans le DPPR. Ajout d une pièce impossible. Erreur ERR609 Les traits stricts du dossier ne correspondent pas aux traits stricts du dossier du DPPR d ippr <ippr> et d ippl <ippl>. Erreur ERR610 La pièce d identifiant local <idlocal> existe déjà dans le DPPR pour votre établissement. Erreur ERR611 Le professionnel de numéro Adéli <numadeli> n est pas inscrit au DPPR. Erreur ERR612 Le professionnel de numéro d ordre <numordre> n est pas inscrit au DPPR. Erreur ERR613 Le type de pièce <idttypepiece> spécifié n existe pas dans le DPPR. Erreur ERR614 La pathologie <idpathologie> spécifiée pour la pièce n existe pas dans le DPPR. Erreur ERR626 La donnée complémentaire de titre <titre> n est pas autorisée. Erreur ERR627 La valeur associée à la donnée de titre <titre> n est pas conforme. Avertissement AVT604 Les correspondants de numéro adéli <numadéli> ou de numéro d ordre <numordre> ne sont pas inscrits au DPPR. La pièce d identifiant <idlocalpiece> de type <idtypepiece> a tout de même été créée. Information INF607 La pièce identifiant <idlocalpiece> de type <idtypepiece> a été créée correctement dans le dossier patient DPPR d ippr <ippr> et d ippl <ippl> et dupliquée par la boîte noire Modification d une pièce dans un dossier (mode sans duplication) Le message de modification d une pièce n existe pas en tant que tel. Pour modifier une pièce, le SIH doit d abord envoyer une demande d invalidation de la pièce (cf. paragraphe 3.8.5), puis renvoyer la nouvelle pièce en mode création (cf. paragraphe 3.8.1) Modification d une pièce dans un dossier (mode avec duplication) Le message de modification d une pièce n existe pas en tant que tel. Pour modifier une pièce, le SIH doit d abord envoyer une demander d invalidation de la pièce (cf. paragraphe 3.8.5), puis renvoyer la nouvelle pièce en mode création (cf. paragraphe 3.8.2). SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 57/89

66 5.9.5 Données évolutives Les données évolutives sont des informations (des pièces) qui évoluent postérieurement à leur mise à disposition au sein du DPPR. L évolution concerne les données médicales contenues dans la pièce et non les méta données associées à la pièce En mode sans duplication Dans ce mode, le SIH héberge les données évolutives. Il va de ce fait les restituer au DPPR lors de la consultation de la pièce par un utilisateur (Cf. service Web). Si une donnée évolue par exemple (changement des données administratives par exemple), le SIH n a pas à informer le DPPR de cette évolution par un message XML car la pièce n est pas dupliquée En mode duplication Dans ce mode, les pièces dynamiques (les fichiers qui constituent la pièce dynamique) sont stockées par la boîte noire. Ainsi, si elles sont modifiées, elles doivent de nouveau être mises à disposition de la boîte noire. Pour cela, le SIH doit envoyer un message de modification de pièce et transmettre de nouveau le ou les fichiers correspondants. Les fichiers qui étaient déjà présents sur la boîte noire sont écrasés par les nouveaux fichiers. Le message de modification de pièce n est jamais transmis au DPPR, seule la boîte noire en est informée. Aucune méta donnée de la pièce ne peut être modifiée dans ce contexte Exemple de fichier de modification d une pièce dynamique Le message à envoyer est identique à un message de création de pièce. Seule l action est différente : 5 Pour spécifier les nouvelles pièces jointes, il faut utiliser (comme en création avec duplication), la structure XML suivante : %= %=# >#=>#= %= %=# >#=;>#= %= %= Les autres éléments du message (entête du message, données patient, données de la pièce) doivent être précisés car ils sont utilisés pour retrouver dans la boîte noire la pièce correspondante, cependant, ils ne permettent pas de modifier la pièce. La pièce est retrouvée par son appartenance à un dossier (IPPR) et par son identifiant local unique. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 58/89

67 5.9.6 Invalidation d une pièce d un dossier Présentation Lorsqu une pièce est portée à un dossier, elle est considérée comme «valide» donc exploitable par les professionnels de santé. Cependant, une erreur a pu être effectuée dans la pièce et elle doit être déclarée comme invalide et ce pour informer les professionnels. La pièce est toujours visible dans le dossier, mais lors de son affichage en consultation, elle sera marquée comme «invalidée». Ainsi en cas de désactivation et si la boîte noire duplique la pièce, la pièce n est pas supprimée physiquement de la boîte noire. Elle peut de ce fait toujours être consultée par les professionnels de santé. Dans le message d invalidation d une pièce, le SIH précise un champ nommé «datevalidation». Ce champ doit contenir la date à laquelle la pièce est déclarée comme invalidée. Lorsque le DPPR va enregistrer l invalidation de la pièce, il va stocker cette date dans un champ prévu à cet effet. La date de validation initiale de la pièce n est pas perdue au niveau du DPPR. Remarque : une pièce invalidée ne pourra pas ensuite est revalidée : il sera nécessaire de renvoyer une nouvelle pièce en mode création. La nouvelle pièce doit porter un nouvel identifiant de pièce (identifiant local de la pièce dans le SIH) et ce pour garantir que l historique des données de la pièce soit consultable. Le SIH doit donc générer un nouvel identifiant local de pièce pour réactiver une pièce désactivée. La plate forme centrale DPPR doit disposer de l ensemble des informations sur la pièce pour être en mesure de l invalider : - Son identifiant local, - Son type de pièce, - Sa pathologie, - L ippr du dossier correspondant. Si ces trois informations ne sont pas renseignées correctement, la plate forme centrale refusera l invalidation de la pièce. Par exemple, si vous ne fournissez que l identifiant local de la pièce mais ne remplissez pas correctement les informations type de pièce et pathologie, l invalidation de la pièce n aura pas lieu. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 59/89

68 Exemple de message Identifiant unique du message Date et heure de production du message par le SIH "# #"#8$%"""# # # #& Code de l'emetteur (code du SIH) # # #& Code du destinataire (code du DPPR) # 5 "%#$8" # %# '' %# %#9%# %# %# # Représente le patient concerné par la pièce % Identifiant local dans l'établissement : IPPL #%#&& #'(((((((# # Identifiant régional : IPPR #%#%#)&# # ## #%# %# & ')' %# %#:0%# %# ( (#8 ( Lieu de naissance ( Pays de naissance %&%& Code postal de naissance %( ( %# & % "# # "%# "# # + SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 60/89

69 Commentaire sur l'invalidation #/+.*$,-.CD-*7,-,$-+*# Données DPPR de la pièce Identifiant local de la pièce dans le SIH 8%"'( Libellé de la pièce tel qu'il sera affiché dans le DPPR + );%"%"+ &% '&% %% "% )#"%)# Pour une invalidation, préciser ici la date d invalidation 2"%"2 ##% ##% ##'"88"## ##% ##% %%8"('8 ##% ##% SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 61/89

70 Acquittements # +1 Identifiant du message d'acquittement date et heure de production de l'acquittement "# #"#$%"""# # # #& code emetteur du dppr # # #& code destinataire (code du SIH) # Identifiant du message qui est acquitté " ####* # code de l'erreur, information ou avertissement -*2%( libellé du message correlé au code +#<)))6)&+# ####* # ## L'identifiant est l'ippl du patient # ## # #%# #"# #%# ## ## + -=...,-./.+ &% &% "# )#"#)# 2"#2 ## # SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 62/89

71 Erreurs, avertissements et informations Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR505 La pièce <cheminpiece> associée au message n est pas accessible. Erreur ERR600 Erreur inattendue Erreur ERR618 Le dossier n existe pas dans le DPPR d ippr <ippr> et d ippl <ippl>. Invalidation d une pièce impossible Erreur ERR619 Le dossier est désactivé dans le DPPR d ippr <ippr> et d ippl <ippl>. Invalidation de la pièce impossible. Erreur ERR617 La pièce d identifiant <idpiecelocal> n existe pas dans le dossier d ippr <ippr> et d ippl <ippl>. Elle n a pas été désactivée. Information INF610 La pièce identifiant <idlocalpiece> de type <idtypepiece> a été invalidée correctement dans le dossier patient DPPR d ippr <ippr> et d ippl <ippl>. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 63/89

72 5.9.7 Gestion des équipes Présentation Les équipes médicales dans le DPPR sont constituées de membres (des professionnels de santé) et sont un élément majeur dans la gestion des habilitations. Le message de gestion des équipes envoyé par le SIH permet : - De créer de nouvelles équipes, - De modifier des équipes existantes en modifiant les membres qui s y trouvent, - De supprimer des équipes. Un message de gestion d équipe envoyé par le SIH concerne une et une seule équipe. Si plusieurs équipes doivent être créées par exemple, un message par équipe doit être envoyé : ce procédé est retenu globalement au sein du DPPR Cinématique La cinématique présentée ci-dessous vaut pour les trois actions possibles (création, modification ou suppression). SIH BN DPPR Envoi à la boîte noire Message XML de type «evenementsequipesdppr» Action= création, modification, suppression Contient les données de l équipe (son nom) et les membres de notification Erreur ou avertissement Pièce créée dans le dossier DPPR Message XML de type «msgretourcreationequipedppr» ou «msqretourmodificationequipedppr» ou «msgretoursuppressionequipedppr» SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 64/89

73 Création d une équipe Pour créer une équipe au sein du DPPR, le SIH doit fournir : - le nom de l équipe ; - la liste éventuelle des membres de l équipe. Le nom de l équipe doit être unique au sein du DPPR. La liste des membres peut être fournie à posteriori dans un message de modification. Si le SIH n envoi pas la liste des membres de l équipe, l équipe est créée vierge. Chaque membre de l équipe est identifié par son numéro adéli ou son numéro d ordre Exemple de message de création d équipe Pour qu une création d équipe soit effectuée, l action doit être «création». Voici un exemple de message XML de création d équipe :?% Identifiant unique du message Date et heure de production du message par le SIH "# #"#$%"""# # # #& # # #& #?% ) %?%.0?% % +# +# ##'"88"## +# +# ##'"88"## +# +# ##'"88"## +# +#?%?% Ce message créé une équipe nommée «Equipe 1» composée de trois membres (chaque membre est identifié par son numéro Adéli) Acquittement Un message de type «msgretourcreationequipedppr» est retourné en réponse à une création. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 65/89

74 Erreurs, avertissements et informations Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR600 Erreur inattendue Erreur AVT615 L équipe <nom équipe> existe déjà pour votre établissement. Le DPPR a transformé votre message de création en modification de l équipe. L équipe a été correctement modifiée. Information INF617 L équipe <nom équipe> a été créée correctement au DPPR pour votre établissement. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 66/89

75 Modification d une équipe Présentation Le SIH peut demander la modification d une équipe. La modification d une équipe ne peut porter sur son nom car c est l identifiant de celle-ci. Une modification d équipe est en fait la modification de ses membres. Le message de modification d une équipe annule et remplace les membres existants d une équipe si bien que le SIH peut, dans un message de modification d équipe, ajouter ou supprimer un ou plusieurs membres. Chaque membre de l équipe est identifié par son numéro adéli Exemple de message?% Identifiant unique du message Date et heure de production du message par le SIH "# #"#$%"""# # # #& # # #& #?% 5 %?%.0?% % +# +# ##'"88"## +# +# ##'"88"## +# +#?%?% Dans cet exemple de message, l équipe 1 est modifiée, elle sera désormais composée de deux membres. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 67/89

76 Erreurs, avertissements et informations Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR600 Erreur inattendue Erreur AVT614 L équipe <nom équipe> n existait pas pour votre établissement. Votre demande de modification a été transformée en création. L équipe a été correctement créée. Information INF618 L équipe <nom équipe> a été modifiée correctement au DPPR pour votre établissement Suppression d une équipe Présentation Le SIH peut supprimer une équipe. Le message de suppression d une équipe ne nécessite pas la transmission de la liste des membres car toute l équipe sera supprimée Exemple de message?% Identifiant unique du message Date et heure de production du message par le SIH "# #"#$%"""# # # #& # # #& #?% %?%.0?% %?%?% Dans cet exemple, l équipe 1 va être supprimée pour le SIH. Les membres de cette équipe seront tous désassociés de l équipe. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 68/89

77 Erreurs, avertissements et informations Type Code Description Erreur ERR500 Erreur inattendue Erreur ERR501 L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Erreur ERR502 Le destinataire du message n est pas le DPPR, le message est rejeté Erreur ERR503 La grammaire du message XML n est pas respectée. Erreur ERR504 Erreur système lors de la tentative d envoi du message au DPPR. Erreur ERR600 Erreur inattendue Avertissement AVT613 L équipe <nom équipe> n a pas été supprimée, elle n existe pas pour votre établissement. Information INF619 L équipe <nom équipe> a été supprimée correctement au DPPR pour votre établissement. Comme vous pouvez le constater, si le SIH tente de supprimer une équipe qui n existe pas, un avertissement (AVT613) est retourné et non une erreur INSCRIPTION D UN PROFESSIONNEL DE SANTE AU DPPR Cette fonctionnalité n est pas disponible en v2.0. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 69/89

78 6. FLUX SYNCHRONES ENTRE BN ET SIH 6.1 PRESENTATION Lorsqu un utilisateur souhaite visualiser une pièce sur le site Web du DPPR, le DPPR va rerouter la demande de pièce vers la boîte noire du SIH d où provient la pièce. La demande est synchrone car l utilisateur doit obtenir une réponse très rapide. Pour effectuer cette communication, les Web Services apparaissent comme la solution choisie par SWORD pour le développement de la plate forme DPPR 6.2 CINEMATIQUE La cinématique de travail est la suivante : - L utilisateur demande une pièce au DPPR ; - Le DPPR reçoit une requête http provenant du poste de travail de l utilisateur ; - Le DPPR recherche la boîte noire qui peut lui fournir la pièce demandée ; - Le DPPR appelle un service Web de la boîte noire en lui demandant la pièce. Chaque pièce est identifiée au sein du DPPR par un numéro unique ; - La boîte noire reçoit la requête et peut : o o Soit répondre immédiatement (mode duplication). Le service Web de la boîte noire va donc répondre immédiatement en attachant à sa réponse le ou les fichiers qui représentent la pièce demandée ; Soit interroger le SIH car la pièce n est pas stockée dans la boîte noire. - En mode sans duplication, un service Web, développé par le SIH (selon une préconisation DPPR), est appelé. L identifiant local de la pièce lui est passé en paramètre. Le service Web doit retrouver la pièce au sein du SIH et ensuite la retourner en réponse sous forme d un attachement de fichier ; - La boîte noire réceptionne la réponse du SIH (et donc le ou les fichiers envoyés en attachement) et réponds au DPPR en renvoyant la pièce demandée ; - Le DPPR réceptionne (soit directement de la boîte noire, soit indirectement du SIH), le ou les fichiers demandés, les encapsule dans un flux HTML et les retourne à l utilisateur ; - Le navigateur Internet de l utilisateur affiche le flux HTML dans lequel se trouve le ou les fichiers demandés. 6.3 LES SERVICES WEB L objectif premier des Web Services est de rendre toute plateforme interopérable avec les autres. Si deux plateformes sont complètement hétérogènes (au niveau du système et du langage), les Web Services vont tout de même leur permettre de communiquer de manière transparente et tout à fait cohérente. Pour cela, des protocoles ou langages standards d échange sont utilisés : XML et SOAP notamment. La technologie des services Web s appuie sur le protocole HTTP. Celui-ci est un standard réseau éprouvé qui fait partie des briques de base de la technologie. Cela implique au niveau sécurité de ne pas avoir à reconfigurer le firewall, si celui-ci est prévu pour laisser passer ce type de trames. Ce type de flux fait appel aux deux modes de fonctionnement de la Boîte Noire. Si celle-ci est en mode duplication, elle renvoie directement la pièce au DPPR. Dans le cas d une non duplication, elle va elle-même appeler un Web Service situé au niveau du SIH, pour lui fournir la pièce. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 70/89

79 6.4 FONCTIONNEMENT DETAILLE DANS LE PROJET DPPR Présentation Les Web Services permettent au client d appeler une méthode qui effectue un traitement métier et renvoie le résultat de ce traitement dans un flux de réponse. Les échanges s effectuent par un flux XML, répondant à un standard de mise en forme : SOAP. La complexité de SOAP a nécessité l implémentation d une API de haut niveau, appelé proxy, permettant son interprétation. Il suffit donc pour le client d appeler cette méthode via le proxy. Le proxy masque au client la complexité de SOAP. Dans le cas présent, la Boîte Noire (le client) va appeler la méthode du Service Web du SIH permettant de récupérer la pièce, en lui passant en paramètre l identifiant de la pièce recherchée. Le proxy va instancier le Web Service en établissant une session, et en lui envoyant le flux de requête SOAP contenant le nom de la méthode appelée et l identifiant de la pièce souhaitée. Le SIH va alors rechercher la pièce et la renvoyer via le Service Web dans un flux SOAP en l attachant (comme une pièce jointe). La génération du flux SOAP est réalisée par des API API de haut niveau que le SIH peut se procurer (exemple : SOAP Toolkit pour le monde Microsoft). Le proxy client (la boîte noire) va alors récupérer la pièce et la Boîte Noire va pouvoir la traiter. Il est donc très simple d implémenter le flux. Boîte Noire DPPR Traitement métier (méthode) SIH identifiant 3 IdP Session Envoi de l identifiant (flux SOAP-XML) 2 Appel méthode + identifiant 1 Client 4 SQL 5 6 Web Service Récupération pièce après identification Envoi pièce attachée (flux SOAP-XML) 7 Proxy : Transformation appel méthode en flux SOAP- XML et inverse 8 SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 71/89

80 6.4.2 Paramètres entrée du service Web Lorsque la boîte noire interroge le service Web du SIH, elle invoque la méthode «getpiece» du service Web du SIH et lui transmet les trois paramètres suivants : Nom Type Description IPPR Entier IPPR du dossier patient IdLocalPiece Chaîne Identifiant local de la pièce IdTypePiece Entier Identifiant du type de pièce (Cf. codification du DPPR). IdEts Entier Identifiant de l établissement Voici un exemple de signature de la méthode getpiece (ici en C#.Net) : @*?+: Le SIH doit implémenter, dans la méthode getpiece, les mécanismes lui permettant de retrouver la pièce à partir des trois paramètres passés à la méthode. Notez que les paramètres sont transmis au service Web en utilisant le protocole SOAP. Ils sont donc encapsulés dans une enveloppe SOAP XML. Cependant, SWORD conseille au SIH de mettre en œuvre une API de haut niveau qui masque les mécanismes SOAP (MS Soap Toolkit pour le monde Microsoft, ou Apache Axis pour le monde Java par exemple). Le SIH n a dons pas à connaître précisément comment constituer un flux conforme SOAP, l API de haut niveau s en charge automatiquement Paramètres de sortie du service Web Deux scénarios peuvent se produire : - Erreur : le SIH ne peut pas retrouver la pièce. Il doit retourner une erreur à la boîte noire ; - OK : le SIH a retrouvé la pièce (un ou plusieurs fichiers) et doit la retourner à la boîte noire. La méthode getpiece retourne un code (sous forme d un entier). Ce code peut avoir les valeurs suivantes : - 0 : exécution OK ; - < 0 : erreur Erreur Erreur dans le service Web La méthode doit retourner un code inférieur à 0 à la boîte noire dans le code retour de la méthode getpiece. C est la seule chose à effectuer dans ce contexte. La boîte noire interprète ensuite ce code et affiche une erreur à l utilisateur en lui indiquant que la pièce n a pu être trouvée Erreur de timeout Si le service Web du SIH n est pas en mesure de répondre assez rapidement (timeout paramétrable dans la boîte noire), la boîte noire va répondre au DPPR pour l informer que le fichier n a pu être délivré par le SIH. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 72/89

81 Ok Deux actions doivent être effectuées en cas de succès lors de la recherche de la pièce jointe Envoi du ou des fichiers Le ou les fichiers doivent être attachés au message SOAP qui est retourné à la boîte noire. Pour cela, il faut utiliser une API de haut niveau permettant la gestion des attachements DIME. Le principe est simple, il suffit, comme cela est effectué dans le contexte d un envoi de mail, d attacher à la réponse SOAP, les fichiers qui doivent être retournés. Pour chaque fichier un type de fichier peut être précisé mais dans le contexte du DPPR le format «inconnu» doit être précisé. Toutes les pièces (documents, html ou xml) sont envoyées sous forme de pièce jointe par le service Web. Aucune mise en page ne doit être effectuée par le SIH. La mise en page de la pièce est effectuée par la plate forme centrale du DPPR. Le SIH se contente de retourner la pièce telle qu elle est gérée dans son système d information. La plate forme DPPR s assure que la pièce pourra être affichée sur n importe quel environnement (dans la limite des données envoyées par le SIH : si le SIH transmet un type de fichier non reconnu par la plate forme cliente, la plate forme DPPR ne pourra pas effectuer les transformations nécessaires). Le SIH doit absolument préciser le type mime du fichier qu il fournit en attachement. Le type mime est utilisé par le site Internet du DPPR pour connaître les actions à réaliser lorsque la pièce est réceptionnée (mise en forme XSL, production de PDF, présentation tel quel). Voici, ci-dessous un exemple de code C# pour l attachement d un fichier à une réponse SOAP : %B## $%$#,C 6D$#;#:,%)#%)" %,%)5%)E )#$D F6@A&%>#?5'GF@ HI #&#5:E D<#;#$% #%)556:E Un service Web d exemple en ASP/SOAP Toolkit seront fournis aux SIH qui le souhaitent : un exemple en dotnet et un exemple en Visual Basic 6 / Soap Toolkit Envoi du code succès Le code de retour doit être envoyé comme en cas d erreur. Sa valeur doit être «0» Mise en forme par le DPPR Trois types de pièces sont distingués par le DPPR : Les pièces XML ; Les pièces convertibles en PDF ; Les pièces non convertibles en PDF Pièces XML Les pièces XML sont retournées au DPPR et mise en forme par l application d une feuille de style XSL. Il y a une feuille de style par type de pièce. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 73/89

82 Pièces convertibles en PDF Les pièces non xml peuvent être converties en PDF par la plate forme centrale du DPPR. Le tableau ci-après liste les extensions de fichiers pouvant être converties en PDF par le DPPR et celles qui ont été configurées pour l être par la plate forme DPPR. Les extension non marquées comme converties par le DPPR sont restituées telles quelles à l utilisateur. Extension de fichier Configuré DPPR? (*) ANS ASC AVI AVS BMP CMYK CUT DCM DCX DIB DOC DPX EMF EPDF EPI EPS EPSF EPSI EPT FAX FITS FPX G3 GIF GRAY HPGL HTML ICO JBIG JNG JP2 JPC JPEG/JPG MAT MHTML MONO MNG MPEG/MPG M2V MTV OTB P7 PAL PALM PBM OUI OUI OUI SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 74/89

83 PCD PCDS PCL PCT PCX PDB PDF PFA PFB PGM PICON PICT PIX PNG PPM PPT PS PS2 PS3 PSD PTIF PWP RGB RLA RLE RTF SCT SFW SGI SUN SVG TGA TIFF TIM TXT VICAR VIFF WBMP WK4 WPD WPG WPS WRI XBM XCF XLS XML XPM XWD OUI OUI OUI OUI OUI OUI (*) Les extensions non configurées au DPPR sont retournées telles qu'elles au client pour visualisation SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 75/89

84 SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 76/89

85 Pièces non convertibles en PDF Certaines pièces ne sont pas converties en PDF par le DPPR. Les raisons de cette non conversion sont : L impossibilité technique de faire la conversion (le convertisseur de PDF ne peut le faire) ; La non nécessité de le faire : le format d origine du fichier ne nécessite pas la conversion en PDF (par exemple un fichier JPEG). 6.5 CONTRAINTES DE SYNCHRONISATION DES HEURES Etant donné que le protocole SOAP qu utilisent les services Web pour communiquer implémente un procédé d expiration des messages, il est impératif que les machines qui communiquent entre elles (le DPPR, la boîte noire et le serveur Web qui héberge le service Web du SIH) soient synchronisées en termes d heures et de date. Si ce n est pas le cas, un message envoyé par un acteur peut être considéré comme périmé par un autre acteur. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 77/89

86 7. ANNEXES 7.1 CODES ERREURS Code erreur ERR500 ERR501 ERR502 ERR503 ERR504 ERR505 ERR600 ERR601 ERR602 Erreur inattendue Message d erreur L émetteur du message n est pas conforme avec l établissement configuré dans la boîte noire. Le destinataire du message n est pas le DPPR, le message est rejeté La grammaire du message XML n est pas respectée (+ détail de l erreur de grammaire). Erreur système lors de la tentative d envoi du message au DPPR. La pièce <cheminpiece> associée au message n est pas accessible. Erreur inattendue Inutilisée Création du patient d ippr <ippr> et d ippl <ippl> impossible : les traits stricts envoyés dans le message XML diffèrent des traits stricts STIC du dossier dans le DPPR. ERR603 Activation / désactivation du dossier d ippr <ippr> et d ippl <ippl> pour votre SIH impossible. Le dossier n existe pas dans le DPPR. ERR604 ERR605 ERR606 ERR607 ERR608 ERR609 ERR610 ERR611 ERR612 ERR613 ERR614 ERR616 ERR617 ERR618 ERR619 ERR620 ERR621 ERR622 ERR623 Non utilisé Le dossier d ippr <ippr> et d ippl <ippl> ne peut être activé/désactivé pour votre SIH, il n existe pas pour votre établissement. Non utilisée Le dossier n existe pas dans le DPPR d ippr <ippr> et d ippl <ippl>. Ajout d une pièce impossible Le dossier d ippr <ippr> et d ippl <ippl> est désactivé dans le DPPR. Ajout d une pièce impossible. Les traits stricts du dossier ne correspondent pas aux traits stricts du dossier du DPPR d ippr <ippr> et d ippl <ippl>. La pièce d identifiant local <idlocal> existe déjà dans le DPPR pour votre établissement. Le professionnel de numéro Adéli <numadeli> n est pas inscrit au DPPR. Le professionnel de numéro d ordre <numordre> n est pas inscrit au DPPR. Le type de pièce <idttypepiece> spécifié n existe pas dans le DPPR. La pathologie <idpathologie> spécifiée pour la pièce n existe pas dans le DPPR. La pièce d identifiant <idlocalpiece> n existe pas dans le dossier du DPPR d ippr <ippr> et d ippl <ippl>. La pièce d identifiant <idpiecelocal> n existe pas dans le dossier d ippr <ippr> et d ippl <ippl>. Elle n a pas été désactivée. Le dossier n existe pas dans le DPPR d ippr <ippr> et d ippl <ippl>. Invalidation d une pièce impossible Le dossier est désactivé dans le DPPR d ippr <ippr> et d ippl <ippl>. Invalidation de la pièce impossible. Non utilisée Non utilisée Activation/désactivation du dossier impossible pour le DPPR. Le dossier n existe pas dans le DPPR. Activation/désactivation du dossier impossible pour le DPPR. Les traits stricts envoyés dans le message XML diffèrent des traits stricts STIC du dossier dans le DPPR. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 78/89

87 ERR624 ERR625 ERR626 ERR627 ERR700 ERR701 Le dossier d ippr <ippr> et d ippl <ippl> n est pas associé à votre établissement, il ne peut donc pas être activé/désactivé au DPPR par votre SIH. L équipe <nom équipe> n a pas été créée : une équipe portant le même nom existe déjà pour votre établissement. La donnée complémentaire de titre <titre> n est pas autorisée. La valeur associée à la donnée de titre <titre> n est pas conforme. Erreur inattendue (provient du STIC) L IPPR <ippr> n existe pas ou n est pas correct (erreur en provenance de STIC). 7.2 CODES AVERTISSEMENTS Code avertissemen t AVT601 AVT602 AVT603 AVT604 AVT605 AVT606 AVT607 AVT610 AVT612 AVT613 AVT614 AVT615 AVT701 Message d avertissement Le dossier d Ippr <ippr> existe déjà pour votre établissement. Non utilisé Non utilisé Les correspondants de numéro adéli <numadéli> ou de numéro d ordre <numordre> ne sont pas inscrits au DPPR. La pièce identifiant <idlocalpiece> de type <idtypepiece> a tout de même été créée. Le dossier d ippr <ippr> et d ippl <ippl> a été supprimé du DPPR. Non utilisé Le dossier d ippr <ippr> a été restauré du DPPR. Non utilisé Le dossier d ippr <ippr> et d ippl <ippl> a été associé à votre établissement mais il est pour l instant déclaré comme supprimé dans le DPPR. Vous ne pouvez donc pas lui associer des pièces. L équipe <nom équipe> n a pas été supprimée, elle n existe pas pour votre établissement. L équipe <nom équipe> n existait pas pour votre établissement. Votre demande de modification a été transformée en création. L équipe a été correctement créée. L équipe <nom équipe> existe déjà pour votre établissement. Le DPPR a transformé votre message de création en modification de l équipe. L équipe a été correctement modifiée. Le dossier d ippr <ippr> a été créé correctement mais il est déclaré comme supprimé par STIC. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 79/89

88 7.3 CODES INFORMATIONS Code information INF601 INF602 INF603 INF604 INF605 INF606 INF607 INF608 INF609 INF610 INF611 INF612 INF613 INF614 INF615 INF616 INF617 INF618 INF619 INF701 Message d information Création du dossier patient régional d ippr <ippr> et d ippl <ippl> effectué et terminé. Non utilisé Le dossier patient d ippr <ippr> et d ippl <ippl> a été désactivé correctement pour votre SIH. Le dossier patient d ippr <ippr> et d ippl <ippl> a été activé correctement pour votre SIH. Le dossier patient d ippr <ippr> et d ippl <ippl> a été désactivé correctement pour le DPPR. La pièce identifiant <idlocalpiece> de type <idtypepiece> a été créée correctement dans le dossier patient DPPR d ippr <ippr> et d ippl <ippl>. La pièce identifiant <idlocalpiece> de type <idtypepiece> a été créée correctement dans le dossier patient DPPR d ippr <ippr> et d ippl <ippl> et dupliquée par la boîte noire. Non utilisé Non utilisé La pièce identifiant <idlocalpiece> de type <idtypepiece> a été invalidée correctement dans le dossier patient DPPR d ippr <ippr> et d ippl <ippl>. Non utilisée Non utilisée Non utilisée Non utilisée Non utilisée Non utilisée L équipe <nom équipe> a été créée correctement au DPPR pour votre établissement. L équipe <nom équipe> a été modifiée correctement au DPPR pour votre établissement. L équipe <nom équipe> a été supprimée correctement au DPPR pour votre établissement. Non utilisé SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 80/89

89 7.4 PARAMETRES DE LA BOITE NOIRE Le paramètres décrits dans ce paragraphe sont contenus dans le fichier de configuration dppr.config stocké dans le répertoire d installation et le sous répertoire «config». La variable d environnement «DPPR_CONFIG» indique l emplacement du fichier de configuration. Deux catégories de paramètres sont identifiées : Les paramètres applicatifs (peuvent être modifiés par chaque SIH) Les paramètres systèmes (ne doivent pas être modifiés par le SIH car nécessitent une connaissance approfondie du fonctionnement de la boîte noire) Les paramètres applicatifs "# $ % "#& $ ' ( ) $% ((( ) " " "#*+,#$-."/%$( (( /" 0 " 2 3 0* % 1 0* % 1 0* % 1 0 % 1* 3/ 0 3$ $$ (("#4 -( $ (5 ("# 3/ $ --. &( /0 /( ( 6 & '1('4 ( $ ( ,* 2-2 ;< 0 ;< ;< " 0/-4 $ 3$ $ /- ( $ $ /- ( 3 ( - $ &, " 3( :,* $54( $54( < $ < $ < $ ' 1( - -* - * 1( : * ="#7." 7."$5 ="#(( 5 % SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 81/89

90 7.4.2 Les paramètres systèmes " " --.%$ ((/" 3 % --. # % %. --. # % % "# 3 %. "# # % "#.. /.. "#. "# /.0%.0..".-? 6 3 &$ --. 3&--. 3 &( % --. 3&( % &$ "# 3 $( "# 3&( "#.(.( ( "#.( $ "#.( ( --. ( ( & --..( %>(*5 --..( *.( >*% 1("#.( >*.( >*.( >* ;>.( (@ 5< 5 -(*( 6 4(( Particularité des mots de passe Tous les mots de passe stockés dans le fichier de configuration peuvent être cryptés par le SIH. Pour cela, la boîte noire est livrée avec un utilitaire de chiffrement (dppr.util.securite.exe) que le SIH peut utiliser pour chiffrer les mots de passe et ensuite les copier dans le fichier de configuration. Notez que si vous utilisez l outil «Configuration de la boîte noire» installé sur la boîte noire, les mots de passes seront automatiquement chiffrés. 7.5 SAUVEGARDE DE LA BOITE NOIRE Deux jobs SQL Server / MSDE sont installés avec la boîte noire, voici la description de ces deux jobs Sauvegarde complète de la base de données Un travail SQL Server/MSDE se charge, chaque soir à 00h00 de procéder à la sauvegarde complète de la base de données «boitenoire». La sauvegarde est effectuée dans un fichier nommé «boitenoire.bak» stocké dans le répertoire «<répertoire d installation>\sauvegardedppr\<jour de la semaine>» Sauvegarde des logs de la base de données Un travail SQL Server/MSDE se charge, chaque quart d heure, de sauvegarder le journal des transactions. La sauvegarde du journal des transactions est effectuée dans le même fichier que la sauvegarde complète de la base de données (<répertoire d installation>\sauvegarde\<jour de la semaine>\boitenoire.bak). SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 82/89

91 7.6 ANTIVIRUS La boîte noire, dans la version packagée livrée aux SIH, ne contient pas de logiciel antivirus. Les flux sont cependant filtrés par un antivirus au sein du DPPR. Le SIH peut : - Soit installer un logiciel antivirus sur la boîte noire ; - Soit filtrer les flux dirigés sur la boîte noire en amont de celle-ci avec des dispositifs antivirus propres au SIH. 7.7 PARE-FEU DE LA BOITE NOIRE La boîte noire ne contient pas de logiciel pare-feu. Le SIH peut cependant disposer la boîte noire derrière un pare-feu afin que celle-ci ne soit pas directement reliée à son réseau local. Un logiciel pare-feu peut également être installé sur la boîte noire par le SIH s il le souhaite. 7.8 MISE A JOUR DE LA BOITE NOIRE Aucune mise à jour automatique de la boîte noire (composants logiciels, base de données ou schémas XML) n est prévue dans cette version. 7.9 SERVEUR DE MESSAGERIE Deux solutions sont offertes aux SIH : Soit installer un serveur SMTP sur la boîte noire DPPR, Soit utiliser un serveur SMTP existant. Le serveur SMTP n est pas livré avec la boîte noire, le SIH peut choisir d installer le serveur SMTP livré avec Windows 2003 Server. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 83/89

92 7.10 CODIFICATION DES TYPES DE PIECES DU DPPR A compléter par ONCORA pour les colonnes Synthèse/Détail et Données évolutives. Code Type de pièce Synthèse Détail Urgence Données évolutives? 1 Administratif Oui 2 Social Oui 3 Psy Oui 4 CR Imagerie Oui 5 CR Anapath Oui 6 CR Exploration fonctionnelle Oui 7 CR Consult Oui 8 CR Opératoire Oui 9 CR Chimiothérapie Oui 10 CR Radiothérapie Oui 11 Médicaments 12 Sang 13 CR Séjour Oui 14 Résultat Biologique 15 Dossier de soins Oui 16 Synthèse de sortie Oui 17 Concertation Oui 18 Résumé d observation Oui 19 Non attribué Pour obtenir la dernière version des codifications des types de pièce et des pathologies, contactez-nous. 20 Co-morbidités alergies Oui 21 Données évolutives Oui 22 Mot libre Oui 23 Essai Thérapeutique Oui 24 Prochains RDV Oui 25 Fiche Tumeur Oui Notez que les types d information qui ne sont ni de synthèse ni de détail n apparaissent pas dans toutes les pièces ni 20 dernières info. Leur accès n est possible qu en cliquant sur le type sur le menu de gauche du DPPR. Notez aussi (cf ) qu un SIH peut annuler ces valeurs par défaut en spécifiant dans le message de création de pièce une donnée complémentaire (piecesynthèse, piecedetail, etc = oui / non) 7.11 CODIFICATION DES PATHOLOGIES DU DPPR Code Pathologie 1 Cancérologie 2 Cardiologie 3 Immunologie SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 84/89

93 7.12 IDENTIFIANT DESTINATAIRE DPPR Dans les messages XML, le SIH doit utiliser l identifiant 10 pour indiquer le DPPR. C est l identifiant du DPPR à STIC. SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 85/89

94 7.13 CONVENTIONS DE NOMMAGE DES PROFESSIONNELS DE SANTE Deux solutions sont offertes aux SIH pour préciser l auteur d une pièce : Soit verser le numéro Adéli ; Soit verser le nom usuel Utiliser le numéro Adéli Le SIH peut renseigner le tag <numeroadeli> de la balise <acteuraction>. Si c est le cas, cette information prévaut sur le champ <nomusuel> (Cf ). Le DPPR va vérifier le numéro Adéli par rapport aux PS inscrits. Si le PS n est pas inscrit, une erreur ERR611 est retournée. Dans le cas contraire (un PS avec ce numéro Adéli existe) alors le nom et prénom de ce PS sont récupérés de l annuaire du DPPR Utiliser le nom usuel Le SIH peut renseigner le tag <nomusuel> de la balise <acteuraction>. Le tag est utilisé par le DPPR uniquement si le tag <numeroadeli> n est pas renseigné. La convention suivante est utilisée pour identifier l auteur d une pièce mise à disposition du DPPR. Convention : NOM_USUEL(espace)PRENOM Le NOM_USUEL et le PRENOM doivent respecter les contraintes suivantes : - en majuscule (pas de caractères accentués), - sans tiret (les noms composés sont séparés par un espace), - sans abréviation (ST est renseigné SAINT, Jean-Charles est saisi JEAN CHARLES et non J CHARLES), - Sans ponctuation, - l'apostrophe est remplacée par un espace. En résumé, les 26 lettres de l'alphabet en majuscule et le caractère espace sont autorisés. + application de la charte d identification régionale du patient dans l écriture des noms et prénoms (il ne s agit bien entendu pas d envoyer le nom de naissance du médecin, mais bien son nom usuel). SWORD - Nos réf. : DPPR/SPF_002 / 3.3 Diffusion : contrôlée Page : 86/89