Créer des maquettes spécifiques (maquettage)

Pour adapter une maquette standard, il suffit de copier le fichier du répertoire « ETA » vers votre répertoire spécifique « MAQ » et de la modifier par éditeur.

Il s’agira alors de prendre en compte le nom spécifique de la maquette ainsi créée dans la structure concernée.

Les maquettes sont proposées dans différents formats (avec XXX = code langue) :

Depuis la version 1.6.0, les fichiers des maquettes d’édition peuvent contenir un « \r » (fichier DOS déposé sous UNIX sans transformation), ce caractère étant simplement ignoré.

Une maquette est constituée de lignes (de taille maximale de 2000 caractères) correspondant à des blocs d’édition (ou blocs de données) ou à des lignes de traitements (variable fictive, paramètre maquette). Certains de ces blocs sont standards et communs à la majorité des traitements (EE, EP, PP et PE), les autres blocs (numériques) sont propres au traitement qui utilisera la maquette. Chaque bloc est constitué d’un ensemble de variables numérotées.

Pour obtenir la liste complète des blocs d’édition, consultez la liste des blocs.

Les lignes composant le fichier spool de sortie correspondent aux lignes commençant par %xx ou &xx (avec xx = EE, EP, PP, PE ou un numéro de bloc disponible dans le moteur utilisé). Ces lignes sont composées de parties fixes et de variables, commençant par @ ou ~ (voir utilisation des variables fictives ci-après) suivies du numéro de variable.

Ces caractères @ ou ~ sont remplacés par la valeur de la variable demandée, jusqu’au premier caractère différent de blanc présent dans la ligne de la maquette

Exemple :

%EP H------------H--------------------------------H

%EP | Produit | Désignation |

%EP T------------T--------------------------------T

%01 | @002 | @003 |

Si @002 vaut 1234567890123 et @003 vaut Marteau, on obtiendra

%EP H------------H--------------------------------H

%EP | Produit | Désignation |

%EP T------------T--------------------------------T

%01 | 12345678901| Marteau |

Les derniers caractères du code produit ne sont pas repris.

Un autre mode d’interprétation des lignes permet de conserver la totalité des valeurs des variables, voir le paramètre maquette « LG_VARIABLE ».

On peut indiquer qu’une ligne d’un bloc ne doit pas être éditée si toutes les variables qu’elle comporte sont vides en remplaçant le % par &. Ceci est valable pour les blocs EE, EP, PP, PE et les blocs numériques.

Exemples de maquettes :

• En-tête d’édition standard.

largeur=132

longueur=50

%EE<c><l><v6>

%EEH-------------------------------------------------------------------------------------------------------H-----------------------H

%EE| Société : @110 @112 Etablissements : @228 - @229 | Le @003 à @105 |

%EE| Etat N° : @106 @107 T-----------------------T

%EE| Demandé par : @108 @109 | Page : 0 |

%EEB-------------------------------------------------------------------------------------------------------B-----------------------B

%EE

%EEH-----------------------------------------------------------------------------------H

%EE| EDITION : @166 |

&EE| @167 @168 |

%EET-----------------------------------------------------------------------------------T

%EE| C R I T E R E S D E S E L E C T I O N |

%EET--------------H----------------------H----------------------H----------------------T

%EE| Critère | Valeurs début | Valeurs fin | Commençant par |

%EET--------------T----------------------T----------------------T----------------------T

&EE| @144 | @44 | @64 | @84 |

&EE| @145 | @45 | @65 | @85 |

&EE| @146 | @46 | @66 | @86 |

%EET--------------B----------------------B----------------------B----------------------T

%EE| O P T I O N S @165 |

%EET-------------------------------------H---------------------------------------------T

&EE| @182 : @04 | @183 : @05 |

&EE| @184 : @06 | @185 : @07 |

&EE| @186 : @08 | @187 : @09 |

%EET-------------------------------------B---------------------------------------------T

&EE| @169 |

&EE| @171 |

%EET-----------------------------------------------------------------------------------T

%EE| C R I T E R E S D E T R I |

%EET----------------H----------------H----------------H---------------H----------------T

&EE| @172 | @173 | @174 | @175 | @176 |

&EE| @177 | @178 | @179 | @180 | @181 |

%EEB----------------B----------------B----------------B---------------B----------------B

• En-tête de page standard.

%CR<c><l><v6>

%EPH-------------------------------------------------------------------------------------------------------H-----------------------H

%EP| Société : @001 @017 Etablissements : @228 - @229 | Le @013 à @016 |

%EP| Etat N° : @007 @006 T-----------------------T

%EP| Demandé par : @011 @012 | Page : @014 |

%EPB-------------------------------------------------------------------------------------------------------B-----------------------B

%EP

%EP H------------------------------------------H

%EP | @015 |

%EP B------------------------------------------B

%EP

Edition des pays standard.

%CR<c><l><v6>

include="ap$std:132.maq"

include="ap$std:ep_132.maq"

%EP H------------H--------------------------------H------------H-------H--------H-------H---------H

%EP | Code | Libellé | Lib réduit | Intra | Région | Fisc. | Secteur |

%EP T------------T--------------------------------T------------T-------T--------T-------T---------T

%01 | @002 | @003 | @006 | @004 | ~001 | ~002 | ~003 |

%05 | @008 | @004 | @005 | | | | |

%PP B------------B--------------------------------B------------B-------B--------B-------B---------B

%PP <FF>

%PE B------------B--------------------------------B------------B-------B--------B-------B---------B

include="ap$std:pe_132.maq"

%CR---- REGION -----------------------------------------------------------------

V ~001=C(03)

V01 ~001=@005[1:3]

%CR---- POSITION FISCALE -------------------------------------------------------

V ~002=C(01)

V01 ~002=@005[4:4]

%CR---- SECTEUR GEOGRAPHIQUE ---------------------------------------------------

V ~003=C(06)

V01 ~003=@005[5:10]

La liste des blocs d’une édition peut être consultée de manière globale ou pour une fonction donnée.

Les variables fictives sont préfixées par ~ dans les maquettes. Il est possible de définir de 0 à 999 variables. Ces variables sont le résultat d’affectation ou de calcul simple réalisés à partir des variables des blocs ou d’autres variables fictives.

Les masques commençant par % correspondent à des masques écrits en langage C.

Pour les chaînes de caractères, c’est la taille de la variable fictive qui donne la longueur de la chaîne.

Certaines fonctions de traitement des dates peuvent être appelées à partir d’une maquette d’édition :

• - MDAT permet de personnaliser le format de la date,
• - ADAT ajoute une période à une date,
• - EDAT fournit l’écart entre deux dates.

Afin de faciliter les éventuels calculs faits dans certains états, le convertisseur peut être directement appelé dans les maquettes par la fonction CDEV(). Il permet de convertir n'importe quel montant dans n'importe quelle devise, même après le passage à l'euro.

Cette fonction possède 6 variables fictives en entrée et retourne une variable fictive en sortie (montant converti) :

Entrée n° 1 : représentant le montant à convertir,

Entrée n° 2 : représentant la devise du montant à convertir,

Entrée n° 3 : représentant la devise dans laquelle on doit convertir,

Entrée n° 4 : représentant la date de recherche des parités,

Entrée n° 5 : représentant la nature de la devise,

Entrée n° 6 : représentant la parité forcée, par rapport à la devise société.

Les deux premières entrées sont obligatoires. Les suivantes, facultatives, s'ajoutent les unes à la suite des autres, sachant que si la nème entrée est renseignée, les précédentes doivent l'être aussi. Un simple blanc (" ") peut suffire à renseigner une entrée facultative, car chacune de ces 4 entrées possède une valeur par défaut.

Valeurs par défaut des entrées, si celles-ci sont à blanc :

Entrée n° 3 : devise société (devise nationale).

Entrée n° 4 : date du jour.

Entrée n° 5 : "STD".

Entrée n° 6 : zéro.

Cette fonction, utilisable dans les maquettes d’édition, permet d’exprimer un montant en chiffres par un montant en lettres (jusqu’à 10 chaînes de caractères).

Elle peut être exploitée pour les impressions sur les chèques.

Voici un exemple :

~020 = CMTL(~001,~002,~003,~004,~005,~006,~007,~008,~009,~010,~011,~012,~013,~014,~015)

~001 = montant en chiffres à convertir en littéral,

~002 = code langue

· FRA pour exprimer le montant en français (valeur par défaut),

· DEU pour exprimer le montant en allemand,

· ENG pour exprimer le montant en anglais,

· ESP pour exprimer le montant en espagnol,

· ITA pour exprimer le montant en italien,

· DUT pour exprimer le montant en néerlandais,

· POR pour exprimer le montant en portugais.

~003 = code devise qui fournira le libellé de la partie entière (« EUR » pour afficher « euro »),

~004 = libellé de la partie entière (si on ne veut pas utiliser le libellé de la devise),

~005 = libellé partie décimale : centimes par exemple,

(s’il n’est pas renseigné, on laisse les décimales en chiffres),

~006 = Chaîne de caractères contenant la 1ère partie du montant en littéral,

.................................................

~015 = Chaîne de caractères contenant la 10ème partie du montant en littéral

~020 = code retour.

Par exemple, avec les variables suivantes:

~001=56.78

~003="EUR"

~005="centimes"

~006=C(15)

~007=C(30)

~008=C(30)

on obtiendra ~006 = « Cinquante-six »

~007 = « euros et soixante-dix-huit »

~008 = « centimes »

L’instruction maquette CODSOC permet de déduire la société physique de gestion d’une table (et son segment) à partir de l’entité courante ou l’entité passé en paramètre.

Vxx ~yyy=CODSOC(table,segment,entité de référence).

Avec :

· xx : numéro de bloc,

· yyy : numéro de la variable recevant le code société physique,

· table : nom de la table,

· segment : à renseigner pour les tables utilisant un segment (voir MEV),

· entité de référence : si l’on veut effectuer une recherche depuis une autre entité que l’entité en cours de traitement par le traitement différé.

Exemple de syntaxe :

V ~901="9"

V ~101="zzz9"

V ~102=C(16)

V10 ~101=CODSOC("PRO")

V10 ~102=@001

V10 ~901=ISQL(update pro set codzn1=’O’ where codsoc=~101 and codpro=’~102’;)

Lorsqu’aucun paramètre n’est précisé dans la syntaxe, l’instruction-maquette CODSOC permet de fournir le code de l’entité courante correspondant au bloc en cours d’édition. Cette fonctionnalité est très utile dans le cadre d’une édition sélectionnant plusieurs entités.

Exemple de syntaxe :

Vxx ~yyy=CODSOC("")

Cette instruction maquette permet d’effectuer des conversions sur les quantités.

Elle possède 4 variables fictives en entrée et retourne dans une variable fictive la quantité convertie.

Entrée n° 1 : représentant le code produit (alpha)

Entrée n° 2 : représentant la quantité à convertir (numérique)

Entrée n° 3 : représentant l’unité de la quantité à convertir (alpha)

Entrée n° 4 : représentant l’unité dans laquelle on veut convertir la quantité (alpha)

Exemple :

~001= CQTE("BISCUIT",~102,~103, "CAR")

Permet de convertir la quantité données en ~102, définie dans l’unité donnée en ~103 en unité de type « CAR ».

Cette fonction, utilisable dans les maquettes d’édition, permet de récupérer une adresse complète dans différentes variables fictives.

Paramètres de l’instruction :

Exemple :

longueur=9999

%CR recherche adresse d'un tiers

P LG_VARIABLE

P UTIL_VARNOM

V ~IADR_RET="9"

V ~IADR_CIV_NOM=C()

V ~IADR_NOM=C()

V ~IADR_LG1=C()

V ~IADR_LG2=C()

V ~IADR_LG3=C()

V ~IADR_LOC=C()

V ~IADR_CP=C()

V ~IADR_BD=C()

V ~IADR_GEO=C()

V ~IADR_PAY=C()

V ~IADR_TEL=C()

V ~IADR_TELC=C()

V ~IADR_LIBPAY=C()

VEE ~IADR_RET=IADR("CLI","BRCLI101","COM",1,~IADR_CIV_NOM,~IADR_NOM,~IADR_LG1,~IADR_LG2,~IADR_LG3,~IADR_LOC,~IADR_CP,~IADR_BD,~IADR_GEO,~IADR_PAY,~IADR_TEL,~IADR_TELC,~IADR_LIBPAY)

