Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Echanges de Données avec les Eleveurs EDEL Référence Version Date de rédaction

Echanges de Données avec les Eleveurs EDEL Référence Version Date de rédaction Catégorie Rédacteur Source IE/EDEL/BBa/002 1.7 24 janvier 2017 Doc Utilisateurs BALVAY EDEL_Bovin_V5_WS_CdC_Util isateur_V1-7.docx Web Service EDEL Bovin V5 Version 1.7 du 24/01/2017 Page 1 sur 101 Système National d’Information Génétique Bovin Guide Utilisateurs Echanges de Données avec les Eleveurs Web Service EDEL Bovin V5 CR N° 0015701003 HISTORIQUE DES VERSIONS Version Date de rédaction Date de validation Motif Statut 0.98 19 décembre 2014 Version initiale DT 0.98-1 12 janvier 2015 Suite 1ère relecture MOE DT 0.98-2 20 janvier 2015 Suite rédaction Spécifications Fonctionnelles Détaillées du WS. DT 0.98-3 29 janvier 2015 Suite remarques MOE au cours de la réalisation du WS. DT 0.98-4 24 février 2015 Suite remarques Groupe utilisateurs EDEL + MOE au cours de la réalisation du WS. DT 1 22 juin 2015 Suite recette du WS DT 1.4 29 septembre 2015 Correction liste codes entreprise DV 1.5 18 juillet 2016 Correction liste codes entreprise + code site ws nationaux DV 1.6 13 septembre 2016 Ajout urée et indicateur Liu dans les données d’information laitière 1.7 24 janvier 2017 Correction codes entreprise Reswel pour départements 72 et 85 Echanges de Données avec les Eleveurs EDEL Référence Version Date de rédaction IE/EDEL/BBa/002 1.7 24 janvier 2017 Web Service EDEL Bovin V5 Version 1.7 du 24/01/2017 Page 2 sur 101 DIFFUSION DE LA VERSION COURANTE Entité Membre Motif de diffusion Groupe Utilisateurs EDEL Pour info Publication sur idele.fr Pour info LISTE DES EVOLUTIONS DE LA PRESENTE VERSION : V 0-98  V 0-98-1 § 5.1.1 p53 : Ajout de la balise « OrganismeTiersDemandeur » dans l’opération « GetDonneesMalesPublics ». V 0-98-1  V 0-98-2 § 3.8.3 p20 : Ajout de balises facultatives dans l’élément « InformationsMessage » pour restituer les éléments de demandes spécifiques à certaines opérations. § 5.1.2 p54 : Ajout de la balise facultative « TaureauEnErreur » dans le message réponse spécifique « MâlesPublics ». § 5.8.1 p63 : Ajout de la balise obligatoire « RaceDemande » dans l’opération « GetDonneesRAC ». § 7.3 p94 : Précision sur le traitement spécifique des erreurs fonctionnelles pour les demandes « Données Mâles publics ». V 0-98-2  V 0-98-3 § 2.3.1 p11 : Ajout d’une recommandation relative au « time out » allongé pour les demandes d’initialisation. § 3.4.1 p13 : L’abonnement « toutes familles » permet aussi d’appeler les WS par famille de données. § 4.1 p22 : Précision sur le traitement des balises événement portant un code suppression. § 4.15.1 p50 : Les balises « ClasseMerite » et « TypeCertificatEdite » sont facultatives et non obligatoires. V 0-98-3  V 0-98-4 § 5.1.1 p55 : Modalités d’appel de l’opération mâles publics : réponse déterminée par la date de demande § 4.8.1 p35 : Précision sur la valeur de la balise <NumeroIETaureau> pour le taureau mis en présence quand ce n’est pas un taureau de monte public : <PRIVE> au lieu de 5 chiffres. V 0-98-4  V 1 § 3.1 p 14 : Complément tableau de paramètres d’appel Reswel + Liste des codes sites et codes entreprises rattachés. Echanges de Données avec les Eleveurs EDEL Référence Version Date de rédaction IE/EDEL/BBa/002 1.7 24 janvier 2017 Web Service EDEL Bovin V5 Version 1.7 du 24/01/2017 Page 3 sur 101 § 3.4.1 p 17 : Ajout d’une recommandation quant à l’ordre d’appel des WS par famille pour une même exploitation : Données CPB en 1er. § 3.6 p 19 et § 3.8.1 p22 : Précision sur le fait que la « DateFinDemande » a été définie par erreur et sera dans tous les cas ignorée par le WS EDEL V5 même quand elle est renseignée. § 4.2 p27 : Modification de la structure de l’élément « PassageControleLaitier » : suppression « DatePassage » redondante avec « DateDebut » de l’événement + ajout d’une balise « HoraireTraite » permettant de gérer les heures début et fin des 2 traites. § 4.5.3 p 32 : Précision sur la DateDebut associée à une sortie UL. § 4.8.1 p38, §6.7.5 p 77, §6.7.6 p 78 et § 6.9 p96 : Précision sur la valeur de la balise <NumeroIETaureau> pour le taureau mis en présence quand ce n’est pas un taureau de monte public : <PRIVE> au lieu de 5 chiffres. § 5.9 p68 (correction coquille faite le 20/07/2015) : Correction de la définition de l’opération dans le 1 er alinéa du §. § 6.8.1 p86 : Correction dans les règles de gestion des données père et mère refusés. § 7 p99 : Ajout tableau complet des codes erreurs. V 1  V1.4 § 3.1 p 14 : Correction de la liste des codes entreprise pour l’aligner sur celle d’EdNotif. V 1.4  V1.5 § 3.1 p 14 : Correction du code site correspondant aux web services nationaux + correction de la liste des codes entreprise pour ajouter les départements de la zone Soual. V 1.5  V1.6 § 4.5.2 p 31 et § 6.7.2 p 75 : Ajout de l’urée et de l’indicateur Liu dans les données de l’observation laitière. V1.6  V1.7 § 3.1 p 14: Correction des codes entreprise Reswel pour les départements 72 et 85 : L720 et L850 (au lieu de E720 et E850) Echanges de Données avec les Eleveurs EDEL Référence Version Date de rédaction IE/EDEL/BBa/002 1.7 24 janvier 2017 Web Service EDEL Bovin V5 Version 1.7 du 24/01/2017 Page 4 sur 101 Sommaire 1 Introduction ..................................................................................................................................... 7 1.1 But de ce document ............................................................................................................................ 7 1.2 Structure du document ....................................................................................................................... 7 1.3 Vocabulaire.......................................................................................................................................... 8 2 Contexte et architecture générale .................................................................................................. 9 2.1 Présentation des acteurs impliqués dans EDEL................................................................................... 9 2.1.1 FGE et les organismes apporteurs de données .............................................................................................. 9 2.1.2 Les opérateurs hébergeant les BD SIG : les ARSOE et le CTIG ........................................................................ 9 2.1.3 Logiciels éleveurs .......................................................................................................................................... 10 2.1.4 Logiciels organismes tiers ............................................................................................................................. 10 2.2 Architecture générale ........................................................................................................................ 11 2.3 Principes de fonctionnement ............................................................................................................ 11 2.3.1 Connaître les informations techniques pour accéder au webservice .......................................................... 11 2.3.2 L'annuaire national ....................................................................................................................................... 12 2.3.3 Séquence d’appel au webservice ................................................................................................................. 13 3 Caractéristiques générales du webservice EDEL V5 WS ............................................................... 14 3.1 Informations d’identification du webservice .................................................................................... 14 3.2 Le WSDL ............................................................................................................................................. 17 3.3 Authentification et droits d’accès ..................................................................................................... 17 3.4 Modalités d’accès au service : gestion des accords et abonnements .............................................. 17 3.4.1 EDEL V5 WS individuel .................................................................................................................................. 17 3.4.2 EDEL V5 WS organisme tiers ......................................................................................................................... 18 3.5 Listes des opérations disponibles ...................................................................................................... 19 3.6 Règles communes de restitution des données ................................................................................. 20 3.6.1 Initialisation .................................................................................................................................................. 20 3.6.2 Routine ......................................................................................................................................................... 20 3.7 Types d’éléments simples définis dans le webservice EDEL V5 WS .................................................. 21 3.8 Eléments communs à toutes les opérations ..................................................................................... 22 3.8.1 Opérations « Request » ................................................................................................................................ 22 3.8.2 Opérations « Response » .............................................................................................................................. 23 3.8.3 Structure des balises« ReponseSpécifique » ................................................................................................ 24 4 Le contenu des balises fonctionnelles ........................................................................................... 27 4.1 Notion d’« Evenement » ................................................................................................................... 27 4.2 Passage contrôle laitier ..................................................................................................................... 28 4.3 Bovin – Généralités ........................................................................................................................... 29 4.3.1 Bovin - Identité ............................................................................................................................................. 30 4.3.2 Classification des données en familles ......................................................................................................... 31 4.4 Bovin – Evenement Animal ............................................................................................................... 31 4.5 Bovin – Evénements Animaux CL ...................................................................................................... 32 4.5.1 Début Lactation ............................................................................................................................................ 32 4.5.2 ObservationLaitiere ...................................................................................................................................... 32 4.5.3 MouvementULConstate ............................................................................................................................... 33 4.5.4 Mammite ...................................................................................................................................................... 34 4.6 Bovin – Evénements Animaux IA ....................................................................................................... 34 4.6.1 Insémination Animale ................................................................................................................................... 34 4.6.2 Constat de Gestation .................................................................................................................................... 36 Echanges de Données avec les Eleveurs EDEL Référence Version Date de rédaction IE/EDEL/BBa/002 1.7 24 janvier 2017 Web Service EDEL Bovin V5 Version 1.7 du 24/01/2017 Page 5 sur 101 4.7 Bovin – Evénements Animaux TE ...................................................................................................... 37 4.7.1 Collecte d’embryon ...................................................................................................................................... 37 4.7.2 Mise en place d’embryon = transfert d’embryon ......................................................................................... 38 4.8 Bovin – Evénements Animaux CPB .................................................................................................... 39 4.8.1 Mise en Présence = Monte Naturelle ........................................................................................................... 39 4.8.2 Avortement................................................................................................................................................... 40 4.8.3 Vêlage ........................................................................................................................................................... 41 4.9 Bovin – Evénements Animaux CPV ................................................................................................... 41 4.9.1 Constat Groupe de Conduite ........................................................................................................................ 41 4.9.2 Constat de Situation Particulière de la Naissance au Sevrage ...................................................................... 41 4.9.3 Pesée en Vif .................................................................................................................................................. 42 4.9.4 Pointage au Sevrage ..................................................................................................................................... 42 4.10 Bovin – Evénements Animaux RAC ................................................................................................... 44 4.10.1 PointageAdulte ............................................................................................................................................. 44 4.11 Bovin – Donnée Elaborée Animal ...................................................................................................... 45 4.12 Bovin – Données Elaborées Animal CPB ........................................................................................... 46 4.12.1 Certification Parenté..................................................................................................................................... 46 4.13 Bovin – Données Elaborées Animal CL .............................................................................................. 47 4.13.1 Lactation ....................................................................................................................................................... 47 4.13.2 Index Bovin Laitier ........................................................................................................................................ 49 4.14 Bovin – Données Elaborées Animal CPV ........................................................................................... 52 4.14.1 Poids âge type............................................................................................................................................... 52 4.14.2 Index IBOVAL ................................................................................................................................................ 52 4.15 Bovin – Données Elaborées Animal RAC ........................................................................................... 56 4.15.1 Inscription Livre Généalogique ..................................................................................................................... 56 4.15.2 Qualification ................................................................................................................................................. 56 4.16 Déclaration initiale – Taureau reproducteur ..................................................................................... 56 5 Description des opérations ............................................................................................................ 58 5.1 Fourniture des données de mâles publics......................................................................................... 58 5.1.1 Définition des paramètres en entrée ........................................................................................................... 58 5.1.2 Définition des paramètres en sortie ............................................................................................................. 59 5.2 Fourniture de l’ensemble des données génétiques des animaux..................................................... 60 5.2.1 Définition des paramètres en entrée ........................................................................................................... 60 5.2.2 Définition des paramètres en sortie ............................................................................................................. 60 5.3 Fourniture des données d’Insémination Animale ............................................................................. 61 5.3.1 Définition des uploads/s1/ edel-bovin-v5-ws-cdc-utilisateur-v1-7.pdf