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