%EE Valeur retournée par IADR

%EE CIV_NOM : ~IADR_CIV_NOM

%EE NOM : ~IADR_NOM

%EE LG1 : ~IADR_LG1

%EE LG2 : ~IADR_LG2

%EE LG3 : ~IADR_LG3

%EE LOC : ~IADR_LOC

%EE CP : ~IADR_CP

%EE BD : ~IADR_BD

%EE GEO : ~IADR_GEO

%EE PAY : ~IADR_PAY

%EE TEL : ~IADR_TEL

%EE TELC : ~IADR_TELC

%EE LIBPAY : ~IADR_LIBPAY

Pour les chaînes de caractères, c’est la taille de la variable fictive qui donne la longueur de la chaîne.

Cette instruction maquette permet de récupérer une adresse sur 20 lignes au maximum, formatée suivant le format associé au code pays de l’adresse demandée.

La recherche s’effectue pour les 4 premiers paramètres d’entrée, d’abord via la table des liens entre adresses des tiers (LAD) qui fournit l'adresse à lire. Si aucun enregistrement n'est trouvé dans la table LAD, on effectue alors un accès direct à la table des adresses ADR. Ce traitement permet de lire les informations « formatées » d’une adresse lorsqu’on a la référence directe de l’adresse (en mode filière logistique, avec le paramètre FILLOG, par exemple).

Paramètres de l’instruction :

Voici un exemple de maquette basé sur le batch GTIEE.exe :

V ~801=C(4)

V ~802=C(16)

V ~803=C(4)

V ~804="zz9"

V ~805=C(256)

V ~806=C(256)

V ~807=C(256)

V ~808=C(256)

V ~809=C(256)

V ~810=C(256)

V ~811=C(256)

V ~812=C(256)

V ~813=C(256)

V ~814=C(256)

V ~815=C(256)

V ~816=C(256)

V ~817=C(256)

V ~818=C(256)

V ~819=C(256)

V ~820=C(256)

V ~821=C(256)

V ~822=C(256)

V ~823=C(256)

V ~824=C(256)

V10 ~801=@1

V10 ~802=@2

V10 ~803="COM"

V10 ~804=1

V10 ~999=IADRF(~801,~802,~803,~804,~805,~806,~807,~808,~809,~810,~811,~812,~813,~814,~815,~816,~817,~818,~819,~820,~821,~822,~823,~824)

%10

%10 IADRF

%10 Type tiers (IADRF) ~801

%10 Sigle tiers (IADRF) ~802

%10 Type Adresse (IADRF) ~803

%10 No adresse (IADRF) ~804

%10 Lig adr fmt 01 (IADRF) ~805

%10 Lig adr fmt 02 (IADRF) ~806

%10 Lig adr fmt 03 (IADRF) ~807

%10 Lig adr fmt 04 (IADRF) ~808

%10 Lig adr fmt 05 (IADRF) ~809

%10 Lig adr fmt 06 (IADRF) ~810

%10 Lig adr fmt 07 (IADRF) ~811

%10 Lig adr fmt 08 (IADRF) ~812

%10 Lig adr fmt 09 (IADRF) ~813

%10 Lig adr fmt 10 (IADRF) ~814

%10 Lig adr fmt 11 (IADRF) ~815

%10 Lig adr fmt 12 (IADRF) ~816

%10 Lig adr fmt 13 (IADRF) ~817

%10 Lig adr fmt 14 (IADRF) ~818

%10 Lig adr fmt 15 (IADRF) ~819

%10 Lig adr fmt 16 (IADRF) ~820

%10 Lig adr fmt 17 (IADRF) ~821

%10 Lig adr fmt 18 (IADRF) ~822

%10 Lig adr fmt 19 (IADRF) ~823

%10 Lig adr fmt 20 (IADRF) ~824

Cette instruction maquette permet, à partir de certaines informations en entrée, de calculer les numéros de BIC et d’IBAN (électronique et papier) et ainsi d’obtenir une édition avec le numéro IBAN au lieu du numéro de compte national. Elle permet également de retourner le BIC nécessaire au traitement efficace de l’IBAN.

Cette instruction maquette comporte au minimum 7 paramètres et au maximum 16.

Fonctions concernées :

Toutes ces entrées doivent permettre de couvrir l’ensemble des fonctions différées traitant les numéros de comptes nationaux. En fonction des informations disponibles dans un bloc, l’instruction maquette sera renseignée différemment. En effet, toutes les entrées ne sont pas nécessaires à la bonne exécution de l’instruction.

Pour éditer les informations d’une banque avec son numéro d’IBAN et BIC au lieu du numéro de compte national fourni par défaut, les informations disponibles dans le bloc d’édition doivent être les suivantes : Journal de banque et numéro de domiciliation bancaire. En cas d’absence ce numéro de domiciliation, il est possible de charger à la place le code banque, le code guichet et le numéro de compte.

Pour éditer pour un tiers donné son numéro d’IBAN au lieu du numéro de compte national fourni par défaut, les informations disponibles dans le bloc d’édition doivent être les suivantes : tiers comptable et numéro de domiciliation bancaire. En cas d’absence ce numéro de domiciliation, il est possible de charger à la place le code banque, le code guichet et le numéro de compte. De même, en cas d’absence du tiers comptable, on peut charger dans l’instruction maquette le type tiers et sigle tiers.

Cette fonction, utilisable dans les maquettes d’édition, permet de récupérer une donnée concernant un tiers.

Voici un exemple :

V ~901=C(4)

VPE ~901="CLI"

V ~902=C(16)

VPE ~902="STEPHAN"

V ~903=C(20)

VPE ~903="CODLAN"

V ~904=C(80)

V ~905="zzzzz9,99"

VPE ~905=ITIE(~901,~902,~903,~904)

Les informations nécessaires à l'exécution

~901 = Type de tiers

~902 = Sigle tiers

~903 = Mot clé de la valeur demandée (nom du champ contenant la donnée)

Les informations retournées

~904 = Valeur de la donnée demandée

~905 = Code retour d'exécution de la fonction

Cette fonction, utilisable dans les maquettes d’édition, permet de récupérer une donnée concernant une adresse :

• - Type de tiers
• - Sigle tiers
• - Type d’adresse
• - Numéro d’adresse
• - Mot-clé de la valeur demandée (nom du champ contenant la donné)
• - Valeur du champ

Les mots clés utilisables sont les champs de la table ADR (adresses) en majuscules,

Pour les champs communs entre l'adresse (table ADR) et le contact principal (table CTC), les informations proviennent en priorité du contact principal, si l'adresse en possède un, sinon de l'adresse. Les champs concernés sont les suivants :

· CODCIV : code civilité du contact,

· CONTAC : personne à contacter,

· PRENOM : prénom du contact,

· FONCTI : fonction de la personne à contacter

· CODSER : code service,

· TEL : numéro de téléphone du contact,

· TELEX : numéro de télex,

· FAX : numéro de télécopie,

· GSM : numéro de téléphone portable,

· TELPRO : numéro de téléphone professionnel,

· DATCRE : date de création,

· DATNAI : date de naissance.

Les informations Adresse email et Zones paramétrées 1 à 20 (champs EMA256, et CODZN1 à CODZ20) sont systématiquement alimentées par la table CTC.

Pour forcer la récupération d'un tel champ dans la table ADR, même si l'adresse possède un contact principal, il faut indiquer comme nom de champ, les noms suivants :

· ADRCIV : code civilité du contact,

· ADRCON : personne à contacter,

· ADRPRE : prénom du contact,

· ADRFON : fonction de la personne à contacter,

· ADRSER : code service,

· ADRTEL : numéro de téléphone du contact,

· ADRTLX : numéro de télex,

· ADRFAX : numéro de télécopie,

· ADRZ1 à ADRZ20 : Zones paramétrées 1 à 20,

· ADRGSM : numéro de téléphone portable,

· ADRTLP : numéro de téléphone professionnel,

· ADRCRE : date de création,

· ADRNAI : date de naissance.

Pour forcer la récupération d'un tel champ dans la table CTC, même si l'adresse ne possède pas de contact principal, faut indiquer comme nom de champ, les noms suivants :

· CTCCIV : code civilité du contact,

· CTCCON : personne à contacter,

· CTCPRE : prénom du contact,

· CTCFON : fonction de la personne à contacter,

· CTCSER : code service,

· CTCTEL : numéro de téléphone du contact,

· CTCTLX : numéro de télex,

· CTCFAX : numéro de télécopie,

· CTCGSM : numéro de téléphone portable,

· CTCTLP : numéro de téléphone professionnel,

· CTCCRE : date de création,

· CTCNAI : date de naissance.

Dans ce cas, lorsqu’il n’y a pas de contact principal, les informations ne seront pas renseignées et n’utiliseront pas les valeurs de la table ADR.

Voici un exemple :

V ~901=C(4)

V10 ~901="CLI"

V ~902=C(16)

V10 ~902="000013"

V ~903=C(4)

V10 ~903="COM"

V ~904="z",1.0

V ~905=C(20)

V10 ~905="COMMEN1"

V ~906=C(80)

V ~907="zzzzz9,99"

V10 ~907=IADD(~901,~902,~903,~904,~905,~906)

Les informations nécessaires à l'exécution

~901 = Type de tiers

~902 = Sigle tiers

~903 = Type d'adresse

~904 = Numéro d'adresse

~905 = Mot clé de la valeur demandée (nom du champ contenant la donnée)

Les informations retournées

~906 = Valeur de la donnée demandée

~907 = Code retour d'exécution de la fonction

Cette fonction, utilisable dans les maquettes d’édition, permet de récupérer les informations bancaires d'un tiers :

• - (E) Type de tiers,
• - (E) Sigle tiers,
• - (E) Numéro de RIB (0 pour RIB par défaut),
• - (S) Banque,
• - (S) Agence,
• - (S) Compte,
• - (S) Clé,
• - (S) Nom,
• - (S) Localité.
• - (S) Type de RIB (utilisable dans l’instruction maquette IBAN)
• - (S) BIC (de la table rib)
• - (S) IBAN (de la table rib)
• - (E) Date de recherche rib (intérêt uniquement si utilisation du ppe RIBDAT)

Voici un exemple :

V ~901=C(4)

VPE ~901="CLI"

V ~902=C(16)

VPE ~902="STEPHAN"

V ~903=C(4)

VPE ~903="12"

V ~904=C(80)

V ~905=C(80)

V ~906=C(80)

V ~907=C(80)

V ~908=C(80)

V ~909=C(80)

V ~910=C(80)

V ~999="zzzzz9,99"

VPE ~999=IRIB(~901,~902,~903,~904,~905,~906,~907,~908,~909,~910)

Les informations nécessaires à l'exécution

~901 = Type de tiers

~902 = Sigle tiers

~903 = Numéro du RIB

Les informations retournées

~904 = Numéro de banque

~905 = Code guichet

~906 = Numéro de compte

~907 = Clé RIB

~908 = Nom de la banque

~909 = Localité de la banque

~9010 = Type de RIB

~999 = Code retour d'exécution de la fonction

Il est possible de faire apparaître des informations sur l'une des entités de la hiérarchie dans n'importe quelle édition. Tous les champs possibles n'ont pas été ajoutés dans toutes les éditions mais une fonction maquette (ISME) vous permet d’utiliser de nombreuses informations :

· Type de tiers (TYPTIE)

· Sigle (SIGTIE)

· Nom (NOMTIE)

· Famille (FAMTIE)

· Représentant (SIGREP)

· Groupe (SIGGRP)

· Nature

· région (CODREG)

· Compte de tiers (CPTTIE)

· Position fiscale (POSFIS)

· Mode de règlement (MODRGL)

· Code incident (CODINC)

· Zones paramétrées (CODZN1 à CODZN16)

· Libellé de l'adresse (ADRESS)

· Adresses (ADRSUI)

· Localité (LOCALI)

· Code postal (CODPOS)

· Bureau distributeur (CENPOS)

· Code pays (CODPAY)

· Contact (CONTAC)

· Fonction (FONCTI)

· Téléphone (TEL)

· Télécopie (FAX)

· Télex (TELEX)

· Siret (SIRET)

· Code APE (CODAPE)

