Télédéclarations

Les télédéclarations permettent à l'utilisateur de déclarer auprès des instances publiques toutes les informations qu'il doit faire remonter. Cette spécification permet de définir comment intégrer ces processus directement au sein d'ERP pour que les échanges se fasse de manière transparente et sans ressaisie.

Pour chaque service de télédéclaration, 2 librairies seront implémentées :

1. Bas niveau : Permet d'échanger avec le web service avec les conventions du web services
2. Haut niveau : Permet d'échanger avec le web service avec les conventions d'Ekylibre ERP (transcodage)

La librairie de haut-niveau repose entièrement sur la librairie de bas-niveau et effectue toutes les opérations de transcodage à la volée en émission et réception.

Les librairies bas-niveau sont implémentées dans RAILS_ROOT/lib/tele/<service>. Elles sont directement liées aux protocoles utilisés (SOAP, REST, XML-RPC…). Elles fonctionnent en mode synchrone. L'utilisation de tâches de fond permettront de gérer les opérations longues.

require 'savon'
 
module Tele
  class PAC < Service
 
    def initialize(pacage_number, password)
    end
 
    def retrieve_land_parcels
      ...
    end
 
  end
end

Ces librairies devront être exportable sous forme de gem et totalement indépendante du framework Rails/ERP.

Les librairies haut-niveau sont implémentées dans RAILS_ROOT/lib/ekylibre/tele/<service>. Elles sont indépendantes des protocoles utilisés en bas-niveau.

Elles réalisent le transcodage des nomenclatures internes vers celles du service. Ce transcodage devra se faire via des tables de correspondance si cela est possible, ce qui ne sera clairement pas toujours le cas. Exemple sur un code race bovine : bos_taurus_normande (ERP) ⇔ 56 (IDELE)

Ces librairies respectent l'arborescence suivante:

/tele/
  /<<service>>/
    /resources/
    /transcoding/
      /in/
      /out/
    /fetcher.rb
    /generator.rb
    /<<service>>.rb

Le répertoire resources contient tous les fichiers de nomenclature issus du service et nécessaires au bon format de données attendu.

Le répertoire transcoding contient toutes les tables de correspondance. Celles-ci sont divisées dans deux répertoires:

1. Le dossier in contenant les tables pour les flux entrants (i.e du service vers ERP),
2. le dossier out contenant les tables pour les flux sortants (i.e ERP vers service).

fetcher.rb a pour rôle d'automatiser la récupération des fichiers de nomenclature du service et les placent dans le dossier resources.

generator.rb s'occupe de la création automatique des tables de correspondances lorsque cela est possible.

«service».rb contient les déclarations des méthodes de haut niveau qui assurent le transcodage et l'appel à la librairie de bas niveau.

Les tables de correspondance générées respectent les spécifications YAML. Pour notre exemple cela donne: bos_taurus_normande: '56'. Chaque table est nommée «nom nomenclature interne».yml. Les correspondances ne sont pas forcément du 1 pour 1. Il peut arriver que les deux nomenclatures ne s'accordent pas: Par exemple, une nomenclature interne plus précise que celle du service devra générer une correspondance dans une catégorie divers. Il faut donc prendre en compte les exceptions.

Le générateur de tables de correspondance vérifie l'existence d'un fichier «nom nomenclature interne».exception.yml pour chaque table. Egalement au format YAML, ce fichier devra être rempli manuellement et spécifie les exceptions.

S'il existe, son contenu sera rajouté à la fin de la table générée. S'il est absent, le générateur considère qu'aucune exception n'est connue.

Lors de la génération de la table, le générateur vérifie que toutes les correspondances sont faites. Dans le cas contraire, il générera lui-même le ou les fichier(s) d'exception «nom nomenclature interne».exception.yml, qu'il faudra remplir à la main. Le générateur alertera alors l'ERP pour que la saisie manuelle soit faite.

Une fois le fichier rempli, le générateur devra être relancé pour prendre en compte les fichiers d'exception nouvellement créés.

Chaque sous-partie concerne un type de télédéclaration.

L'Institut de l'Élevage fournit depuis juin 2013 un service web SOAP permettant d'effectuer 14 opérations de déclaration sur les troupeaux bovins :

1. Enregistrement des données d’un mouvement d’entrée dans l’exploitation.
2. Fourniture de l’inventaire des animaux présents à un instant donné, ou ayant été présents entre deux dates.
3. Vérification et enregistrement des données de naissance (y compris de celles relevant de l’ECB) d’un veau né vivant et/ou identifié dans la base locale.
4. Enregistrement des données de naissance d’un veau mort-né (non bouclé).
5. Enregistrement des données d’un bovin échangé introduit dans une exploitation.
6. Notification de première entrée d'un bovin importé - Demande de passage d'un agent identificateur.
7. Enregistrement des données d’un bovin importé introduit dans une exploitation.
8. Enregistrement des données d’un mouvement de sortie dans l’exploitation.
9. Enregistrement d’une demande de commande de boucles de rebouclage.
10. Enregistrement d’une insémination par l’éleveur IPE.
11. Fourniture des modifications apportées à des dossiers de bovins d’une exploitation (RETMOUV) depuis une date donnée.
12. Fourniture des sorties présumées de bovin d’une exploitation.
13. Enregistrement d’une demande de commande de boucles de naissance.
14. Fourniture à la demande d’un dossier de bovin.

Vous trouverez ci-dessous les déclarations des méthodes bas-niveaux destinées à la gestion du webservice Idele.

^ Types complexes ^

TT: tables de transcodage | Nomen: Nomenclature

create_cattle_entrance:

get_list:

Réponse

create_cattle_new_birth:

create_cattle_stillbirth:

create_switched_animal:

create_imported_animal:

create_imported_animal_notice:

create_cattle_exit:

create_rebuckling:

create_insemination:

get_case_feedback:

Réponse:

get_presumed_exit:

Réponse:

create_buckle_request:

get_animal_case:

Réponse: