Comment créer une intégration CSV en utilisant des sources de données nommées
Aperçu
Les intégrations CSV sont parmi les intégrations les plus simples et les plus utiles. Contrairement à d'autres types d'intégrations, cette intégration prend une base de données CSV contenue dans un fichier déclencheur et la divise en variables qui peuvent être transmises à un fichier d'étiquettes. Assurez-vous d'utiliser le menu déroulant de version en haut de la page, car l'interface peut différer selon les versions de BarTender.
Si vous recherchez des intégrations similaires, consultez ces autres tutoriels utiles :
- Imprimer un document à l'aide d'un script de commande d'impression (Vidéo - 9:40) - une intégration qui définit l'imprimante et les informations d'étiquette dans l'en-tête du script et contient une base de données CSV
- Comment créer une intégration CSV basique - une intégration CSV qui utilise une substitution de base de données pour envoyer des données à une étiquette.
- Créer une intégration de base de données (Vidéo - 33:42) - une intégration qui fonctionne de manière très similaire à ce type d'intégration CSV et utilise des sources de données nommées sur l'étiquette.
S'applique à
BarTender 2022 et versions ultérieures
Informations
Configuration de l'étiquette
Ce type d'étiquette n'utilise pas de base de données mais utilise à la place des sources de données nommées pour gérer toutes ses données. Voici les bases pour configurer cette étiquette. Pour plus d'informations, consultez Sources de données nommées dans le fichier d'aide.
- Créez une nouvelle étiquette.
- Ajoutez un objet texte dans la zone de conception de l'étiquette.
- Faites un clic droit sur l'étiquette et sélectionnez Propriétés.
- Sélectionnez la source de données dans la liste. Il sera indiqué "Texte d'exemple".
- Cliquez sur la case à côté du champ Nom.
- Dans la boîte de dialogue, saisissez un nom unique et cliquez sur OK. Pour cet exemple, utilisez ProductName.
- Assurez-vous que le Type est défini sur Données intégrées.
- Lorsque vous créez d'autres objets texte, la boîte de dialogue Source de données nommée sera différente. Lorsque vous cliquez sur la case à côté du champ Nom, sélectionnez la première option pour créer un nouveau nom. Par exemple, utilisez ProductType.
- Une fois que vous avez créé autant de sources de données nommées que vous le souhaitez, enregistrez l'étiquette.
Création de l'intégration
Pour votre intégration, vous aurez besoin d'un fichier déclencheur. Les noms de champs CSV n'ont pas besoin de correspondre aux noms de vos sources de données nommées, car vous allez faire correspondre les champs aux sources de données nommées ici dans l'intégration. Ces noms de champs CSV deviendront automatiquement des variables dans votre intégration. Assurez-vous que vos noms de champs ne contiennent pas d'espaces.
Cet exemple inclut également des informations sur l'imprimante. Modifiez le nom de l'étiquette et le nom de l'imprimante avant de tester dans votre propre intégration. Voici l'exemple :
Name,Food,ID,btw,printer
Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
- Ouvrez Integration Builder et sélectionnez "Créer une nouvelle intégration".
- Dans la nouvelle boîte de dialogue d'intégration, sélectionnez Intégration de fichiers et cliquez sur OK.
- Commencez par définir comment l'intégration détectera les fichiers en configurant le dossier de surveillance. C'est ici que vos fichiers déclencheurs seront déposés et que l'intégration les récupérera. Pour mon exemple, j'ai utilisé un dossier sur le disque C. Évitez les emplacements comme Mes documents ou le Bureau car des autorisations supplémentaires sont nécessaires pour accéder à ces emplacements.
- Cliquez sur le menu déroulant à côté de Emplacement et choisissez "Ordinateur/Réseau"
- Saisissez le nom du dossier ou utilisez le bouton Parcourir pour le localiser.
- Modifiez le modèle de fichier pour qu'il corresponde à votre fichier. J'utilise le modèle par défaut .dat mais vous pouvez utiliser .txt, .csv ou tout autre type que vous souhaitez.
- Faites défiler jusqu'en bas de cette section. Si vous utilisez un modèle de fichier *.txt, modifiez les options "Après détection" pour utiliser une autre extension afin que l'intégration ne récupère pas sans cesse le même fichier.
- Dans le menu de gauche, cliquez sur le bouton + à côté de Actions.
- Dans la boîte de dialogue, cliquez sur la catégorie Transformer puis sélectionnez "Transformer le texte en ensemble d'enregistrements" puis cliquez sur OK.
- Cliquez sur le bouton "Configuration de la connexion à la base de données" et suivez les étapes de l'assistant pour vous connecter à un fichier au format CSV contenant les champs de base de données que vous utiliserez lors de l'impression.
- Changez la "Source du texte" en "Variable", puis assurez-vous que la variable est définie sur "%EventData%".
- Cliquez sur le bouton "Configuration de la connexion à la base de données" et suivez les étapes de l'assistant pour vous connecter à un fichier au format CSV contenant les champs de base de données que vous utiliserez lors de l'impression.
- Cliquez à nouveau sur le bouton + à côté de Action.
- Cliquez sur la catégorie Base de données puis sélectionnez "Pour chaque enregistrement de la base de données" puis cliquez sur OK.
- Cliquez sur l'action Imprimer le document dans la liste des actions et faites-la glisser sous l'action "Pour chaque enregistrement de la base de données" jusqu'à ce qu'elle soit indentée. Cela fera de l'action Imprimer le document un enfant de cette action.
- Dans la section Document, sélectionnez le document que vous avez créé dans la section précédente. Nous allons lui attribuer un nom de variable plus tard.
- Changez l'emplacement en "Ordinateur/Réseau"
- Saisissez le nom du dossier ou utilisez le bouton Parcourir pour le localiser.
- Cliquez sur le bouton [Importer les paramètres du document...]
- Dans la boîte de dialogue, cliquez sur OK.
- Cliquez sur l'onglet Sources de données nommées et remarquez les informations qui ont été importées et remplies pour vous.
Les noms de variables à saisir dans le champ Valeur sont les noms de champs de votre CSV. Les variables sont entourées de %. L'un de nos champs s'appelle Name, donc la variable correspondante sera %Name%.
- Saisissez les variables dans les colonnes correspondantes. En utilisant la base de données d'exemple, les valeurs seront les suivantes :
- Si vous souhaitez remplacer les informations d'imprimante et d'étiquette, vous pouvez également utiliser des variables ici.
- Cliquez sur l'onglet Options d'impression
- Dans la case Imprimante, tapez %printer%, ce qui correspond au champ printer dans le fichier déclencheur csv
- Cliquez sur l'onglet Document.
- Dans le champ Document, supprimez le nom de votre fichier btw tout en gardant le chemin d'accès. Remplacez le nom du document par %btw% qui correspond au nom du champ dans le fichier déclencheur. Le champ Document aura un chemin et une variable comme dans cet exemple :
Notez que lorsque le chemin contient une variable, l'aperçu ne pourra pas être généré. C'est normal.
- Enregistrez votre intégration.
- Cliquez sur le bouton Tester l'intégration dans la barre d'outils en haut.
- Cliquez sur le bouton vert Démarrer en haut à droite.
- Dans l'Explorateur de fichiers, faites glisser le fichier déclencheur CSV dans le dossier de surveillance. L'intégration se déclenchera et une étiquette sera imprimée.
Déployer l'intégration
Après avoir testé l'intégration, vous voudrez la déployer en production.
- Cliquez sur l'onglet Déployer puis sur le bouton Déployer dans la barre d'outils en haut. S'il y a des modifications, il vous sera demandé d'enregistrer votre fichier d'intégration avant de continuer.
- Cliquez sur la liste déroulante et sélectionnez "Cet ordinateur" pour déployer localement. Cliquez sur Suivant.
- Laissez Déployer maintenant sélectionné et cliquez sur Terminer.
- Après un instant, la Console d'administration s'ouvrira et l'intégration apparaîtra comme déployée et en cours d'exécution.
S'applique à
BarTender 2019 et BarTender 2021
Informations
Configuration de l'étiquette
Ce type d'étiquette n'utilise pas de base de données, mais utilise plutôt des sources de données nommées pour gérer toutes ses données. Voici les bases pour configurer cette étiquette. Pour plus d'informations, consultez Sources de données nommées dans le fichier d'aide.
- Créez une nouvelle étiquette.
- Ajoutez un objet texte dans la zone de conception de l'étiquette.
- Faites un clic droit sur l'étiquette et sélectionnez Propriétés.
- Sélectionnez la source de données dans la liste. Il sera indiqué "Texte d'exemple".
- Cliquez sur la case à côté du champ Nom.
- Dans la boîte de dialogue, saisissez un nom unique et cliquez sur OK. Pour cet exemple, utilisez ProductName.
- Assurez-vous que le Type est défini sur Données intégrées.
- Lorsque vous créez d'autres objets texte, la boîte de dialogue Source de données nommée sera différente. Lorsque vous cliquez sur la case à côté du champ Nom, cochez la première option pour créer un nouveau nom. Par exemple, utilisez ProductType.
- Une fois que vous avez créé autant de sources de données nommées que vous le souhaitez, enregistrez l'étiquette.
Création de l'intégration
Pour votre intégration, vous aurez besoin d'un fichier déclencheur. Les noms de champs du CSV n'ont pas besoin de correspondre à vos sources de données nommées, car vous allez faire la correspondance entre les champs et les sources de données nommées ici dans l'intégration. Ces noms de champs CSV deviendront automatiquement des variables dans votre intégration. Assurez-vous que vos noms de champs ne contiennent pas d'espaces.
Cet exemple inclut également des informations sur l'imprimante. Modifiez le nom de l'étiquette et le nom de l'imprimante avant de tester dans votre propre intégration. Voici l'exemple :
Name,Food,ID,btw,printer
Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
- Ouvrez Integration Builder et sélectionnez "Créer une nouvelle intégration".
- Dans la nouvelle boîte de dialogue d'intégration, sélectionnez Intégration de fichiers puis cliquez sur OK.
- Commencez par définir comment l'intégration détectera les fichiers en configurant le dossier de surveillance. C'est ici que vos fichiers déclencheurs seront déposés et que l'intégration les récupérera. Dans mon exemple, j'ai utilisé un dossier sur le disque C. Saisissez le nom du dossier ou utilisez le bouton Parcourir pour le localiser. Évitez les emplacements comme Mes documents ou le Bureau car ils nécessitent des autorisations supplémentaires pour y accéder.
- Modifiez le modèle de fichier pour qu'il corresponde à votre fichier. J'utilise le modèle par défaut .dat mais vous pouvez utiliser .txt, .csv ou tout autre type que vous souhaitez.
- Faites défiler jusqu'en bas de cette section. Si vous utilisez un modèle de fichier *.txt, modifiez les options "Après détection" pour utiliser une autre extension afin que l'intégration ne traite pas plusieurs fois le même fichier.
- Dans le menu de gauche, cliquez sur le bouton + à côté de Actions.
- Dans la boîte de dialogue, cliquez sur la catégorie Transformer puis sélectionnez "Transformer le texte en ensemble d'enregistrements" puis cliquez sur OK.
- Cliquez sur le bouton "Configuration de la connexion à la base de données" et suivez les étapes de l'assistant pour vous connecter à un fichier au format CSV contenant les champs de base de données que vous utiliserez lors de l'impression.
- Changez la "Source du texte" en "Variable", puis assurez-vous que la variable est définie sur "%EventData%".
- Cliquez sur le bouton "Configuration de la connexion à la base de données" et suivez les étapes de l'assistant pour vous connecter à un fichier au format CSV contenant les champs de base de données que vous utiliserez lors de l'impression.
- Cliquez à nouveau sur le bouton + à côté de Action.
- Cliquez sur la catégorie Base de données puis sélectionnez "Pour chaque enregistrement de la base de données" puis cliquez sur OK.
- Cliquez sur l'action Imprimer le document dans la liste des actions et faites-la glisser sous l'action "Pour chaque enregistrement de la base de données" jusqu'à ce qu'elle soit indentée. Cela fera de l'action Imprimer le document un enfant de cette action.
- Dans la section Document, sélectionnez le document que vous avez créé dans la section précédente. Nous utiliserons un nom de variable plus tard.
- Cliquez sur le bouton [Importer les paramètres du document...]
- Dans la boîte de dialogue, cliquez sur OK.
- Cliquez sur l'onglet Sources de données nommées et remarquez les informations qui ont été importées et remplies pour vous.
Les noms de variables à saisir dans le champ Valeur sont les noms de champs de votre CSV. Les variables sont entourées de %. L'un de nos champs s'appelle Name, donc la variable correspondante sera %Name%.
- Entrez les variables dans les colonnes correspondantes. En utilisant la base de données d'exemple, les valeurs seront les suivantes :
- Si vous souhaitez remplacer les informations sur l'imprimante et l'étiquette, vous pouvez également utiliser des variables ici.
- Cliquez sur l'onglet Options d'impression
- Dans la case Imprimante, tapez %printer%, ce qui correspond au champ printer dans le fichier déclencheur csv
- Cliquez sur l'onglet Document.
- Dans le champ Document, supprimez le nom de votre fichier btw tout en gardant le chemin intact. Remplacez le nom du document par %btw% qui correspond au nom du champ dans le fichier déclencheur. Le champ Document aura un chemin et une variable comme dans cet exemple :
Notez que lorsque le chemin contient une variable, l'aperçu ne pourra pas être généré. C'est normal.
- Enregistrez votre intégration.
- Cliquez sur le bouton Tester l'intégration dans la barre d'outils en haut.
- Cliquez sur le bouton vert Démarrer en haut à droite.
- Dans l'Explorateur de fichiers, faites glisser le fichier déclencheur CSV dans le dossier de surveillance. L'intégration se déclenchera et une étiquette sera imprimée.
Déployer l'intégration
Après avoir testé l'intégration, vous voudrez la déployer en production.
- Cliquez sur l'onglet Déployer puis sur le bouton Déployer dans la barre d'outils en haut. S'il y a des modifications, il vous sera demandé d'enregistrer votre fichier d'intégration avant de continuer.
- Cliquez sur la liste déroulante et sélectionnez "Cet ordinateur" pour déployer localement. Cliquez sur Suivant.
- Laissez Déployer maintenant sélectionné et cliquez sur Terminer.
- Après un instant, la Console d'administration s'ouvrira et l'intégration apparaîtra comme déployée et en cours d'exécution.