· TVA intercommunautaire (TVAINTER)

· CODSOC

· CODETT

· CODDEV

· CNUFD

· ETBCOD

· COMMEN1 à COMMEN5

Ces informations dont valables pour toutes les entités de niveau hiérarchique supérieur à l'entité en cours de traitement.

Description :

Exemples :

~001 = ISME("0","0","CODSOC","","0") permet d'obtenir le code société de l'entité courante

~001 = ISME("0","0","NOMTIE","","0") permet d'obtenir le nom de l'entité courante

~001 = ISME(@001,"02","TEL","FAC","1") permet d'obtenir le téléphone de l'adresse de facturation de l'entité de niveau 2 supérieure à l'entité qui se trouve dans la variable @001

Cette routine maquette ISME permet aussi de récupérer le code de l'entité courante :

Exemple à mettre dans la maquette

Initialisation de variable + paramétrage mot clé :

V ~001=C(10)

V10 ~001=ISME(0,0,"CODSOC","",0)

L’instruction maquette ISQL permet de lancer une requête SQL de type « update », « delete » ou « select » directement depuis la maquette d’édition.

Vxx ~yyy=ISQL(ordre_sql)

Avec :

· xx : numéro de bloc,

· yyy : numéro de la variable (déclarée en numérique) recevant le code retour de l’exécution de l’ordre SQL (1 : OK, sinon, voir les erreurs possibles ci-dessous),

· ordre_sql : correspondant à un ordre SQL update uniquement, avec possibilité d’inclure des variables fictives.

Erreurs possibles en retour de ISQL (et ISQLxx) en mise à jour :

Instruction SQL insert

1 si le row a été inséré correctement,

-5 si la PK du row existe déjà.

Instruction SQL update

1 si le row a été mis à jour correctement,

-1 si row non trouvé.

Instruction SQL delete

1 si le row a été supprimé correctement,

-1 si row non trouvé.

Instruction SQL select

1 si le row lu correctement,

-1 si row non trouvé.

Dans tous les cas, -100 pour les erreurs non trappées

Restrictions

L’ordre SQL est limité à 10.000 caractères (5000 en version 1.55, et 980 dans les versions antérieurs à ACE 1.55).

Le nombre total de caractères retournés par la requête SQL est limité par Oracle à 4096 caractères.

Ordres SQL de type « select »

La syntaxe d’écriture de l’ordre « select » se rapproche de la syntaxe utilisée lors de l’appel d’une requête SQL dans une maquette d’édition via la solution PROC2, consistant à rapatrier une chaîne de caractère indiquant les variables fictives à renseigner, chaque valeur séparée par un point-virgule, afin de ramener une seule chaîne de caractère, de type « ~301="XXX"; ~302=nnnn.nn ».

Lorsqu’on rapatrie plusieurs variables, il faut concaténer les différentes valeurs de retour pour ne constituer qu’une chaîne de caractères en retour. Voir notre exemple ci-après.

Exemple :

V ~301=C(6)

V ~302=C(6)

V ~303="zzzzz9.999"

V10 ~301=""

V10 ~302=""

V10 ~303=0

V10 ~901=ISQL( select '~301="'||fampro||'";~302="'||sfapro||'";~303='||poids from pro where codsoc = ~202 and codpro = '~201' )

Remarques

· Si l’ordre select ramène plusieurs enregistrements, seul le premier est pris en compte pour le chargement des variables fictives. Si nécessité de travailler sur plusieurs enregistrements, voir les instructions ISQLCAV ouISQLCAP.

· Si aucun enregistrement n’est trouvé, il n’y a pas de modification des variables fictives citées dans la partie select. Il est donc prudent d’initialiser au préalable les variables attendues en retour.

Particularité 1

Lors de l’exécution de l’ordre « select » écrit de cette façon, seules les variables fictives suivant le premier « from » sont remplacées avant exécution. On ne peut donc pas dans le même « select » retourner la valeur d’une sous-requête.

Particularité 2

Une autre syntaxe consiste à marquer les variables fictives à charger en retour de l’ordre « select » par le caractère dièse. Cette fonctionnalité permet d’utiliser les variables fictives aussi dans la partie « select » afin de pouvoir utiliser les fonctions Oracle avec, en paramètre, des valeurs provenant de la maquette.

Exemple :

V ~301=C(6)

V ~302=C(6)

V ~303="zzzzz9.999"

V10 ~301=""

V10 ~302=""

V10 ~303=0

V10 ~901=ISQL( select '#301="'||fampro||'";#302="'||substr('~203',1,3)||sfapro||'";#303='||poids from pro where codsoc = ~202 and codpro = '~201' )

Particularité 3

Si la valeur d’un champ alphanumérique peut contenir des guillemets ("), ceux-ci doivent être doublés dans la valeur de retour. Pour cela, utilisez la fonction Oracle replace, comme dans cet exemple :

V10 ~901=ISQL( select '#301="'|| replace(nompro,'"','""') ||'";#302="'||substr('~203',1,3)||sfapro||'";#303='||poids from pro where codsoc = ~202 and codpro = '~201' )

Particularité 4

Utilisation des fonctions Oracle dans l’instruction ISQL pour charger une variable fictive.

Dans une requête SQL, une fonction dont le retour s’effectue par un « varchar2 » est considérée de longueur 4000.

Dans ce contexte, une fonction ORACLE de type « varchar2 » doit être utilisée obligatoirement par le biais de l’instruction « substr » permettant de limiter le nombre de caractères ramenés au nombre de caractères attendus.

V10 ~901=ISQL(select '#011="' || coduni || '";#012="' || substr(f_libtbl(1,'uni',pro.coduni),1,30) || '"' from pro where codsoc=1 and codpro='~001';

L’exemple suivant permet de récupérer 2 valeurs dans un seul appel de fonction oracle :

Extrait de la maquette :

%CR Code retour ISQL

V ~900="9"

P ISQL_TRACE

%CR Codsoc

V ~100="9999"

VEE ~100=@001

V ~160="zzzzzzzzz"

V ~161="zzzzzzzzz"

V ~162=C(8)

V10 ~900=ISQL(select '#160=9;'||substr(F_DEMO(~100),1,256) from dual )

%10 Dbg : ~160 ~161 ~162

Extrait de la fonction appelée :

CREATE OR REPLACE function F_DEMO(

codsoc_p in cts.codsoc%type

) return varchar2 is

res VARCHAR2(80);

err_num NUMBER;

err_msg VARCHAR2(100);

begin

res := '~160=0';

return ('~161=1;~162="GNC"') ;

EXCEPTION

WHEN OTHERS THEN

err_num := SQLCODE;

err_msg := SUBSTR(SQLERRM, 1, 100);

return res ;

end F_DEMO;

Résultat

Dbg : 9 1 GNC

Un autre moyen pour ramener plusieurs valeurs en retour d’une fonction Oracle est que celle-ci effectue un retour de type PIPELINED, et de l’utiliser par une syntaxe du style :

select chp1 as vf001, chp2 as vf002, chp3 as vf003 from table (FCT_ORACLE(~001,~002, ~003,~004))

Souplesse d’écriture de l’instruction ISQL

Plusieurs fonctionnalités apportent de la souplesse d’écriture des maquettes, et un gain de mise au point des maquettes avec des ordres ISQL.

1) Il vous est possible d’écrire l’instruction ISQL sur plusieurs lignes, avec possibilité d’insérer des lignes de commentaire commençant par -- (en dehors des premiers caractères blanc)

Exemple :

VEE ~999=ISQLCAV("AA",

select '~201="'||codpro||'";~202="'||nompro||'"'

from pro

where codsoc=1 and codpro like 'BR%'

-- par ordre décroissant

order by codpro DESC)

2) Vous pouvez préciser les variables fictives en retour du select par la syntaxe as vfnnn (ou as VFnnn), avec nnn = numéro (ou nom) de la variable fictive à charger.

Exemple :

VAA ~999=ISQLCAP("AB",

select dun14 as VF301,

libelle as VF302,

nbre as VF303,

poidsnet as VF304

from prl where codsoc=1 and codpro = '~201')

Cette syntaxe vous affranchit des particularités 1 à 4

Exemple :

· Ordre à exécuter par ISQL :

V10 ~900=ISQL(

select nompro as vf101, (select substr('~001',1,2) from dual) as vf106, fampro as vf102,

design1 as vf103, (select substr('~001',1,4) from dual) as vf107, design4 as vf105, design2 as vf104

from pro where codsoc=1 and codpro='~001'

)

· Ordre exécuté :

select '~101="'||RPAD(SUBSTR(nompro,1,30),30,' ')||'"'||';' || '~106="'||RPAD(SUBSTR((select substr('BR101',1,2) from dual),1,4),4,' ')||'"'||';' || '~102="'||RPAD(SUBSTR(fampro,1,6),6,' ')||'"'||';' || '~103="'||RPAD(SUBSTR(design1,1,40),40,' ')||'"'||';' || '~107="'||RPAD(SUBSTR((select substr('BR101',1,4) from dual),1,4),4,' ')||'"'||';' || '~105="'||RPAD(SUBSTR(design4,1,40),40,' ')||'"'||';' || '~104="'||RPAD(SUBSTR(design2,1,40),40,' ')||'"'||';' from pro where codsoc=1 and codpro='BR101'

3) L’utilisation des variables fictives nommées est également disponible pour l’instruction ISQL (voir chapitre « Utilisation des variables fictives ») dans les maquettes d’édition)

Utilisation des fonctions Oracle dans ACE, au niveau des vues et de l’instruction ISQL

Dans une requête SQL, une fonction dont le retour s’effectue par un « VARCHAR2 » est considérée de longueur 4000.

La taille maximum des buffers de retour des accès SQL est de 4048 (depuis la version 1.55).

Dans ce contexte, une fonction ORACLE de type VARCHAR2 doit être utilisé obligatoirement par le biais de l’instruction SUBSTR permettant de limiter le nombre de caractères ramenés au nombre de caractères attendus.

Exemple de fonction Oracle

rem ******

rem ****** Fonction de récupération du libellé d'un enrgt de table

rem ****** Attention : Une fonction PL/SQL de type VARCHAR2 retourne

rem ****** un VARCHAR2(4000) !

rem ****** Le SUBSTR est donc impératif.

rem ******

CREATE OR REPLACE function f_libtbl

( ncodsoc tbl.codsoc%type,

ncodtbl tbl.codtbl%type,

ncletbl tbl.cletbl%type )

RETURN varchar2 is

vlibtbl tbl.lib1%type ;

BEGIN

vlibtbl := ' ' ;

select lib1 into vlibtbl

from tbl

where codsoc = ncodsoc

and codtbl = ncodtbl

and cletbl = ncletbl ;

RETURN vlibtbl ;

exception when others then return vlibtbl ;

END;

Utilisée dans une Requête SQL appelé par ISQL

%10 Code produit = ~001 Unité : ~011 Libellé : ~012

V ~001=C(16)

V ~011=C(3)

V ~012=C(30)

V ~901="9"

%CM Mémorisation du code produit dans ~001

V10 ~001=@001

%CM Recherche du code unité du produit et du libellé de cette unité

