S'applique à : BarTender 2019 et versions ultérieures.

Présentation

Le but de cet exemple est d'inclure un script de commande d'impression dans une intégration de fichiers.

Ce type d'intégration peut être nécessaire pour les entreprises qui disposent de différentes applications et bases de données avec des besoins d'impression variés répartis sur leur réseau. Dans ces cas-là, le document BarTender à imprimer peut varier en fonction des données incluses dans le fichier déclencheur.

Avec peu de programmation, ces applications peuvent être modifiées ou configurées pour écrire dans un fichier texte les données à utiliser pour l'impression, ainsi que des lignes de commande intégrées. Le service d'intégration peut alors lire et exécuter ces lignes de commande, indiquant à BarTender comment imprimer l'élément selon les instructions spécifiques contenues dans le fichier.

Scénario

Une entreprise doit imprimer des factures saisies par de nombreux utilisateurs différents sur son réseau. Chaque utilisateur a accès à un lecteur partagé. Cependant, les factures sont formatées différemment selon l'utilisateur et le produit facturé. Les différents services utilisent chacun une imprimante distincte.

Dans cette situation, une application de facturation peut créer, avec chaque facture, un fichier texte contenant à la fois les données et un script de commande d'impression, ce script indiquant à BarTender de :

1. Ouvrir le document BarTender spécifié.
2. Utiliser le fichier déclencheur comme fichier de données.
3. Imprimer sur une imprimante spécifique.
4. Supprimer le fichier déclencheur.

Mise en œuvre

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

Préparer les fichiers de données

1. Créez le dossier réseau où les fichiers déclencheurs seront enregistrés. C'est ce dossier que le service d'intégration surveillera. Dans cet exemple, il sera appelé \\InvoiceServer\NewInvoice.
2. Pour chaque type de facture, créez un fichier exemple dans lequel les données sont structurées et délimitées exactement comme elles le seront dans les fichiers de données réels. Dans cet exemple, deux services impriment des factures.

• Pour le premier, créez un fichier texte nommé invoice1.txt contenant deux lignes de données séparées par des virgules (comme ci-dessous).
  

  BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2
  Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Haddonfield,GA,31002,USA,(706) 555-7788,(706) 555-6750

• Pour le second, créez un fichier texte nommé invoice2.txt contenant deux lignes de données séparées par des guillemets et des virgules (comme ci-dessous).
  

  "BusinessName","ContactName","Position","Address1","City","State","Zip","Country","Phone1","Phone2"
  "Far Fetched Imports","Jerry Bom","manager","3320 Happy St.","Incident","Washington","98887","USA","(206) 555-7788","(206) 555-6750"

• Enregistrez les fichiers texte dans le dossier créé à l'étape 1, \\InvoiceServer\NewInvoice.

Créer les documents BarTender

1. En suivant les mêmes étapes que dans la section Créer le document BarTender de Imprimer un document à l'aide d'un fichier de données, créez un document BarTender pour le premier service, en utilisant invoice1.txt comme base de données.
2. Enregistrez le document sous HardwareInvoice.btw.
3. Répétez les mêmes étapes pour créer un second document BarTender pour le deuxième service, en utilisant invoice2.txt comme base de données, en veillant à spécifier le type de délimitation comme "Guillemet et virgule".
4. Enregistrez le document sous SoftwareInvoice.btw.
5. Déplacez les deux fichiers de base de données exemples hors du dossier que le service d'intégration va surveiller et placez-les dans un autre dossier.
6. Fermez BarTender.

Ajouter le script de commande d'impression aux fichiers déclencheurs

1. Ouvrez invoice1.txt et ajoutez les deux lignes suivantes au début du fichier. (Les seuls retours chariot sont juste avant et juste après %END%.)
   

   %BTW% /AF=c:\command\HardwareInvoice.btw /D="%Trigger File Name%" /PRN="EasyCoder F4 (203 dpi)" /R=3 /P /DD 
   %END%

   
   Le fichier complet contient donc maintenant ceci :
   

   %BTW% /AF=c:\command\HardwareInvoice.btw /D="%Trigger File Name%" /PRN="EasyCoder F4 (203 dpi)" /R=3 /P /DD 
   %END%
   BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2
   Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Haddonfield,GA,31002,USA,(706) 555-7788,(706) 555-6750

2. Enregistrez le document sous invoice1.dat.
3. Ouvrez invoice2.txt et ajoutez les deux lignes suivantes au début du fichier. (Les seuls retours chariot sont juste avant et juste après %END%.)
   

   %BTW% /AF=c:\command\SoftwareInvoice.btw /D="%Trigger File Name%" /PRN="Datamax 4400" /R=3 /P /DD 
   %END%

4. Le fichier complet contient donc maintenant ceci :
   

   %BTW% /AF=c:\command\SoftwareInvoice.btw /D="%Trigger File Name%" /PRN="Datamax 4400" /R=3 /P /DD 
   %END%
   "BusinessName","ContactName","Position","Address1","City","State","Zip","Country","Phone1","Phone2"
   "Far Fetched Imports","Jerry Bom","manager","3320 Happy St.","Incident","Washington","98887","USA","(206) 555-7788","(206) 555-6750"

5. Enregistrez le document sous invoice2.dat.

Créer et déployer le fichier d'intégration

