Intégration du barman

Bartender étend les fonctionnalités d'impression des applications Tulip.

:::(Info) ()Téléchargez le test unitaire de Bartender depuis la bibliothèque Tulip::: :

Bartender de Seagull Scientific est un client d'impression leader dans l'industrie qui est largement utilisé dans le monde de la fabrication pour agir comme une couche d'interface entre les solutions ERP/MES et une liste toujours croissante d'imprimantes, de configuration de réseau, et plus encore.

En bref, Bartender gère le côté imprimante de cette équation, et expose des points de terminaison API que les fonctions du connecteur Tulip peuvent atteindre pour imprimer des documents.

Considérations sur le réseau

Le client Bartender est généralement hébergé sur un serveur (ou un ordinateur) sur le réseau Internet de votre établissement. Il n'est généralement pas accessible depuis des systèmes externes. Comme Tulip fonctionne dans le Cloud, nous devons exposer votre instance de Bartender au Cloud.

Il y a plusieurs façons de procéder :

1. Un hôte Connecteur On-Prem peut servir de tunnel dans votre réseau. Le processus d'installation de ces connecteurs peut être un peu complexe et nécessitera probablement l'aide de votre équipe informatique.
2. Un appareil Tulip Edge connecté à votre réseau peut agir en tant qu'hôte du connecteur dans votre réseau. C'est de loin la façon la plus simple d'établir ce tunnel, et la configuration ne devrait pas nécessiter d'aide informatique. L'Edge MC est disponible pour 150 $.
3. Un tunnel SSH peut être établi pour exposer votre instance de bartender. Il s'agit de l'option la plus technique, et sa mise en place nécessitera très certainement l'aide du département informatique. Ce type de tunnel n'offre pas la sécurité intégrée d'une solution construite par Tulip.

En outre, nous utiliserons le portail d'impression proposé par Bartender. Cette offre n'est accessible que dans le cadre des plans "Automation" et "Enterprise".

Configuration

:::(Info) (NOTE) Cette procédure a été créée dans le cadre de la recherche initiale d'intégration avec le barman, les fonctions fournies dans l'application de test unitaire peuvent être légèrement différentes ::: :

Configuration de l'étiquette du barman

Dans le cadre de Bartender, j'ai créé un exemple d'étiquette appelé Label Example.btw. Ce document peut être téléchargé (il est joint au bas de cet article). La configuration importante est de s'assurer que chaque champ dynamique de votre étiquette est lié à une entrée de votre modèle de formulaire. Dans ce cas, j'ai également renommé ces champs d'entrée afin que nos touches lors de l'utilisation de l'étiquette dans Tulip soient plus intuitives.

Enfin, j'ai noté l'adresse IP de mon serveur Bartender.

Lorsque Bartender est configuré, vous devriez pouvoir accéder au portail d'impression à partir de n'importe quelle machine sur le même réseau à l'adresse suivante :

http://[server ip]/bartender

Je vous recommande vivement de tester votre formulaire à partir du portail d'impression pour vous assurer que votre instance de Bartender est correctement configurée.

Configuration de Tulip

Remarque : dans cet exemple, j'utiliserai un Edge MC comme hôte du connecteur.

1. Connectez votre Edge MC à votre réseau
2. Cliquez sur la configuration du connecteur

1. Réglez le champ "Running on" sur l'hôte du connecteur de votre Edge MC.

1. Réglez l'hôte sur l'IP de votre serveur Bartender.

1. Réglez le port sur "5160" comme indiqué par le serveur de barman.

Fonctions du connecteur

L'impression vers Bartender nécessite cinq fonctions de connecteur :

1. Obtenir une liste des dossiers dans votre instance de bartender. Sélectionnez le dossier à partir duquel vous souhaitez imprimer.
2. Obtenir une liste d'imprimantes et sélectionner l'imprimante sur laquelle vous souhaitez imprimer.
3. Obtenir une liste de fichiers dans le dossier souhaité. Sélectionnez le fichier que vous souhaitez imprimer.
4. Formulez une demande au point d'accès à l'impression, qui vous renverra un identifiant de demande.
5. Transmettez l'imprimante, le chemin d'accès à l'étiquette, l'identifiant de la demande et le nom de l'imprimante.

:::(Info) (NOTE) Les imprimantes, dossiers et documents (1,2 et 3 ci-dessus) ne changeront pas si la configuration de Bartender ne change pas. Ils peuvent être définis de manière statique dans vos applications de production :: :

Obtenir des dossiers

Entrées : Note

Résultats : Une liste de dossiers dans votre instance de Bartender. Chaque dossier possède 3 attributs :

• ID unique
• Nom
• Chemin d'accès - Si ce dossier se trouve dans d'autres dossiers, il s'agit du chemin d'accès à ce dossier.

Obtenir des imprimantes

Entrées : Note

Résultats : Liste des imprimantes configurées dans votre instance de Bartender.

Obtenir les éléments d'un dossier

Entrées : L'identifiant unique du dossier, provenant de la fonction Get Folders.

Résultats : Une liste de tous les noms de fichiers dans ce dossier, et le chemin absolu vers ce dossier.

Obtenir l'identifiant de la demande

Entrées : Le nom de l'imprimante, le chemin absolu vers le fichier (chemin du dossier + nom du fichier) et l'identifiant unique du dossier (provenant de la fonction Get Folders).

Résultats : Une valeur textuelle, cet identifiant de réponse sera utilisé lors de l'impression.

:::(Info) (NOTE) Cette fonction doit être appelée à chaque fois qu'une impression est effectuée. Un ID d'impression unique est nécessaire pour chaque travail d'impression. :: :

Imprimer

Entrées : Le nom de l'imprimante, le chemin absolu du fichier (chemin du dossier + nom du fichier) et l'identifiant unique du dossier (provenant de la fonction Get Folders), l'identifiant de la réponse (provenant de Get RequestID), et tous les champs dynamiques de l'étiquette.

Résultats : Une valeur textuelle indiquant si l'impression a réussi.

:::(Info) (REMARQUE) Les champs dynamiques de cette étiquette doivent correspondre à ceux de la configuration de l'étiquette dans Bartender. La fonction d'impression de l'exemple est configurée pour fonctionner avec le fichier Label Example.btw fourni avec le test unitaire de la bibliothèque ::: :