V10 ~901=ISQL(select '#011="' || coduni || '";#012="' || substr(f_libtbl(1,'uni',pro.coduni),1,30) || '"' from pro where codsoc=1 and codpro='~001';

Lancement d’une procédure Oracle (PL-SQL) via l’instruction ISQL :

Pour cela, on va d’abord créer une fonction Oracle qui lance la procédure

create or replace

FUNCTION f_lance_pro_rec_complete return integer

IS

pragma AUTONOMOUS_TRANSACTION;

BEGIN

BEGIN

gxp_ot.pro_rec_complete;

return 1;

EXCEPTION

WHEN OTHERS THEN

RETURN SQLCODE;

END;

END f_lance_pro_rec_complete;

Fonction qu’on va utiliser ainsi :

V ~201="9"

V ~901="9"

V10 ~901=ISQL(select f_lance_pro_rec_complete() as vf201 from dual)

L’instruction maquette ISQL permet, sur les ordres « select .. .», de ne travailler que sur le premier row lu.

Les instructions maquette ISQLCAV("xx", select …..) et ISQLCAP("xx", select …..) permettent d’appeler un bloc vide à chaque row lu (respectivement avant et après le bloc).

Le premier paramètre correspond au bloc vide à appeler. Ce bloc devra comporter deux caractères alphabétiques, en majuscule, et ne pas commencer par C, E, P ou L (préfixes de blocs réservés).

Exemple 1 :

V ~201=C(16)

V ~202=C(30)

V ~999="9"

VEE ~999=ISQLCAV("AA",select '~201="'||codpro||'";~202="'||nompro||'"' from pro where codsoc=1 and codpro like 'BR%' order by codpro DESC)

%AA Bloc AA : Code produit=~201

%AA Bloc AA : Nom du produit=~202

Avec l’instruction ISQLCAV, le bloc vide s’édite avant le bloc sur lequel est déclarée l’instruction maquette.

Avec l’instruction ISQLCAP, le bloc vide s’édite après le bloc sur lequel est déclarée l’instruction maquette (attention, dans ce cas, seules les instructions ISQLCAP sont traitées après l’édition du bloc le déclenchant, les autres variables fictives sont calculées avant l’édition du bloc déclenchant le ISQLCAP).

Dans l’exemple 1, le bloc AA s’édite avant le bloc EE, et celui-ci peut aussi appeler un ISQLCxx et calcul sur des variables fictives

Exemple 2 :

V ~201=C(16)

V ~202=C(30)

V ~301=C(14)

V ~302=C(30)

V ~999="9"

VEE ~999=ISQLCAV("AA",select '~201="'||codpro||'";~202="'||nompro||'"' from pro where codsoc=1 and codpro like 'BR%' order by codpro DESC)

VAA ~999=ISQLCAP("AB",select '~301="'||dun14||'";~302="'||libelle||'"' from prl where codsoc=1 and codpro = '~201')

%AA Bloc AA - Code produit=~201

%AA Bloc AA - Nom du produit=~202

%AB Bloc AB - Code produit=~201 PRL dun14 : ~301

%AB Bloc AB - Code produit=~201 PRL libelle : ~302

Dans l’exemple 2, le bloc AB s’édite après l’édition du bloc AA.

Exemples de cas interdits :

Exemple a) :

VAA ~901=ISQLCxx("AA", xxxx)

Exemple b) :

VAA ~901=ISQLCxx("AB", xxxx)

VAB ~901=ISQLCxx("AA", xxxx)

Exemple c) :

VAA ~901=ISQLCxx("AB", xxxx)

VAB ~901=ISQLCxx("AC", xxxx)

VAB ~901=ISQLCxx("AB", xxxx)

Cette fonction, utilisable dans les maquettes d’édition, permet de rechercher la valeur d’un compteur de stock.

L’instruction comporte plusieurs paramètres :

Cette fonction, utilisable dans les maquettes d’édition, permet de rechercher des informations sur les zones paramétrées datées (table ZOD).

Paramètres de l’instruction :

Voici un exemple :

V ~901=C(3)

VPE ~901="CLI"

V ~902=C(16)

VPE ~902="MAI001"

V ~903=C(3)

VPE ~903="102"

V ~904=C(8)

VPE ~904=””

V ~905=C(40)

V ~906=C(30)

V ~907=C(10)

Les informations nécessaires à l'exécution

~901 = Type de zone paramétrée datée,

~902 = Clé de la zone paramétrée datée,

~903 = Numéro de la zone paramétrée datée,

~904 = Date de la recherche.

Les informations retournées :

~905 = Valeur de la zone paramétrée datée

~906 = Libellé de la zone paramétrée datée

~907 = Libellé réduit de la zone paramétrée datée

Pour les chaînes de caractères, c’est la taille de la variable fictive qui donne la longueur de la chaîne.

Cette fonction est utilisée en autre pour lancer une réédition depuis l’application web d’un fichier du serveur, en utilisant les imprimantes connues du serveur de traitement, et ceci via un GEDTE en batch rapide, avec les options

Option1 : impression

Option2 : N° de société è que l’on récupérera en ~102 dans l’exemple

Option3 : N° de spool è que l’on récupérera en ~103 dans l’exemple

Option que l’on récupère du bloc EE pour l’appel à l’instruction maquette VEE ~901=LPRINT(~102, ~103)

Paramètres de l’instruction :

Voici un exemple :

longueur=9999

P UTIL_VARNOM

V ~CODRET=""

V ~SOCSPL=""

V ~NUMSPL=""

V ~NOMFIC=C(31))

VEE ~SOCSPL=@5

VEE ~NUMSPL=@6

VEE ~NOMFIC=@7

VEE ~CODRET=LPRINT(~SOCSPL,~NUMSPL,~NOMFIC)

MAJACT : Alimentation du dossier client

Paramètres de l’instruction :

Certaines informations de l'action peuvent être mises à jour directement par l'instruction maquette MAJACT sans avoir à utiliser forcément la notion de contexte d'appel (fonction GCXA).

Exemple : création d'une action sur le client PAINYCHE en s'arrêtant aux n° d'événement :

V ~901=C(3)

V05 ~901="CLI"

V ~902=C(10)

V05 ~902=" PAINYCHE "

V ~903=C(5)

V05 ~903="APPEL"

V ~905=C(1)

V05 ~905="V"

V ~906=C(3)

V05 ~906="CDE"

V ~907="zzzzzzz",36

V ~908="zzzzzzz"

V05 ~908=MAJACT(~901,~902,~903,"",~905,~906,~907)

Depuis la version 162, on peut laisser vide les noms de variable que l’on n’a pas à renseigner.

Exemple :

V ~RET_MAJACT="9999"

V ~NUMTIM="999999999"

VEE ~RET_MAJACT=MAJACT("CLI","BRCLI101","CRMDTX","Test",,,,"Lib1","Lib2",,,,,,,,,,,,"Zn1",,,,,,,,,,,,,,,,,,,,,~NUMTIM)

Mise à jour des cinq premières zones paramétrées de la table des contacts (CTC) :

Ø Type de tiers (typtie),

Ø Sigle tiers (sigtie),

Ø Type d’adresse (typadr),

Ø N° adresse (numadr),

Ø N° du contact (numord),

Ø N° et valeur de la zone paramétrée (de 1 à 5).

Mise à jour des cinq premières zones paramétrées de la table des tiers (TIE) :

Ø Type de tiers (typtie),

Ø Sigle tiers (sigtie),

Ø N° et valeur de la zone paramétrée ( de 1 à 5).

Cette fonction, utilisable dans les maquettes d’édition, permet d’effectuer une mise à jour des zones paramétrées datées (table ZOD).

Paramètres de l’instruction :

Exemple :

V ~902=C(16)

V10 ~902=@001

VPE ~910=IZOD("PRO",~902,"105",””,”VALIDE”)

Ces instructions permettent de mettre à jour (mise à jour ou création) la donnée complémentaire PRO105 (table zod) du produit donné par @001 avec la valeur «VALIDE».

Donne le nombre de lignes déjà éditées pour la page, juste avant le bloc depuis lequel l’instruction est appelée. Peut servir à forcer un saut de page (ligne préfixée par R) pour permettre d’éditer un bloc entier.

Exemples :

V10 ~006=NBLED()

Donne le nombre total d’enregistrements sélectionnés.

Exemples :

V10 ~006=NBLSEL()

Donne le nombre d’enregistrements déjà traitées, dont l’enregistrement en cours de traitement.

Exemples :

V10 ~006=NBLTRT()

Cette instruction permet d’écrire des lignes dans le fichier journal (.log) du traitement à partir de la maquette. Cette instruction n’utilise qu’un paramètre en entrée correspondant à la chaîne de caractères à écrire dans le fichier journal. Si cette chaîne de caractères contient des variables fictives, elles seront remplacées par leurs valeurs respectives.

Exemple :

VEE ~001=@339

VEE ~901=PRINTF("#NUMERO_EMAIL=~001")

Cette instruction maquette permet de rechercher une valeur définie au niveau du paramétrage des barèmes (table BAP), en sélectionnant la première valeur trouvée par rapport aux couples QUE/QUE définis.

L’instruction maquette utilise plusieurs critères :

Exemple (depuis la fonction EDEVE) :

longueur=63

largeur=132

%CR Variables retournées par la recherche BAP

V ~112=C(3)

V ~113=C(12)

V ~114="999999999"

V ~115="999999999"

V ~116=C(30)

V ~117=C(3)

V ~118=C(12)

V ~119=C(3)

V ~120="999.99"

V ~121=C(3)

%CR Variables d'entrées

V ~106=C(1)

V ~107=C(3)

V ~108="999999999"

V ~109="99999"

V ~017=C(10)

V ~018=C(1)

V ~019=C(1)

V ~020=C(4)

V ~021=C(16)

V ~022=C(10)

%CM Achvte d’evp

V10 ~106=@32

%CM Typeve d’evp

V10 ~107=@33

%CM Numeve d’evp

V10 ~108=@34

%CM Numpos d’evp

V10 ~109=@35

V10

~010=RBAP("V","CTD","","","",~106,~107,~108,~109,"","",~112,~113,~116,~117,~118,~119,~121)

%10 Typtie (de bap) : ~112

%10 Sigtie (de bap) : ~113

%10 Num1 (de bap) : ~114

%10 Num2 (de bap) : ~115

%10 Lib1 (de bap) : ~116

%10 Typtie1 (de bap) : ~117

%10 Sigtie1 (de bap) : ~118

%10 Codbar (de bap) : ~119

%10 Taucom (de bap) : ~120

%10 Coduni (de bap) : ~121

Cette instruction maquette permet de récupérer une valeur numérique depuis la recherche des Conditions Tarifaires (CTS).

Les CTS peuvent être de type simple (affectation d’un taux) ou par seuil (attribution de prime en fonction d’un chiffre d’affaire).

La fonction RCTS peut utiliser des CTS définies par le mécanisme des Que/Que hors tout autre traitement dédié (panachage complexe, calcul de taxe, …).

L’instruction comporte plusieurs paramètres :

Lors de la recherche de conditions tarifaires, la prise en compte des QUE (voir fonction GTQUE) dépendant d’un événement sera possible en précisant les paramètres 6, 7 et 8.

La prise en compte des QUE dépendant d’un poste sera possible en précisant, en plus, un numéro de poste (paramètre 9).

Règles de gestion :

Exemple d’utilisation sans ramener le détail :

V ~901=C(1)

VPE ~901="V"

V ~902=C(3)

VPE ~902="LIG"

V ~903=C(3)

VPE ~903="CLI"

V ~904=C(12)

VPE ~904="00000002"

V ~905=C(16)

VPE ~905="050001"

V ~906=C(1)

VPE ~906="V"

V ~907=C(3)

VPE ~907="CDE"

V ~908="9999999",98765

V ~909="999",1

V ~910=C(10)

VPE ~910="01/07/2002"

V ~911="zzzzzz.zz",100.00

V ~912="zzzzzz.zz"

V ~913="zzzzzz.zz"

V ~914="zzzzzz.zz"

V ~915="zzzzzz.zz",100.00

V ~916=C(3)

VPE ~916="EUR"

V ~917="zzzzz9",10

V ~918=C(3)

VPE ~918="U "

V ~920="zzzzz9,99"

VPE ~920=RCTS(~901,~902,~903,~904,~905,~906,~907,~908,~909,~910,~911,

~912,~913,~914,~915,~916,~917,~918)

Exemple ramenant le détail :

%CR Catégories de remise (21)

V ~121=C(3)," "

V ~122=C(3)," "

V ~123=C(3)," "

V ~124=C(3)," "

V ~125=C(3)," "

V ~126=C(3)," "

V ~127=C(3)," "

V ~128=C(3)," "

V ~129=C(3)," "

V ~130=C(3)," "

V ~131=C(3)," "

V ~132=C(3)," "

V ~133=C(3)," "

V ~134=C(3)," "

V ~135=C(3)," "

V ~136=C(3)," "

V ~137=C(3)," "

V ~138=C(3)," "

V ~139=C(3)," "

V ~140=C(3)," "

%CR Bases de calcul (22)

V ~141="z",0

V ~142="z",0

V ~143="z",0

V ~144="z",0

V ~145="z",0

V ~146="z",0

V ~147="z",0

V ~148="z",0

V ~149="z",0

V ~150="z",0

V ~151="z",0

V ~152="z",0

V ~153="z",0

