Présentation

Le but de cet exemple est de créer une intégration via socket réseau qui inclut un script BTXML dans une action. Le script BarTender XML (BTXML Script) permet d'automatiser facilement BarTender tout en offrant aux développeurs tiers un moyen simple d'intégrer BarTender dans leurs applications.

Une réponse XML est générée après l'exécution d'un script BTXML. Cette réponse XML vous fournit des informations précieuses sur le travail d'impression, comme l'imprimante utilisée, les paramètres de BarTender lors de l'impression, et tous les détails concernant les étiquettes imprimées.

Scénario

Une entreprise doit envoyer un travail d'impression contenant 100 articles sérialisés vers le bac 1 de son imprimante HP LaserJet. Le travail d'impression sera lancé lorsque des données — dans ce cas, un script BTXML — seront envoyées via un socket réseau et lues par le service d'intégration BarTender.

Mise en œuvre

Les procédures suivantes expliquent comment configurer, déployer et vérifier l'intégration pour le scénario décrit ci-dessus.

Créer le document BarTender

1. Ouvrez BarTender.
2. Dans le menu Fichier, sélectionnez Nouveau pour ouvrir l'Assistant Nouveau document.
3. Sélectionnez Modèle vierge, puis cliquez sur Terminer pour fermer l'assistant. Un nouveau document s'affiche dans BarTender.
4. Dans le menu Fichier, sélectionnez Imprimer pour ouvrir la boîte de dialogue Imprimer.
5. Dans la liste déroulante Nom, choisissez l'imprimante que vous souhaitez utiliser. Assurez-vous de modifier le nom de l'imprimante dans le script BTXML pour qu'il corresponde à celui sélectionné ici.
6. Cliquez sur Fermer pour quitter la boîte de dialogue Imprimer.
7. Dans le menu Fichier, sélectionnez Mise en page pour ouvrir la boîte de dialogue Mise en page et configurez votre page selon vos besoins.
8. Une fois la configuration terminée, cliquez sur OK pour fermer la boîte de dialogue Mise en page.
9. Dans le menu Créer, sélectionnez les objets de modèle et configurez votre document BarTender comme vous le souhaitez.
10. Dans le menu Fichier, sélectionnez Enregistrer sous et enregistrez le document BarTender sous le nom Scriptdoc.btw.
11. Fermez BarTender.

Créer le document déclencheur du script BTXML

<?xml version="1.0" encoding="utf-8"?>		
<XMLScript Version="2.0">
	<Command Name="Job1">
		<Print>
			<Format>c:\BarTender\Scriptdoc.btw</Format>
			<PrintSetup>
			        <NumberSerializedLabels>100</NumberSerializedLabels>
				<Printer>HP LaserJet</Printer>
				<PaperTray>Tray 1</PaperTray>
			</PrintSetup>
		</Print>
	</Command>
</XMLScript>

<?xml version="1.0" encoding="utf-8"?> 

Collez le script BTXML dans un fichier texte et enregistrez-le sous le nom BTXMLScript.txt.

Créer le fichier d'intégration : Sélectionner une intégration via socket réseau

1. Ouvrez Integration Builder.
2. Cliquez sur Créer une nouvelle intégration pour ouvrir la boîte de dialogue Nouvelle intégration.
3. Cliquez sur Socket réseau puis sur OK.
4. Dans le panneau Intégration via socket réseau, sélectionnez Intégration.
5. Dans le panneau Propriétés, saisissez le Nom de votre intégration, par exemple "Imprimer 100".
6. Dans la liste déroulante Démarrer l'intégration, sélectionnez Automatique.
7. Sous Compte utilisateur, indiquez les identifiants utilisateur. Voir Imprimer un document à l'aide d'un fichier vide pour plus de détails.
8. Dans le panneau Intégration via socket réseau, sélectionnez Socket.
9. Dans le panneau Propriétés, renseignez les informations de Protocole et de Port.
10. Sous Adresse réseau, sélectionnez Écouter sur toutes les interfaces réseau. Vous pouvez aussi choisir Écouter sur une adresse IP spécifique et sélectionner ou saisir une adresse IP.
11. Définissez vos Paramètres de communication et Protocole de connexion si besoin.
12. Dans le panneau Intégration via socket réseau, sélectionnez Données d'entrée.
13. Dans le panneau Propriétés, choisissez Unicode (UTF-8) pour la propriété Encodage.
14. Pour Arrêter la lecture lorsque, sélectionnez Séquence de caractères reçue.
15. Dans le champ Caractères, saisissez </XMLScript>.
16. Activez Inclure la séquence dans le contenu des données d'entrée.
17. Pour Format des données d'entrée, sélectionnez Script BTXML.
18. Dans le panneau Intégration via socket réseau, sélectionnez Réponse.
19. Dans le panneau Propriétés, choisissez vos options de réponse.

