Impression d’étiquettes en Python : personnaliser les champs avec LPSNG

Vous devez imprimer des étiquettes dont le contenu n’est pas fixe. Un nom de produit peut devoir être mis en majuscules, une date d’expiration calculée à partir d’une date de production, ou un prix total dérivé de la quantité et du prix unitaire. Au lieu d’exécuter un script Python séparé pour transformer vos données avant chaque impression, vous pouvez attacher du Python directement aux champs d’étiquette dans LPSNG.

Avec l’API de script de champ, vous intégrez de petits blocs Python dans des champs d’étiquette individuels. Avant que LPSNG ne génère l’étiquette, il exécute ces scripts et utilise la valeur retournée comme contenu final du champ. C’est le cœur de l’impression d’étiquettes par script Python dans LPSNG : des valeurs de champ pilotées par les données, sans pipeline de script externe.

Comme le système d’impression d’étiquettes nouvelle génération inclut un concepteur d’étiquettes visuel et une exécution Python intégrée, vous n’avez pas à configurer un environnement Python séparé, à gérer des pilotes d’imprimante ou à traiter des protocoles d’impression bruts. Le flux de travail géré réunit la conception d’étiquettes, l’exécution des scripts et la soumission des travaux d’impression au même endroit.

Prérequis

Avant de commencer, assurez-vous de disposer de :

• Un compte LPSNG avec accès au concepteur d’étiquettes. Cela s’applique aux éditions cloud et embarquées.
• Une familiarité de base avec la syntaxe Python : variables, fonctions, méthodes de chaînes et f-strings.
• Une mise en page d’étiquette avec laquelle travailler, ou la possibilité d’en créer une nouvelle dans LPSNG.
• Facultatif : un fichier de données d’exemple tel que CSV ou Excel pour tester les valeurs de champ dynamiques avec des enregistrements réalistes.

Vous n’avez pas besoin d’une installation Python locale. Les scripts Python s’exécutent dans LPSNG dans le cadre du processus de rendu de l’étiquette.

Étape par étape : ajouter des scripts Python aux champs d’étiquette

Étape 1 : Ouvrir le concepteur d’étiquettes et sélectionner le champ cible

Connectez-vous à LPSNG et ouvrez l’étiquette que vous souhaitez modifier. Dans le concepteur d’étiquettes, sélectionnez le champ qui doit contenir du contenu dynamique — par exemple, un champ de texte pour le nom du produit.

Si vous partez de zéro, créez une nouvelle étiquette, ajoutez un champ de texte et liez-le à une source de données ou laissez-le comme espace réservé pour les tests.

Étape 2 : Ouvrir les propriétés du champ et localiser la section de script

Une fois le champ sélectionné, ouvrez ses propriétés. Recherchez la zone de script destinée au code Python. L’API de script de champ la traite comme un bloc de script attaché au champ ; la section peut donc être intitulée Script, Python ou similaire selon la version du concepteur.

Le point important est que le script appartient au champ, et non à l’étiquette entière. Si vous attachez un script au mauvais champ, il n’affectera pas la sortie que vous attendez.

Étape 3 : Écrire un script qui reçoit la valeur du champ et renvoie une valeur modifiée

Dans la zone de script Python, la valeur actuelle du champ est disponible pour votre code. Un script minimal qui convertit la valeur en majuscules ressemble à ceci :

return value.upper()

Si le champ contient "apple" avant l’exécution du script, l’étiquette générée affichera "APPLE".

Utilisez return pour renvoyer la valeur finale à l’étiquette. LPSNG utilise la valeur retournée comme contenu imprimé du champ.

Étape 4 : Utiliser les variables de contexte pour créer du contenu dynamique

Vous pouvez combiner la valeur actuelle du champ avec des dates, des données d’enregistrement ou d’autres contextes disponibles pendant le rendu. Par exemple, pour ajouter la date actuelle à un nom de produit :

from datetime import datetime

