API Gestion Traitement créer Edition

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)

MULENTEDTDIR -

Processus, contrôles et règles de gestion

Etape Description du Processus
1
  • Si le champ« traitement.batch » n’est pas renseigné, l’API le recherche dans la table UT_PLED, puis dans la table UT_FCG, puis dans la table UT_UTI. Si aucune valeur n’est trouvée, une erreur est envoyée.
  • Si « traitement.titre » n’est pas renseigné, l’API le recherche dans la table UT_PLED, puis dans la table UT_FCG. Si aucune valeur n’est trouvée, la valeur prise par défaut est « Edition de l'utilisateur XXX ».
  • Si « traitement.maquette » n’est pas renseigné, l’API recherche « codeMaquette » et « nomFichier » dans la table UT_PLED. Si aucune valeur n’est trouvée, une erreur est envoyée.
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)
Egal Début Fin Commence (like)
BR01      
  BR10 BR13  
      BR3

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 :

  • = 0 (mode par défaut) è fonctionnement standard,
  • = 1 è récupération des valeurs par défaut des critères et options définis au niveau du lanceur (table UT_PLEDC).
  • Ce mode permet d'utiliser les critères de sélection du lanceur sans avoir à les fournir en entrée de l’API.

  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.