Création d'élément d'affaire et évolution de besoins d'affaire (V10.12) (JSON)
- Bertrand Littel
Un même code action couvre deux fonctionnalités complémentaires : integration_element_affaire
Créer un élément d'affaire sous un élément d'arborescence opérationnel défini au dossier, avec des besoins associés dès la création, en spécifiant que ces besoins ont une origine "PLM".
Gérer des évolutions sur les besoins d'affaires via un projet de modification pour un élément d'affaire existant
SOMMAIRE
Création des besoins sur un élément d’affaire
Contraintes
En cas d’incohérence dans les besoins (dans le Json) la demande sur l'élément sera en erreur
Le Web Service ne traite pas une création ou modification d'élément qui aurait des erreurs sur les besoins
soit il est traitable dans son intégralité
soit il est en erreur
De plus, une référence article ne peut figurer qu’une seule fois sur un élément
Pour créer des besoins d’affaire il faut au préalable créer l'élément d’affaire de rattachement (pas de modification)
L'élément est toujours créé directement sous l’arborescence opérationnelle
Il est possible de définir un élément père en fournissant la valeur de PARENTNUMBER
Quand l'élément est crée :
Le numéro d'élément
ELEMNOfigure dans la réponse JSONLes besoins seront crées sur l'élément
En cas d’échec de création de l'élément
Aucun besoin ne sera crée sur l’élément
Balise de paramètres (parameters) | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
dos | 1 | Dossier achat-vente | NON | Par défaut selon utilisateur |
En niveau 2 et 3 : informations concernant les données des éléments en création (et introduction du niveau 4 avec les besoins)
Balise du corps (data) | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
Elementtb | 2 | Tableau d'éléments | OUI | Sous la forme "Elementtb":
[
{ Données élément 1},
{ Données élémént 2}
...
] |
DEAL | 3 | Numéro d’affaire | OUI |
|
PARENTNUMBER | 3 | Permet de définir l'élément père d'attache de l'élément qui sera crée | NON | Il doit correspondre à un numéro d'élément existant dans l’affaire |
DESCRIPTION | 3 | Libellé de l'élément d’affaire | OUI |
|
ELEMENTTYPECODE | 3 | Type élément d’affaire | NON | Si non fourni l'élément d’affaire est crée avec la paramétrage du dossier affaire |
ELEMENTCODE | 3 | Code élément d’affaire | NON |
|
STATUSCODE | 3 | Code Statut | NON | Si non fourni correspond au code défini sur l’arborescence d’affaire |
ELEMENTQUANTITY | 3 | Nombre d'éléments | NON | Valeur par défaut : 1 |
QUANTITYTYPE | 3 | Type de quantité | NON | Valeur par défaut : 1 - Proportionnel 1 - Proportionnel |
QUANTITYFOR | 3 | Type de quantité / Pour Format numérique | NON |
|
QUESTION | 3 | Questionnaire | NON |
|
PLANNUMBER | 3 | Numéro de plan | NON |
|
PLANMARK | 3 | Numéro de plan / Repère | NON |
|
DUEDATE | 3 | Date d'échéance Format date “AAAAMMDD” | NON |
|
PLANNEDSTARTDATE | 3 | Prévu / Date début | NON | Format date “AAAAMMDD” |
PLANNEDENDDATE | 3 | Prévu / Date fin | NON | Format date “AAAAMMDD” |
PLANNINGSTARTDATE | 3 | Planifié / Date début | NON | Format date “AAAAMMDD” |
PLANNINGENDDATE | 3 | Planifié / Date fin | NON | Format date “AAAAMMDD” |
BUDGETVALUEDATE | 3 | Suivi budgétaire / Date de valeur | NON | Format date “AAAAMMDD” |
SELLINGPRICE | 3 | Prix de vente | NON | Format numérique |
REFERENCE | 3 | Gestion des pièces / Référence | NON | Si non fourni initialisé à partir du Type élément d’affaire |
SUBREFERENCE1 | 3 | Gestion des pièces / Sous-référence 1 | NON | Si non fourni initialisé à partir du Type élément d’affaire |
SUBREFERENCE2 | 3 | Gestion des pièces / Sous-référence 2 | NON | Si non fourni initialisé à partir du Type élément d’affaire |
WAREHOUSE | 3 | Dépôt | NON | Si non fourni initialisé à partir de l'Affaire |
STOCKNATURE | 3 | Nature de stock | NON | Si non fourni initialisé à partir de l'Affaire |
LOCATION | 3 | Emplacement | NON | Si non fourni initialisé à partir de l'Affaire |
THIRDPARTYTYPE | 3 | Type de tiers | NON | Valeur par défaut : C - Client P - Prospect |
THIRDPARTY | 3 | Tiers | NON | Il doit être cohérent avec |
SITE | 3 | Code site | NON |
|
PAYMENTCHOICE | 3 | Mode de règlement | NON |
|
Besointb | 3 | Tableau des besoins de l'éléments | OUI | "Besointb" :
[
{ Données du besoin 1 },
{ Données du besoin 2 },
...
] |
En niveau 4 : données des besoins en création d'élément d’affaire
Balise du corps (data) | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
Besointb | 3 | Tableau des besoins | OUI | Sous la forme "Besointb" :
[
{ Données du besoin 1 },
{ Données du besoin 2 },
...
] |
REFERENCE | 4 |
| OUI |
|
SUBREFERENCE1 | 4 |
| OUI si article géré en sous-référence |
|
SUBREFERENCE2 | 4 |
| OUI si article géré en sous-référence |
|
PLANMARK | 4 | Repère plan | NON | Repris de l'élément d’affaire si non fourni |
DESIGNATION | 4 | Désignation du besoin | NON | Repris de la fiche article si non fourni |
QUANTITY | 4 | Quantité | OUI |
|
SALEUNIT | 4 | Unité | NON | Repris de la fiche article si non fourni
|
QUANTITYTYPE | 4 | Type de quantité | NON | Valeur par défaut : 1 - Proportionnel 1 - Proportionnel |
QUANTITYFOR | 4 | Pour | NON | Valeur par défaut : 0 |
BUDGETCODE | 4 | Budget | NON |
|
REQUESTEDTIME | 4 | Délai Sous la forme “AAAAMMJJ” | NON |
|
SUPPLYMODE | 4 | Mode d’approvisionnement | NON | Valeur par défaut : 2 - Automatique 0 - Aucun |
WAREHOUSE | 4 | Dépôt | NON |
|
STOCKNATURE | 4 | Nature de stock | NON |
|
UNITYCOSTPRICE | 4 | Cout de revient saisi | NON | Récupérer d’après le tarif de l’article |
UNITPRICE | 4 | Prix unitaire brut Valeur numérique | NON |
|
PRICEPER | 4 | Prix par | NON | Valeur par défaut : 0 |
FLATERATEPRICEFLAG | 4 | Tarif forfaitaire | NON | Valeur par défaut : 1 - NON 1 - Non |
DISCOUNTTYPE1 ... DISCOUNTTYPE3 | 4 | Type de remise 1 à 3 | NON | Récupérer à partir des conditions tarifaires appliqués sur l’article 1 - Cumulé |
DISCOUNT1 ... DISCOUNT3 | 4 | Remise 1 à 3 Valeur numérique | NON | Récupérer à partir des conditions tarifaires appliqués sur l’article |
THIRDPARTYSUGGEST | 4 | Fournisseur proposé | NON |
|
Rappel : tous les champs du dictionnaire GPAELEM et GPABESOIN sont utilisables directement. La couche de MAPPING du tableau ci-dessus est visible en détails dans le module GATMMAPPING.dhsp
Exemple de corps
Exemple de corps avec création d’un élément et de 2 besoins d’affaire
Exemple complet flux JSON avec création d’un élément et de 2 besoins d’affaire
Format de la réponse
Balise | Contenu |
|---|---|
error | Anomalie technique de l’appel du service web 0 = pas n’anomalie, autre valeur = anomalie Dans ce cas la balise |
result | Détail du résultat fonctionnel de l’appel du service web
|
Exemple de réponse
La balise “errormessage” contient tout les erreurs séparées avec “|”
La balise ”response” contient tous les éléments intégrés avec succès en indiquant pour chaque élément :
Le nombre de besoins crées
Le nombre de besoins en échec
Réponse OK
Réponse non OK
Evolutions des besoins sur un élément d’affaire
Les besoins sont traités de manière différentielle ce qui implique que :
Les besoins qui existent dans le JSON et dans les besoins en projet sont modifiés (ou conservé)
Les besoins qui existent uniquement dans le JSON sont crées dans les besoins en projet
Les besoins en projet qui n’existent pas dans le JSON sont supprimés dans les besoins en projet
L’évolution des besoins se fait via un projet sur l'élément d’affaire. Si l'élément d’affaire en déjà en projet la demande est rejetée.
La création du projet sur l'élément d’affaire réalise les opérations suivants :
Duplication de l'élément d’affaire en indice projet
Duplication des besoins d’affaire de l'élément d’affaire en indice projet
Balise de paramètres (parameters) | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
dos | 1 | Dossier achat-vente | NON | Par défaut selon utilisateur |
En niveau 2 et 3 : informations concernant les données des éléments en évolution de leurs besoins (et introduction du niveau 4 avec les besoins)
Balise du corps (data) | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
Elementtb | 2 | Tableau d'éléments | OUI | Sous la forme |
ELEMENTNUMBER | 3 | Correspond au numéro d’élément | OUI |
|
En niveau 4 : données des besoins concernées par la modification
Balise du corps (data) | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
Besointb | 3 | Tableau des besoins | OUI | Sous la forme |
REFERENCE | 4 |
| OUI |
|
SUBREFERENCE1 | 4 |
| OUI si article géré en sous-référence |
|
SUBREFERENCE2 | 4 |
| OUI si article géré en sous-référence |
|
PLANMARK | 4 | Repère plan | NON | Repris de l'élément d’affaire si non fourni |
DESIGNATION | 4 | Désignation du besoin | NON | Repris de la fiche article si non fourni |
QUANTITY | 4 | Quantité | OUI |
|
SALEUNIT | 4 | Unité | NON | Repris de la fiche article si non fourni
|
QUANTITYTYPE | 4 | Type de quantité | NON | Valeur par défaut : 1 - Proportionnel 1 - Proportionnel |
QUANTITYFOR | 4 | Pour | NON | Valeur par défaut : 0 |
BUDGETCODE | 4 | Budget | NON |
|
REQUESTEDTIME | 4 | Délai Sous la forme “AAAAMMJJ” | NON |
|
SUPPLYMODE | 4 | Mode d’approvisionnement | NON | Valeur par défaut : 2 - Automatique 0 - Aucun |
WAREHOUSE | 4 | Dépôt | NON |
|
STOCKNATURE | 4 | Nature de stock | NON |
|
UNITYCOSTPRICE | 4 | Cout de revient saisi | NON | Récupérer d’après le tarif de l’article |
UNITPRICE | 4 | Prix unitaire brut Valeur numérique | NON |
|
PRICEPER | 4 | Prix par | NON | Valeur par défaut : 0 |
FLATERATEPRICEFLAG | 4 | Tarif forfaitaire | NON | Valeur par défaut : 1 - NON 1 - Non |
DISCOUNTTYPE1 ... DISCOUNTTYPE3 | 4 | Type de remise 1 à 3 | NON | Récupérer à partir des conditions tarifaires appliqués sur l’article 1 - Cumulé |
DISCOUNT1 ... DISCOUNT3 | 4 | Remise 1 à 3 Valeur numérique | NON | Récupérer à partir des conditions tarifaires appliqués sur l’article |
THIRDPARTYSUGGEST | 4 | Fournisseur proposé | NON |
|
Exemple de corps
Exemple de corps avec modification des besoins d’affaire
A partir de la création des besoins sur élément 1325 on souhaite procéder aux modifications suivantes :
Sur le besoin X1000008 on veut modifier la quantité 2 à 3
On veut supprimer le besoin X1000011
On veut ajouter le besoin X1000009
Exemple de corps flux JSON
Voir les exemples ci-dessus au chapitre création
Format de réponse
Balise | Contenu |
|---|---|
error | Anomalie technique de l’appel du service web 0 = pas n’anomalie, autre valeur = anomalie Dans ce cas la balise |
result | Détail du résultat fonctionnel de l’appel du service web
|