V ~154="z",0

V ~155="z",0

V ~156="z",0

V ~157="z",0

V ~158="z",0

V ~159="z",0

V ~160="z",0

%CR Types de valeurs (23)

V ~161=C(1)," "

V ~162=C(1)," "

V ~163=C(1)," "

V ~164=C(1)," "

V ~165=C(1)," "

V ~166=C(1)," "

V ~167=C(1)," "

V ~168=C(1)," "

V ~169=C(1)," "

V ~170=C(1)," "

V ~171=C(1)," "

V ~172=C(1)," "

V ~173=C(1)," "

V ~174=C(1)," "

V ~175=C(1)," "

V ~176=C(1)," "

V ~177=C(1)," "

V ~178=C(1)," "

V ~179=C(1)," "

V ~180=C(1)," "

%CR Valeurs remises (24)

V ~181="zzzzz.zzzz",0

V ~182="zzzzz.zzzz",0

V ~183="zzzzz.zzzz",0

V ~184="zzzzz.zzzz",0

V ~185="zzzzz.zzzz",0

V ~186="zzzzz.zzzz",0

V ~187="zzzzz.zzzz",0

V ~188="zzzzz.zzzz",0

V ~189="zzzzz.zzzz",0

V ~190="zzzzz.zzzz",0

V ~191="zzzzz.zzzz",0

V ~192="zzzzz.zzzz",0

V ~193="zzzzz.zzzz",0

V ~194="zzzzz.zzzz",0

V ~195="zzzzz.zzzz",0

V ~196="zzzzz.zzzz",0

V ~197="zzzzz.zzzz",0

V ~198="zzzzz.zzzz",0

V ~199="zzzzz.zzzz",0

V ~200="zzzzz.zzzz",0

%CR Prix intermédiaires (25)

V ~201="zzzzz.zzzz",0

V ~202="zzzzz.zzzz",0

V ~203="zzzzz.zzzz",0

V ~204="zzzzz.zzzz",0

V ~205="zzzzz.zzzz",0

V ~206="zzzzz.zzzz",0

V ~207="zzzzz.zzzz",0

V ~208="zzzzz.zzzz",0

V ~209="zzzzz.zzzz",0

V ~210="zzzzz.zzzz",0

V ~211="zzzzz.zzzz",0

V ~212="zzzzz.zzzz",0

V ~213="zzzzz.zzzz",0

V ~214="zzzzz.zzzz",0

V ~215="zzzzz.zzzz",0

V ~216="zzzzz.zzzz",0

V ~217="zzzzz.zzzz",0

V ~218="zzzzz.zzzz",0

V ~219="zzzzz.zzzz",0

V ~220="zzzzz.zzzz",0

%CR N° de CTS (26)

V ~221="zzzzzz",0

V ~222="zzzzzz",0

V ~223="zzzzzz",0

V ~224="zzzzzz",0

V ~225="zzzzzz",0

V ~226="zzzzzz",0

V ~227="zzzzzz",0

V ~228="zzzzzz",0

V ~229="zzzzzz",0

V ~230="zzzzzz",0

V ~231="zzzzzz",0

V ~232="zzzzzz",0

V ~233="zzzzzz",0

V ~234="zzzzzz",0

V ~235="zzzzzz",0

V ~236="zzzzzz",0

V ~237="zzzzzz",0

V ~238="zzzzzz",0

V ~239="zzzzzz",0

V ~240="zzzzzz",0

%CR Libellés catégories (27)

V ~241=C(30)," "

V ~242=C(30)," "

V ~243=C(30)," "

V ~244=C(30)," "

V ~245=C(30)," "

V ~246=C(30)," "

V ~247=C(30)," "

V ~248=C(30)," "

V ~249=C(30)," "

V ~250=C(30)," "

V ~251=C(30)," "

V ~252=C(30)," "

V ~253=C(30)," "

V ~254=C(30)," "

V ~255=C(30)," "

V ~256=C(30)," "

V ~257=C(30)," "

V ~258=C(30)," "

V ~259=C(30)," "

V ~260=C(30)," "

%CR Natures (28)

V ~261=C(12)," "

V ~262=C(12)," "

V ~263=C(12)," "

V ~264=C(12)," "

V ~265=C(12)," "

V ~266=C(12)," "

V ~267=C(12)," "

V ~268=C(12)," "

V ~269=C(12)," "

V ~270=C(12)," "

V ~271=C(12)," "

V ~272=C(12)," "

V ~273=C(12)," "

V ~274=C(12)," "

V ~275=C(12)," "

V ~276=C(12)," "

V ~277=C(12)," "

V ~278=C(12)," "

V ~279=C(12)," "

V ~280=C(12)," "

%CR Indicateur répercuté dans prix de cession (29)

V ~281=C(1)," "

V ~282=C(1)," "

V ~283=C(1)," "

V ~284=C(1)," "

V ~285=C(1)," "

V ~286=C(1)," "

V ~287=C(1)," "

V ~288=C(1)," "

V ~289=C(1)," "

V ~290=C(1)," "

V ~291=C(1)," "

V ~292=C(1)," "

V ~293=C(1)," "

V ~294=C(1)," "

V ~295=C(1)," "

V ~296=C(1)," "

V ~297=C(1)," "

V ~298=C(1)," "

V ~299=C(1)," "

V ~300=C(1)," "

%CR Dates de début (30)

V ~301=C(10)," "

V ~302=C(10)," "

V ~303=C(10)," "

V ~304=C(10)," "

V ~305=C(10)," "

V ~306=C(10)," "

V ~307=C(10)," "

V ~308=C(10)," "

V ~309=C(10)," "

V ~310=C(10)," "

V ~311=C(10)," "

V ~312=C(10)," "

V ~313=C(10)," "

V ~314=C(10)," "

V ~315=C(10)," "

V ~316=C(10)," "

V ~317=C(10)," "

V ~318=C(10)," "

V ~319=C(10)," "

V ~320=C(10)," "

%CR Dates de fin (31)

V ~321=C(10)," "

V ~322=C(10)," "

V ~323=C(10)," "

V ~324=C(10)," "

V ~325=C(10)," "

V ~326=C(10)," "

V ~327=C(10)," "

V ~328=C(10)," "

V ~329=C(10)," "

V ~330=C(10)," "

V ~331=C(10)," "

V ~332=C(10)," "

V ~333=C(10)," "

V ~334=C(10)," "

V ~335=C(10)," "

V ~336=C(10)," "

V ~337=C(10)," "

V ~338=C(10)," "

V ~339=C(10)," "

V ~340=C(10)," "

%CR Types de remises (32)

V ~341=C(1)," "

V ~342=C(1)," "

V ~343=C(1)," "

V ~344=C(1)," "

V ~345=C(1)," "

V ~346=C(1)," "

V ~347=C(1)," "

V ~348=C(1)," "

V ~349=C(1)," "

V ~350=C(1)," "

V ~351=C(1)," "

V ~352=C(1)," "

V ~353=C(1)," "

V ~354=C(1)," "

V ~355=C(1)," "

V ~356=C(1)," "

V ~357=C(1)," "

V ~358=C(1)," "

V ~359=C(1)," "

V ~360=C(1)," "

V ~111="zzzz9.9999"

V ~112="z9.99"

V ~113="zzzz9.9999"

V ~114="zzzz9.9999"

V ~116="99"

V ~118=C(3)

V ~119=C(9)

V ~120=C(1)

V10 ~111=1000

V10 ~999=RCTS("V", "LIG", "CLI", "BRCLI102", "BR105", "", "", 0, 0, "", ~111, ~112, ~113, ~114, , "EUR", 1, ~118, ~119, ~120, 121, 141, 161, 181, 201, 221, 241, 261, 281, 301, 321, 341, 20, ~116)

%10 Résultat :

%10 Prix départ : ~111

%10 Prix remisé : ~114

%10

%10 Soit ~112 % de remise effective

%10

%10 Détail des ~116 CTS appliquées :

%10

%10 |Numord|Codcre|Bascal|Typval| Valrem | PrxvduI |Numcot | Libcre | Codstat |Indact| Datdeb Datfin |Typrem|

&10 | 1 | ~121 | ~141 | ~161 |~181 |~201 |~221 |~241 |~261 |~281 |~301 ~321 |~341 |

&10 | 2 | ~122 | ~142 | ~162 |~182 |~202 |~222 |~242 |~262 |~282 |~302 ~322 |~342 |

&10 | 3 | ~123 | ~143 | ~163 |~183 |~203 |~223 |~243 |~263 |~283 |~303 ~323 |~343 |

&10 | 4 | ~124 | ~144 | ~164 |~184 |~204 |~224 |~244 |~264 |~284 |~304 ~324 |~344 |

&10 | 5 | ~125 | ~145 | ~165 |~185 |~205 |~225 |~245 |~265 |~285 |~305 ~325 |~345 |

&10 | 6 | ~126 | ~146 | ~166 |~186 |~206 |~226 |~246 |~266 |~286 |~306 ~326 |~346 |

&10 | 7 | ~127 | ~147 | ~167 |~187 |~207 |~227 |~247 |~267 |~287 |~307 ~327 |~347 |

&10 | 8 | ~128 | ~148 | ~168 |~188 |~208 |~228 |~248 |~268 |~288 |~308 ~328 |~348 |

&10 | 9 | ~129 | ~149 | ~169 |~189 |~209 |~229 |~249 |~269 |~289 |~309 ~329 |~349 |

&10 | 10 | ~130 | ~150 | ~170 |~190 |~210 |~230 |~250 |~270 |~290 |~310 ~330 |~350 |

&10 | 11 | ~131 | ~151 | ~171 |~191 |~211 |~231 |~251 |~271 |~291 |~311 ~331 |~351 |

&10 | 12 | ~132 | ~152 | ~172 |~192 |~212 |~232 |~252 |~272 |~292 |~312 ~332 |~352 |

&10 | 13 | ~133 | ~153 | ~173 |~193 |~213 |~233 |~253 |~273 |~293 |~313 ~333 |~353 |

&10 | 14 | ~134 | ~154 | ~174 |~194 |~214 |~234 |~254 |~274 |~294 |~314 ~334 |~354 |

&10 | 15 | ~135 | ~155 | ~175 |~195 |~215 |~235 |~255 |~275 |~295 |~315 ~335 |~355 |

&10 | 16 | ~136 | ~156 | ~176 |~196 |~216 |~236 |~256 |~276 |~296 |~316 ~336 |~356 |

&10 | 17 | ~137 | ~157 | ~177 |~197 |~217 |~237 |~257 |~277 |~297 |~317 ~337 |~357 |

&10 | 18 | ~138 | ~158 | ~178 |~198 |~218 |~238 |~258 |~278 |~298 |~318 ~338 |~358 |

&10 | 19 | ~139 | ~159 | ~179 |~199 |~219 |~239 |~259 |~279 |~299 |~319 ~339 |~359 |

&10 | 20 | ~140 | ~160 | ~180 |~200 |~220 |~240 |~260 |~280 |~300 |~320 ~340 |~360 |

Cette fonction permet de remplacer une chaîne de caractère (1 à n) par une autre chaîne de caractère (0 à n) dans une chaîne de caractère.

La chaîne de caractère traitée est disponible en retour de la fonction REPLACE (retour de type Char)

Exemple avec « Mode de remplacement » vide :

V ~110=C()

V ~111=C()

VEE ~110="Test de l'instruction 'REPLACE'"

VEE ~111=REPLACE(~110,"'","\'")

La valeur de ~111 sera égale à "Test de l\'instruction \'REPLACE\'"

Listes des caractères remplacés sur la chaine en mode de remplacement HTML :

Cette fonction permet de vérifier si un paramètre (PPE) est positionné dans l’environnement du traitement et d’identifier la valeur d’une option du paramètre.

La recherche du PPE s’effectue sur la cible utilisée par le batch, et si non présent, sur les flux métiers associés, sinon, au niveau général.

Code retour de la fonction :

· 1, si le ppe est actif,

· 0, si le ppe n’est pas actif (ou non positionné),

· -1 en cas d’erreur d’utilisation.

Exemple :

P UTIL_VARNOM

V ~PARA1=B(6)

V ~PARA2=B(6)

V ~PARA3=B(6)

V ~PARM1=B(12)

V ~PARM2=B(12)

