Comment créer une intégration CSV de base en utilisant des remplacements de base de données
Aperçu
Les intégrations CSV sont parmi les intégrations les plus simples et les plus utiles. Elles nécessitent seulement un minimum de configuration pour démarrer. Ce type d'intégration utilise les informations d'un fichier déclencheur pour remplacer la base de données associée à une étiquette. 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 en utilisant les sources de données nommées - une intégration CSV qui sépare un fichier CSV et le répartit dans des sources de données nommées sur l'étiquette. Peut également être utilisée pour définir l'imprimante et les informations d'étiquette.
S'applique à
BarTender 2022 et versions ultérieures
Informations
Configuration de l'étiquette
Commencez par créer le fichier d'étiquette et le connecter à une base de données. Vous pouvez utiliser votre propre fichier CSV ou enregistrer cette base de données d'exemple simple dans un fichier texte ou CSV :
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Créez une nouvelle étiquette et connectez-la à la base de données texte. Si vous ne connaissez pas la procédure, consultez Premiers pas avec les connexions de base de données (Vidéo - 5:20).
- Dans la boîte à outils (par défaut à gauche de l'interface), cliquez sur l'onglet Sources de données.
- Cliquez et faites glisser un champ de la base de données depuis cette boîte à outils et déposez-le sur la zone de conception de l'étiquette. Répétez l'opération pour chaque champ de base de données que vous souhaitez ajouter à l'étiquette.
- Enregistrez l'étiquette.
Création de l'intégration
Pour votre intégration, vous aurez besoin d'un fichier déclencheur. Ce fichier doit correspondre au format de la base de données utilisée avec l'étiquette. Ainsi, un déclencheur CSV doit correspondre à une base de données CSV et une base de données délimitée par des tabulations doit avoir un déclencheur délimité par des tabulations. Si vous avez utilisé l'exemple ci-dessus, voici un exemple de fichier déclencheur à utiliser :
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Ouvrez Integration Builder et sélectionnez "Créer une nouvelle intégration".
- Dans la boîte de dialogue de nouvelle 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. Dans 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 y accéder.
- Cliquez sur le menu déroulant Emplacement et sélectionnez "Ordinateur/Réseau"
- Utilisez le bouton Parcourir pour localiser votre dossier ou saisissez le nom du dossier.
- 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 de fichier souhaité.
- 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 l'action Imprimer un document.
- Dans la section Document, sélectionnez le document qui sera imprimé lorsque l'intégration sera déclenchée.
- Cliquez sur l'onglet Options d'impression. Dans la section Remplacements de base de données, cliquez sur le bouton "Ajouter un remplacement de base de données". Modifiez la source de données en Variable. Sélectionnez EventData dans la liste déroulante Variable.
-
L'option (La base de données par défaut) est sélectionnée par défaut lorsque vous n'avez pas importé les paramètres du document. Elle indique que la première connexion de base de données au niveau du document sera remplacée. Cela ne concerne pas les objets de table ou les connexions de base de données des contrôles de saisie de données. Si vous souhaitez plutôt remplacer une connexion de base de données d'un objet de table ou d'un contrôle de saisie de données, ou si vous connaissez le nom de la connexion, vous pouvez sélectionner un nom existant dans la liste Base de données à remplacer ou cliquer sur
Ajouter et saisir le nom dans le champ texte Base de données à remplacer pour ajouter une nouvelle connexion. - 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éploiement de l'intégration
Après avoir testé l'intégration, vous souhaiterez 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 un déploiement local. Cliquez sur Suivant.
- Laissez l'option Déployer maintenant sélectionnée 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 2021
Informations
Configuration de l'étiquette
Commencez par créer le fichier d'étiquette et le connecter à une base de données. Vous pouvez utiliser votre propre fichier CSV ou enregistrer cette base de données d'exemple simple dans un fichier texte ou CSV :
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Créez une nouvelle étiquette et connectez-la à la base de données texte. Si vous ne connaissez pas la procédure, consultez Premiers pas avec les connexions de base de données (Vidéo - 5:20).
- Dans la boîte à outils (par défaut à gauche de l'interface), cliquez sur l'onglet Sources de données.
- Cliquez et faites glisser un champ de la base de données depuis cette boîte à outils et déposez-le sur la zone de conception de l'étiquette. Répétez l'opération pour chaque champ de base de données que vous souhaitez ajouter à l'étiquette.
- Enregistrez l'étiquette.
Création de l'intégration
Pour votre intégration, vous aurez besoin d'un fichier déclencheur. Ce fichier doit correspondre au format de la base de données utilisée avec l'étiquette. Ainsi, un déclencheur CSV doit correspondre à une base de données CSV et une base de données délimitée par des tabulations doit avoir un déclencheur délimité par des tabulations. Si vous avez utilisé l'exemple ci-dessus, voici un exemple de fichier déclencheur à utiliser :
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Ouvrez Integration Builder et sélectionnez "Créer une nouvelle intégration".
- Dans la boîte de dialogue de nouvelle 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. 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 des autorisations supplémentaires sont nécessaires 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 de fichier souhaité.
- 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 l'action Imprimer un document.
- Dans la section Document, sélectionnez le document qui sera imprimé lorsque l'intégration sera déclenchée
- Cliquez sur l'onglet Options d'impression. Dans la section Remplacements de base de données, cliquez sur le bouton "Ajouter un remplacement de base de données". Modifiez la source de données en Variable. Sélectionnez EventData dans la liste déroulante Variable.
-
L'option (La base de données par défaut) est sélectionnée par défaut lorsque vous n'avez pas importé les paramètres du document. Elle indique que la première connexion de base de données au niveau du document sera remplacée. Cela ne concerne pas les objets de table ou les connexions de base de données des contrôles de saisie de données. Si vous souhaitez plutôt remplacer une connexion de base de données d'un objet de table ou d'un contrôle de saisie de données, ou si vous connaissez le nom de la connexion, vous pouvez sélectionner un nom existant dans la liste Base de données à remplacer ou cliquer sur
Ajouter et saisir le nom dans le champ texte Base de données à remplacer pour ajouter une nouvelle connexion. - 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éploiement de l'intégration
Après avoir testé l'intégration, vous souhaiterez 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 un déploiement local. Cliquez sur Suivant.
- Laissez l'option Déployer maintenant sélectionnée 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
Informations
Configuration de l'étiquette
Commencez par créer le fichier d'étiquette et le connecter à une base de données. Vous pouvez utiliser votre propre fichier CSV ou enregistrer cette base de données d'exemple simple dans un fichier texte ou CSV :
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Créez une nouvelle étiquette et connectez-la à la base de données texte. Si vous ne connaissez pas la procédure, consultez Premiers pas avec les connexions de base de données (Vidéo - 5:20).
- Dans la boîte à outils (par défaut à gauche de l'interface), cliquez sur l'onglet Sources de données.
- Cliquez et faites glisser un champ de la base de données depuis cette boîte à outils et déposez-le sur la zone de conception de l'étiquette. Répétez l'opération pour chaque champ de base de données que vous souhaitez ajouter à l'étiquette.
- Enregistrez l'étiquette.
Création de l'intégration
Pour votre intégration, vous aurez besoin d'un fichier déclencheur. Ce fichier doit correspondre au format de la base de données utilisée avec l'étiquette. Ainsi, un déclencheur CSV doit correspondre à une base de données CSV et une base de données délimitée par des tabulations doit avoir un déclencheur délimité par des tabulations. Si vous avez utilisé l'exemple ci-dessus, voici un exemple de fichier déclencheur à utiliser :
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Ouvrez Integration Builder et sélectionnez "Créer une nouvelle intégration".
- Dans la boîte de dialogue de nouvelle 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. 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 des autorisations supplémentaires sont nécessaires 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 de fichier souhaité.
- 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 l'action Imprimer un document.
- Dans la section Document, sélectionnez le document qui sera imprimé lorsque l'intégration sera déclenchée
- Cliquez sur l'onglet Options d'impression. Dans la section Remplacements de base de données, cochez la case et gardez l'option par défaut "Données d'entrée de l'intégration"
- 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éploiement de l'intégration
Après avoir testé l'intégration, vous souhaiterez 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 un déploiement local. Cliquez sur Suivant.
- Laissez l'option Déployer maintenant sélectionnée 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.
Ressources supplémentaires