ebir th ebirth service web pour les agents de l Etat civil Communes Version 2.0
Table des matières 1 INTRODUCTION... 3 2 ETAPES A SUIVRE POUR L UTILISATION DU SERVICE WEB EBIRTH... 4 3 ANNEXE : TABLEAU RECAPITULATIF LISTE DE CONTROLE COMMUNES... 8 8 Page 2
1 Introduction Nous souhaitons par le biais de ce document vous fournir toutes les informations nécessaires à l utilisation de l application ebirth. Ce document est destiné aux points de contacts ebirth de la commune. Deux types d interface ont été développés par le projet ebirth pour les communes : une application web des web services. L application web est à considérer comme une solution temporaire ou d exception qui permettra aux communes de plus petite taille de réceptionner et traiter les données sans pouvoir directement les exploiter dans leurs propres solutions internes. L application web a surtout été développée pour les communes qui ne disposent pas d un logiciel puissant pour le service de l Etat Civil qui intègrerait les fonctionnalités ebirth et/ou qui ne sont que très peu confrontées à des naissances sur leur territoire (ce sont donc les communes qui ne disposent généralement pas d un hôpital ou d une maternité sur leur territoire). Afin de pouvoir exploiter au mieux la digitalisation du transfert des données, le projet a donc également mis en œuvre des services web qui permettront aux communes (qui traitent de gros volumes de données) de pouvoir intégrer directement, à partir de leurs propres applications «Etat Civil», la réception des données provenant des hôpitaux au travers de services web ebirth. L objectif de ce document est définir toutes les étapes préalables à suivre pour une bonne intégration du service web dans l application de l Etat Civil. Page 3
2 Etapes à suivre pour l utilisation du service web ebirth Deux points importants à souligner : INTERNET : une connexion à Internet est indispensable pour l accès au FSB (Federal Service Bus) de Fedict. Le rôle principal de ce FSB est d assurer de manière homogène la sécurité dans le cadre de l échange des données et d authentifier formellement l application qui désire accéder à l application ebirth. ENVIRONNEMENTS FSB : deux environnements sont mis à votre disposition au niveau du FSB chez Fedict. o o Environnement d intégration : cet environnement permet de vérifier que l intégration du service web au sein de la commune fonctionne et renvoie les messages adéquats (réussites ou échecs) pour chaque situation définie. Environnement de production : cet environnement est celui qui sera utilisé pour l utilisation effective du service web. L accès à cet environnement ne sera possible qu après l installation par la commune. Ci-dessous, nous reprenons toutes les étapes nécessaires à la bonne intégration du service web au sein de votre commune. Etape 1 : renvoi du formulaire de préparation pour l utilisation d ebirth Communes Renvoyez le «Formulaire de préparation pour l utilisation d ebirth Communes», reçu lors de la présentation ebirth organisée dans votre région durant les mois de septembre octobre 2009, dûment complété au Service Desk de Fedict. Si vous n avez pas pu assister à une des présentations, veuillez télécharger le formulaire sur le site d information d ebirth ( www.ebirth.be) ou veuillez en faire la demande en envoyant un e-mail à l adresse suivante : ebirth@servicedesk.fedict.b e. Veuillez noter que vous devez compter au minimum 2 mois entre l envoi de votre formulaire et l installation effective au sein de votre commune. Veuillez noter que l installation au sein de l Etat Civil de votre commune se fera parallèlement à l installation de l application au sein d un ou plusieurs hôpitaux liés à votre commune. Etape 2 : remplir le «Technical Connection Request Form» (TCRF) ebirth pour l accès aux environnements d intégration et de production Ce document, qui est à renvoyer à Fedict, permet de configurer votre accès au FSB dans les environnements d intégration et de production de Fedict et d obtenir les deux certificats X.509 (un pour chaque environnement) qui permettent l identification et l authentification de votre commune. Sans ces certificats, il vous sera impossible d accéder aux environnements de Fedict et d utiliser le service web. Même si l accès à l environnement de production ne sera disponible qu après les tests effectués dans l environnement d intégration et qu à partir de la date définie pour l installation au sein de la commune (voir étapes 6 et 7), nous vous conseillons de remplir directement tant les données du TCRF pour l accès à l environnement d intégration que les données du TCRF pour l accès à l environnement de production (même formulaire). Ce document est disponible sur le site ebirth (www.ebirth.be). Page 4
Etape 3 : signature du contrat d utilisation d ebirth Afin de pouvoir utiliser l application ebirth, la commune doit préalablement signer un contrat d utilisation avec Fedict. Ce contrat est disponible sur le site ebirth ( www.ebirth.be). Etape 4 : accès à l environnement d intégration Dès réception du certificat X.509 de la part de Fedict, vous avez accès à l environnement d intégration. Pour rappel, cet environnement permet de vérifier que l intégration du service web au sein de votre commune fonctionne et renvoie les messages adéquats (réussites ou échecs) pour chaque situation définie. Etape 5 : implémentation et test du service web au sein de la commune Dans cette étape, vous intégrez (développez) le service web au sein de l application de votre commune. Afin de vous aider dans cette intégration, nous avons mis à votre disposition un guide d utilisateur technique qui décrit toutes les spécifications, le format des données et les règles de validation nécessaires dans l application ebirth. Ce document, «EB_Guide utilisateur Web Services City», ainsi que ses annexes sont disponibles sur le site ebirth ( www.ebirth.be). Veuillez également contacter votre fournisseur de logiciel à ce sujet. Ci-dessous vous trouverez un bref explicatif des annexes mises à votre disposition sur le site ebirth : Fichier EB_Districts_1.0.xls EB_Countries_1.0.xls EB_Responsefields_1.0.xls EB_helpfields_1.0.xls EB-City-schemas-client-v1.00.rar EB-City-examples-v1.00.zip Explications Ce fichier reprend les codes de district pour les communes d Anvers et de Tournai. Ce fichier reprend la liste des pays selon le code GEOBEL. Pour certaines questions, l agent de l Etat civil doit choisir la réponse adéquate. Ce fichier reprend les réponses et les traductions des champs. Ce fichier reprend tous les champs d aide ainsi que leurs traductions. Ce fichier reprend les schémas WSDL et XML. Ce fichier reprend des exemples des messages entrants et sortants du service web via le FSB. Avant d effectuer les tests de votre application avec l environnement d intégration du FSB, il est important d informer Fedict au préalable en faisant une demande de réservation de cet environnement. Cette demande se fait en envoyant un meeting request à l adresse FSB-integration@fedict.be, avec comme sujet «e-birth : test de connectivité». Veillez à bien indiquer les dates et heures de début et de fin de votre session de test, ainsi que la personne à contacter. Fedict confirmera cette réservation afin de vous assurer la disponibilité de l environnement durant la période demandée. Fedict vous proposera d autres périodes de test en cas d indisponibilité ou de surcharge d environnement. Etape 6 : renvoi des résultats des tests effectués dans l environnement d intégration du FSB Lorsque tous les développements ont été effectués, il est important de fournir le résultat des tests effectués dans l environnement d intégration du FSB. Il s agit d une preuve que les tests standard ont été Page 5
effectués et qu ils renvoient les messages adéquats (réussites ou échecs) pour chaque situation définie. Pour chaque test, il vous faudra indiquer la date à laquelle le test a été effectué et le résultat obtenu. Un document avec tous les tests à effectuer est disponible sur le site ebirth (www.ebirth.be). Pour effectuer les tests, il est nécessaire d avoir des données de test (ex. simulation des notifications envoyés par un hôpital).ces données sont créées par Fedict. Dès que vous avez accès à l environnement d intégration, ces données de test sont mis à votre disposition. Veuillez contacter le Service Desk de Fedict si vous désirez ajouter des données de tests complémentaires. Page 6
Etape 7 : accès à l environnement de production FSB La dernière étape est l accès à l environnement de production du FSB. Comme expliqué plus haut, un nouveau certificat X.509 est nécessaire pour avoir accès à cet environnement (voir étape 2). Cet environnement est celui qui sera utilisé pour l utilisation du service web. Toutefois, l accès à cet environnement ne pourra se faire qu à la date définie du lancement au sein de la commune (voir étape 1). Etape 8 : mesures à prendre en cas de problèmes Pour toute question concernant l accès à l application ebirth ou l utilisation de l application ebirth, veuillez vous adresser au Support Service Desk de Fedict via : ebirth@servicedesk.fedict.be Tél.: 078 15 03 14 (FR) 078 15 03 13 (NL) Vous trouverez également les coordonnées de contact sur la page web suivante : http://www.fedict.belgium.be/fr/support/contact/ http://www.fedict.belgium.be/nl/support/contact/ Page 7
3 Annexe : tableau récapitulatif Communes Ci-dessous vous trouverez un tableau récapitulatif de toutes les étapes abordées dans le présent document. Il sera utile de s en servir afin de n omettre aucune étape lors de la mise en place du service web. ETAPES CARACTERE QUI? REALISE Démarches nécessaires pour l intégration du service web ebirth 1 Renvoi du formulaire de préparation OBLIGATOIRE Responsable Etat Civil 2 Remplir le «Technical Connection Request Form» (TCRF) OBLIGATOIRE Département IT / Gestionnaire de sécurité 3 Signature du contrat d utilisation d ebirth OBLIGATOIRE 4 Accès à l environnement d intégration OBLIGATOIRE Responsable Etat Civil/commune Département FSB / Département IT 5 Implémentation et test du service web au sein de la commune 6 Renvoi des résultats des tests effectués dans l environnement d intégration du FSB OBLIGATOIRE OBLIGATOIRE Fournisseur de logiciel de la commune / Département IT Fournisseur de logiciel de la commune / Département IT 7 Accès à l environnement de production FSB OBLIGATOIRE Département FSB / Département IT Page 8