V ~PARL1=C(256)

V ~PARN1="9999"

V ~PARN2="9999"

V ~PARN3="9999"

V ~PARN4="9999"

V ~PARN5="9999"

V ~PARD1="9999.999"

V ~PARD2="9999.999"

V ~PARD3="9999.999"

V ~EXIS_PPE="9"

VEE ~EXIS_PPE=RPPE("TEST","A1",~PARA1)

VEE ~EXIS_PPE=RPPE("TEST","A2",~PARA2)

VEE ~EXIS_PPE=RPPE("TEST","A3",~PARA3)

VEE ~EXIS_PPE=RPPE("TEST","M1",~PARM1)

VEE ~EXIS_PPE=RPPE("TEST","M2",~PARM2)

VEE ~EXIS_PPE=RPPE("TEST","L1",~PARL1)

VEE ~EXIS_PPE=RPPE("TEST","N1",~PARN1)

VEE ~EXIS_PPE=RPPE("TEST","N2",~PARN2)

VEE ~EXIS_PPE=RPPE("TEST","N3",~PARN3)

VEE ~EXIS_PPE=RPPE("TEST","N4",~PARN4)

VEE ~EXIS_PPE=RPPE("TEST","N5",~PARN5)

VEE ~EXIS_PPE=RPPE("TEST","D1",~PARD1)

VEE ~EXIS_PPE=RPPE("TEST","D2",~PARD2)

VEE ~EXIS_PPE=RPPE("TEST","D3",~PARD3)

%EE PPE positionné = ~EXIS_PPE

%EE ParA1 = ~PARA1

%EE ParA2 = ~PARA2

%EE ParA3 = ~PARA3

%EE ParM1 = ~PARM1

%EE ParM2 = ~PARM2

%EE ParL1 = ~PARL1

%EE ParN1 = ~PARN1

%EE ParN2 = ~PARN2

%EE ParN3 = ~PARN3

%EE ParN4 = ~PARN4

%EE ParN5 = ~PARN5

%EE ParD1 = ~PARD1

%EE ParD2 = ~PARD2

%EE ParD3 = ~PARD3

Cette fonction permet de faire une recherche de l'habilitation selon le type de QUE (table HQUE).

Exemple :

longueur=63

largeur=132

%EP<FF>

%EP@1 Le @13

%EP@3 Page n° @14

%EP@2 @4 @5 @6 @7

%EP@8 @9 @10 @11 @12

%CR Variables retournées par la recherche HQUE

V ~001=C(40)

V ~002=C(40)

V ~003=C(1)

V ~004=C(1)

V ~005="9"

V ~006="9"

%CR Code TVA trouvé par recherche HQUE

V ~010="9"

%CR Variables d'entrées

V ~011=C(12)

V ~012=C(16)

V ~013=C(1)

V ~014=C(3)

V ~015="999999999"

V ~016="99999"

V ~017=C(10)

V ~018=C(1)

V ~019=C(1)

V ~020=C(4)

V ~021=C(16)

V ~022=C(10)

V05 ~011=@76

V10 ~012=@57

V10 ~013=@32

V10 ~014=@33

V10 ~015=@34

V10 ~016=@35

V10 ~017=@718

V10 ~018=@2

V10 ~019=@19

V10 ~020=""

V10 ~021=""

V10 ~022=@148

V10 ~010=RHQUE("V","TVA","CLI",~011,~012,~013,~014,~015,~016,~017,~018,~19,~20,~21,~22,4,~001,~002,~003,~004,~005,~006)

%10 Produit : @57 @58

%10 Code TVA : ~001

%PP

Dans cet exemple, le mode utilisé est le mode « 4 » (recherche d’un code TVA).

On récupère, dans la variable fictive ~001, le code TVA correspondant aux critères.

Cette instruction maquette permet de faire un appel prix (y compris les prix promotion et les prix grossiste) pour un article, un tiers …, à l’achat et/ou à la vente.

Utilisable pour toutes les éditions, elle permet notamment aux points de vente d’une organisation de type Retail, de consulter à tout moment les tarifs en cours du produit, pour l’Achat comme pour la Vente, ainsi que le prix de vente conseillé (PVC) par la Centrale d’Achat pour un article donné.

Sortie : code retour.

Code Achat/Vente

· A = Achat,

· V = Vente,

· R = Revient.

Appel prix

Si le code option (variable n°11) est à zéro, l’appel prix ne se fait que pour la valeur du paramètre 1 (achvte).

Pour les prix promotion, l’appel prix s’effectue normalement, sauf pour les conditions tarifaires. En effet, le moteur de recherche n’applique que les conditions tarifaires dont la catégotie de remise est précisée dans le paramètreCTSCRE.

Ce paramètre précise en effet les catégories de remise qui permettent d’identifier les promotions (A1 et/ou A2). En mode RETAIL, il faut obligatoirement renseigner ce paramètre si on veut obtenir les tarifs permanents et promotions. Mettre 1 dans le N1 et préciser au moins une catégorie de remise sur le A1 ou le A2.

Si ce paramètre n’est pas positionné, le tarif permanent tient compte des promotions. Les tarifs promotions ne seront pas renseignés. L’instruction maquette peut donc être utilisée hors contexte RETAIL.

Accord fournisseur

L’application de l’accord fournisseur est réalisée par rapport à la date passée en paramètre (variable n°14). Si cette date n’est pas renseignée, on prend la date du jour.

La recherche de l’accord est déclenchée uniquement si le paramètre RECCNT est positionné (A1=A).

Tarif d’achat permanent

Le tarif achat permanent (variable n° 5) tient compte de l’accord fournisseur.

Exemple : l’instruction suivante fournit le prix de revient dans la variable ~709:

%CR : RPRX

V ~701=C(1),"R"

V ~702=C(3),""

V ~703=C(12),""

V ~704=C(16)

V ~705="999999.999"

V ~706=C(8)

V ~707="999999.999"

V ~708="999999.999"

V ~709="999999.999"

V ~710="999999.999"

V10 ~704="AG100"

V10 ~999=RPRX(~701,~702,~703,~704,~705,~706,~707,~708,~709,~710)

Cette fonction permet de rechercher un prix tarif au niveau d’un fournisseur.

Utilisée conjointement avec une succession de fonction RCTS, cette fonction permet par exemple de bâtir un fichier pour l’intégrateur (fonction INTEG).

L’instruction maquette possède plusieurs paramètres.

Les paramètres en retour sont les suivants :

o le code barème,

o le code devise,

o l’unité de facturation,

o le prix,

o le prix de revient,

o le mode de tarification.

Permet de substituer un caractère par un autre, ensemble de caractères donné par une ttu via le ppe SUBCAR, ou suivant la liste par défaut adaptée pour la génération des fichiers de virements bancaires au format XML (SEPA) (concernant notamment les caractères de code ascii supérieur à 127).

Cette instruction maquette s’utilise de la façon suivante :

V ~102=C(30)

V10 ~102=@012(SUBCAR)

Exemple :

V ~101=C(30)

V ~102=C(30)

V10 ~101="31 Allée du Général Leclerc"

V10 ~102=~101(SUBCAR)

~102 recevra "31.Allee.du.General.Leclerc"

Liste par défaut des caractères spéciaux pouvant être substitués :

Cette fonction permet de valoriser l’évènement.

L’instruction maquette possède plusieurs paramètres :

Exemple d’utilisation avec un appel depuis la fonction GEDTE :

P UTIL_VARNOM

V ~SOCEVE="9999"

V ~ACHVTE=C(1)

V ~TYPEVE=C(3)

V ~NUMEVE="999999999"

V ~CUMHT="zzzzzzzz9.99"

V ~CUMTVA="zzzzzzzz9.99"

V ~CUMTTC="zzzzzzzz9.99"

V ~MODHT_TTC=C(3)

V ~NBLIG_TVA="z9"

V ~TVA_1_CODTVA=C(1)

V ~TVA_1_TAUTVA="z9.99"

V ~TVA_1_MTHT="zzzzzzzz9.99"

V ~TVA_1_MTTVA="zzzzzzzz9.99"

V ~TVA_1_MTTTC="zzzzzzzz9.99"

V ~TVA_2_CODTVA=C(1)

V ~TVA_2_TAUTVA="z9.99"

V ~TVA_2_MTHT="zzzzzzzz9.99"

V ~TVA_2_MTTVA="zzzzzzzz9.99"

V ~TVA_2_MTTTC="zzzzzzzz9.99"

P LIST_VARNOM

V10 ~SOCEVE=CODSOC("EVE","")

V10 ~ACHVTE=@1

V10 ~TYPEVE=@2

V10 ~NUMEVE=@3

V10 ~999=VALOEVE(~SOCEVE,~ACHVTE,~TYPEVE,~NUMEVE,"","",~MODHT_TTC,,,,,~CUMHT,~CUMTVA,~CUMTTC,, ~NBLIG_TVA,~TVA_1_CODTVA,,~TVA_1_TAUTVA,~TVA_1_MTHT,~TVA_1_MTTVA,~TVA_1_MTTTC,~TVA_2_CODTVA,,~TVA_2_TAUTVA,~TVA_2_MTHT,~TVA_2_MTTVA,~TVA_2_MTTTC)

%10 Evénement en : ~MODHT_TTC

%10 Montant HT = ~CUMHT

%10 Montant TVA = ~CUMTVA

%10 Montant TTC = ~CUMTTC

%10

%10 Nombre de ligne de TVA : ~NBLIG_TVA

%10 TVA-1

%10 Code TVA = ~TVA_1_CODTVA

%10 Taux TVA = ~TVA_1_TAUTVA

%10 Base HT = ~TVA_1_MTHT

%10 Montant TVA = ~TVA_1_MTTVA

%10 Montant TTC = ~TVA_1_MTTTC

%10 TVA-2

%10 Code TVA = ~TVA_2_CODTVA

%10 Taux TVA = ~TVA_2_TAUTVA

%10 Base HT = ~TVA_2_MTHT

%10 Montant TVA = ~TVA_2_MTTVA

%10 Montant TTC = ~TVA_2_MTTTC

Il est possible de conditionner l’édition des lignes d’un bloc.

Pour ce faire, le format attendu est le suivant :

Tbb si (@001 = ~001)

%bb @001

%bb @002

Tbb else

%bb @002

%bb @001

Tbb fsi

La variable utilisée au niveau du test peut être une variable fictive mais dans ce cas, cette variable doit être déclarée et valorisée avant la ligne d’édition. Il faut donc dans ce cas déclarer ces variables en début de maquette et non à la fin comme c’est généralement le cas.

Exemple :

T10 si (@001="ENTREE")

%10 Entrée en stock : Produit : @002

%10 Quantité : @003

T10 fsi

Ce principe peut aussi être utilisé pour conditionner les affectations et les calculs sur les variables fictives.

Exemples équivalents :

T10 si (~001="A")

V10 ~002=@001 V10 ~002=@001 si (~001="A")

V10 ~003=~003+@002 V10 ~003=~003+@002 si (~001="A")

T10 else

V10 ~004=@001 V10 ~004=@001 si (~001<>"A")

V10 ~005=~005+@002 V10 ~005=~005+@002 si (~001<>"A")

T10 fsi

Il est possible d’inclure un fichier annexe dans une maquette. Le format attendu est le suivant :

include="ap$std :ee_132.std"

Par exemple, les données à faire apparaître en entête d’édition ou de page sont souvent les mêmes. Il est alors plus simple de maintenir l’ensemble des maquettes en utilisant la possibilité d’inclure un fichier unique dans de nombreuses maquettes.

Le répertoire utilisé doit être défini dans le fichier « Generix.ini ».

Il est possible de copier le fichier résultat d’un traitement différé dans un autre fichier dont la localisation est à définir. Le format attendu est le suivant :

P INTERFACE="xxxxxxx,c,mmm,yyyy,ext,pppp"

avec :

· xxxxxx :

localisation du fichier

Si non renseigné, on prendra le nom du fichier spool avec l’extension .int et place de .spl

· c :

caractère terminateur des enregistrements à supprimer lors de la création du fichier interface (permet de créer des enregistrements dans une la longueur attendue)

· mmm :

peut prendre les valeurs

APPEND pour ouvrir le fichier interface en mode APPEND