Création

1. Ouvrez BarTender Integration Builder.
2. Cliquez sur Créer une nouvelle intégration pour ouvrir la boîte de dialogue Nouvelle intégration.
3. Cliquez sur Fichier puis sur OK.
4. Dans le panneau Intégration de fichiers, sélectionnez Intégration.
5. Dans le panneau Propriétés, saisissez le Nom de votre intégration, par exemple Chaque commande.
6. Dans le menu 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 de fichiers, sélectionnez Détection de fichiers.
9. Dans le panneau Propriétés, sous Options de détection, sélectionnez Ordinateur/Réseau dans la liste Emplacement.
10. Pour l'option Dossier à analyser, saisissez le chemin ou parcourez jusqu'au dossier que vous souhaitez que le service d'intégration surveille. Dans ce cas, indiquez le dossier \\InvoiceServer\NewInvoice que vous avez créé dans la section Préparer les fichiers de données ci-dessus.
11. Dans le champ Motif de fichier, tapez *.dat. 
12. Faites défiler jusqu'à la section Actions après détection. Dans le menu Action, sélectionnez Renommer le fichier.

13. Dans le champ Nouvelle extension, saisissez .txt. Cette extension ne peut pas être la même que celle spécifiée dans Motif de fichier.

14. Dans le panneau Intégration de fichiers sous Actions, cliquez sur  à droite de Imprimer le document pour supprimer l'action par défaut.
15. Sélectionnez Actions, puis cliquez sur  pour ouvrir la boîte de dialogue Nouvelle action.
16. Sélectionnez Imprimer dans la liste des types d'action dans le panneau de navigation de gauche, puis sélectionnez Script de commande d'impression.
17. Cliquez sur OK pour fermer la boîte de dialogue Nouvelle action.
18. Cliquez sur  en haut à gauche d'Integration Builder pour enregistrer le fichier d'intégration sous VariantInvoices.btin.

Déploiement

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

Comprendre et personnaliser le script de commande d'impression

%BTW% est la commande du script de commande d'impression qui indique au service d'intégration de lancer BarTender et d'utiliser la chaîne qui suit comme ligne de commande BarTender.

%END% indique au service d'intégration que la ligne de commande est terminée et que ce qui suit correspond aux données.

Vous devrez modifier le script de commande d'impression pour les deux fichiers déclencheurs comme suit : 

• Remplacez le chemin et le nom de l'imprimante après la commande /PRN par le chemin et le nom de vos propres imprimantes.
• Remplacez c:\command\ par le chemin où vous avez enregistré vos documents BarTender.

Notez également les points suivants :

• Si l'un des chemins, noms de fichiers ou noms d'imprimantes utilisés dans votre script de commande d'impression contient des espaces, vous devez mettre l'ensemble du chemin entre guillemets.
• La Console d'administration reconnaîtra %Trigger File Name% comme une variable et la remplacera automatiquement par le nom du dernier fichier déclencheur avant de transmettre le paramètre à BarTender. Ne remplacez pas %Trigger File Name% par le nom du fichier de base de données.
• La commande /R=3 indique à BarTender de traiter la troisième ligne du fichier déclencheur comme l'enregistrement de données.
• Lorsque vous utilisez un script de commande d'impression pour imprimer une étiquette qui fait une jointure interne sur deux bases de données, où l'une est un fichier texte et l'autre une base de données d'un autre type, et qu'une substitution de base de données est effectuée sur la base texte à l'aide de la commande /D, la commande /R doit être définie sur /R=1 au lieu de /R=3.
• La commande /P indique à BarTender d'imprimer l'élément.
• La commande /DD indique à BarTender de supprimer le fichier déclencheur après l'avoir lu.

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

1. Dans la Console d'administration, cliquez sur le nom de l'intégration Chaque commande pour ouvrir une vue détaillée de l'intégration.
2. Lorsque vous exécutez le scénario d'exemple à l'étape suivante, vous pouvez observer les étapes de traitement de l'intégration dans la section Sortie de cette vue.
2. À l'aide de l'Explorateur Windows, copiez le fichier texte invoice1.dat dans le dossier \\InvoiceServer\NewInvoice.
3. L'intégration démarre presque immédiatement, détectant le fichier invoice1.dat, puis le renomme en invoice1.txt.
4. BarTender se lance en arrière-plan (vous ne le verrez même pas s'ouvrir) et envoie le fichier .txt à la ligne de commande contenue dans le fichier déclencheur, en insérant invoice1.txt pour la variable %Trigger File Name%
5. BarTender ouvre alors HardwareInvoice.btw, lit les données de invoice1.txt, imprime l'élément et supprime invoice1.txt.
3. À l'aide de l'Explorateur Windows, copiez le fichier texte invoice2.dat dans le dossier \\InvoiceServer\NewInvoice.
4. L'intégration démarre presque immédiatement, détectant le fichier invoice2.dat, puis le renomme en invoice2.txt.
5. BarTender s'ouvre et envoie le fichier .txt à la ligne de commande contenue dans le fichier déclencheur, en insérant invoice2.txt pour la variable %Trigger File Name%
6. BarTender ouvre alors SoftwareInvoice.btw, lit les données de invoice2.txt, imprime l'élément et supprime invoice2.txt.