SOMMAIRE
Généralités
Le connecteur étiquette s’appuie sur la notion de code traitement
Pour les généralités sur les codes traitements, consultez la page dédiée
Code traitement et langage de routine (généralités et configurateur article)
Codes traitement etiquettes
Les codes traitement sont utiles pour personnaliser plus facilement le contenu d’un fichier export d'étiquette.
Code traitement pour connecteur étiquettes
Des codes traitement sont livrés à titre d’exemple dans la visite guidée
Pour les distinguer des codes traitement destinés au configurateur, la notion de langage a été introduite.
Actuellement 2 langages
Code langage | Libellé |
---|---|
CFG | Traitement pour configurateur |
ETI | Traitement pour connecteur étiquette |
Le choix du langage permet de préciser l’usage du code traitement et le domaine lexical autorisé lors de l’analyse et de la compilation.
Les fonctions autorisées pour le langage connecteur étiquette sont :
Fonction | Description | Paramètres |
---|---|---|
ETI_Export_Debut | Initialise un fichier export étiquette | MIMPETAT : instance de paramètre état par famille (doit être chargé par le programme d’impression) |
ETI_Export_Ligne_Ecriture | Ajoute une ligne dans le fichier | Ticket : Identifiant dans liste des exports à traiter |
ETI_Export_Champ_Ecriture | Ajoute un champ dans la ligne courante | Ticket : Identifiant dans liste des exports à traiter |
ETI_Export_Fin | Enregistre le fichier export étiquette dans sa destination finale et supprime les fichiers temporaires | Ticketfichier : identifiant fichier export étiquette initialisé |
Le séparateur par défaut utilisé pour séparer les champs dans le fichier est la tabulation
Code variable
Dans les exemples livrés dans la visite guidée, on utilise deux variables
TicketFichierPlat pour identifier le fichier export étiquette
LigneFichierPlat pour contenir la ligne entête de fichier
Données publiques
Ces données doivent être initialisées par le programme d’impression
Donnée | Description |
---|---|
LCT_MIMPETAT | Contient une instance de la table des paramètres états par famille. Chargée par le programme d’impression en fonction du contexte d’impression et de l'état cible |
LCT_ETICONNECTEUR | Structure de travail du connecteur comportant les champs IMPWINCHN : nom imprimante client Windows destinataire de l’impression |
Code traitement pour étiquette réservation
TicketFichierPlat= ETI_Export_Debut (LCT_mImpEtat ) (SI) TicketFichierPlat<> 0 (ET) TicketFichierPlat<> - 1 ;Fichier initialisé ;Ecriture du contenu ; Ligne entete lignefichierplat= "@Label;@Printer;@Nbex,ref;sref1;sref2;designation;sref1_lib;sref2_lib;Numero_Lot;Numero_Colis;LotFournisseur;Quantite;Affaire;unite_travail" ETI_Export_Ligne_Ecriture (TicketFichierPlat, lignefichierplat) ; champs etiquette ETI_Export_Champ_Ecriture (TicketFichierPlat, LCT_mImpEtat.LabelCod ) ETI_Export_Champ_Ecriture (TicketFichierPlat, LCT_Eticonnecteur.ModImp ) ETI_Export_Champ_Ecriture (TicketFichierPlat, 1 ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.Ref ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.Sref1 ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.Sref2 ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.Des ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.Lib (1 ) ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.Lib (2 ) ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.Serie ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.ColiNo ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.SerieExt ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.StQte ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.Affaire ) ETI_Export_Champ_Ecriture (TicketFichierPlat, GTSLR200I1.RefUn , dernier = 1 ) ;transport du fichier et liberation ETI_Export_Fin (TicketFichierPlat) (FinSi)
Précisions techniques
Les fonctions publiques autorisées dans les code traitement du connecteur étiquette sont déclarées dans le module GTTMETICODETRAIT
A5PMCODETRAIT
Extension fonctions pour ne pas être spécialisées configurateur.
Tenir compte du langage traitement pour la déclaration du source include adapté
Langage | Include |
---|---|
CFG | gttcCfgCodeTrait.dhsp |
ETI | gttcEtiCodeTrait.dhsp |
Ajout nouvelles instructions du code traitement pour le parcours d’une liste
Instruction | Finalité | Exemple |
---|---|---|
LISTEDEBUT | se positionner en début d’une liste | (LISTEDEBUT)(LCT_Eticonnecteur.ListeEtiquette) |
ELEMENTSUIVANT | délivre l'élément suivant dans une liste | (TANTQUE) (ELEMENTSUIVANT) (LCT_Eticonnecteur.ListeEtiquette , GT020T1 ) |
A5PMLEX
Ajout fonctions pour gérer le langage (Set_LanguageCode et Get_LanguageCode
Déplacement déclarations domaine lexical par langage dans un source include A5TCLEX
A5TMCHKCODETRAIT
Ajout contrôle champ LanguageCode
Ajout fonctions de nommage source et objet diva générés en fonction du langage
Compute_MCODETRAIT_Field_NomSource et Compute_MCODETRAIT_Field_NomObjet
GTPMETICODETRAIT
Fonctions à invoquer dans le programme d’impression d'étiquettes
Fonction | Description | Paramètres |
---|
Fonction | Description | Paramètres |
---|---|---|
Executer_Traitement | Execute le code traitement | CODETRAITCOD : code traitement à executer |
ETI_Connecteur_Preparation | Prépare un export d'étiquette selon le contexte d’impression posé par l’appelant. | ImpFamCod : Code famille impression |
ETI_Connecteur_AjoutEtiquette | Ajoute un élément étiquette dans la liste LCT_EtiConnecteur.ListeEtiquette | ETI_ENREG : Instance enregistrement qui dépend du programme d’impression |
ETI_Fin_Edition | Met en forme un compte-rendu de génération étiquettes | MIMPETAT : instance paramètre état par famille RECAP_ETIQNB : compteur nombre d'étiquettes générées fourni par le programme d’impression |