DECOUP si on veut découper le fichier spool en plusieurs fichiers interface. Dans ce cas, xxxxxx correspond au mot clé déclenchant le découpage. Voir mode DECOUP.

(on peut combiner les valeurs avec |)

· yyy :

peut prendre la valeur MINMAJ si le nom du fichier interface créé doit respecter la casse (minuscules / majuscules) du nom demandé par la maquette.

· ext :

extension finale du fichier interface.

Permet de créer un fichier d'interface "temporaire", non visible d’un EAI externe, et de le renommer avec cette extension pour le rendre visible (une fois le fichier disponible) d’un EAI externe scrutant régulièrement le répertoire.

· pppp :

si renseigné, correspond au nom d’une procédure exécutée juste après la fermeture du fichier créé, avec comme paramètre le chemin complet + nom du fichier créé. Ce traitement s’effectue avant la prise en compte de l’option ext.

Exemple d’utilisation :

Depuis un serveur de traitement sous Linux, créer un fichier d’interface au format DOS

P INTERFACE=",,DECOUP,MINMAJ,,ap$tmp:unix2dos.bat"

avec la procédure unix2dos.bat

# Cette procedure, appellee depuis une maquette d'edition,

# permet de transformer le fichier passe en parametre au format DOS

unix2dos $1

exit

Exemples :

P__ INTERFACE="ap$int:interface.lis"

P__ INTERFACE="ap$int:interface.lis,| "

P__ INTERFACE="ap$int:interface.lis,|,APPEND"

P__ INTERFACE="ap$int:interface.lis,,APPEND"

Il est également possible d’utiliser des variables fictives pour xxxxxx (nom de fichier ou mot clé de découpe) :

Exemple :

P__ INTERFACE="~001"

Il est également possible d’obtenir un fichier interface dont le nom respecte la casse (minuscules / majuscules) écrite dans la maquette.

Pour ce faire, il suffit d’ajouter le paramètre MINMAJ à la fin de la ligne « P INTERFACE ».

Par défaut le comportement est inchangé, on effectue systématiquement la mise en minuscule du nom du fichier.

Ex 1 : P INTERFACE= "NomFichier.test,,,MINMAJ "

Ce qui donnera un fichier NomFichier.test

Ex 2 : P INTERFACE="NomFichier.test "

Ce qui donnera un fichier nomfichier.test.

Mode DECOUP

C’est le fichier spool qui donne le nom des fichiers interfaces à générer, par une ligne commençant par un mot clé, que l’on précisera en xxxxxx. Si pas de mot clé précisé, on prend alors ###DECOUP_FICHIER=

Le nom de fichier se trouve sur la même ligne, juste après le mot clé.

Si le nom n’est pas précisé, alors on prend alors le nom du fichier spool avec _nnn ajouté avant l’extension (avec nnn = numéro de découpe, commençant à 1), et l’extension .int

En présence d’une nouvelle ligne commençant par le mot clé, on ferme le fichier interface précédent s’il y a lieu, et on ouvre le nouveau fichier demandé.

La ligne commençant par le mot clé n’est pas écrite dans le fichier interface.

Exemple 1 avec la maquette

P INTERFACE=",,DECOUP"

%21###DECOUP_FICHIER=

%21Sigle Tiers (B20) @24

%10Code produit (B10) @45

%10Quantité (B10) @49

Générant le fichier spool spl/SOC1_49.spl contenant :

###DECOUP_FICHIER=ap$spl/ficint_001.int

Sigle Tiers (B20) BRFOU101

Code produit (B10) BR101

Quantité (B10) 145

Code produit (B10) BR102

Quantité (B10) 367

###DECOUP_FICHIER=ap$spl/ficint_002.int

Sigle Tiers (B20) BRFOU102

Code produit (B10) BR105

Quantité (B10) 111

Code produit (B10) BR106

Quantité (B10) 34

Donnera 2 fichiers interfaces.

Le fichier spl/SOC1_49_1.int avec

Sigle Tiers (B20) BRFOU101

Code produit (B10) BR101

Quantité (B10) 145

Code produit (B10) BR102

Quantité (B10) 367

et le fichier spl/SOC1_49_2.int avec

Sigle Tiers (B20) BRFOU102

Code produit (B10) BR105

Quantité (B10) 111

Code produit (B10) BR106

Quantité (B10) 34

Exemple 2 avec la maquette

P LG_VARIABLE

P INTERFACE=",,DECOUP"

%21###DECOUP_FICHIER=int/[email protected]

%21Sigle Tiers (B20) @24

%10Code produit (B10) @45

%10Quantité (B10) @49

Générant le fichier spool spl/SOC1_49.spl contenant :

###DECOUP_FICHIER= int/STAT_FOU_BRFOU101.txt

Sigle Tiers (B20) BRFOU101

Code produit (B10) BR101

Quantité (B10) 145

Code produit (B10) BR102

Quantité (B10) 367

###DECOUP_FICHIER= int/STAT_FOU_BRFOU102.txt

Sigle Tiers (B20) BRFOU102

Code produit (B10) BR105

Quantité (B10) 111

Code produit (B10) BR106

Quantité (B10) 34

Donnera 2 fichiers interfaces.

Le fichier int/STAT_FOU_BRFOU101.txt avec

Sigle Tiers (B20) BRFOU101

Code produit (B10) BR101

Quantité (B10) 145

Code produit (B10) BR102

Quantité (B10) 367

et le fichier int/STAT_FOU_BRFOU102.txt avec

Sigle Tiers (B20) BRFOU102

Code produit (B10) BR105

Quantité (B10) 111

Code produit (B10) BR106

Quantité (B10) 34

Les autres options (APPEND, MINMAJ, caractères terminateur) sont aussi pris en compte en mode « découpe ».

En savoir plus…

COTATION

P COTATION="1" (ou "2")

1 : Recherche s’il existe une meilleure cotation,

2 : Recherche s’il existe une meilleure cotation avec mise à jour de du poste s’il existe une cotation meilleure.

NUMSER5

Edition des numéros de série par lot.

La présence de ce mot clé dans la maquette signale au système qu’il doit éditer les numéros de série (Bloc 18) par lot de 5. Les champs édités sont numdeb1, numdeb2, numdeb3, numdeb4, numdeb5, numdeb6, numdeb7, numdeb8, numdeb9 et numdeb10.

P NUMSER5, précisé en fin de maquette de l’état, édite 5 numéros par ligne,

P NUMSER5= « x », précisé en fin de maquette de l’état, édite x numéros par ligne (10 au maximum).

DATRAL

Date de départ pour l’édition des restes à livrer dans le bloc 10.

P DATRAL= « DATEXP » : la date d’expédition est la date de référence pour le calcul.

Par défaut le calcul est effectué avec la date de livraison du poste.

TRT

Ce paramètre vous permet d’optimiser l’édition. Il suffit de préciser, dans la maquette, P TRT="xxx" avec xxx pouvant être = à :

• evp_eve_src : informations sur événement source du poste en cours d’édition,
• lect_evt : Lecture de evt pour obtenir les poids et commentaires,
• lect_prc : Lecture de prc pour obtenir la quotité et le multiple,
• info_sigmag : Lecture des informations du magasin (Géant du Meuble) du tiers final lié à l’entête d’événement. Si le sigle du magasin n’est pas renseigné, on prendra l’adresse de livraison du tiers de l’événement.

Prévoir autant de ligne P TRT="xxx" que d’option à activer.

VALEVE

Ce paramètre vous permet d’optimiser le traitement différé en empêchant la valorisation de l’événement.

• Voir aussi paramètre VALEVE.

MAJ_INDEDI (EDEVP, EDEVL, EDENT et EDEVE)

Mise à jour de l’indicateur d’édition de l’événement

Signale au système qu’il doit mettre à jour l’indicateur d’édition des événements édités, comme lors de l’édition par l’option Fiche. Ce paramètre permet de mettre à jour l’indicateur « déjà édité » (indedi) lors des éditions en liste.

Par défaut, l’indicateur passe de N à 1, de 1 à 2, ... et de 9 à N à chaque édition fiche. Par ce mot clé, on peut aussi, en mode fiche ou liste, indiquer la valeur à mettre dans la variable « indedi » pour ne pas suivre la mise à jour standard.

Exemple :

P MAJ_INDEDI= « O », précisé dans la maquette de l’état, permet de passer directement de N à O

MAJ_INDTRT (EDEVP, EDEVL, EDENT et EDEVE)

Si MAJ_INDTRT="1" alors pas de mise à jour de l'indicateur de traitement "indint" de l'événement, même si le paramètre INTERFACE est positionné.

TRADUC

Traduction multi-langues.

• des désignations des articles (GART),

• des libellés longs et réduits de toutes les tables accessibles par une fonction du type GTxxx,

• des commentaires structurés (GCOS).

Ce mot-clé maquette ne peut être utilisé que pour les fonctions suivantes : EDEVE, EDEVE et EDEVP.

Voir documentation du paramètre TRADUC.

CREER_REPARTITION

Ce mot-clé est utilisé dans le cadre des Flux poussés, dans le portail I_ACHAT_F, lors de la saisie avec répartition. Lorsqu'on valide la sélection pour générer les postes avec la répartition par rapport aux produits et magasins sélectionnés (mis dans le panier), ce mot-clé permet, si le paramètre EVRP est positionné (voir zone A3), de lancer une génération via le traitement GCOVV1 (lancé en mode rapide) au lieu du lancement de l’APIGestionRepartitioncreerRepartition.

CTRMIP

En présence du paramètre maquette P CTRMIP, la fonction différée GCOVV1 ne traite que le contrôle de compatibilité entre produit dangereux.

Voir documentation du paramètre CTRMIP qui permet notamment, en validation d’expédition (ou en validation de commande), de contrôler que les produits dangereux sont compatibles entre eux.

DECAL_DATE

Permet de décaler les dates d’expédition des événements sélectionnés.

Le traitement recalcule la date d’expédition de la manière suivante :

Date du jour + délai (indiqué sur le paramètre N2 de DELAI)

Il met à jour la date d’expédition de chaque ligne d’événement sélectionné dans le traitement et active un transfert de stock à la nouvelle date dans le cas où les stocks sont gérés en prévisionnel.

Ce traitement ne permet pas de décaler les dates d’expédition d’un certain nombre de jours, il force systématiquement toutes les lignes à la date indiquée par le paramétrage au jour du lancement.

DUPLI_EVE

Duplication d’événement en changeant le type d’événement : voir fonction GCOVV1.

GENERE_ACOMPTE

Permet de générer une facture d'acompte à l'issue de la validation de la commande, s’il existe au moins un acompte à générer sur la commande. Voir documentation de la fonction GCOVV1.

REPARTITION

Permet de réaliser la répartition des quantités supplémentaires sur les commandes de vente magasin.

Voir fonction GCOVV1.

REVALORISATION

Voir documentation de la fonction GCOVV1.

EA_OL_RELIQUAT

Ce paramètre maquette permet, sur les EA sélectionnés, de générer des EA reliquats sur le reste à recevoir. Si des OL sont associés à l’EA (Cross Dock), on génère les OL reliquats en rapport de l’EA reliquat.

LISTE_EXT_FICEDT_A_SUP

Ce paramètre maquette permet, en suppression des demandes de traitements batch (de type Manuel) via le traitement UEDIE1 lancé avec l’option « supprimer », de supprimer les fichiers SOC{xx}_{nnnn}.{extension demandée} pour les différentes extensions demandées par le paramètre maquette.

La suppression standard supprime déjà les fichiers .ext, .spl et .log

Ces extensions ne sont donc pas à repréciser.

Donner la liste des extensions permet d’optimiser la suppression effectuée en standard, à savoir supprimer les fichiers correspondant à SOC{xx}_{nnnn}.*, recherche d’autant plus lngue que le répertoire est chargé.

Exemple :

P LISTE_EXT_FICEDT_A_SUP="pdf,txt,csv"

SANS_SUP_FIC

Ce paramètre maquette permet, en suppression des demandes de traitements batch (de type Manuel) via le traitement UEDIE1 lancé avec l’option « supprimer », de ne supprimer aucun des fichiers SOC{xx}_{nnnn}.{extension demandée}.

ADRESSAGE

Avec ce paramètre-maquette, le traitement différé LRECE1 permet de lancer l’adressage des mouvements de réception sélectionnés (mouvements validés ou non validés) tout en tenant compte du paramètre LADMVT.

