Intégration de fichiers : utiliser une image comme déclencheur et comme donnée
Vue d'ensemble
Dans cet exemple, nous allons créer une intégration où nous utilisons un fichier image comme fichier déclencheur, mais aussi le même fichier image à l'intérieur de l'étiquette lors de l'impression. Tant que l'image que vous souhaitez imprimer porte le même nom que dans le fichier déclencheur, vous pouvez changer dynamiquement l'image à imprimer sur l'étiquette au moment de l'impression.
Fichiers d'exemple
Mise en œuvre
Créez un dossier nommé Test sur votre disque C:\. Nous utiliserons ce dossier pour stocker vos fichiers ainsi que comme dossier de surveillance pour votre intégration. Placez tous vos fichiers d'exemple dans ce dossier Test.
Créer le document BarTender
Vous pouvez utiliser le fichier ImageLabel.btw ci-dessus ou simplement créer un document BarTender en suivant les instructions ci-dessous :
- Ouvrez BarTender Designer
- Créez un nouveau document BarTender
- Sélectionnez l'option de sélection d'image
ci-dessus, puis sous Fichier image externe sélectionnez Spécifier le nom du fichier...
- Accédez au dossier Test, cliquez sur le fichier Picture.png puis cliquez sur Sélectionner
- Enregistrez votre document BarTender et nommez-le ImageLabel.btw
Créer l'intégration
Vous pouvez utiliser le fichier ImageFileIntegration.btin ci-dessus ou simplement créer une nouvelle intégration en suivant les instructions ci-dessous :
- Ouvrez Integration Builder
- Sélectionnez Fichier parmi les options d'intégration disponibles
- Dans les options Détection de fichier, changez le modèle de fichier en *.png
- Dans cette même fenêtre, réglez Actions après détection sur Aucune. Nous expliquerons pourquoi un peu plus loin.
- Descendez jusqu'à l'action Imprimer le document. Sous Document, sélectionnez ImageLabel.btw comme étiquette à imprimer.
- Ajoutez une action en utilisant le bouton bleu
à côté de l'arborescence des actions. Nous cherchons ici à sélectionner l'action Supprimer le fichier :
- Sous l'option Fichier, accédez et sélectionnez l'image Picture.png comme fichier à supprimer. Cette action permet deux choses :
- Elle permet d'utiliser l'image pour l'action Imprimer le document, c'est-à-dire que l'étiquette a une image à référencer lors de l'impression, et
- Elle garantit que l'intégration ne tourne pas indéfiniment en boucle, ce qui se serait produit après avoir réglé Actions après détection sur Aucune.
- Enregistrez votre intégration.
Tester l'intégration
- Cliquez sur l'option Tester l'intégration dans le menu Accueil.
- Cliquez sur le bouton Démarrer en haut à droite de la fenêtre de test. Votre intégration devrait maintenant démarrer.
- Observez les messages de sortie. Remarquez comment BarTender parvient à imprimer le document puis à supprimer l'image.
- N'hésitez pas à tester à nouveau en ajoutant une autre image Picture.png de votre choix (rappelez-vous que vous pouvez utiliser n'importe quelle image tant que le nom et l'extension sont Picture.png lorsqu'elle est placée dans le dossier Test déclencheur)
Déployer l'intégration
- Dans la barre d'outils d'Integration Builder, cliquez sur
Déployer l'intégration pour ouvrir la boîte de dialogue Nouvelle mise en production. - Dans la boîte de dialogue Nouvelle mise en production, saisissez un nom et une description pour votre déploiement.
- Assurez-vous que le paramètre Fichier d'intégration affiche IntegrationFile.btin (ou le nom sous lequel vous avez enregistré votre intégration).
- Pour Serveurs cibles, ajoutez le ou les serveurs sur lesquels vous souhaitez déployer le fichier d'intégration.
- Spécifiez les paramètres de Gestion des erreurs souhaités.
- Cliquez sur OK pour fermer la boîte de dialogue et déployer le fichier d'intégration.
- La Console d'administration s'ouvrira sur le nœud Intégrations, affichant votre intégration.