SOMMAIRE
| Sommaire | ||
|---|---|---|
|
Généralités
| Astuce |
|---|
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)
Les codes traitement pour les étiquettes
Les codes traitements interviennent dans le paramétrage ERP des impressions. En effet, au lieu d’imprimer directement par exemple une étiquette de transport, le code traitement va GENERER LE FICHIER TEL QU’ATTENDU PAR L’OUTIL. Le fait d’utiliser un code traitement permettre d’exposer le codage du fichier sans nécessiter de développement Diva, depuis le zoom des codes traitement.
Langage de routines étiquettes
Mot-clé et opérateurs routine
Voir les chapitres suivants :
Enregistrement mémoire (données)
Tous les enregistrements mémoire ont pour structure celle du dictionnaire de données de l’ERP.
| Info |
|---|
Pour connaître les champs disponibles dans un enregistrement mémoire, appuyez sur Ctrl+D dans le zoom correspondant à l’entité. Exemple : le zoom article indique le champ ‘Des’ comme étant la désignation. On pourra donc affecter ce champ avec la syntaxe : CODE_ENREGISTREMENT.NomDuChamp |
...
Code enregistrement
...
Type d’accès
...
Utilisation
...
LCT_MIMPETAT
...
Lecture/Ecriture
...
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
...
Lecture/Ecriture
...
Structure de travail du connecteur comportant les champs
MODIMP : modèle imprimante Divalto destinataire de l’impression
IMPWINCHN : nom imprimante client Windows destinataire de l’impression
LISTEETIQUETTE : identifiant liste des étiquette à imprimer. Les éléments de cette liste dépendent du programme d’impression
Fonctions préprogrammées
Fonctions préprogrammées de gestion du connecteur étiquettes
...
Nom de la fonction
...
Utilisation
...
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)
Ticketfichier : identifiant fichier export étiquette initialisé
...
ETI_Export_Ligne_Ecriture
...
Ajoute une ligne dans le fichier
...
Ticket : Identifiant dans liste des exports à traiter
Ligne : Ligne contenu à écrire
cr : ajout retour chariot ou pas
nbex : Nombre de repetitions de la ligne
sep : séparateur de champ
...
ETI_Export_Champ_Ecriture
...
Ajoute un champ dans la ligne courante
...
Ticket : Identifiant dans liste des exports à traiter
Champ : Valeur champ à écrire
Dernier : ajout retour chariot si dernier champ
sep : séparateur de champ
...
ETI_Export_Fin
...
Enregistre le fichier export étiquette dans sa destination finale et supprime les fichiers temporaires
...
Ticketfichier : identifiant fichier export étiquette initialisé
| Info |
|---|
Le séparateur par défaut utilisé pour séparer les champs dans le fichier est la tabulation |
Exemple dans la visite guidée
Des codes traitement de type ETI (pour Traitement pour connecteur étiquette) sont livrés à titre d’exemple dans la visite guidée
...
Ils utilisent deux variables
...
TicketFichierPlat pour identifier le fichier export étiquette
LigneFichierPlat pour contenir la ligne entête de fichier
Et voici l’extrait du code traitement pour étiquette réservation (ETIQ_RESERVATION)
| Bloc de code |
|---|
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
La gestion des code traitement est par définition une approche low-code qui ne nécessite pas d’intervenir en surcharge.
Cependant, les mécanismes programmés en Diva mis en application sont également très ouverts à la surcharge, afin de faciliter l’ajout d’entité, de mot clé.
Surchage configurateur article
La surcharge est fait via le module GTTMCODETRAIT
Le module GTTMCFG000 permet également la surcharge du configurateur
Surchage connecteur étiquettes
Les fonctions publiques autorisées dans les code traitement du connecteur étiquette sont déclarées dans le module GTTMETICODETRAIT
GTPMETICODETRAIT
Fonctions à invoquer dans le programme d’impression d'étiquettes
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 |
Surchage commune
A5PMCODETRAIT
Extension fonctions pour ne pas être spécialisées configurateur.
...
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
LANGUAGECODE : langage traitement (connecteur étiquette par défaut)
...
ETI_Connecteur_Preparation
...
Prépare un export d'étiquette selon le
contexte d’impression posé par l’appelant.
Initialise 'enregistrement de travail du connecteur étiquette LCT_ETICONNECTEUR
ImpFamCod : Code famille impression
MIMPETAT : instance paramètre état par famille chargé en retour
...
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
...