CAT_A_PLAT

Permet d’éditer les différentes informations du catalogue (table CATP) avec l’ensemble de l’arborescence.

DETAILS_ENCOURS

Permet de détailler, dans le fichier trace (« .log ») et sous la forme d’un tableau, le détail du calcul des encours (fonction GTIEF) :

· Sigtie : sigle tiers de l’événement,

· Tiers sur lequel va être calculé l’encours (partenaire financier, groupe financier en fonction des paramètres HIEFIN et HIERAR),

· Valeur de l’encours avant le calcul,

· Entité sur laquelle va être cumulé l’encours,

· Entité : dans le cas multi-entité, code société de l’événement,

· Achvte : code achat/vente de l’événement traité,

· Typeve : type événement,

· Numeve : numéro d’événement,

· Codeta : état événement,

· Valeve : valorisation de l’événement pour le calcul de l’encours en devise de l’événement,

· Coddev : devise de l’événement,

· Valeveenc :valorisation de l’événement pour le calcul de l’encours en devise tiers,

· Coddevenc : code devise du tiers. (dans lequel est calculé l’encours),

· Optenc/Cptenc :opération (+/-)/numéro de compteur d’encours impacté (déduit de la matrice GENC),

· Valcpt :Valeur du compteur après mise à jour,

· Valenc : valeur de l’encours total.

Paramétrages supplémentaires

On peut obtenir détail du calcul des encours pour seulement un tiers : il suffit d’en préciser le sigle.

Exemple : P DETAILS_ENCOURS="ROUY"

Seul le détail des encours du tiers ROUY apparaîtra dans le tableau.

Il est également possible de préciser le séparateur à utiliser pour délimiter les champs du tableau (un espace par défaut). Pour ce faire, il suffit de précéder le séparateur (caractère ou la chaine de caractères) par un / (barre de division).

Exemple : P DETAILS_ENCOURS="/;" pour que le séparateur soit un point virgule.

Si vous définissez le séparateur en plus du filtre sur tiers, cette définition devra se trouver juste après le sigle du tiers.

Exemple : P DETAILS_ENCOURS="ACE/;"

GEN_ECR_RGL

Permet, avec l’utilisation du paramètre ECRLIB, de définir le libellé de l'écriture comptable dans les fonctions GCAVE1 et GCOVV1.

INFO_PICTO

Permet d’alimenter les champs « picto1 » à « picto10 » (pictogrammes des étiquettes textiles) dans les blocs d’éditions suivantes :

· EDEVE_B10,

· GARTE_B10,

· GTASE1_B10,

· GTASE1_B10.

MAJ_CONTRAT

Ce mot clé est utilisé dans les traitements différés GCOVV1 et GBFAV1 pour pointer le contrat auquel est rattaché l'événement commercial, et ceci, lors de sa validation.

si MAJ_CONTRAT=

Ø "CDE" alors mise à jour de la quantité / montant commandée,

Ø "LIV" alors mise à jour de la quantité / montant livrée,

Ø "FAC" alors mise à jour de la quantité / montant facturée. Cette option est à positionner uniquement si vous utilisez le paramètre GENECR avec A1=N.

Les paramètres CNTQTE et CNTMNT permettent d’indiquer ce qui est mis à jour : la quantité, ou le montant, ou les deux.

MAJ_EVE_ICPE

En présence du paramètre maquette P MAJ_EVE_ICPE, le traitement GCOVV1 ne traite que la mise à jour de la table EVE_ICPE utilisée dans la feuille de style appelée depuis l’onglet "Danger" des en-têtes de réception. Dans ce cas, l’option N2 doit être à "1".

Voir documentation du paramètre CTRICP qui permet, en validation de réception (ou en validation de commande) de contrôler les seuils ICPE. Ce contrôle n'est effectué que dans les validations différés GCOVV1 et GBLVV1, en mode gestion des produits dangereux (paramètre DANGER positionné).

MAJ_INDEPU

Permet d’identifier les événements à purger sans les supprimer (voir fonction PURGEV). Cette fonctionnalité peut s’avérer intéressante pour une gestion d’archivage. L’identifiant de la table EVE (champ « indepu ») doit être à « O ».

MAJ_INDICE (iceve2)

Mémorise les indices de revalorisation utilisés par la formule de révision du contrat dans des données complémentaires du postes du contrat.

Deux options :

P MAJ_INDICE

Mise à jour des indices pour Prix1 et Prix2 s'il est renseigné, uniquement pour les postes n'ayant pas encore fait encore l'objet d'une révision (postes créés depuis la dernière révision c'est à dire pour qui la date de dernière révision n'est pas renseignée (icf.datdrv = " ")).

Les postes ayant déjà fait l'objet d'une révision seront également mis à jour mais uniquement si aucun indice n'a encore été mémorisé dans le poste. Plus exactement, les indices utilisés pour réviser prix1 seront mémorisés dans le poste du contrat uniquement si toutes les données complémentaires référencées au travers du paramètre ICFIP1 sont vides et les indices utilisés pour réviser prix2 seront mémorisés dans le poste du contrat si toutes les données complémentaires référencées au travers du paramètre ICFIP2 sont vides. Cela traite le cas où le prix2 ne serait pas saisi tout de suite (avant la première révision du contrat) ; cela permet aussi de fonctionner en mode "reprise" et d'initialiser les indices de tous les postes si les paramètres ICFIP1 et ICFIP2 n'étaient pas présents dans le paramétrage lors du dernier traitement de révision.

P MAJ_INDICE="TOUT"

Ce paramètre permet de mettre à jour les indices pour Prix1 et Prix2 même si le poste a déjà été révisé.

Il est surtout prévu pour être utilisé en mode "Remise à jour" pour recharger ponctuellement des indices qui auraient été mal chargés dans les contrats.

MAJ_LISTE_TIERS

Permet de calculer les encours pour une liste de tiers. Pour traiter les encours d’une liste de tiers, il vous suffit de placer le mot clé « MAJ_LISTE_TIERS » dans la maquette d’édition, et de positionner le paramètre INIENC.

Pour en savoir plus, consultez la documentation de la fonction GTIEF.

MEMO_MESSAGE_TXT_SPL

Concerne les traitements suivants : GARTE, GCOVV1, GBFAV1, GBLVV1, GBLVG2, GJALE1 et GDOSE1.

Permet de mémoriser, dans la table TXT (associée au numéro de spool du traitement), tous les messages d’erreur (enregistrés via UMES) générés lors de l’exécution de ce traitement. Une fois le traitement de validation terminé, les anomalies survenues lors du traitement peuvent ainsi être présentées dans une page d’erreur (mode web). En effet, ce mécanisme sert essentiellement au lancement des traitements depuis l’application web en mode direct, mode dans lequel on se met généralement en attente de fin d’exécution du traitement.

Ce paramètre-maquette ne tient pas compte des erreurs survenues après les contrôles suivants :

· paramètre VALPOI,

· paramètre CTRFAC,

· paramètre GELEVE,

· évènement déjà validé,

· évènement bloqué.

Par défaut, les messages ne sont mémorisés qu’en cas d’erreur du traitement de génération / validation.

L’option ALWAYS (P MEMO_MESSAGE_TXT_SPL="ALWAYS") permet de mémoriser les messages dans tous les cas, notamment les messages non bloquants (dépassement de stock non bloquant, contrôle non bloquant autour des matières dangereuses comme le dépassement de seuil ICPE (paramètre CTRICP), …).

NB_ETIQ (EDEVE, GARTE, GTASEL, WCATE4)

Permet d’éditer (via la fonction GBLV ) un autre nombre d’étiquettes que le nombre d’étiquettes donné par le nombre total de colis (champ « totcol » (bloc d’édition edeve_b06 et edeve_b10 ).

P06 NB_ETIQ= « xxx »

où xxx est le numéro de la variable fictive contenant le nombre d’étiquettes.

Cette variable fictive doit obligatoirement être définie en tant que variable numérique, et ne pas être initialisée avec des zéros.

Exemple :

V ~001="zzz",

et surtout pas : V ~001="999".

Cette variable peut-être définie au niveau des blocs inférieurs ou égaux au bloc 10.

Avec ce mot-clé, on édite au moins 1 étiquette.

NUMSER5 (COSKE0, COSKE, EDEVL, EDEVP, EDEVE)

Edition des numéros de série par lot.

Signale au système qu’il doit éditer les numéros de série (Bloc 55) par lot de 5. (Les champs à éditer sont numdeb1, numdeb2, numdeb3, numdeb4, numdeb5, numdeb6, numdeb7, numdeb8, numdeb9, numdeb10).

P NUMSER5, précisé dans la maquette de l’état, édite 5 numéros par ligne,

P NUMSER5= « x », précisé dans la maquette de l’état, édite x numéros par ligne, 10 valeur maximum.

PAS_CHG_10

Afin d’optimiser le temps de traitement lors du chargement de l’inventaire (GINVC), il vous est possible d’éviter une recherche des libellés lors de l’édition du bloc d’édition ginvc_b10. Il vous suffit en effet de positionner le paramètre maquette “PAS_CHG_10” sur la maquette associée au traitement GINVC.

PAS_CRT_CAIS

Permet de désactiver la gestion de caisses (fonction GCAVE1).

SOLDE_LIGNE

Permet, depuis le batch EDEVL, de solder les lignes sélectionnées.

dans le cadre de l'affectation (voir paramètres AFFECT et INDVER), de préciser la valeur de l’indicateur de verrouillage des lignes d’événement soldées.

SUPP_CAE

Permet de supprimer l’élément de catalogue sélectionné (fonction WCATE4).

Des options permettent de supprimer tous les éléments se situant sous l'élément sélectionné et/ou de supprimer le niveau supérieur si ce dernier est vide.

La suppression est en effet effectuée selon deux critères (séparés par une virgule).

Exemple : P SUPP_CAE="2,SUPNIV"

Premier critère :

- 0 è On supprime l'élément sélectionné uniquement,

- 1 è On supprime l'élément sélectionné à condition qu'il n'y ait plus d’autre élément qui en dépende,

- 2 è On supprime l'élément sélectionné ainsi que tous les autres éléments qui en dépendent.

Exemple : supprimer la rubrique SPORT LOISIRS / SPORT ETE

SPORT LOISIR --> SPORT ETE --> P1

--> P2

--> SPORT HIVER

CAMPING -> SPORT ETE --> P1

--> P2

--> SPORT HIVER

Le second critère indique s'il faut supprimer le niveau supérieur lorsque tous les éléments sous ce dernier sont vides :

- " " è on ne fait rien,

- "SUPRUB" è on supprime la rubrique si elle est vide,

- "SUPCAT" è on supprime l'en-tête de catalogue s'il est vide,

- "SUPNIV" è SUPRUB + SUPCAT : on supprime le niveau supérieur s'il est vide (rubrique ou en-tête de catalogue).

SUPP_CAT

Permet de supprimer les catalogues sélectionnés, lorsqu’ils sont édités (fonction WCATE2).

SUPP_PRO

Permet d’utiliser le moteur GARTE pour supprimer en masse les produits sélectionnés et correspondant aux critères de suppression (on effectue les mêmes contrôles qu’en suppression interactive d‘un produit par la fonctionGART : voir paramètre SUPPRO).

SUPP_TIE

Permet de supprimer en masse les tiers sélectionnés qui correspondent aux critères de suppression.

Pour en savoir plus, consultez la documentation de référence de la fonction GTIEE et du paramètre SUPTIE.

TRT_CTR_PRO_LOGIS

Le paramètre maquette « TRT_CTR_PRO_LOGIS » permet d’activer le contrôle de fiche article incomplète, de la même façon qu’en alimentant l’option 1 avec « ctr_pro_logis » depuis un écran lanceur e-GX.

VALIDER_MAGASIN

Permet lors de cette validation (faite en magasin) de dupliquer l’élaboration pour les magasins du bassin ainsi que pour les magasins dépendants (comportement spécifique sur la fonction GTASEL).

VALORISER_LIGNE

Permet de valoriser une ligne d’élaboration (comportement spécifique sur la fonction GTASEL).

Paramètre du mot clé :

1 on ne traite que les lignes non valorisées,

0 on traite les lignes dépassées et non valorisées.