| API / API Web | |
|
Version : 5.0-00 |
Edition spéciale ES1 |
|
|
Package : fr.ACE.metier.bc4j.utilisateur.common GestionTraitementcreerEdition |
||
| Schémas d’entrée et de sortie : | IN | OUT |
Cette API permet de créer des procédures d’édition (UT_PRC), des éléments d’exploitation (UT_SPL) et des paramètres (UT_PAR).
Voir documentations UERP , GestionTraitementlancerEditionDirecte et UerpManagerspoolRequest.
|
|
Pour en savoir plus sur le service d’impression immédiate (S2I), consultez le « Guide de mise en œuvre UERP/S2I ». |
API imbriquées : aucune.
Contraintes et limites de fonctionnement (hors périmètre)
| RAS. |
Paramétrage (PPE)
Processus, contrôles et règles de gestion
| Etape | Description du Processus | ||||||||||||||||
| 1 |
|
||||||||||||||||
| 2 |
Si « impression.indicateur » n’est pas renseigné, la valeur prise par défaut est « NON ». Si « impression.indicateur » est égal à OUI et que « impression.fprint » n’est pas renseigné, l’API recherche « fprint » dans la table UT_PLED, puis dans la table UT_FCG, puis dans la table UT_UTI. Si aucune valeur n’est trouvée pour fprint, une erreur est envoyée. Si « impression.indicateur » est égal à « OU » et que « impression.nbreCopies » n’est pas renseigné, l’API recherche « nbreCopies » dans la table UT_PLED. Si aucune valeur n’est trouvée pour « nbreCopies », la valeur prise par défaut est 1. Si « impression.indicateur » est égal à « OUI » et que « impression.format » n’est pas renseigné, l’API recherche « format » dans la table UT_PLED, puis dans la table UT_FCG. Si « activation.date » ou « activation.heure » ne sont pas renseignés, l’API prend pour valeurs la date et l’heure d’invocation de l’API. |
||||||||||||||||
| 3 |
L’API contrôle l’existence de « codeFonction » dans la table UT_FCG. L’API contrôle l’existence de « batch » dans la table UT_FIL. L’API contrôle l’existence de « fprint » dans la table UT_FIL. L’API contrôle l’existence de « maquette » dans la table UT_MAQ. L’API analyse quel type d’édition il doit créer. Si « activation.elementProcedure » et « activation.tacheAutomatique » ne sont pas renseignés, c’est une édition simple. Si « activation.elementProcedure » est renseigné, c’est une liste d’éditions. Si « activation.tacheAutomatique » est renseigné, c’est une tâche automatique. L’API recherche le numéro d’édition en lisant la table UT_CPT. Le code compteur dépend du type d’édition : EDITION , ELTLIST ou TACHOTO |
||||||||||||||||
| 4 |
Attribut lisVal Cet attribut permet de donner une liste de groupes de valeurs (les valeurs "début, fin, like séparé par le caractère "¤") pour le nomChamp, chaque groupe séparé par le caractère |, ce qui donne la codification suivante : {Valeur égale}¤{Valeur début}¤{Valeur fin}¤{Valeur like}[|{Valeur début}¤{Valeur début}¤{Valeur fin}¤{Valeur like}][|…] Exemple : Critère Famille de produit (fampro)
Dans ce cas, on passe : BR01¤¤¤|¤BR10¤BR13¤|¤¤¤BR3 à l’attribut lisVal correspondant au critère "fampro". |
||||||||||||||||
| Critères de sélection |
La balise « heritageValdefLanceur » de type « integer » peut activer deux modes :
|
||||||||||||||||
| Champs renseignés par l’API : | |||||||||||||||||
| Table UT_PRC : |
Codsoc : Codsoc indiqué en entrée Nomprc : numero + codeFonction / nomProcedure / nomTache St1 : ChampStatutEdition.UN St2 : ‘ ‘ / ‘Liste non active’ / ‘ ‘ Nbedi : 0 / nombre de UT_SPL liés / 0 Nomcal : ‘ ‘ / ‘ ‘ / calendrier Periode : ‘ ‘ / ‘ ‘ / periode Contin : ‘N‘ / continuation / ‘N‘ Datdmd : activation.date Heudmd : activation.heure Libprc : ‘Edition simple’ / ‘Liste d’edition’ / ‘Edition automatique’ Automanu : ChampTypeEdition.M / ChampStatutEdition.M / ChampStatutEdition.A Eshs : ChampESHS.ES / ChampESHS.HS / ChampESHS.ES Batch : traitement.batch Uti : sessionMetier.utilisateur AttDatfix : ChampOuiNon.NON |
||||||||||||||||
| Table UT_SPL |
Codsoc : Codsoc indiqué en entrée Fct : codeFonction Uti : sessionMetier.utilisateur Datact : activation.date Heuact : activation.heure St1 : ChampStatutEdition.UN / ChampStatutEdition.QUATRE / ChampStatutEdition.UN Fprint : impression.fprint Batch : traitement.batch Forma : impression.format Afct : ‘’ Numero : numero Nbc : impression.nbreCopies Dir : champ Dir de l’enregistrement de UT_UTI correspondant à sessionMetier.utilisateur Tfc : Tit de l’enregistrement de la table UT_FCG Automanu : ChampTypeEdition.M / ChampTypeEdition.E / ChampTypeEdition.A Edit : indicateur.indicateur Nomprc : numero + codeFonction Ord : 1 / ordre de UT_SPL dans UT_PRC / 1 CodeMaq : traitement.maquette.codeMaquette Nommaq : traitement.maquette.nomFichier Eshs : ChampESHS.ES Contin : ‘N‘ / continuation / ‘N‘ |
||||||||||||||||
| Table UT_PAR : |
Codsoc : Codsoc indiqué en entrée Numero : numero Numpar : numérotation de 0 à nbre de paramètres Automanu : ChampTypeEdition.M |
||||||||||||||||
| 4 |
Pour chaque élément de « optionEdition », un enregistrement est créé. Param : optionEdition.mode + optionEdition.nom + optionEdition.valeur Si le paramètre ‘MULENT’ est positionné un enregistrement est créé. Param : ‘NS’ + ‘MULTI_ENT’ + ‘multi’ Pour chaque élément de « selection.critereSelection », un ou plusieurs enregistrements seront créés dans la table UT_PAR. Nomtable : table Nomchamp : nomChamp Si le champ de la table est de type VARCHAR, « param0 » est égal à ‘S’. Si le champ de la table est de type NUMERIC, « param0 » est égal à ‘N’. |
||||||||||||||||
|
Si « selection.critereSelection.egale » n’est pas nul, un enregistrement est créé. Si dans selection, il existe d’autres « selection.critereSelection », « param1 » est égal à ‘C’, sinon, « param1 » est égal à ‘V’. Param : param0 + param1 + selection.critereSelection.egale Si « selection.critereSelection.debut » ou « selection.critereSelection.fin » n’est pas nul, un enregistrement est créé. Si dans selection, il existe d’autres « selection.critereSelection », « param1 » est égal à ‘A’, sinon, « param1 » est égal à ‘M’. Param : param0 + param1 + selection.critereSelection.debut + selection.critereSelection.fin Si « selection.critereSelection.like » n’est pas nul, un enregistrement est créé. Si dans selection, il existe d’autres « selection.critereSelection », « param1 » est égal à ‘B’, sinon, « param1 » est égal à ‘T’. Param : param0 + param1 + selection.critereSelection.like Lorsque l’on ne renseigne que la colonne « Debut », la valeur est prise en « egale » |
|||||||||||||||||
|
Pour chaque élément de tri, un enregistrement est créé dans la table UT_PAR. Si « tri.ordreTri » n’est pas renseigné, la valeur prise par défaut est ASC. Nomtable : table Nomchamp : nomChamp Param : ‘TR’ + tri.ordreTri Si « vue » n’est pas nul, un enregistrement est créé. Param : ‘VU’ + vue Si « codeLanceur » est renseigné et qu’il possède des lignes de « clause where » complémentaires, des enregistrements sont créés. Param : ‘WH’ + lanceur.ligwhere(i) Un dernier enregistrement est créé. Param : ‘PL’ + codeLanceur Si « modeEdition » = 0, le scrutateur se charge du lancement du batch d’édition. Remarque : Si « modeEdition » = 1 (demande d’édition directe), le statut dans la table ut_spl est égal à 8 et dans la table ut_prc à 6. |