Créer le fichier d'intégration : Ajouter une action à l'intégration via socket réseau

1. Dans le panneau Intégration via socket réseau, sélectionnez Actions.
2. Dans le panneau Propriétés, pour Exécuter les actions, sélectionnez Séquentiellement.
3. Pour Répéter les actions, indiquez "1".
4. Dans le panneau Intégration via socket réseau sous Action, cliquez sur  à droite de Imprimer le document pour supprimer l'action par défaut.
5. Sélectionnez Action et cliquez sur  Ajouter pour ouvrir la boîte de dialogue Nouvelle action.
6. Sélectionnez Imprimer dans la liste des types d'action à gauche, puis choisissez Imprimer un script BTXML
7. Cliquez sur OK pour fermer la boîte de dialogue Nouvelle action.
8. L'action Imprimer un script BTXML apparaît dans le panneau Intégration via socket réseau sous Actions.
9. Si ce n'est pas déjà fait, cliquez sur Imprimer un script BTXML dans le panneau Intégration via socket réseau.
10. Dans le panneau Propriétés sous Action, saisissez un nom et une description pour l'action Imprimer un script BTXML.
11. Sous Script, sélectionnez Variable dans la liste déroulante Source du script.
12. Si ce n'est pas déjà fait, choisissez EventData dans la liste déroulante Variables.
13. Cliquez sur  en haut à gauche d'Integration Builder pour enregistrer le fichier d'intégration sous BTXML_Integration.btin.

Tester l'action Imprimer un script BTXML (et non l'intégration complète)

Pour tester une action "Imprimer un script BTXML", vous devez modifier certains paramètres pour le test, puis les remettre à leur état initial après.

1. Dans le panneau Intégration via socket réseau sous Actions, sélectionnez Imprimer un script BTXML.
2. Dans le panneau Propriétés sous Script, sélectionnez Script intégré dans la liste déroulante Source du script.
3. Cliquez sur le bouton Importer pour importer votre fichier BTXML, ou collez simplement le contenu du fichier dans la fenêtre prévue à cet effet.
4. Cliquez sur le bouton Tester à droite de la fenêtre du script.
5. Si l'action "Imprimer un script BTXML" réussit le test, dans le panneau Intégration via socket réseau sous Actions, sélectionnez à nouveau Imprimer un script BTXML.
6. Dans le panneau Propriétés, remettez le type de Script sur Variable et le type de Variable sur %EventData%.

Tester et déployer le fichier d'intégration

1. Cliquez sur  Tester l'intégration dans la barre d'outils d'Integration Builder.
2. Si votre intégration passe le test, cliquez sur  Déployer l'intégration pour ouvrir la boîte de dialogue Nouveau déploiement.
3. Saisissez un nom et une description pour le déploiement.
4. Vérifiez que le paramètre Fichier d'intégration indique bien BTXML_Integration.btin. Sinon, cliquez sur Parcourir et sélectionnez BTXML_Integration.btin.
5. Pour Serveurs cibles, ajoutez le ou les serveurs sur lesquels vous souhaitez déployer le fichier d'intégration.
6. Définissez les paramètres de Gestion des erreurs souhaités.
7. Cliquez sur OK pour fermer la boîte de dialogue et déployer le fichier d'intégration.
8. La Console d'administration s'ouvrira sur le nœud Intégrations, affichant votre intégration

Exécuter le scénario et visualiser le traitement de l'intégration

1. Le service d'intégration BarTender surveille le socket réseau sélectionné. Envoyez le contenu de BTXMLScript.txt via le socket réseau en utilisant la méthode de votre choix.
2. Le service d'intégration transmet le script BTXML à BarTender.
3. BarTender exécute les actions spécifiées dans le script BTXML, en imprimant 100 exemplaires du document Scriptdoc.btw à l'aide du bac 1 de l'imprimante sélectionnée.