Vue d'ensemble

À partir de la Révision 5 de BarTender 2019, il est possible d'utiliser un document Excel comme fichier déclencheur dans une intégration. Les fichiers déclencheurs sont des documents qui, lorsqu'ils sont placés dans un dossier prédéfini, déclenchent l'exécution d'une intégration.

Ce tutoriel va vous guider à travers les étapes suivantes :

• Utiliser un fichier Excel comme base de données
• Configurer une intégration de fichiers
• Tester et déployer votre intégration

Ce tutoriel vous explique le processus de base pour mettre en place ce type d'intégration. Une fois que vous l'aurez essayé, n'hésitez pas à suivre les mêmes étapes avec vos propres données.

Applicable à

BarTender 2019 R5 et versions ultérieures.

Informations

Création du fichier d'étiquette

1. Téléchargez database.xlsx à utiliser comme fichier de base de données.
2. Ouvrez BarTender Designer et créez un nouveau document.
3. Une fois l'assistant de nouveau document terminé, cliquez sur l'icône de base de données.
4. Sélectionnez "Microsoft Excel" dans la liste puis cliquez sur Suivant :
5. Utilisez le bouton Parcourir pour localiser le fichier database.xlsx. Sélectionnez-le puis cliquez sur Suivant.
6. Sur cet écran, laissez tous les paramètres par défaut. Vous pouvez consulter l'aperçu du fichier pour voir à quoi ressemble votre base de données avec ces réglages.
   1. Nos données sont toutes contenues dans Sheet1, la seule feuille du document Excel
   2. La première ligne contient les noms de nos champs
      
7. Cliquez sur Suivant puis sur Terminer. Cliquez sur OK pour fermer la boîte de dialogue de la base de données.
8. Maintenant que la base de données est connectée, cliquez sur l'onglet Sources de données dans votre boîte à outils si ce n'est pas déjà sélectionné.
9. Cliquez et faites glisser les deux champs sur votre étiquette.
10. Enregistrez votre étiquette. Elle est maintenant prête à être utilisée !

Création de l'intégration

1. Ouvrez Integration Builder
2. Depuis l'écran de démarrage, sélectionnez "Créer une nouvelle intégration"
3. Sélectionnez "Fichier" dans la boîte de dialogue puis cliquez sur OK :
   
4. Sous Détection de fichiers, choisissez l'emplacement du dossier à surveiller. C'est ici que l'intégration récupérera les fichiers.

5. Modifiez le modèle de fichier en *.xlsx, car nous allons rechercher des fichiers Excel :
   
6. Cliquez sur l'action Imprimer le document.
7. Dans l'onglet Document, utilisez le bouton Parcourir pour sélectionner le document que vous avez créé dans la section précédente. Comme pour le dossier de surveillance, il est recommandé que ce document soit situé dans un dossier centralisé et non dans Mes documents :
   
   
   Dans BarTender 2022, vous pouvez spécifier un chemin relatif au fichier d'intégration lui-même. Pour utiliser le bouton Parcourir et spécifier un chemin absolu, vous devez sélectionner "Ordinateur/Réseau" dans la liste déroulante d'emplacement. Pour plus d'informations sur les chemins relatifs, veuillez consulter l'article suivant : Comment déplacer mes fichiers Excel et BarTender contenus dans le même dossier vers un autre emplacement ?
8. Dans l'onglet Options d'impression, cochez la case "Utiliser la source de données" et sélectionnez "Fichier" dans la liste déroulante.
9. Dans la case Nom du fichier, saisissez "%FilePath%" sans les guillemets.
10. Enregistrez votre fichier.

Test et déploiement de l'intégration

Avant de déployer l'intégration, nous allons la tester et créer quelques fichiers déclencheurs d'exemple. Les fichiers déclencheurs doivent avoir la même structure que la base de données liée au fichier d'étiquette. Voici des données d'exemple pour les tests. Les données sont différentes de celles de la base de données de l'étiquette mais la structure reste la même :

Veuillez télécharger trigger.xlsx pour les tests.

1. Avec l'intégration ouverte, cliquez sur l'onglet Test.
2. Cliquez sur le bouton vert Démarrer dans le ruban supérieur.
   
3. Déposez trigger.xlsx dans le dossier de surveillance que vous avez défini à l'étape précédente.
4. Des messages d'intégration vont commencer à apparaître, confirmant que l'intégration a bien détecté le fichier.
5. Une fois l'impression réussie, il est temps de déployer.
6. Cliquez sur l'onglet Déployer puis sur le bouton vert Déployer :
   
7. Si vous n'avez pas enregistré votre fichier, il vous sera demandé de le faire.
8. Cliquez sur le menu déroulant et sélectionnez "Cet ordinateur" dans la liste. Cliquez sur Suivant.
9. Sélectionnez "Déployer maintenant" puis cliquez sur Terminer.
10. Votre intégration est maintenant déployée.