Outil de configuration de l'imprimante
| Version | 01 |
|---|---|
| Date | octobre 2026 |
| Public cible | Intégrateurs POS, équipes de mise en œuvre et de soutien, auteurs de scripts |
| Types de documents | Reçus, billets de cuisine et étiquettes |
1. Aperçu
1.1 Qu'est-ce que l'impression par script
L'impression par script permet à un utilisateur autorisé de définir la mise en page d'un reçu ou d'un billet de cuisine dans PAR POS à l'aide d'un court programme JavaScript, plutôt que de se fier uniquement aux formats fixes de l'Éditeur de paramètres. Un script lit la commande à imprimer, décide de ce qui doit être imprimé et construit la sortie ligne par ligne au moyen d'un objet PrintJob : texte aligné, séparateurs, mise en évidence, codes à barres, codes QR, images stockées, regroupement d'articles, modificateurs et contenu conditionnel. Sur les imprimantes d'étiquettes prises en charge, le même script peut aussi positionner du texte et tracer des cadres.
Le script s'exécute localement sur la caisse au moment de l'impression, dans un environnement isolé sans accès au réseau, aux fichiers ni au système. La configuration fixe Options > Impression reste en place comme solution de repli.
1.2 Problèmes résolus
Deux limites des formats fixes ont motivé cette fonctionnalité. Les changements de mise en page nécessitaient auparavant une modification du code du produit, et il était difficile de faire varier la sortie selon les caractéristiques d'une transaction, comme la destination, le type de billet, l'état de commande future, le terminal, l'article, le groupe d'articles ou l'imprimante. Un script est une couche de personnalisation contrôlée qui répond aux deux besoins sans modifier le code de la caisse.
| Portée | Détail |
|---|---|
| Types de documents pris en charge | Reçus et billets de cuisine (phase 1). Les étiquettes sur les imprimantes d'étiquettes Brother prises en charge sont produites au moyen de scripts de billets. |
| Non couvert | Les reçus de paiement et les autres types de documents nécessitent une prise en charge distincte du produit. Les scripts ne peuvent pas appeler de services externes. |
| Solution de repli | Si l'indicateur de fonctionnalité est désactivé, qu'aucun script n'est assigné ou qu'un script échoue, la caisse imprime la mise en page existante de Options > Impression. |
1.3 À qui s'adresse ce guide
-
Les intégrateurs POS qui configurent des sorties propres à une marque ou à un emplacement sans modifier le code de la caisse.
-
Les exploitants d'entreprise qui gèrent les exigences de marketing, d'exécution des commandes et de communication en cuisine.
-
Les équipes de mise en œuvre et de soutien qui prévisualisent, valident et publient des ensembles de modifications.
-
Les auteurs de scripts qui connaissent JavaScript et travaillent avec les objets Order, Printer, Store et PrintJob.
Ce guide suppose une connaissance pratique de JavaScript, de l'Éditeur de paramètres et de la publication d'ensembles de modifications. Il ne suppose aucune connaissance du code source de la caisse.
1.4 Démarrage rapide
Ce script minimal imprime le nom du magasin, une ligne de commande et un remerciement. C'est le script le plus court qui soit valide à la fois en aperçu et en production.
Script 1 : reçu minimal
function setupPreviewData() {
Store.Name = "PAR Burger";
Store.Address1 = "123 Main Street";
Order.Number = 312;
Order.Total = 9.71;
}
function print() {
PrintJob.Bold = true;
PrintJob.AddCenteredLine(Store.Name);
PrintJob.Bold = false;
PrintJob.AddCenteredLine(Store.Address1);
PrintJob.AddFilledLine("-");
PrintJob.AddLeftAndRightLine("Order " + Order.Number, "$" + Order.Total.toFixed(2));
PrintJob.AddNewLine();
PrintJob.AddCenteredLine("Merci!");
}
Exemple de sortie (imprimante de 42 colonnes)
PAR Burger
123, rue Principale
------------------------------------------
Ordre 312 9,71 $
Merci!
-
Dans le Portail d'administration, ouvrez l'Éditeur de paramètres pour votre emplacement ou votre groupe.
-
Ouvrez Fonctions de script et sélectionnez Ajouter une nouvelle fonction de script.
-
Définissez Nom avec une valeur descriptive, Type de script à Configurateur d'impression et Type de document à Reçu.
-
Collez le script 1 dans l'éditeur et exécutez l'aperçu. Un script valide s'affiche; un script invalide affiche « Le script est invalide. ».
-
Sélectionnez OK, puis ouvrez Options > Impression > Reçu et sélectionnez votre script.
-
Publiez l'ensemble de modifications, attendez que la caisse reçoive les paramètres, puis imprimez un reçu.
2. Exigences et compatibilité
2.1 Logiciel et indicateur de fonctionnalité
-
L'indicateur de fonctionnalité au niveau du groupe
PARPOS.EnableScriptPrintingConfigurationdoit être activé. Lorsqu'il est activé, un script Configurateur d'impression sélectionné a préséance. Lorsqu'il est désactivé, la configuration existante de Options > Impression demeure active et les commandes du Configurateur d'impression sont masquées. -
La caisse et l'Éditeur de paramètres exécutent tous deux la bibliothèque PARPOS.JavaScriptEngine (un paquet .NET Standard 2.0 reposant sur l'interpréteur JavaScript Jint 4.1.0), de sorte qu'un script se comporte de la même façon en aperçu et sur la caisse.
2.2 Accès
-
Accès au Portail d'administration avec l'autorisation d'ouvrir l'Éditeur de paramètres de l'emplacement.
-
Autorisation de créer ou de modifier des fonctions de script et de publier des ensembles de modifications.
-
Accès à la caisse pour les essais d'impression physiques.
2.3 Imprimantes prises en charge
La portée de certification documentée pour l'impression par script est la suivante :
-
Bixolon SRP-S300 (couramment configurée au moyen de l'émulation Epson).
-
Epson TM-U220.
-
Epson TM-T88.
-
Imprimante d'étiquettes Epson TM-L90.
3. Fonctionnement
3.1 Cycle d'exécution
| Étape | Ce qui se passe |
|---|---|
| 1. Déclencheur | Un événement d'impression de reçu ou de billet survient sur la caisse. |
| 2. Sélection | La caisse identifie le type de document et le script sélectionné pour celui-ci sous Options > Impression (Reçu ou Billet). Si l'indicateur est désactivé ou si rien n'est sélectionné, la mise en page existante est utilisée et les étapes suivantes sont ignorées. |
| 3. Validation | Le moteur vérifie que le script ne contient aucun mot restreint et qu'il comporte la fonction print() requise. |
| 4. Exécution | Le moteur isolé reçoit les objets de données (Order, Store, PrintJob, PrintHelper et Printer pour les billets) et appelle print(). |
| 5. Rendu | print() a mis à jour le PrintJob; la caisse le convertit en commandes d'imprimante pour le pilote et l'émulation configurés. |
| 6. Livraison | La file d'impression et le processus de traitement existants envoient la sortie par le chemin COM, USB ou réseau configuré. |
3.2 Reçus par rapport aux billets
| Script de reçu | Script de billet | |
|---|---|---|
| Type de document | Reçu | Billet |
| Sélectionné sous | Options > Impression > Reçu Options.Printing.Receipt.ScriptId |
Options > Impression > Bon (Options.Impression.Bon.ScriptId) |
| Objets disponibles | PrintJob, Order, Store, PrintHelper. Aucun objet Printer. |
PrintJob, Order, Store, Printer, PrintHelper |
| Coupe | Avance du papier et coupe automatiques après le script. N'appelez pas AddCut. | Le script termine lui-même le billet avec PrintJob.AddCut(85). |
| Autour de votre sortie | Le cadre d'application imprime une image d'en-tête et des messages d'imprimante avant votre sortie, et les renseignements de fidélisation après celle-ci. | Aucune image d'en-tête, aucun message d'imprimante ni aucun bloc de fidélisation n'est documenté pour les billets. Considérez que le script est responsable de l'ensemble du billet. |
| Données supplémentaires | Order.ReceiptPrintCount |
Destination de l'article, OrderTime, Seat, Units, Weight, PreviousItems, BagItems, AllItems, KeyIngredients et plus encore |
Un script de reçu et un script de billet sont des scripts distincts. Ils exposent des données différentes; ne réutilisez donc pas l'un pour l'autre sans protéger chaque champ propre à un document.
3.3 Le modèle d'exécution des billets
Le même script de billet s'exécute à répétition, et ce qu'il voit dépend de Printer.ChitType :
| ChitType | Fréquence d'exécution du script | Contenu de Order.Items |
|---|---|---|
| SingleChit | Une fois par article | Exactement un article |
| SummaryChit | Une fois par imprimante | Les articles de cette imprimante |
| Bag | Une fois | Les articles du sac |
L'énumération ChitType comporte aussi une valeur Both, mais le moteur ne la transmet jamais à un script. Ne gérez que SingleChit, SummaryChit et Bag.
3.4 Aperçu des objets de données
| Objet | Accès | Objectif |
|---|---|---|
PrintJob |
Lecture et écriture | La sortie que vous construisez. Définissez des propriétés pour contrôler le formatage et appelez des méthodes pour ajouter du contenu. |
Order |
Lecture seule en production | La commande à imprimer : articles, totaux, modes de paiement, client, destination, employé et plus encore. |
Printer |
Lecture seule, billets seulement | L'imprimante de billets et l'exécution de billet en cours. |
Store |
Lecture seule | Nom, adresse et numéro de téléphone de l'emplacement. |
PrintHelper |
Lecture seule | Fonctions d'aide au formatage (devise, date courte, heure courte et longue). |
3.5 Aperçu par rapport à la production
| Aperçu de l'Éditeur de paramètres | Caisse (production) | |
|---|---|---|
| Données | Objets JavaScript simples et modifiables. Votre fonction setupPreviewData() crée les données. | Enveloppes en lecture seule construites à partir de la commande réelle. |
| setupPreviewData() | Obligatoire. S'exécute avant print(). | Non appelée. |
| Limites | Des limites plus strictes sont appliquées. | Limites configurées sur la caisse. |
| Objets figés | Non figés. | Les objets marqués comme figés, y compris PrintHelper, ne peuvent pas être modifiés. |
| Erreurs | L'éditeur affiche « Script is invalid Le script est invalide.ise en page intégrée est imprimée. |
Le moteur fige tout objet marqué comme figé lorsqu'il s'exécute hors de l'aperçu. PrintHelper en est un. Les autres objets qui portent cet indicateur n'ont pas été vérifiés; traitez donc chaque objet comme étant en lecture seule en production.
3.6 Solution de repli et échec silencieux
Si la validation échoue ou si le script génère une erreur à l'exécution, le moteur ne renvoie rien et la caisse imprime la mise en page intégrée. L'utilisateur voit un reçu ou un billet ordinaire, et l'erreur n'est consignée que dans les journaux de la caisse. Un reçu qui est « revenu à l'ancien format » après une publication est donc le premier symptôme d'une erreur de script.
4. Création, assignation et publication d'un script
4.1 Champs de la fonction de script
| Champ | Valeur | Objectif |
|---|---|---|
| Nom | Unique et descriptif | Identifie le script dans la liste des fonctions de script et dans la liste déroulante d'assignation. |
| Type de script | Configurateur d'impression | Active les champs et le comportement de l'éditeur propres aux reçus et aux billets. |
| Type de document | Reçu ou Billet | Définit le contexte du document et, par conséquent, les objets que reçoit le script. |
| Éditeur de script | JavaScript contenant print() | Définit la sortie. |
| Données d'aperçu | setupPreviewData() | Crée des données représentatives pour le panneau d'aperçu. |
| Publication | Ensemble de modifications publié | Rend la sélection enregistrée disponible pour la caisse. |
4.2 Procédure
-
Connectez-vous au Portail d'administration et ouvrez l'Éditeur de paramètres pour l'emplacement ou le groupe cible.
-
Sélectionnez Fonctions de script dans la navigation de gauche.
-
Sélectionnez Ajouter une nouvelle fonction de script.
-
Saisissez un nom descriptif.
-
Définissez Type de script à Configurateur d'impression.
-
Définissez Type de document à Reçu ou Bon.
-
Saisissez le script. Définissez
print(). DéfinissezsetupPreviewData()pour que l'aperçu dispose de données. -
Utilisez la commande d'aperçu. Un script valide affiche un aperçu; un script invalide affiche « Le script est invalide. » avec la raison.
-
Sélectionnez OK pour enregistrer la fiche du script.
-
Ouvrez Options > Impression > Reçu ou Options > Impression > Bon et sélectionnez le script enregistré dans la liste déroulante.
-
Publiez l'ensemble de modifications et attendez que la caisse reçoive les paramètres mis à jour.
4.3 Assignation des scripts
-
Reçu : Options > Impression > Reçu > sélectionnez un script Configurateur d'impression de reçu.
-
Bon: Options > Impression > Bon > sélectionnez un script Configurateur d'impression de billet.
Si aucun script n'est sélectionné ou si l'indicateur de fonctionnalité est désactivé, la configuration existante du même onglet Options est utilisée.
4.4 Correspondance entre imprimante et contexte
Le script sélectionné contrôle le contenu du document. La configuration de l'imprimante contrôle la destination physique, la connexion, l'émulation, le rôle en cuisine et la file d'impression. Un script de billet peut inspecter Printer.Name, Printer.ChitType, Printer.ChitCurrentIndex et Printer.TotalChits afin de varier la sortie pour une imprimante ou une position de billet précise.
Les facteurs d'affaires que vous pouvez utiliser dans la logique de sélection comprennent la destination, le type de billet, l'état de commande future, le type de service, le sous-total, la date ou l'heure, le terminal, l'article, le groupe d'articles, l'imprimante et l'état d'assignation à un client ou de fidélisation.
4.5 Paramètres de cuisine
-
Les types de billets de cuisine sont Sommaire, Simple, Sommaire + Simple et Sac, lorsque la version déployée les prend en charge.
-
Les champs propres aux billets comprennent la destination de l'article, les modificateurs au niveau de l'article, l'heure de la commande, le siège, les unités, le nom de l'unité, le poids, les ingrédients clés, ainsi que les collections PreviousItems, BagItems et AllItems.
-
SortPriority est exposé sur les articles et peut réordonner les articles de cuisine. Le tri par groupe d'articles dépend de la prise en charge du produit et ne doit pas être tenu pour acquis.
-
Les paramètres existants des imprimantes de cuisine et les messages d'imprimante sont des couches distinctes. Ne présumez pas qu'un script remplace tous les anciens messages d'imprimante, à moins que la version ne le documente.
5. Règles des scripts
5.1 Contrat d'exécution
-
Un script est du JavaScript et il est sensible à la casse. Utilisez exactement les noms
PrintJob,Order,Printer,Store,PrintHelper,printetsetupPreviewData. -
print()est toujours obligatoire. Le moteur l'appelle; votre code ne doit pas l'appeler. -
setupPreviewData()n'est obligatoire que dans l'aperçu de l'Éditeur de paramètres. Le moteur l'appelle avant print(); votre code ne doit pas l'appeler. -
Définissez les deux comme déclarations de fonction de niveau supérieur. Un appel direct de l'une ou l'autre génère l'erreur « L'appel direct à la fonction print n'est pas autorisé. ».
-
Ne déclarez pas de variable ni de fonction dont le nom est original suivi de
printou desetupPreviewData; le moteur utilise ces noms.
5.2 Mode strict et déclarations
Le mode strict est activé. L'affectation à une variable non déclarée génère une erreur ReferenceError (par exemple « q n'est pas défini »); déclarez donc tout avec var, let ou const.
Privilégiez var pour les déclarations de niveau supérieur. En aperçu, le validateur évalue l'ensemble de votre script une fois pour chaque fonction requise (print et setupPreviewData) dans le même moteur. Un const ou let de niveau supérieur est donc déclaré deux fois et échoue avec « L'identifiant ... a déjà été déclaré ». Les let et const à l'intérieur d'une fonction sont sûrs, tout comme les déclarations de fonction de niveau supérieur.
Déclarations
var IG_BOXED = 673549520; // OK: top-level var
const IG_OTHER = 1; // FAILS in preview: declared twice
function print() {
const width = 42; // OK: scoped to the function
}
5.3 Mots restreints
Avant l'exécution, le validateur recherche des mots restreints dans l'ensemble du texte du script. La correspondance ne tient pas compte de la casse, porte sur des mots entiers et s'applique partout : code, commentaires et chaînes littérales. Une seule correspondance entraîne le rejet du script avec « Le script contient un motif non autorisé».
Les mots restreints sont eval, alert, console, document, window, localStorage, sessionStorage, setTimeout, setInterval, XMLHttpRequest, fetch, onload, onerror, System.IO, System.Net et Process.Start.
5.4 Fonctionnalités du langage prises en charge
Le moteur est Jint 4.1.0, qui prend en charge le JavaScript moderne. Les éléments suivants fonctionnent, à notre connaissance : fonctions fléchées, gabarits de chaînes littérales, let et const à l'intérieur des fonctions, chaînage optionnel (?.), opérateur de décomposition sur des objets simples, padStart et padEnd, Array.from, Object.assign, Number.isFinite, ainsi que les API habituelles Array, String, Math et Date.
Non disponibles : les API de navigateur et de Node.js (document, window, fetch, minuteries, localStorage); l'accès au système de fichiers, au réseau, aux processus et à .NET (CLR) en général; et le code dynamique (eval et le constructeur Function sont désactivés).
5.5 Limites d'exécution
Un script est arrêté s'il dépasse les limites de mémoire, de temps ou d'instructions du moteur. Un script arrêté entraîne le retour à la mise en page intégrée.
| Limite | Configuration de la caisse | Valeur par défaut de la bibliothèque (dépôt) |
|---|---|---|
| Mémoire | 100 Mo | 1 Mo |
| Délai d'expiration | 5 000 ms | 100 ms |
| Instructions | 1 000 000 | 1 000 |
| Mode strict | Activé | Activé |
La caisse fournit ses propres valeurs au moyen de la configuration JavaScriptEngineOptions. L'aperçu de l'Éditeur de paramètres applique des limites plus strictes. Confirmez les valeurs de votre version déployée.
5.6 PrintJob conserve son état
Les propriétés de formatage restent activées jusqu'à ce que vous les désactiviez. Initialisez les propriétés qui vous intéressent au début d'un script et réinitialisez chacune d'elles immédiatement après le contenu qui en avait besoin. Cela est particulièrement important sur les imprimantes d'étiquettes, où Bold, DoubleHeight, DoubleWidth et la justification se reportent d'une étiquette à la suivante.
Réinitialiser le formatage après utilisation
PrintJob.Bold = true;
PrintJob.AddCenteredLine("TOTAL");
PrintJob.Bold = false; // always switch it back off
5.7 Manipuler les données en toute sécurité
| Sujet | Règle |
|---|---|
| Valeurs nulles et manquantes | Order.Customer est null lorsqu'aucun client n'est assigné. Order.Destination n'est jamais null en JavaScript, mais la lecture de ses propriétés génère une erreur si la destination ne figure pas dans les paramètres. Protégez chaque valeur facultative. |
| Collections | Les collections de production proviennent de .NET. Utilisez length en minuscules. Copiez une collection avec Array.from(collection) avant d'utiliser des méthodes de tableau telles que forEach, sort, filter ou find; les scripts de production le font couramment. Vérifiez d'abord qu'elle n'est pas null. |
| Types | Store.Id est une chaîne. Order.Training est un booléen. Order.Id est une chaîne et peut être un identifiant chiffré selon les paramètres du groupe. Les montants sont des nombres; formatez-les avec toFixed(2). |
| Dates | CreatedDate, BusinessDate et PromiseTime sont des valeurs DateTime .NET qui arrivent sous forme d'objets Date JavaScript. Ne transmettez pas un objet Date à PrintHelper; transmettez date.toISOString(). La sortie des dates est dans l'heure et la culture locales de la caisse. |
| Devise | PrintHelper.ConvertDecimalToCurrencyString utilise la culture de l'ordinateur de la caisse; le symbole monétaire dépend donc de cet ordinateur. Pour un symbole fixe, construisez la chaîne vous-même : "\$" + value.toFixed(2). |
| Données sensibles | Les numéros de carte et les jetons sont masqués dans les enveloppes. N'imprimez pas de renseignements personnels sur les employés au-delà des besoins opérationnels approuvés. |
6. Référence des objets et des méthodes
Les types suivent les conventions courantes : string, int, decimal, bool et DateTime. Un ? final (par exemple decimal?) signifie que la valeur peut être null. Les membres qui ne sont pas indiqués comme propres aux billets ou aux reçus peuvent être utilisés dans les deux documents.
6.1 PrintJob
Propriétés
Chaque propriété est un interrupteur qui s'applique au contenu ajouté après sa définition, jusqu'à ce qu'elle soit rétablie.
| Propriété | Type | Description |
|---|---|---|
| Bold | bool | Texte en gras. |
| Red | bool | Texte rouge sur les imprimantes et les rubans qui le prennent en charge. Ignoré ailleurs. |
| Center | bool | Centre le texte subséquent. La méthode dédiée AddCenteredLine est habituellement plus claire. |
| Reverse | bool | Vidéo inversée, habituellement du texte blanc sur fond noir. Sur les imprimantes d'étiquettes Brother, elle s'imprime sous forme de barre pleine. |
| DoubleHeight | bool | Hauteur de caractère double. |
| DoubleWidth | bool | Largeur de caractère double. Réduit de moitié le nombre de caractères par ligne. |
| Orientation | int | Imprimantes d'étiquettes seulement : 1 = horizontale, 2 = verticale. 0 n'est pas valide. |
| FixXPosition | bool | Imprimantes d'étiquettes seulement : ancre la position X pour les lignes suivantes. |
| FixYPosition | bool | Imprimantes d'étiquettes seulement : ancre la position Y pour les lignes suivantes. |
| Height, Width | int | Imprimantes d'étiquettes seulement : taille de l'étiquette, reportée d'une étiquette à l'autre dans une tâche. |
| Justification | enum | Justification du texte (gauche, centre, droite). Non réinitialisée lors de la coupe d'une étiquette. |
Méthodes
| Méthode | Description |
|---|---|
| AddText(string text) | Ajoute du texte à la position courante sans terminer la ligne. |
| AddLine(string text) | Ajoute une ligne alignée à gauche. |
| AddCenteredLine(string text) | Ajoute une ligne centrée. |
| AddRightLine(string text) | Ajoute une ligne alignée à droite. |
| AddLeftAndRightLine(string left, string right) | Texte à gauche et à droite sur une même ligne. L'outil de prédilection pour les lignes d'articles et de totaux. |
| AddLeftCenterRightLine(string left, string center, string right) | Trois colonnes sur une même ligne. |
| AddLeftCenterLine(left, center) AddCenterRightLine(center, right) |
Existent, mais n'ont aucun effet sur les imprimantes visées. Utilisez plutôt AddLeftCenterRightLine. |
| AddFilledLine(char c) | Remplit toute une ligne avec un seul caractère, par exemple "-". Elle accepte un seul caractère, et non une chaîne. |
| AddNewLine() | Ajoute une ligne vide. |
| AddNewLines(int count) | Ajoute plusieurs lignes vides. |
| AddCut(byte length) | Coupe le papier. length est un octet (85 par défaut), et non un pourcentage. Transmettez 85 explicitement. |
| AddQRCode(string data, int moduleSize = 3) | Imprime un code QR. La taille du module est facultative. |
| AddBarCode(string data, symbology) | Imprime un code à barres. Symbologies : Code39, Ean13, UPCA. La prise en charge varie selon l'imprimante. |
| AddImage(byte id) | Imprime un logo déjà stocké dans la mémoire NVRAM de l'imprimante, identifié par son numéro d'image. Cette méthode ne téléverse pas d'image. |
| SetCursorPosition(int x, int y) | Imprimantes d'étiquettes : saute à une position absolue, en points d'imprimante. |
| MoveCursorPosition(int x, int y) | Imprimantes d'étiquettes : déplace le curseur par rapport à la position courante, en points. Les valeurs négatives déplacent vers la gauche ou vers le haut. |
| AddBox(int width, int height, int thickness) | Imprimantes d'étiquettes : cadre à la position du curseur. Une épaisseur égale à la plus petite dimension produit une barre pleine. |
| AddBoxToAxis(int position, int otherDimension, int thickness) | Imprimantes d'étiquettes : cadre allant du curseur jusqu'à un point cible, sans déplacer le curseur. |
PrintJob expose aussi AddLines, Merge et Clone, que ce guide ne documente pas encore. Separation, Bottom, BottomLineCount, FontB et Wrap existent, mais n'ont aucun effet sur les imprimantes visées (voir la section 7.2).
6.2 Order
La commande à imprimer. Elle est en lecture seule en production. En aperçu, vous attribuez les propriétés dont vous avez besoin dans setupPreviewData().
Propriétés de niveau supérieur
| Propriété | Type | Remarques |
|---|---|---|
| Id | string | Peut être un identifiant de commande chiffré selon les paramètres du groupe. |
| Number | int | Numéro de commande. |
| Name | string | Nom de la commande. Certains magasins ajoutent du texte supplémentaire après une barre verticale. |
| Balance | decimal | Positif : solde dû. Négatif : monnaie à rendre. Zéro : payé en entier. |
| SubTotal | decimal | Sous-total. |
| SubTotalBeforeReduction | decimal? | Sous-total avant réductions. |
| Tax | decimal | Taxe de la commande. Les scripts de production utilisent cette propriété plutôt que TotalTaxAmount. |
| TotalTaxAmount | decimal | Montant total des taxes. |
| Rounding | decimal | Ajustement d'arrondi; zéro s'il n'y en a pas. |
| Total | decimal | Total de la commande. |
| BusinessDate | DateTime? | Date d'affaires. |
| CreatedDate | DateTime | Date de création de la commande. |
| PromiseTime | DateTime | Heure promise. Les scripts de livraison de production impriment « ASAP » lorsque getFullYear() n'est pas supérieur à 0. |
| Closed | bool | La commande est fermée. |
| IsFired | bool | La commande a été envoyée à la cuisine. |
| IsFutureOrder | bool | Commande future. |
| Refund | bool | Commande de remboursement. |
| TaxExempt | bool | Commande exonérée de taxes. |
| Training | bool | Commande en mode formation. |
| GuestCount | string | Nombre de convives. |
| CustomerAccountNumber | string | Numéro de compte du client. |
| CustomerAssigned | bool | Un client est assigné. |
| CustomerType | string | Type de client. |
| string | Courriel de la commande. | |
| PhoneNumber | string | Numéro de téléphone de la commande. |
| ReceiptPrintCount | int | Reçu seulement. Nombre de fois que le reçu a été imprimé. |
| ChitPrintCount, EditCount | int | Compteurs des impressions et des modifications de billets. |
Objets imbriqués
| Propriété | Membres | Remarques |
|---|---|---|
| Customer | FirstName, LastName, FullName, PhoneNumber, Address (y compris Notes) | Null lorsqu'aucun client n'est assigné. |
| Delivery | Address.Address1, Address2, City, State, PostalCode, Notes; PhoneNumber | Renseigné pour les commandes de livraison. Vérifiez Destination.IsDelivery. |
| Destination | Id, Name, Indicator, IsDelivery, KitchenChitHeader, KitchenDescription | Jamais null, mais la lecture des propriétés génère une erreur si la destination ne figure pas dans les paramètres. |
| Employee, ClosedByEmployee | DisplayName, FirstName, LastName, IsTraining | DisplayName peut être null; utilisez alors le prénom et le nom de famille. |
| Lane | Name, Prefix | |
| Party | Name, OrderNumber | |
| Terminal | Name | La caisse. |
Collections d'ajustements
| Collection | Membres |
|---|---|
| Discounts | Name, PrintedName, Amount |
| Promotions | Name, PrintedName, Amount |
| Surcharges | Name, Amount |
| Taxes | Name, Amount |
| MarketingCampaigns | Name |
Articles
Order.Items contient les lignes de commande. Cette collection peut comprendre des articles annulés (Vidée est true) ainsi que les enfants des combos et des ensembles. Un enfant a un CompositeOrderItemId supérieur à zéro et apparaît aussi sous son parent dans CompositeOrderItems; un article de niveau supérieur a un CompositeOrderItemId égal à 0. N'imprimez que les articles de niveau supérieur et affichez les enfants par l'intermédiaire du parent. Order.VoidItems a la même structure, avec Vidée à true.
| Propriété | Type | Remarques |
|---|---|---|
| Id, ItemId | int | Id identifie la ligne de commande, ItemId l'article du menu. |
| Description | string | Nom de l'article. |
| AlternateKitchenName | string | Nom en cuisine. |
| Quantity | int | |
| Price | decimal | Prix unitaire de base. |
| PriceWithModifiers | decimal | Prix unitaire incluant les modificateurs. Multipliez par Quantity pour obtenir le total de la ligne. |
| Note | string | Note de l'article. |
| SortPriority | byte | Ordre d'affichage; la valeur la plus basse s'imprime en premier. |
| ItemGroups[] | Id, Name | Peut être vide. Ne présumez jamais que la première entrée existe. |
| Modifiers[] | voir ci-dessous | Chaque modificateur peut contenir ses propres Modifiers. |
| CompositeOrderItemId | int | 0 = autonome, supérieur à 0 = fait partie d'un combo. |
| CompositeOrderItems[] | articles | Articles enfants. Chaque propriété d'article s'applique à chaque enfant. |
| AutoNumber, AutoNumberPrefix, AutoNumberItemGroupId | byte, string, int | Numérotation automatique. |
| IsEdited | bool | Modifié après son envoi à la cuisine. |
| IsDeleted, IsCleared, Voided, Sent, IsTaxFree | bool | Indicateurs d'état. La propriété est IsDeleted (I majuscule). |
| PrinterGroupId | int | Articles de billet : le groupe d'imprimantes de l'article. |
| Length | int | Longueur de l'article. |
Membres d'un modificateur : Description, Id, ItemId, Price, IsTaxFree, ModifierGroup.Id, ModifierGroup.Name et Modifiers imbriqués. ModifierGroupIds et ModifierCodeId ne sont pas exposés aux scripts. Sur les billets, la structure du modificateur est réduite à Description et ItemId.
Propriétés d'article propres aux billets : Destination (Id, Indicator, KitchenChitHeader, KitchenDescription, IsDelivery, Name), Discounts[] (PrintedName, Name, Amount), OrderTime, Seat, Units, UnitName, Weight.
Collections propres aux billets
| Propriété | Description |
|---|---|
| Order.PreviousItems | Articles déjà envoyés sur un billet antérieur. Structure d'article. |
| Order.BagItems | Articles destinés au sac. Structure d'article. |
| Order.AllItems | Tous les articles de la commande. Structure d'article. |
| Order.KeyIngredients | Tableau de { Count, Text }. |
Modes de paiement
Order.Tenders énumère les paiements. Il n'existe aucune propriété de type de paiement; déduisez le type d'après les champs présents. Le numéro de carte et le jeton sont masqués.
| Type de paiement | Membres |
|---|---|
| Espèces | Name, Amount |
| Chèque | Name, Amount, CheckNumber |
| Carte de crédit | Name, Amount, TipAmount, CardNumber, Authorization, AuthorizedTenderAmount, Token, Balance |
| Débit | Name, Amount, TipAmount, CardNumber, Authorization, AuthorizedTenderAmount |
| Externe | Name, Amount, TipAmount, AuthorizedTenderAmount |
| Carte-cadeau | Name, Amount, TipAmount, CardNumber, AuthorizedTenderAmount, BalanceRemaining |
| Certificat-cadeau | Name, Amount, TipAmount, AuthorizedTenderAmount |
| Compte client | Name, Amount, TipAmount, AccountNumber, AuthorizedTenderAmount |
| EBT | Name, Amount, TipAmount, CardNumber, Authorization, Balance, AuthorizedTenderAmount |
Les modes de paiement peuvent aussi comporter AdditionalData.
Order expose également les méthodes GetUCPEmbeddedBarCode(plu) et GetCode39EmbeddedBarCode(), ainsi que les collections AllOrderItems et GiftCardItems. Ces éléments ne sont pas encore documentés en détail.
6.3 Printer
Scripts de billets seulement. Le fait de référencer Printer dans un script de reçu génère une erreur Erreur de référence.
| Propriété | Type | Description |
|---|---|---|
| Name | string | Nom de l'imprimante. |
| ChitType | string | SummaryChit, SingleChit ou Bag. |
| ChitCurrentIndex | int | Billet courant dans une exécution à billets multiples. |
| TotalChits | int | Nombre total de billets dans l'exécution. |
| DiscountChitPlacement | string | None, Top, Bottom ou Both. |
| KeyIngredientSummaryPlacement | string | None, Top, Bottom ou Both. |
| PrinterGroupIds | int[] | Groupes d'imprimantes auxquels l'imprimante appartient. |
6.4 Store
| Propriété | Type |
|---|---|
| Id | string |
| Name | string |
| Address1, Address2 | string (Address2 peut être null) |
| City, State, Zip | string |
| Phone | string |
6.5 PrintHelper
Fonctions d'aide au formatage disponibles en aperçu et en production. Hors de l'aperçu, l'objet est figé et ne peut pas être modifié.
| Méthode | Description |
|---|---|
| ConvertDecimalToCurrencyString(decimal) | Formate selon la culture de l'ordinateur (par exemple, 7.5 devient $7.50 sur un ordinateur américain; le symbole dépend de la culture). |
| GetShortDate(string iso) | Analyse une chaîne ISO 8601 et renvoie la date courte locale. |
| GetShortTime(string iso) | Renvoie l'heure courte locale. |
| GetLongTime(string iso) | Renvoie l'heure longue locale. |
Une chaîne ISO sans Z ni décalage est traitée comme étant en UTC. Le résultat est affiché selon l'heure et la culture locales de la caisse.
Formatage sécuritaire des dates
function formatDateTime(value) {
// value can be a production Date or a preview string
var iso = new Date(value).toISOString();
return PrintHelper.GetShortDate(iso) + " " + PrintHelper.GetShortTime(iso);
}
7. Capacités des imprimantes
Le tableau ci-dessous provient d'un examen technique des pilotes d'imprimante. Il décrit ce que chaque pilote fait avec une commande PrintJob, et non le résultat sur le matériel physique; confirmez donc sur l'imprimante réelle avant la mise en production.
7.1 Largeur de ligne et prise en charge des fonctionnalités
| Imprimante | Largeur | Red | Reverse | AddBarCode | AddQRCode | AddImage |
|---|---|---|---|---|---|---|
| Epson TM-T88 / RESTICK / U200 | 42 / 44 / 33 | Fonctionne | Fonctionne | Code39, Ean13, UPCA (la U200 imprime du texte centré) | Fonctionne | Image NV stockée |
| Star TSP100 | 48 | Sans effet | Sans effet | Code39 seulement | Sans action | Génère une erreur |
| NCR 7197 | 44 | Fonctionne | Fonctionne | Code39, Ean13 (UPCA génère une erreur) | Sans action | Génère une erreur |
| PAR M3876 | 42 | Sans effet | Fonctionne | Code39, Ean13, UPCA | Sans action | Image stockée |
| Partner RP-320 | 42 | Sans effet | Fonctionne | Code39, Ean13, UPCA | Sans action | Génère une erreur |
| Zebra TTP2000 | Non vérifiée | Sans effet | Fonctionne | Sans action | Sans action | Génère une erreur |
| OPOS | Selon les paramètres | Stocké seulement | Stocké seulement | Toujours Code39 | Fonctionne | Génère une erreur |
| PosForDotNet | Selon les paramètres (42 par défaut) | Stocké seulement | Stocké seulement | Génère une erreur | Sans action | Génère une erreur |
| Brother (nouveau pilote) | Proportionnelle (ZPL) | Sans effet | Cadre rempli | Code39, Ean13, UPCA | Fonctionne | Image flash IMAGE{n}.GRF |
« Sans effet » signifie que la commande est acceptée, puis ignorée. « Sans action » signifie que rien n'est imprimé. « Génère une erreur » signifie que le script échoue et que la caisse revient à la mise en page intégrée. AddFilledLine fonctionne sur toutes ces imprimantes, sauf la Zebra TTP2000, où elle ne fait rien.
Rouge et Reverse sont envoyés sous forme des commandes d'imprimante suivantes. Le pilote Brother ne les utilise pas : il imprime Reverse sous forme de cadre rempli, et Red n'a aucun effet.
| Imprimante | Red | Reverse |
|---|---|---|
| Epson TM-T88 / RESTICK / U200 | ESC r | Fonctionne |
| Star TSP100 | Sans effet | Sans effet |
| NCR 7197 | ESC r | GS B |
| PAR M3876 | Sans effet | GS B |
| Partner RP-320 | Sans effet | GS B |
| Zebra TTP2000 | Sans effet | ESC T |
| OPOS / PosForDotNet | Stocké seulement | Stocké seulement |
Seul le nouveau pilote Brother prend en charge les commandes de curseur et de cadre ZPL, FixXPosition, FixYPosition, Orientation, Height et Width.
7.2 Commandes sans effet sur les imprimantes visées
AddLeftCenterLine, AddCenterRightLine, FontB, Wrap, Bottom, BottomLineCount et Separation.
7.3 Largeur, polices et jeux de caractères
-
La largeur de ligne, la taille de police, Red, Reverse, la double hauteur et la double largeur sont limitées par l'imprimante et son émulation. Un script ne peut pas forcer un résultat que le matériel ne peut pas produire.
-
Gardez le texte à l'intérieur de la largeur imprimable. Tronquez ou découpez vous-même les noms d'articles et les modificateurs longs, et faites des essais avec les noms réels les plus longs.
-
DoubleWidthréduit de moitié le nombre de caractères par ligne. Les mises en page sensibles à la largeur doivent en tenir compte. -
Ne présumez pas la prise en charge des polices proportionnelles, des glyphes Unicode, de l'italique ou du soulignement. Utilisez les caractères que l'imprimante prend en charge.
-
Testez les codes à barres et les codes QR avec un lecteur réel; l'aperçu n'indique pas la qualité de lecture.
7.4 Étiquettes Epson TM-L90
L'Epson TM-L90 fait partie de la portée de certification de l'impression par script. Son mécanisme existant de gabarits d'étiquettes (la page Étiquettes, avec des balises de formatage comme <Bold> et des paramètres comme%ItemName%) est une fonctionnalité distincte, documentée dans le Guide de formatage des étiquettes Epson TM-L90. Le présent guide ne le remplace pas.
8. Impression d'étiquettes sur les imprimantes Brother
Les imprimantes d'étiquettes Brother offrent un contrôle de mise en page de bas niveau : orientation de l'étiquette, positions ancrées, déplacement manuel du curseur et cadres. Les coordonnées sont exprimées en points d'imprimante, et non en pouces ni en millimètres. N'utilisez ces membres que sur une imprimante et un type de document qui les prennent en charge; sur une imprimante de reçus thermique, ils n'ont aucun effet.
8.1 Orientation
Définissez PrintJob.Orientation pour changer la mise en page. Les valeurs proviennent de l'énumération d'orientation des étiquettes.
| Valeur | Signification |
|---|---|
| 0 (None) | Valeur non valide à définir. |
| 1 (Horizontal) | Mise en page standard, de gauche à droite. |
| 2 (Vertical) | L'étiquette pivote de 90 degrés. Le texte se lit de côté et les lignes avancent dans le sens de la largeur de l'étiquette. |
-
L'orientation se reporte d'une étiquette à l'autre dans la même tâche. Définissez-la toujours explicitement au début du script.
-
Un changement en cours d'étiquette conserve la position courante et modifie la façon dont elle est interprétée; il ne ramène pas le curseur à un coin.
-
Un changement sur une toute nouvelle étiquette part de la position de départ normale de cette orientation.
8.2 Positions fixes
L'activation de FixXPosition ou de FixYPosition verrouille la position courante du curseur comme point d'ancrage. Chaque ligne suivante qui reviendrait à la marge par défaut part plutôt du point d'ancrage, jusqu'à ce que vous le désactiviez.
-
La direction physique régie par un point d'ancrage dépend de l'orientation au moment de son activation. Modifier l'orientation par la suite ne change pas un point d'ancrage actif.
-
La désactivation d'une fixation ramène cet axe à son point de départ par défaut pour la ligne suivante. Elle ne rétablit pas la position antérieure à la fixation.
-
Déplacer manuellement le curseur pendant qu'une fixation est active déplace aussi le point d'ancrage.
-
Une barre inversée pleine largeur tracée pendant qu'une fixation est active s'étend du point d'ancrage jusqu'au bord opposé, et non sur toute la largeur de l'étiquette.
8.3 Contrôle manuel du curseur
-
MoveCursorPosition(x, y)se déplace par rapport à la position courante. Les valeurs peuvent être négatives : un x négatif déplace vers la gauche et un y négatif vers le haut. -
SetCursorPosition(x, y)saute à une position exacte. Les valeurs sont normalement 0 ou positives; une valeur négative place le contenu hors de l'étiquette. -
Dans l'appel, x est toujours horizontal et y toujours vertical. En orientation verticale, leur effet visuel s'inverse, mais l'ordre des arguments ne change jamais.
-
Ce sont des commandes de bas niveau. Elles ne découpent pas le texte, ne s'ajustent pas à la taille de l'étiquette et n'évitent pas les chevauchements; il revient au script d'éviter les collisions.
8.4 Cadres et barres
-
AddBox(width, height, thickness)trace un cadre à la position du curseur. Lorsque l'épaisseur est grande par rapport à la plus petite dimension, le cadre est rendu plein, ce qui produit une barre d'arrière-plan inversée ou en surbrillance. -
AddBoxToAxis(position, otherDimension, thickness)trace un cadre du curseur jusqu'à un point cible sans déplacer définitivement le curseur.
Cadres
PrintJob.AddBox(800, 307, 2); // outer border for the whole label
PrintJob.MoveCursorPosition(765, 0);
PrintJob.AddBox(35, 35, 2); // small square callout
PrintJob.AddBox(681, 35, 35); // thickness = height: solid bar
Appels d'orientation, d'ancrage et de curseur
PrintJob.Orientation = 2; // Vertical
PrintJob.Orientation = 1; // back to Horizontal
PrintJob.FixXPosition = true; // lock the X anchor
PrintJob.AddLeftAndRightLine("Left text", "Right text");
PrintJob.FixXPosition = false; // release it when done
PrintJob.MoveCursorPosition(20, 0); // 20 dots right, from the current position
PrintJob.MoveCursorPosition(0, -35); // 35 dots up (negative y)
PrintJob.SetCursorPosition(8, 0); // jump to x = 8, y = 0
8.5 Ce qui est réinitialisé lors de la coupe d'une étiquette
AddCut (ou l'envoi de la mémoire tampon) termine une étiquette. Certains états reviennent à leur valeur par défaut pour l'étiquette suivante, d'autres non.
| Comportement | État |
|---|---|
| Réinitialisé à la valeur par défaut | Mode Reverse (toujours désactivé); ancrages FixXPosition et FixYPosition (libérés); position du curseur (retour au départ pour l'orientation active); toute ligne en cours et inachevée. |
| Reporté | Orientation; Height et Width de l'étiquette. |
| Non réinitialisé (à désactiver vous-même) | Bold, DoubleHeight, DoubleWidth et justification du texte. |
9. Recettes
Chaque recette est un bloc de construction autonome et testé. Copiez dans votre script les fonctions dont vous avez besoin. Les exemples supposent la fonction d'aide list(c) qui renvoie c ? Array.from(c) : [].
9.1 Lecture sécuritaire des données facultatives
Protégez chaque valeur qui peut être manquante : Order.Customer, Order.Delivery, ItemGroups, Employee.DisplayName et toute collection.
Lectures sécuritaires
function safeReads() {
var customerName = Order.Customer && Order.Customer.FirstName
? Order.Customer.FirstName
: "Guest";
var city = Order?.Delivery?.Address?.City ?? "";
var items = Order.Items ? Array.from(Order.Items) : [];
var employee = Order.Employee.DisplayName == null
? Order.Employee.FirstName + " " + Order.Employee.LastName
: Order.Employee.DisplayName;
return [customerName, city, items.length, employee];
}
9.2 Dates et heures
Deux approches fonctionnent. PrintHelper formate selon la culture locale de la caisse. Le formatage manuel donne une mise en page fixe qui ne dépend pas de la culture de l'ordinateur. Les deux acceptent un objet Date ou une chaîne analysable.
Formatage manuel de la date et de l'heure
function formatDate(value) {
var d = new Date(value);
return (d.getMonth() + 1) + "/" + d.getDate() + "/" + d.getFullYear();
}
function formatTime(value) {
var d = new Date(value);
var hours = d.getHours();
var minutes = String(d.getMinutes()).padStart(2, "0");
var ampm = hours >= 12 ? "PM" : "AM";
return (hours % 12 || 12) + ":" + minutes + " " + ampm;
}
9.3 Montants et totaux
-
Formatez vous-même les montants avec
"\$" + value.toFixed(2). Les scripts de production ont cessé d'utiliserPrintHelper.ConvertDecimalToCurrencyStringaprès qu'il eut imprimé le mauvais symbole monétaire sur un ordinateur configuré avec une culture différente. -
Le total d'une ligne est
item.Quantity \* item.PriceWithModifiers.PriceWithModifiersest le prix unitaire incluant les modificateurs; imprimer séparément le prix des modificateurs les compte donc en double. -
Affichez les rabais avec un signe moins et les frais supplémentaires avec un signe plus, en utilisant la valeur absolue du montant stocké.
-
N'imprimez la ligne Rounding que si elle n'est pas nulle, avec son signe.
-
Déduisez le résultat final de
Order.Balance: positif correspond à un solde dû, négatif à de la monnaie à rendre (imprimez la valeur absolue).
Solde et monnaie
function printBalance() {
if (Order.Balance > 0) {
PrintJob.AddLeftAndRightLine("BALANCE DUE", "$" + Order.Balance.toFixed(2));
} else if (Order.Balance < 0) {
PrintJob.AddLeftAndRightLine("CHANGE DUE", "$" + Math.abs(Order.Balance).toFixed(2));
}
}
9.4 Colonnes, troncature et retour à la ligne
PrintJob.Wrap n'a aucun effet, et un texte long peut déborder de la ligne. Tronquez ou découpez le texte vous-même, en utilisant la largeur de l'imprimante cible.
Retour à la ligne par mots
function wrapText(text, width) {
var words = String(text || "").split(" ");
var lines = [];
var line = "";
words.forEach(function (word) {
if ((line + " " + word).trim().length > width) {
if (line) { lines.push(line); }
line = word;
} else {
line = (line + " " + word).trim();
}
});
if (line) { lines.push(line); }
return lines;
}
Colonnes fixes
function padRight(text, width) {
return String(text).substring(0, width).padEnd(width, " ");
}
function padLeft(text, width) {
return String(text).substring(0, width).padStart(width, " ");
}
9.5 Modificateurs, sous-modificateurs et combos
Un modificateur peut contenir des modificateurs, et un article combo contient des articles enfants qui ont leurs propres modificateurs. Une petite fonction récursive gère n'importe quelle profondeur. Dans un script de reçu, n'imprimez que les articles de niveau supérieur (CompositeOrderItemId == 0) et affichez les enfants par l'intermédiaire de CompositeOrderItems.
Modificateurs récursifs
function printModifiers(modifiers, level) {
(modifiers ? Array.from(modifiers) : []).forEach(function (mod) {
PrintJob.AddLine(" ".repeat(level * 3) + mod.Description);
printModifiers(mod.Modifiers, level + 1);
});
}
9.6 Regroupement des articles en double
Lorsque le même article est saisi sur plusieurs lignes, vous pouvez souhaiter une seule ligne avec la quantité totale. Faites la fusion en fonction de tout ce qui doit correspondre : l'article du menu, le prix unitaire, la note et les modificateurs.
Regrouper des articles identiques
function itemKey(item) {
var mods = list(item.Modifiers)
.map(function (m) { return m.ItemId + ":" + m.Price; })
.sort()
.join(",");
return [item.ItemId, item.PriceWithModifiers, item.Note || "", mods].join("|");
}
function consolidate(items) {
var byKey = {};
var result = [];
items.forEach(function (item) {
var key = itemKey(item);
if (byKey[key]) {
byKey[key].Quantity += item.Quantity;
} else {
byKey[key] = Object.assign({}, item); // copy so the original is untouched
result.push(byKey[key]);
}
});
return result;
}
9.7 Fonctions d'aide destinées aux clients
Numéro de téléphone, numéro de commande abrégé, nom d'affichage
function formatPhone(raw) {
var digits = String(raw || "").replace(/\D/g, "");
var m = digits.match(/^(\d{3})(\d{3})(\d{4})$/);
return m ? "(" + m[1] + ") " + m[2] + "-" + m[3] : String(raw || "");
}
function shortOrderNumber(id) {
var s = String(id);
return s.slice(Math.max(0, s.length - 4));
}
// "Name|extra" -> "Name", at most 20 characters
function displayName(name) {
var s = String(name || "");
var i = s.indexOf("|");
return s.substring(0, i === -1 ? Math.min(20, s.length) : Math.min(i, 20));
}
9.8 Modes de paiement et détails du paiement
Il n'existe aucune propriété de type de paiement. Déduisez le type d'après les champs présents et n'imprimez les détails de carte que pour les modes de paiement qui en comportent. Les numéros de carte sont déjà masqués.
Déduire le type de paiement
function tenderKind(t) {
if (t.CheckNumber != null) return "check";
if (t.AccountNumber != null) return "house account";
if (t.BalanceRemaining != null) return "gift card";
if (t.CardNumber != null) return "card";
return "other";
}
9.9 Commandes de livraison
Vérifiez Order.Destination.IsDelivery avant de lire Order.Delivery. Utilisez le numéro de téléphone de livraison pour les commandes de livraison, ignorez les valeurs de remplissage dans la deuxième ligne d'adresse et imprimez les notes du client ou de livraison lorsqu'elles sont présentes.
En-tête de livraison
function printDeliveryHeader() {
if (!Order.Destination.IsDelivery) {
return;
}
var address = Order.Delivery.Address;
var line2 = address.Address2 ? address.Address2.trim() : "";
var promise = new Date(Order.PromiseTime);
PrintJob.Bold = true;
PrintJob.DoubleHeight = true;
PrintJob.AddCenteredLine("Delivery Order");
PrintJob.AddCenteredLine(address.Address1.trim());
if (line2 && line2 !== "APT" && line2 !== "NON") { // skip placeholder values
PrintJob.AddCenteredLine(line2);
}
PrintJob.AddCenteredLine(address.City + ", " + address.State + " " + address.PostalCode);
PrintJob.AddCenteredLine("Requested: " + (promise.getFullYear() > 0
? formatDate(promise) + " " + formatTime(promise)
: "ASAP"));
PrintJob.DoubleHeight = false;
PrintJob.Bold = false;
if (address.Notes && address.Notes.trim().length > 0) {
PrintJob.AddLine("Notes: " + address.Notes.trim());
}
PrintJob.AddFilledLine("-");
}
9.10 Regroupement des articles par groupe d'articles
Regroupez un billet par poste, en utilisant le premier groupe d'articles comme titre. Les articles peuvent n'avoir aucun groupe; prévoyez donc une valeur par défaut. Une bannière centrée comme ---- Entrées: 3 ---- aide le personnel de cuisine à parcourir le billet.
Ligne de bannière
function banner(label, width) {
if (label.length >= width) { return label.substring(0, width); }
var left = Math.floor((width - label.length) / 2);
return "-".repeat(left) + label + "-".repeat(width - label.length - left);
}
La bannière n'est que le titre. Pour construire le billet groupé complet, répartissez d'abord les articles dans des compartiments, fusionnez les lignes identiques à l'intérieur de chaque compartiment (même description et mêmes modificateurs), puis imprimez une bannière par groupe suivie de ses articles. Les lignes d'articles centrées en double taille et le décompte final des articles constituent une mise en page courante en cuisine. DoubleWidth réduit de moitié le nombre de caractères par ligne; conservez donc la largeur de la bannière à la largeur normale de la ligne.
Regrouper, fusionner et imprimer (utilise list() et banner() de cette section)
function groupItems(items) {
var groups = {};
items.forEach(function (item) {
var g = list(item.ItemGroups);
var name = g.length > 0 ? g[0].Name : "Other"; // never assume ItemGroups[0]
if (!groups[name]) { groups[name] = { items: [], total: 0 }; }
// same description + same modifiers = same line
var mods = list(item.Modifiers).map(function (m) { return m.Description; }).join(",");
var key = item.Description + "|" + mods;
var existing = groups[name].items.find(function (i) { return i.key === key; });
if (existing) {
existing.Quantity += item.Quantity;
} else {
groups[name].items.push(Object.assign({}, item, { key: key }));
}
groups[name].total += item.Quantity;
});
return groups;
}
function printGrouped(items) {
var groups = groupItems(items);
var total = 0;
Object.keys(groups).forEach(function (name) {
PrintJob.AddNewLine();
PrintJob.AddCenteredLine(banner(name + ": " + groups[name].total, 42));
PrintJob.AddNewLine();
groups[name].items.forEach(function (item) {
PrintJob.DoubleHeight = true;
PrintJob.DoubleWidth = true;
PrintJob.AddCenteredLine(item.Quantity + " " + item.Description);
PrintJob.DoubleWidth = false;
PrintJob.DoubleHeight = false;
list(item.Modifiers).forEach(function (m) { PrintJob.AddCenteredLine(m.Description); });
});
total += groups[name].total;
});
PrintJob.AddNewLine();
PrintJob.AddCenteredLine("Total Items: " + total);
}
9.11 Mise en évidence des articles modifiés
IsEdited indique qu'un article a été modifié après son envoi à la cuisine. Marquez ces articles lorsqu'un billet est réimprimé.
Marqueur de modification
function printWithEditMarker(items) {
items.forEach(function (item) {
var tag = item.IsEdited ? "[EDITED]" : "[NEW] ";
PrintJob.AddLine(tag + " " + item.Quantity + "x " + item.Description);
});
}
CONSEIL
IsEdited est un booléen simple une fois atteint. Pour vous protéger contre une version de la caisse où le champ n'est pas renseigné, vérifiez typeof item.IsEdited !== "undefined" avant de vous y fier.
9.12 Codes à barres, codes QR et images stockées
-
AddBarCode(data, symbology)prend en charge Code39, Ean13 et UPCA, mais chaque imprimante prend en charge un sous-ensemble différent. Transmettez le nom de la symbologie sous forme de chaîne et confirmez en aperçu la forme acceptée par votre version. -
AddQRCode(data, moduleSize)fonctionne sur Epson, OPOS et Brother, et ne fait rien sur Star, NCR, PAR M3876, Partner et PosForDotNet. -
AddImage(id)imprime une image déjà stockée dans la mémoire NVRAM de l'imprimante, selon son numéro d'image. Téléversez d'abord l'image au moyen du processus d'imprimante pris en charge. Cette méthode génère une erreur sur plusieurs imprimantes. -
Faites toujours un essai de lecture de la sortie physique.
Code à barres, code QR et logo stocké
function printCodes() {
PrintJob.AddBarCode(String(Order.Number), "Code39");
PrintJob.AddQRCode("https://example.com/orders/" + Order.Id, 4);
PrintJob.AddImage(1);
}
10. Exemples de scripts complets
Les scripts ci-dessous sont complets et ont été testés par rapport aux règles du moteur (mots restreints, mode strict, déclarations de niveau supérieur, fonctions requises). Exécutez chacun d'abord en aperçu, puis sur l'imprimante cible. Remplacez les valeurs propres à un magasin, comme les identifiants de groupes d'articles, par les vôtres.
REMARQUE: Les blocs « Exemple de sortie » ont été produits en exécutant chaque script avec ses données d'aperçu au moyen d'un moteur de rendu de texte de 42 colonnes. Ils montrent la mise en page prévue. Les polices, les largeurs ainsi que l'impression en rouge et en inversé dépendent de votre imprimante.
10.1 Reçu
Un reçu complet : en-tête du magasin, renseignements sur la commande, articles avec modificateurs et enfants de combos, articles annulés, rabais, frais supplémentaires, taxes, arrondi, total, modes de paiement avec pourboire et détails de la carte, et solde ou monnaie à rendre. Il suppose une imprimante thermique standard de 42 colonnes et n'appelle pas AddCut.
Script 2 : reçu de référence
/*
* Reference receipt script (Receipt script)
* - Receipt scripts receive Order, Store, PrintJob and PrintHelper.
* There is no Printer object in a receipt script.
* - Do not call AddCut(); the receipt is fed and cut automatically after the script.
*/
function setupPreviewData() {
Store.Id = "1234";
Store.Name = "PAR Burger";
Store.Address1 = "123 Main Street";
Store.City = "Syracuse";
Store.State = "NY";
Store.Zip = "13202";
Store.Phone = "315-555-0100";
Order.Id = "AAAE6LTF9QAE";
Order.Number = 312;
Order.Name = "Melissa";
Order.CreatedDate = new Date("2026-10-08T17:32:22Z");
Order.Employee = { DisplayName: "Sam K" };
Order.Destination = { Name: "Counter - Dine In", IsDelivery: false };
Order.Customer = null;
Order.Items = [
{
Voided: false, IsDeleted: false,
CompositeOrderItemId: 0, CompositeOrderItems: [],
Quantity: 2, Description: "Cheeseburger", Price: 7.50, PriceWithModifiers: 8.50,
Modifiers: [
{ Description: "Extra Cheese", Price: 1.00, Modifiers: [] },
{ Description: "No Onion", Price: 0, Modifiers: [] }
]
},
{
Voided: false, IsDeleted: false, CompositeOrderItemId: 0, Quantity: 1,
Description: "Value Basket", Price: 9.99, PriceWithModifiers: 9.99,
Modifiers: [],
CompositeOrderItems: [
{ Quantity: 1, Description: "Fries MED", Price: 0, PriceWithModifiers: 0,
Modifiers: [{ Description: "Extra Salt", Modifiers: [] }] },
{ Quantity: 1, Description: "Root Beer MED", Price: 0, PriceWithModifiers: 0,
Modifiers: [] }
]
},
{
Voided: true, IsDeleted: false,
CompositeOrderItemId: 0, CompositeOrderItems: [],
Quantity: 1, Description: "Hot Dog", Price: 3.00, PriceWithModifiers: 3.00,
Modifiers: []
}
];
Order.Discounts = [
{ PrintedName: "Employee Meal", Name: "Employee Meal", Amount: 2.00 }
];
Order.Promotions = [];
Order.Surcharges = [{ Name: "Service Fee", Amount: 1.00 }];
Order.SubTotal = 26.99;
Order.Tax = 2.02;
Order.Rounding = 0;
Order.Total = 28.01;
Order.Balance = 0;
Order.Tenders = [{
Name: "Visa", Amount: 28.01, TipAmount: 3.00, CardNumber: "************1111",
Authorization: "A2B45", AuthorizedTenderAmount: 31.01
}];
}
/* ---------- helpers ---------- */
function money(value) {
return "$" + Number(value || 0).toFixed(2);
}
function formatDateTime(value) {
// Works for a production DateTime (arrives as a JS Date) and for preview strings.
var iso = new Date(value).toISOString();
return PrintHelper.GetShortDate(iso) + " " + PrintHelper.GetShortTime(iso);
}
function list(collection) {
// Null-safe copy of a collection into a real array.
return collection ? Array.from(collection) : [];
}
function printModifiers(modifiers, level) {
list(modifiers).forEach(function (mod) {
PrintJob.Red = true;
PrintJob.AddLine(" ".repeat(level * 3) + mod.Description);
PrintJob.Red = false;
printModifiers(mod.Modifiers, level + 1); // sub-modifiers
});
}
function printItem(item, isVoid) {
var total = item.Quantity * item.PriceWithModifiers;
var label = item.Quantity + " " + (isVoid ? "VOID " : "") + item.Description;
var price = isVoid ? "(" + money(total) + ")" : (total > 0 ? money(total) : "");
PrintJob.AddLeftAndRightLine(label.substring(0, 32), price);
list(item.CompositeOrderItems).forEach(function (child) {
PrintJob.AddLine(" " + child.Quantity + " " + child.Description);
printModifiers(child.Modifiers, 2);
});
printModifiers(item.Modifiers, 1);
}
/* ---------- print ---------- */
function print() {
var items = list(Order.Items).filter(function (i) {
return i.CompositeOrderItemId == 0 && !i.IsDeleted; // top-level items only
});
var active = items.filter(function (i) { return !i.Voided; });
var voided = items.filter(function (i) { return i.Voided; });
// Header
PrintJob.Bold = true;
PrintJob.DoubleHeight = true;
PrintJob.AddCenteredLine(Store.Name + " #" + Store.Id);
PrintJob.DoubleHeight = false;
PrintJob.Bold = false;
PrintJob.AddCenteredLine(Store.Address1);
PrintJob.AddCenteredLine(Store.City + ", " + Store.State + " " + Store.Zip);
PrintJob.AddCenteredLine(Store.Phone);
PrintJob.AddNewLine();
// Order information
PrintJob.AddLine(formatDateTime(Order.CreatedDate));
PrintJob.AddLine("Destination: " + (Order.Destination ? Order.Destination.Name : ""));
PrintJob.AddLine("Order: " + Order.Number + (Order.Name ? " " + Order.Name : ""));
PrintJob.AddLine("Server: " + (Order.Employee ? Order.Employee.DisplayName : ""));
if (Order.Customer) {
PrintJob.AddLine("Customer: " + Order.Customer.FullName);
}
PrintJob.AddFilledLine("-");
// Items
active.forEach(function (item) { printItem(item, false); });
if (voided.length > 0) {
PrintJob.AddNewLine();
PrintJob.Bold = true;
PrintJob.AddCenteredLine("VOIDED ITEMS");
PrintJob.Bold = false;
voided.forEach(function (item) { printItem(item, true); });
}
PrintJob.AddFilledLine("-");
// Totals
PrintJob.AddLeftAndRightLine("Subtotal", money(Order.SubTotal));
list(Order.Discounts).forEach(function (d) {
PrintJob.AddLeftAndRightLine(d.PrintedName || d.Name, "-" + money(d.Amount));
});
list(Order.Promotions).forEach(function (p) {
PrintJob.AddLeftAndRightLine(p.PrintedName || p.Name, "-" + money(p.Amount));
});
list(Order.Surcharges).forEach(function (s) {
PrintJob.AddLeftAndRightLine(s.Name, "+" + money(s.Amount));
});
PrintJob.AddLeftAndRightLine("Tax", money(Order.Tax));
if (Order.Rounding != 0) {
var sign = Order.Rounding > 0 ? "+" : "-";
PrintJob.AddLeftAndRightLine("Rounding", sign + money(Math.abs(Order.Rounding)));
}
PrintJob.Bold = true;
PrintJob.AddLeftAndRightLine("TOTAL", money(Order.Total));
PrintJob.Bold = false;
// Tenders
list(Order.Tenders).forEach(function (t) {
PrintJob.AddLeftAndRightLine(t.Name, money(t.Amount));
if (t.TipAmount > 0) {
PrintJob.AddLeftAndRightLine(" Tip", money(t.TipAmount));
}
if (t.CardNumber) { // card tenders only
PrintJob.AddRightLine("Card: " + t.CardNumber);
if (t.Authorization) {
PrintJob.AddRightLine("Auth: " + t.Authorization);
}
}
});
// Balance / change
if (Order.Balance > 0) {
PrintJob.Bold = true;
PrintJob.AddLeftAndRightLine("BALANCE DUE", money(Order.Balance));
PrintJob.Bold = false;
} else if (Order.Balance < 0) {
PrintJob.AddLeftAndRightLine("CHANGE DUE", money(Math.abs(Order.Balance)));
}
PrintJob.AddNewLine();
PrintJob.AddCenteredLine("Merci de votre visite !");
}
Exemple de sortie
PAR Burger #1234
123, rue Principale
Syracuse, NY 13202
315-555-0100
8/10/2026 17 h 32
Destination : Comptoir - Sur place
OCommande : 312 Melissa
Serveur : Sam K
------------------------------------------
2 Cheeseburger 17,00$
Supplément fromage
Sans oignons
1 Panier économique 9,99$
1 portion de frites moyennes
ExSupplément de sel
1 bière de racine moyenne
ARTICLES ANNULÉS
1 Hot-dog VOID ((3,00 $)
------------------------------------------
Sous-total 26,99$
Repas du personnel -2,00$
SFrais de service +1,00$
Taxes 2,02$
TOTAL 28,01$
Visa 28,01$
Pourboire 3,00$
Carte : ************1111
Auth: A2B45
Merci de votre visite !
10.2 Billet de cuisine
Un billet qui s'adapte à Printer.ChitType : les billets sommaires regroupent les articles par groupe d'articles; les billets simples et de sac impriment les articles tels qu'ils sont énumérés. Il affiche une bannière de commande future, des marqueurs d'articles modifiés, des notes et la position du billet, et se termine par AddCut(85).
Script 3 : billet de cuisine de référence
/*
* Reference kitchen chit script (Chit script)
* - Chit scripts receive Order, Printer, Store, PrintJob and PrintHelper.
* - Printer.ChitType is "SummaryChit", "SingleChit" or "Bag".
* SingleChit: the script runs once per item and Order.Items holds exactly that one item.
* SummaryChit: the script runs once per printer with that printer's items.
* Bag: the script runs once.
* - Chit scripts end the ticket themselves with AddCut(85).
*/
function setupPreviewData() {
Printer.Name = "Grill";
Printer.ChitType = "SummaryChit";
Printer.ChitCurrentIndex = 1;
Printer.TotalChits = 1;
Order.Number = 312;
Order.Name = "Melissa";
Order.IsFutureOrder = true;
Order.PromiseTime = new Date("2026-10-08T18:30:00Z");
Order.Destination = {
Name: "Drive Thru", KitchenChitHeader: "DRIVE THRU", IsDelivery: false
};
Order.Items = [
{
Quantity: 1, Description: "WHOPPER", SortPriority: 2, IsEdited: false, Note: "",
ItemGroups: [{ Id: 1, Name: "Entrees" }],
CompositeOrderItems: [],
Modifiers: [{ Description: "NO PICKLES" }, { Description: "ADD ONION" }]
},
{
Quantity: 2, Description: "FRIES MED", SortPriority: 3,
IsEdited: true, Note: "Well done",
ItemGroups: [], CompositeOrderItems: [], Modifiers: []
},
{
Quantity: 1, Description: "OREO SHAKE", SortPriority: 4,
IsEdited: false, Note: "",
ItemGroups: [{ Id: 2, Name: "Drinks" }], CompositeOrderItems: [], Modifiers: []
}
];
}
function list(collection) {
return collection ? Array.from(collection) : [];
}
function groupName(item) {
var groups = list(item.ItemGroups);
// never assume ItemGroups[0] exists
return groups.length > 0 ? groups[0].Name : "Other";
}
function printItem(item) {
PrintJob.Bold = true;
PrintJob.DoubleHeight = true;
var tag = item.IsEdited ? "[EDIT] " : "";
PrintJob.AddLine(tag + item.Quantity + " " + item.Description);
PrintJob.DoubleHeight = false;
PrintJob.Bold = false;
list(item.CompositeOrderItems).forEach(function (child) {
PrintJob.AddLine(" " + child.Quantity + " " + child.Description);
});
list(item.Modifiers).forEach(function (mod) {
PrintJob.AddLine(" " + mod.Description);
});
if (item.Note) {
PrintJob.AddLine(" NOTE: " + item.Note);
}
}
function print() {
var chitType = Printer.ChitType;
var items = list(Order.Items).sort(function (a, b) {
return a.SortPriority - b.SortPriority;
});
// Header
PrintJob.Bold = true;
PrintJob.Reverse = true;
PrintJob.AddCenteredLine(Order.Destination.KitchenChitHeader || Order.Destination.Name);
PrintJob.Reverse = false;
PrintJob.DoubleHeight = true;
PrintJob.AddCenteredLine("#" + Order.Number + " " + (Order.Name || ""));
PrintJob.DoubleHeight = false;
PrintJob.Bold = false;
if (Order.IsFutureOrder) {
var promise = new Date(Order.PromiseTime).toISOString();
PrintJob.AddCenteredLine("FUTURE - " + PrintHelper.GetShortDate(promise)
+ " " + PrintHelper.GetShortTime(promise));
}
PrintJob.AddLeftAndRightLine(
Printer.Name, "Chit " + Printer.ChitCurrentIndex + " of " + Printer.TotalChits);
PrintJob.AddFilledLine("-");
// Body
if (chitType == "SummaryChit") {
var current = "";
items.forEach(function (item) {
var group = groupName(item);
if (group !== current) {
current = group;
PrintJob.AddCenteredLine("-- " + group + " --");
}
printItem(item);
});
} else {
items.forEach(printItem); // SingleChit and Bag: no grouping
}
PrintJob.AddNewLine();
PrintJob.AddCut(85);
}
Exemple de sortie (SummaryChit, imprimante de 40 colonnes)
DRIVE THRU
#312 Melissa
FUTUR - 2026-10-08 18h30
Grill Bon 1 sur 1
----------------------------------------
-- Entrees --
1 WHOPPER
SANS CORNICHONS
AJOUTER DES OIGNONS
-- Autre --
[EMODIFIER] 2 FRITES MOYENNES
NOTE : bien joué
-- Boissons --
1 MILK-SHAKE OREO
------- COUPURE -------
Pour une exécution SingleChit, Order.Items contient exactement un article; le même script imprime donc un article par billet.
10.3 Étiquettes d'articles en boîte
Certains articles, comme les pizzas entières ou le poulet en boîte, s'impriment sur leur propre étiquette plutôt que sous forme de ligne sur le billet principal. Ce modèle identifie les articles en boîte au moyen d'un groupe d'articles, fusionne les articles identiques, imprime une étiquette par unité (ou une seule étiquette regroupée « 12x » à partir d'un seuil) et ajoute à chaque étiquette le pied de page « Box X of Y ». Associez les articles du menu à un groupe d'articles dédié et remplacez IG_BOXED par son identifiant.
Script 4 : étiquettes d'articles en boîte
/*
* Étiquettes des articles en boîte (Chit script, SummaryChit).
* Les articles du groupe « en boîte » s'impriment sur leur propre étiquette. ("Box X of Y");
* Tout le reste est laissé aux cartes habituelles.
* Remplacez l'identifiant du groupe d'éléments par celui configuré dans votre menu.
*/
var IG_BOXED = 673549520;
// À partir de cette quantité, imprimez une seule étiquette « 12x » au lieu de 12 étiquettes.
var CONSOLIDATE_AT = 10;
function setupPreviewData() {
Printer.Name = "Box Station";
Printer.ChitType = "SummaryChit";
Order.Number = 312;
Order.Name = "Melissa";
Order.Items = [
{ ItemId: 1, Description: "PIZZA AU FROMAGE", AlternateKitchenName: "PIZZA AU FROMAGE",
Quantity: 1, ItemGroups: [{ Id: IG_BOXED, Name: "Boxed" }],
Modifiers: [{ Description: "Sauce légère", ItemId: 50 }] },
{ ItemId: 1, Description: "PIZZA AU FROMAGE", AlternateKitchenName: "PIZZA AU FROMAGE",
Quantity: 1, ItemGroups: [{ Id: IG_BOXED, Name: "Boxed" }],
Modifiers: [{ Description: "Sauce légère", ItemId: 50 }] },
{ ItemId: 2, Description: "AILE", AlternateKitchenName: "AILES",
Quantity: 12, ItemGroups: [{ Id: IG_BOXED, Name: "Boxed" }], Modifiers: [] },
{ ItemId: 3, Description: "SOUDE", AlternateKitchenName: "SOUDE",
Quantity: 1, ItemGroups: [], Modifiers: [] }
];
}
function list(c) { return c ? Array.from(c) : []; }
function hasItemGroup(item, groupId) {
return list(item.ItemGroups).some(function (g) { return g.Id == groupId; });
}
function modifiersEqual(a, b) {
var left = list(a).map(function (m) { return m.ItemId; }).sort().join(",");
var right = list(b).map(function (m) { return m.ItemId; }).sort().join(",");
return left === right;
}
function mergeBoxed(items) {
var merged = [];
var candidates = items.filter(function (i) { return hasItemGroup(i, IG_BOXED); });
candidates.forEach(function (item) {
var match = merged.find(function (m) {
return m.ItemId === item.ItemId && modifiersEqual(m.Modifiers, item.Modifiers);
});
if (match) {
match.Quantity += item.Quantity;
} else {
merged.push(Object.assign({}, item));
}
});
return merged;
}
function print() {
var boxed = mergeBoxed(list(Order.Items));
var totalBoxes = boxed.reduce(function (sum, i) { return sum + i.Quantity; }, 0);
var boxNumber = 1;
boxed.forEach(function (item) {
var consolidated = item.Quantity >= CONSOLIDATE_AT;
var labels = consolidated ? 1 : item.Quantity;
for (var n = 0; n < labels; n++) {
PrintJob.Bold = true;
PrintJob.AddCenteredLine("#" + Order.Number + " " + (Order.Name || ""));
PrintJob.DoubleHeight = true;
var prefix = consolidated ? item.Quantity + "x " : "";
PrintJob.AddCenteredLine(prefix + item.AlternateKitchenName);
PrintJob.DoubleHeight = false;
PrintJob.Bold = false;
list(item.Modifiers).forEach(function (m) {
PrintJob.AddCenteredLine(m.Description);
});
if (consolidated) {
var last = boxNumber + item.Quantity - 1;
PrintJob.AddRightLine("Boxes " + boxNumber + "-" + last + " of " + totalBoxes);
boxNumber += item.Quantity;
} else {
PrintJob.AddRightLine("Box " + boxNumber + " of " + totalBoxes);
boxNumber += 1;
}
PrintJob.AddCut(85);
}
});
}
Exemple de sortie
#312 Melissa
PIZZA AU FROMAGE
Sauce légère
Boîte 1 of 14
------- COUPURE -------
#312 Melissa
PIZZA AU FROMAGE
Sauce légère
Boîte 2 of 14
------- COUPURE -------
#312 Melissa
12x AILES
Boîte 3-14 of 14
------- COUPURE -------
Types de boîtes et lignes complémentaires
Le script 4 fusionne selon ItemId et les modificateurs. Pour fusionner aussi les articles qui partagent un nom de cuisine, acceptez également une correspondance sur AlternateKitchenName. Au-delà du groupe d'articles en boîte lui-même, des groupes d'articles ou des identifiants de modificateurs supplémentaires peuvent décrire la boîte (taille ou type) et déclencher des lignes complémentaires, comme des instructions de coupe en pointes, un sachet d'assaisonnement ou des pepperoncini. Les constantes ci-dessous sont des exemples tirés du menu d'un magasin; remplacez-les par les identifiants de groupes d'articles et de modificateurs de votre propre configuration.
| Constante d'exemple | Représente |
|---|---|
| IG_Box8 / IG_Box10 / IG_Box12 | Taille de la boîte (8 po, 10 po ou 12 po) à imprimer sur l'étiquette. |
| IG_BoxChicken / IG_BoxSandwich | Étiquette du type de boîte (« BOÎTE À POULET», « Boîte à sandwich »). |
| IG_NYS | Signale un article qui nécessite des instructions de coupe en pointes (par exemple, une pizza de style New York). |
| IG_ITSeasoning | Signale un article qui nécessite une ligne complémentaire « IT Assaisonnement ». |
| IG_AllPizzas / IG_ThinPizzas | Signale les articles de pizza, et plus précisément les pizzas à croûte mince, pour leurs lignes complémentaires respectives. |
| IG_AllSandwiches | Signale les articles de sandwich pour leur ligne complémentaire. |
| I_GESC | Un ItemId de modificateur précis vérifié au moyen d'une fonction d'aide hasItemModifier plutôt que d'un groupe d'articles. |
Lignes complémentaires (ébauche, à appeler depuis la boucle d'étiquettes du script 4)
// Remplacez les zéros par les identifiants configurés dans votre menu.
var IG_BOX8 = 0, IG_BOX10 = 0, IG_BOX12 = 0, IG_NYS = 0, IG_SEASONING = 0;
function hasItemModifier(item, modifierItemId) {
return list(item.Modifiers).some(function (m) { return m.ItemId == modifierItemId; });
}
function printBoxLines(item) {
if (hasItemGroup(item, IG_BOX8)) { PrintJob.AddCenteredLine('8" box'); }
if (hasItemGroup(item, IG_BOX10)) { PrintJob.AddCenteredLine('10" box'); }
if (hasItemGroup(item, IG_BOX12)) { PrintJob.AddCenteredLine('12" box'); }
if (hasItemGroup(item, IG_NYS)) { PrintJob.AddCenteredLine("WEDGE CUT"); }
if (hasItemGroup(item, IG_SEASONING)) { PrintJob.AddCenteredLine("IT SEASONING"); }
}
10.4 Étiquette de livraison Brother
Une étiquette horizontale de 812 sur 309 points avec des bordures imbriquées, une bannière d'adresse inversée, des étiquettes latérales verticales, un bloc de totaux ancré et un pied de page. Elle met en œuvre l'orientation, le curseur, les positions fixes, les cadres et les règles de réinitialisation. Exécutez-la uniquement sur une imprimante d'étiquettes Brother.
Script 5 : étiquette de livraison Brother
/*
* Étiquette de livraison pour imprimante d'étiquettes Brother (écriture Chit, étiquette horizontale avec
* étiquettes latérales verticales). Toutes les positions sont exprimées en points d'impression. À exécuter sur une
* imprimante Brother seulement ; les imprimantes thermiques de reçus ignorent les instructions de positionnement.
*/
function setupPreviewData() {
Store.Name = "Store 5QR4";
Order.Name = "David Bratcher";
Order.Number = 12;
Order.PromiseTime = new Date(2026, 9, 8, 14, 20);
Order.Delivery = {
PhoneNumber: "(502)281-4877",
Address: { Address1: "123 Main Street", Address2: "Apt 4" }
};
Order.SubTotal = 87.06;
Order.Tax = 6.09;
Order.Total = 93.15;
}
function money(v) { return "$" + Number(v || 0).toFixed(2) + " "; }
function timeText(date) {
var d = new Date(date);
var h = d.getHours();
var ampm = h >= 12 ? "pm" : "am";
var hh = String(h % 12 || 12).padStart(2, "0");
var mm = String(d.getMinutes()).padStart(2, "0");
return hh + ":" + mm + ampm;
}
function print() {
var addr = Order.Delivery && Order.Delivery.Address ? Order.Delivery.Address : {};
PrintJob.Orientation = 1; // set orientation first (it carries over)
PrintJob.SetCursorPosition(0, 0); // top-left corner
PrintJob.AddBox(812, 309, 2); // outer border
PrintJob.MoveCursorPosition(35, 0);
PrintJob.AddBox(746, 277, 2); // inner border
PrintJob.AddBox(350, 277, 2); // left-side divider
PrintJob.AddBox(746, 240, 2);
PrintJob.AddBox(746, 100, 2); // lower section
PrintJob.AddBox(646, 100, 2);
PrintJob.AddBox(681, 35, 35); // thickness = height: a solid bar
PrintJob.Reverse = true; // white text on the solid bar
PrintJob.AddLine(addr.Address1 || "");
PrintJob.SetCursorPosition(778, 0);
PrintJob.Reverse = false;
PrintJob.AddBox(35, 35, 2); // corner mark
PrintJob.MoveCursorPosition(10, 10);
PrintJob.AddLine("C");
PrintJob.MoveCursorPosition(28, -12);
PrintJob.FixXPosition = true; // anchor X for the next line
PrintJob.Reverse = true;
PrintJob.AddLeftAndRightLine(addr.Address2 || "", "");
PrintJob.Reverse = false;
PrintJob.FixXPosition = false; // release the anchor
PrintJob.SetCursorPosition(43, 75);
PrintJob.AddLine(Order.Name);
PrintJob.SetCursorPosition(388, 75);
PrintJob.AddLine(Order.Delivery.PhoneNumber);
PrintJob.SetCursorPosition(658, 75);
PrintJob.AddLine(timeText(Order.PromiseTime));
PrintJob.SetCursorPosition(8, 10); // vertical tag, left column
PrintJob.Orientation = 2;
PrintJob.FixYPosition = true;
PrintJob.AddLeftAndRightLine(String(Order.Number).padStart(4, "0"), "5 box(es) ");
PrintJob.Orientation = 1;
PrintJob.SetCursorPosition(780, 65); // vertical tag, right column
PrintJob.Orientation = 2;
PrintJob.Reverse = true;
PrintJob.FixYPosition = true;
PrintJob.AddLeftAndRightLine("P", " " + String(Order.Number).padStart(4, "0") + " ");
PrintJob.FixYPosition = false;
PrintJob.Reverse = false;
PrintJob.Orientation = 1;
PrintJob.SetCursorPosition(388, 108); // totals block
PrintJob.FixXPosition = true;
PrintJob.AddLeftAndRightLine("Sub-Total", money(Order.SubTotal));
PrintJob.AddLeftAndRightLine("Sales Tax", money(Order.Tax));
PrintJob.Bold = true;
PrintJob.AddLeftAndRightLine("TOTAL", money(Order.Total));
PrintJob.Bold = false; // AddCut does not reset Bold
PrintJob.FixXPosition = false;
PrintJob.AddLeftAndRightLine(" THANKS FOR ORDERING", "DOWNLOAD OUR APP ");
PrintJob.AddCut(85); // ends and cuts the label
}
Ce que le script dessine
| Élément | Façon dont il est dessiné |
|---|---|
| Bordures extérieure et intérieure | SetCursorPosition(0, 0), puis AddBox(812, 309, 2); un déplacement de 35 points, puis un AddBox(746, 277, 2) imbriqué. |
| Barre d'adresse pleine | AddBox(681, 35, 35) : l'épaisseur égale la hauteur, la barre est donc remplie. Reverse = true imprime l'adresse en blanc sur celle-ci. |
| Marque de coin | Un cadre de 35 sur 35 en haut à droite, avec la lettre « C » placée à l'intérieur au moyen de MoveCursorPosition(10, 10). |
| Rangée client, téléphone, heure | Trois appels à SetCursorPosition sur la même rangée (y = 75). |
| Étiquettes latérales verticales | Orientation = 2 avec FixYPosition pour ancrer chaque paire, puis Orientation = 1 pour revenir à l'horizontale. |
| Bloc de totaux | FixXPosition = true pour que chaque rangée parte du même bord gauche; Bold est désactivé avant la coupe de l'étiquette. |
10.5 Étiquette verticale de boîte à pizza
Une étiquette Brother avec une bordure extérieure, une marque de coin « C », une étiquette verticale de commande « P / 0006 », trois colonnes inversées de description de pizza, un séparateur simple, un cadre s'étendant jusqu'au bord de l'étiquette, un bloc vertical « SIDES: », une étiquette verticale du nombre de boîtes et un pied de page inversé avec l'adresse du client, de retour en mode horizontal. Des commentaires figurent sur les lignes qui utilisent l'orientation, les ancrages, le déplacement du curseur et les cadres. Ajoutez une fonction setupPreviewData() pour l'exécuter en aperçu, et exécutez-la uniquement sur une imprimante d'étiquettes Brother.
Script 6 : étiquette verticale de boîte à pizza
function print() {
PrintJob.SetCursorPosition(0, 0); // jump to the label's top-left corner
PrintJob.AddBox(812, 307, 2); // outer border for the whole label
PrintJob.MoveCursorPosition(777, 0); // move to the right edge for the corner box
PrintJob.AddBox(35, 35, 2); // small callout box
PrintJob.MoveCursorPosition(10, 10); // move inside the callout box
PrintJob.AddLine("C");
PrintJob.MoveCursorPosition(770, -10); // move to where the vertical tag will start
PrintJob.Orientation = 2; // switch to Vertical; keeps the current position
PrintJob.Reverse = true;
PrintJob.FixYPosition = true; // anchor for the "P" / "0006" pair
PrintJob.AddLeftAndRightLine("P", "0006");
PrintJob.MoveCursorPosition(0, -35); // move along the label's length before the next section
PrintJob.FixYPosition = false; // release the anchor
PrintJob.Reverse = false;
PrintJob.AddLeftAndRightLine('14" ORIGINAL', " ");
PrintJob.Reverse = true; // black background for the next three lines
PrintJob.AddLeftAndRightLine("# G-PARM SWIRL", " ");
PrintJob.AddLeftAndRightLine("# CLEAN CUT", " ");
PrintJob.AddLeftAndRightLine("# SQUADERE CUT", " ");
PrintJob.Reverse = false;
PrintJob.AddLeftAndRightLine("HAWAIIAN BBQ Chicken", "");
PrintJob.MoveCursorPosition(30, -8); // move past the last column before the divider
PrintJob.AddBox(2, 307, 2); // plain line
PrintJob.AddBoxToAxis(0, 35, 35); // customer address bar: spans back to the label edge without moving the cursor
PrintJob.MoveCursorPosition(0, 40); // move into the SIDES: block
PrintJob.FixYPosition = true; // anchor for the whole SIDES: block
PrintJob.Reverse = false;
PrintJob.AddLine("");
PrintJob.AddLine("SIDES:");
PrintJob.AddLine("");
PrintJob.AddLine("+1 Garlic Sauce");
PrintJob.AddLine("+1 Pepperoncini");
PrintJob.SetCursorPosition(10, 40); // jump to the box-count tag's position
PrintJob.FixYPosition = true; // anchor for the "031126" / "5 of 5" pair
PrintJob.AddLeftAndRightLine("031126", "5 of 5");
PrintJob.Orientation = 1; // back to Horizontal for the footer
PrintJob.SetCursorPosition(8, 0); // jump to the footer's starting position
PrintJob.Reverse = true;
PrintJob.AddLine("Customer Address: 1234");
PrintJob.Reverse = false; // reset styles before the cut
PrintJob.AddCut(85);
}
11. Essais et validation
11.1 Procédure
-
Commencez dans un emplacement hors production ou avec un ensemble de modifications de test.
-
Confirmez que l'indicateur de fonctionnalité
PARPOS.EnableScriptPrintingConfigurationest activé pour le groupe cible. -
Créez le script avec un nom clair et le bon type de document.
-
Rédigez
setupPreviewData()avec des valeurs représentatives : noms longs, nombreux modificateurs, modificateurs imbriqués, combos, annulations, rabais, état de commande future, données de livraison et champs facultatifs manquants (client null, groupes d'articles vides, aucun mode de paiement). -
Exécutez l'aperçu et corrigez chaque erreur de validation avant d'enregistrer.
-
Assignez le script sous Options > Impression > Reçu ou Bon.
-
Publiez l'ensemble de modifications et confirmez que la caisse a reçu les paramètres mis à jour et que l'imprimante prévue est configurée.
-
Effectuez un essai d'impression physique sur l'imprimante cible par le chemin de connexion réel.
-
Comparez la sortie avec la mise en page attendue.
-
Testez la solution de repli : désactivez l'indicateur de fonctionnalité ou retirez la sélection du script dans un environnement contrôlé et confirmez que la mise en page intégrée s'imprime.
-
Testez les cas d'échec : script invalide, données facultatives manquantes, imprimante hors ligne, imprimante principale indisponible et fonctionnalité matérielle non prise en charge.
11.2 Ce qu'il faut vérifier sur papier
| Vérification | Ce qu'il faut observer |
|---|---|
| Largeur de ligne | Aucune ligne coupée ou tronquée, y compris en double largeur et avec les noms d'articles réels les plus longs. |
| Alignement | Les colonnes de gauche et de droite sont alignées; les lignes centrées sont bien centrées. |
| Mise en évidence | Bold, Red, Reverse, la double hauteur et la double largeur apparaissent comme prévu, ou se dégradent de façon lisible lorsqu'ils ne sont pas pris en charge. |
| Codes | Le code à barres et le code QR se lisent de façon fiable à une distance et à un contraste normaux. |
| Images | Le logo stocké s'imprime, avec le bon numéro d'image. |
| Coupe et avance | Un reçu est coupé exactement une fois. Les billets et les étiquettes sont coupés aux endroits prévus. |
| Ordre des articles | Les articles, les modificateurs et les enfants de combos apparaissent dans l'ordre et avec l'indentation attendus. |
| Totaux | Le sous-total, les rabais, les frais supplémentaires, les taxes, l'arrondi et le total concordent; le solde dû ou la monnaie à rendre est correct. |
| Billets multiples | Chaque billet d'une tâche à billets multiples comporte le bon en-tête et le bon indice de billet. |
| État de l'étiquette | Sur les étiquettes, rien (gras, double hauteur ou largeur, justification) ne se reporte d'une étiquette à la suivante. |
12. Dépannage et FAQ
12.1 Dépannage
| Symptôme | Cause probable | Correctif |
|---|---|---|
| « Le script est invalide. » en aperçu | Erreur de syntaxe, variable non déclarée, print() ou setupPreviewData() manquant, ou mot restreint n'importe où dans le texte. |
Lisez le message. Vérifiez la casse, les accolades et les noms de fonctions. Recherchez des mots restreints dans tout le script, y compris les commentaires et les chaînes. |
| « L'identifiant ... a déjà été déclaré » | Un const ou let de niveau supérieur dans un script validé pour l'aperçu. | Utilisez var au niveau supérieur, ou déplacez la déclaration dans une fonction. |
| « X n'est pas défini » | Mode strict et variable non déclarée, ou Printer référencé dans un script de reçu. | Déclarez la variable. N'utilisez Printer que dans les scripts de billets. |
| « Le script contient un motif non autorisé » | Un mot restreint tel que document ou window dans un commentaire ou une chaîne. | Reformulez-le, par exemple « Script type » au lieu de « Document type ». |
| L'ancienne mise en page s'imprime après la publication | Indicateur désactivé, aucun script sélectionné, ensemble de modifications non publié, ou échec du script et retour silencieux de la caisse à la solution de repli. | Activez l'indicateur, sélectionnez le script, publiez, actualisez les paramètres de la caisse et consultez les journaux de la caisse pour y trouver l'erreur du script. |
| Sortie vide | print() n'effectue aucun appel à PrintJob, ou l'exécution a échoué avant la sortie. |
Ajoutez PrintJob.AddLine("Test"), validez, puis ajoutez la logique étape par étape. |
| L'impression se fait sur la mauvaise imprimante | La sélection du script et l'acheminement vers l'imprimante sont des paramètres distincts. | Examinez Options > Impression, la configuration de l'imprimante, la destination de cuisine, le type de billet, la file d'impression et les paramètres de connexion. |
| Données de billet manquantes | Des champs propres aux reçus sont utilisés dans un billet, ou une valeur facultative est absente. | N'utilisez les champs propres aux billets que dans les scripts de billets; protégez les propriétés facultatives. |
| Erreur de fonction d'aide pour les dates « non reconnu comme une date/heure valide » | Un objet Date a été transmis à PrintHelper. | Transmettez new Date(value).toISOString() . |
| AddFilledLine échoue | Une chaîne de plus d'un caractère a été transmise. | Transmettez un seul caractère, comme "-". Pour répéter un motif, utilisez "-".repeat(n) avec AddLine. |
| Mauvais symbole monétaire | ConvertDecimalToCurrencyString suit la culture de l'ordinateur. |
Construisez le montant avec "\$" + value.toFixed(2). |
| Le nom du client est manquant ou génère des erreurs | Order.Customer est null. |
Vérifiez Order.Customer avant de lire ses champs. |
| Le texte est tronqué ou se coupe de façon inattendue | Contenu plus large que l'imprimante, ou double largeur utilisée. | Raccourcissez ou divisez les lignes, utilisez les méthodes à colonnes et faites des essais sur l'imprimante. |
| Red ou Reverse est absent | L'imprimante, le ruban, l'émulation ou le pilote ne le prend pas en charge. | Confirmez le matériel et l'émulation. Prévoyez une solution de repli lisible en texte normal. |
| Le code QR ou le code à barres ne se lit pas, ou le script échoue | Symbologie ou imprimante non prise en charge, taille, zone de silence ou qualité d'impression. | Utilisez une méthode et une symbologie prises en charge pour cette imprimante et faites des essais physiques. |
| L'image ne s'imprime pas | L'image ne se trouve pas dans la mémoire NVRAM de l'imprimante, ou le mauvais numéro a été utilisé. Certaines imprimantes génèrent une erreur avec AddImage. | Stockez l'image au moyen du processus d'imprimante pris en charge et utilisez son numéro avec AddImage. |
| L'étiquette est pivotée ou mal placée | L'orientation ou l'état du curseur s'est reporté, ou les coordonnées ont été conçues pour une autre taille d'étiquette. | Définissez l'orientation explicitement au début, réinitialisez les styles et testez les coordonnées en points d'imprimante. |
| L'étiquette suivante commence en gras ou en double hauteur | Bold, DoubleHeight, DoubleWidth ou la justification ne sont pas réinitialisés par une coupe. |
Désactivez-les avant AddCut . |
| L'imprimante principale est hors ligne | Défaillance de l'imprimante physique ou de la file d'impression. | Suivez la procédure de basculement d'imprimante du site. Un script ne garantit pas l'acheminement vers une imprimante de secours. |
12.2 Comportement hors ligne
Lorsque la caisse est hors ligne par rapport aux services de niveau supérieur au magasin, les paramètres et les scripts qu'elle a déjà téléchargés peuvent continuer d'être utilisés, sous réserve du comportement de la mémoire cache locale des paramètres. Un script ne peut pas récupérer de nouvelles données ni appeler de services externes. Si le script n'est pas présent localement, si les paramètres sont périmés ou si l'imprimante ou la file d'impression locale est indisponible, l'impression suit le comportement existant de la caisse en cas d'échec et de repli. Validez le fonctionnement hors ligne sur le déploiement cible, car le comportement de la mémoire cache et de la file d'impression dépend de l'environnement.
12.3 Foire aux questions
L'impression par script remplace-t-elle la configuration existante des reçus et des billets?
Non. Lorsqu'il est activé et sélectionné, un script a préséance. Si l'indicateur est désactivé, qu'aucun script n'est sélectionné ou que l'exécution échoue, la configuration existante de Options > Impression est utilisée.
Puis-je appeler des API externes à partir d'un script?
Non. fetch, XMLHttpRequest et les éléments semblables sont restreints, et l'environnement isolé n'a aucun accès au réseau. Un script ne fonctionne qu'avec les données que la caisse fournit (ou les données d'aperçu).
Puis-je utiliser un même script pour les reçus et les billets?
Pas en pratique. Les scripts sont créés et assignés par type de document, les données diffèrent et Printer n'existe pas dans les scripts de reçus.
Dois-je appeler AddCut?
Dans un script de billet ou d'étiquette, oui : terminez avec PrintJob.AddCut(85). Dans un script de reçu, non : le reçu est avancé et coupé automatiquement.
Pourquoi mon reçu est-il revenu silencieusement à l'ancien format?
Une erreur de validation ou d'exécution ne renvoie rien et la caisse imprime la mise en page intégrée. L'erreur ne figure que dans les journaux. Validez de nouveau en aperçu et consultez les journaux.
AddBox est-il valide pour toutes les imprimantes?
Non. Les commandes de cadre et de curseur sont destinées aux imprimantes d'étiquettes Brother prises en charge. Utilisez AddFilledLine pour les séparateurs sur les imprimantes de reçus.
Un script contrôle-t-il l'imprimante de secours?
Pas universellement. Le contenu du script et le basculement physique sont distincts; l'acheminement vers l'imprimante de secours dépend de la configuration de l'imprimante et de la file d'impression, et doit être testé sur place.
Quelles fonctionnalités JavaScript puis-je utiliser?
La syntaxe moderne prise en charge par Jint 4.1.0, y compris les fonctions fléchées, le chaînage optionnel, les gabarits de chaînes littérales et padStart. Utilisez var au niveau supérieur.
Comment imprimer un logo stocké?
Stockez l'image dans la mémoire NVRAM de l'imprimante au moyen du processus d'imprimante pris en charge et appelez PrintJob.AddImage(id) avec son numéro d'image.
Annexe A. Données d'aperçu
Exemples pour setupPreviewData(). Les valeurs sont des valeurs fictives. En production, la caisse fournit les objets réels et n'appelle jamais setupPreviewData().
A.1 Structures des objets
Une affectation par objet imbriqué de Order, en utilisant les membres énumérés à la section 6.2. Order.Employee et Order.ClosedByEmployee partagent la même structure. Les collections qui contiennent des articles (Items, VoidItems, PreviousItems, BagItems, AllItems) partagent la structure d'article.
Commun aux scripts de reçus et de billets
function setupPreviewData() {
Order.Customer = { FirstName: "Test", LastName: "Name", FullName: "Test Name", PhoneNumber: "12435456" };
Order.Delivery = {
Address: { Address1: "Address 1", Address2: "Address 2", City: "Test city", State: "Test state", PostalCode: "12345678" },
PhoneNumber: "1243635123"
};
Order.Destination = {
Id: 1, Indicator: "Test indicator", KitchenChitHeader: "TestKitchenHead",
KitchenDescription: "Test description", IsDelivery: true, Name: "Test name"
};
Order.Discounts = [{ PrintedName: "TestPrintedName", Name: "TestName", Amount: 19.68 }];
Order.Employee = { DisplayName: "DisplayTestName", FirstName: "TestFirstName", LastName: "TestLastName", IsTraining: false };
Order.Lane = { Name: "TestLane", Prefix: "TestPrefix" };
Order.MarketingCampaigns = [{ Name: "TestCampaignName" }];
Order.Party = { Name: "TestParty", OrderNumber: 1234 };
Order.Promotions = [{ PrintedName: "TestPromotionDisplayName", Name: "TestPromotionName", Amount: 11.84 }];
Order.Surcharges = [{ Name: "TestSurcharges", Amount: 22.38 }];
Order.Taxes = [{ Name: "TestTaxName", Amount: 14.12 }];
Order.Terminal = { Name: "test" };
Order.Items = [{
Id: 1, ItemId: 1214, Voided: false, IsTaxFree: true, Quantity: 2,
Description: "Amer - Hamburger", Price: 7.5, PriceWithModifiers: 8.5, Note: "Order Notes",
Modifiers: [{ Id: 1, ItemId: 123214, Description: "Extra Cheese", Price: 1.0 }]
}];
}
Scripts de billets seulement
Order.KeyIngredients = [{ Count: 2, Text: "Key ingredient 1" }];
// Premiers éléments, BagItems et AllItems utilisent tous la forme de l'objet. Sur les jetons, un modificateur
// est réduit à Description et ItemId.
Order.PreviousItems = [{
Id: 1, ItemId: 1214, Quantity: 2, Description: "Amer - Hamburger", Price: 7.5,
AutoNumberPrefix: "pref", AutoNumber: 1, Note: "Order Notes",
Modifiers: [{ Description: "Extra Cheese", ItemId: 123214 }]
}];
Scripts de reçus seulement
Order.ReceiptPrintCount = 1;
A.2 Combos et articles composites sur un billet
Exemple de données avec des articles composites (combos). Chaque combo contient des CompositeOrderItems imbriqués, chacun avec ses propres ItemGroups et Modifiers, à côté d'articles autonomes qui réutilisent les mêmes identifiants d'articles du menu. Utilisez-le pour tester la logique des billets, comme le modèle d'articles en boîte de la section 10.3, par rapport à des structures de combos réalistes. Il ne définit que setupPreviewData(); ajoutez votre propre print().
Données d'aperçu d'un billet de combo
// Build one item. parentId is 0 for a top-level item, or the Id of its parent combo.
function mk(id, itemId, desc, kitchen, sort, group, parentId, children, mods) {
return {
Id: id, ItemId: itemId, Quantity: 1, IsDeleted: false,
Description: desc, AlternateKitchenName: kitchen, SortPriority: sort,
ItemGroups: group ? [group] : [],
CompositeOrderItemId: parentId,
CompositeOrderItems: children || [],
Modifiers: mods || []
};
}
function setupPreviewData() {
Store.Name = "Culver's 99999";
Store.Address1 = "Prairie du Sac";
Store.State = "WI";
Store.Phone = "608-643-7980";
Order.CreatedDate = new Date();
Order.Id = "AAAE6LTF9QAE";
Order.Destination = { Name: "Online Carryout" };
Order.Name = "John Doe";
Order.PromiseTime = new Date();
Order.Total = 45.99;
var DISCOUNTABLE = { Id: 1, Name: "Discountable Items" };
var SIDES = { Id: 3, Name: "Sides" };
var CHICKEN = { Id: 44, Name: "CHICKEN" };
Order.Items = [
// Combo: Dinner (id 1) with three children
mk(1, 1, "Dinner", "Din", 2, DISCOUNTABLE, 0, [
mk(2, 2, "6 Piece Shrimp (Dnr)", "6 SHRIMP", 1, DISCOUNTABLE, 1, [], [
{ Id: 3, ItemId: 3, Description: "Cocktail Sauce" },
{ Id: 4, ItemId: 4, Description: "Boom Boom Sauce" }
]),
mk(5, 5, "French Fries MED", "FRY", 4, SIDES, 1),
mk(6, 6, "Coleslaw MED", "SLAW", 5, { Id: 4, Name: "Drinks" }, 1)
]),
// Combo: Value Basket (id 7) with four children
mk(7, 7, "Value Basket", "VB", 3, null, 0, [
mk(8, 8, "Crispy Chicken Sandwich", "CRSP CHIX", 3, CHICKEN, 7),
mk(9, 9, "Regular VB", "OLO ID: 217270 91573227520", 1, { Id: 2, Name: "Regular" }, 7),
mk(10, 5, "French Fries MED", "FRY", 5, SIDES, 7),
mk(11, 11, "Root Beer MED", "RT BR MED", 6, { Id: 4, Name: "DRINKS" }, 7)
]),
// Standalone items that reuse ItemIds from the combos
mk(12, 5, "French Fries MED", "FRY", 5, SIDES, 0),
mk(13, 8, "Crispy Chicken Sandwich", "CRSP CHIX", 6, CHICKEN, 0)
];
}
REMARQUE:La référence aux objets de ce guide s'appuie également sur la documentation de référence antérieure des scripts d'imprimante, qui a été compilée à partir de notes locales sur les scripts d'imprimante..