return f"{value} - {datetime.now().strftime('%Y-%m-%d')}"

Si la valeur du champ est "Sauce tomate", le résultat généré pourrait être :

Sauce tomate - 2026-08-26

Selon la façon dont votre étiquette est liée à une source de données, l’enregistrement de données actuel peut également être disponible dans le contexte du script. Vérifiez les paramètres de liaison de données de votre étiquette dans le concepteur pour confirmer les variables que vous pouvez utiliser.

Étape 5 : Tester le script dans le concepteur

Utilisez l’aperçu de l’étiquette ou les données de test pour vérifier la sortie avant l’impression. LPSNG exécute les scripts de champ pendant l’aperçu, vous pouvez donc voir le résultat exact de votre code Python sans envoyer de travail d’impression.

Apportez de petites modifications et relancez l’aperçu jusqu’à ce que le champ affiche exactement ce dont vous avez besoin.

Étape 6 : Enregistrer l’étiquette et l’utiliser dans un travail d’impression

Une fois que le script fonctionne dans l’aperçu, enregistrez l’étiquette. Vous pouvez maintenant l’utiliser via l’interface web, l’API de services web ou le lecteur LPSNG.

Le flux de travail géré signifie que vous n’avez pas besoin d’exporter votre script Python, de l’envelopper dans un processeur de travaux séparé ou de communiquer avec un protocole d’imprimante. LPSNG exécute le script dans le cadre du rendu de l’étiquette et envoie la sortie finale à l’imprimante ou au format de fichier sélectionné.

Étape 7 : Facultatif — combiner plusieurs champs ou effectuer des calculs

Les scripts de champ Python peuvent également calculer des valeurs à partir d’autres données. Par exemple, si l’enregistrement actuel expose quantity et unit_price, vous pouvez calculer un prix total :

quantity = float(data["quantity"])
unit_price = float(data["unit_price"])
total = quantity * unit_price

return f"{total:.2f}"

Cela est utile pour l’étiquetage des commandes, les bordereaux d’expédition ou les étiquettes d’entrepôt où une valeur imprimée dépend de plusieurs champs d’entrée.

Veillez à renvoyer une chaîne. Si votre script renvoie un nombre, LPSNG peut ne pas le générer comme vous l’attendez. En cas de doute, convertissez le résultat avec str() ou une f-string.

Vérification : confirmer que votre script Python fonctionne

Après avoir attaché un script Python à un champ, confirmez la sortie à l’aide d’au moins l’une de ces vérifications :

• Utilisez l’aperçu de l’étiquette dans LPSNG. C’est le moyen le plus rapide de voir les valeurs des champs après l’exécution du script.
• Générez une sortie PDF ou PNG via le service web ou le lecteur LPSNG, puis inspectez l’étiquette générée. Si vous ne disposez pas d’imprimante physique, consultez Comment tester l’impression d’étiquettes sans imprimante physique.
• Vérifiez les erreurs de script dans le concepteur. LPSNG peut afficher des exceptions Python ou des messages d’erreur lorsque vous testez le champ.
• Comparez la sortie sur plusieurs enregistrements de données. Exécutez la même étiquette avec différentes données d’entrée pour confirmer que le script se comporte de manière cohérente et ne produit pas de valeurs inattendues pour les champs vides ou manquants.

Résolution des problèmes courants

Le script ne s’exécute pas

Assurez-vous que le script est attaché au bon champ. Un script sur un autre champ n’affectera pas le champ que vous inspectez. Confirmez également que le type de champ prend en charge les scripts.

Erreurs de syntaxe

L’indentation Python et les deux-points manquants sont des causes courantes. Si l’éditeur de script affiche des détails d’erreur, lisez-les attentivement. Testez d’abord avec un script minimal d’une ligne :

return value

Ensuite, construisez la logique progressivement.

Sortie incorrecte

Si la valeur imprimée semble incorrecte, vérifiez si votre script renvoie une chaîne. Pour les nombres et les dates, utilisez str() ou une f-string pour produire une sortie texte :

