Introduction

0. Glossaire

1. Périmètre de l'échange

2. Prérequis de paramétrage

3. Le fichier "Contrat"

3.1 Format du fichier

3.2 Structure du fichier

3.3 Règles de gestion

3.4 Les codes utilisés dans Agreo

3.4.1 Les codes contrats type

3.5 Exemple de fichiers

Introduction

Ce document a pour objectif de décrire le processus d’échanges pour l’import des contrats dans AGREO. Il présente donc l’architecture mise en place pour assurer l’échange ainsi que le format des fichiers échangés.

Il permettra ainsi au client de respecter les normes afin d’assurer le développement de la partie qui lui incombe.

0. Glossaire

Contrat type : c’est un modèle de contrat. Il possède un type (Surface, Quantité) qui définit l’unité des contrats qui l’utiliseront (Ha, Kg). 

Contrat : c’est la formalisation d’un accord entre un fournisseur et un client sur une quantité donné (d’unité variable en fonction du contrat type).

1. Périmètre de l'échange

L’import des contrats est basé sur un échange de fichier utilisant un mécanisme classique de l’application : dépôt de fichiers à échéances régulières dans un répertoire FTP et intégration en mode batch des données dans la base de données.

Un seul fichier est concerné par cet import : le fichier des contrats

Si le besoin client le nécessite, cet import pourra également couvrir l’import des contrats types.

La suite du document décrit à la fois de manière détaillée l’architecture mise en place pour les échanges, les spécifications techniques de chacun des fichiers, les règles de gestion. Nous vous fournirons également des exemples à suivre ainsi que les codes à utiliser issus du paramétrage de votre application.

2. Prérequis de paramétrage

Les éléments suivants devront donc avoir été paramétrés de façon cohérente avec le SI du client pour permettre un fonctionnement correct de l’échange :

• des contrats types,
• des produits.

3. Le fichier "Contrat"

3.1 Format du fichier

3.2 Structure du fichier

Une "donnée vide" donne lieu à une écriture de la forme « ;; » et non « ».

3.3 Règles de gestion

• Vérification des champs obligatoires : si un champ est manquant, on génère une erreur et l’import s’arrête pour la ligne du fichier.
• Si l’état initial du workflow (CODE : INIT) n’existe pas ou n’est pas activé à la coop, on génère une erreur et l’import s’arrête. Sinon, on poursuit l’import.
• Si le code de l’exploitation n’est pas unique, alors une erreur est générée.
• Les champs « Surface », « Quantité » et « Volume » sont obligatoires en fonction du type de contrat type. La gestion de l’unité se fait en fonction du type de contrat type. 
• Si le type de contrat type est ‘SURFTON’, le rendement du contrat sera calculé. 
• Le flux ne traite que les champs obligatoires en fonction du type de contrat type ; même les autres champs sont fournis dans le fichier.

• Si le numéro du contrat, le contrat type et l’exploitation sont identiques avec un contrat existant alors on met à jour ce contrat (mise à jour de dm_contrat). 

  Sinon, on crée le contrat (saisie de dc_contrat). La mise à jour ou la création concerne toutes les informations disponibles dans le fichier y compris les caractéristiques. Attention, chacune des caractéristiques importées doit être existante dans le contrat type.

• Le contrôle du produit s’effectue en fonction du paramétrage du contrat type :

  Si la saisie du produit est « obligatoire », alors s’il n’est pas renseigné dans le fichier d’import, une erreur est générée.

Si la saisie du produit est « pas de saisie » alors si un produit est indiqué dans le fichier, il sera ignoré.

• Une caractéristique n’est importée que si son code existe et qu’elle est activée pour le contrat type correspondant.

• Si le contrat à importer existe, vérifier le workflow du contrat type avec l’état du contrat :

  Si l’action du workflow Modification complète(MOD) est disponible, modifier le contrat.

  S’il n’y a que l’action du workflow Modification des caractéristiques est disponible, les informations générales ne seront pas mises à jour. Les caractéristiques du contrat seront mises à jour. Un message d’information sera généré.

  Si aucune de ces deux actions n’existe, on génère une erreur et l’import s’arrête pour la ligne du fichier.

• Mise à jour de l’historique du contrat avec un vide ‘id_tiers’ et ‘IMPORT CONTRAT’ comme le commentaire:

  Si l’action Modification complète est disponible, prendre l’état finale de cet action comme l’état courant.

  Sinon, prendre celle de la modification des caractéristiques.

  S’il y a plusieurs actions qui portent le même traitement(MOD), prendre l’état finale de la première action.

Remarques :

Les contrats pour lesquels la saisie des cultures est obligatoire sont intégrés dans la base par cette procédure d’import. Il reviendra à l’utilisateur de compléter le contrat par les interfaces Agreo afin d’y associer les cultures.

La notion de contrat principal ou secondaire n’est pas prise en compte dans l’import. Celle-ci intervient lors de l’association du contrat à des cultures via l’interface Agreo, avec un contrôle sur le nombre de contrats maximal qui peuvent être associées à une culture

Pour les contrats associés à l’atelier viticulture, la colonne produit ne doit pas être valorisée.

3.4 Les codes utilisés dans Agreo

3.4.1 Les codes contrats type

3.5 Exemple de fichiers