return str(total)

Vérifiez également que le script lit les bons noms de variables pour le champ actuel et l’enregistrement de données.

Performances avec de grands travaux d’impression

Pour les grands lots, gardez les scripts de champ légers. Évitez les boucles complexes ou les opérations coûteuses répétées si le même résultat peut être précalculé dans votre fichier de données avant l’impression.

Accès au contexte

Confirmez quelles variables et importations sont disponibles dans l’environnement de script. L’API de script de champ est conçue pour modifier les valeurs de champ en fonction de l’enregistrement actuel et du contexte intégré. Elle peut ne pas autoriser l’accès arbitraire au réseau ou aux fichiers pour des raisons de sécurité.

FAQ

Puis-je utiliser des scripts Python pour générer des codes-barres dynamiquement ?

Oui. LPSNG prend en charge les scripts Python sur les champs, et vous pouvez générer du contenu de code-barres dynamiquement en renvoyant la chaîne appropriée. Le type de champ code-barres peut ensuite générer cette chaîne sous forme de code-barres. Consultez la documentation des formats de codes-barres pour les types pris en charge. Si vous avez besoin d’un flux d’impression de codes-barres entièrement piloté par API, consultez Automatiser l’impression d’étiquettes de codes-barres avec l’API LPSNG.

Est-il possible d’accéder à des sources de données externes depuis un script Python dans LPSNG ?

L’API de script de champ est conçue pour modifier les valeurs de champ en fonction de l’enregistrement de données actuel et du contexte intégré. Elle peut ne pas autoriser l’accès arbitraire au réseau ou aux fichiers pour des raisons de sécurité. Pour les données externes, envisagez d’utiliser l’API de services web ou des fichiers de données tels qu’Excel et CSV pour fournir les données avant l’impression.

Comment déboguer un script Python qui échoue silencieusement ?

LPSNG peut afficher les erreurs de script dans le concepteur lorsque vous testez le champ. Vous pouvez également ajouter des instructions return temporaires pour inspecter les valeurs intermédiaires :

return f"DEBUG: value={value}, type={type(value)}"

Assurez-vous que le script renvoie une chaîne et gère les exceptions proprement afin qu’un mauvais enregistrement ne casse pas un travail d’impression entier.

Puis-je réutiliser des scripts Python sur plusieurs étiquettes ?

Les scripts sont généralement attachés à des champs individuels, mais vous pouvez les copier-coller entre les étiquettes. Pour une logique complexe, envisagez d’utiliser une intégration externe via l’API pour prétraiter les données avant de les envoyer à LPSNG. Cela garde les scripts d’étiquette simples et rend la logique réutilisée plus facile à maintenir.

Conclusion

Les scripts Python dans LPSNG vous offrent un moyen pratique de créer des étiquettes dynamiques, pilotées par les données, sans outils externes. Vous pouvez formater des chaînes, calculer des valeurs, ajouter des dates et générer du contenu de codes-barres directement dans le concepteur d’étiquettes.

Une fois que vos scripts de champ Python fonctionnent, l’étape suivante consiste à automatiser le flux de travail environnant. Explorez l’API de services web pour les travaux d’impression programmatiques, ou utilisez le lecteur LPSNG pour le traitement par lots. Si vous évaluez les éditions, consultez Tarification des logiciels d’impression d’étiquettes : explication des offres RSJ LPSNG.

Connectez-vous à LPSNG et ouvrez le concepteur d’étiquettes pour essayer votre premier script de champ Python dès aujourd’hui.

Articles connexes

• Automatiser l’impression d’étiquettes de codes-barres avec l’API LPSNG
• Comment tester l’impression d’étiquettes sans imprimante physique
• Tarification des logiciels d’impression d’étiquettes : explication des offres RSJ LPSNG
• Solutions d’impression d’étiquettes pour les systèmes de gestion d’entrepôt