Présentation

Dans cet exemple, vous allez concevoir une intégration qui imprime un document BarTender spécifique après avoir détecté un fichier déclencheur, ce fichier contenant lui-même les données qui serviront à remplir les objets du modèle du document. Les techniques utilisées ici s'appliquent également aux exemples suivants.

Scénario

Une société de vente par correspondance doit imprimer un article contenant les données d'une commande à chaque fois qu'une commande est emballée. L'application de gestion des ventes génère un fichier texte délimité par des virgules et l'enregistre dans un dossier surveillé par le service d'intégration. Lorsqu'il détecte le fichier, le service d'intégration supprime le fichier déclencheur, envoie son contenu à BarTender pour remplir les objets du modèle du document, puis imprime le document.

Mise en œuvre

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

Préparer le fichier de données

1. Créez le dossier réseau où les fichiers de données seront enregistrés. C'est ce dossier que le service d'intégration surveillera. Dans cet exemple, il sera nommé \\ShippingServer\NewOrders.
2. Créez un fichier texte contenant les données séparées par des virgules (voir ci-dessous). Vous pouvez copier-coller les données dans le fichier texte.

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

2. Enregistrez le fichier texte dans le dossier créé à l'étape 1, \\ShippingServer\NewOrders, en le nommant "order.txt".

Créer le document BarTender

1. Ouvrez BarTender.
2. Dans le menu Fichier, sélectionnez Nouveau pour ouvrir l'Assistant Nouveau Document.
3. Sélectionnez Modèle vierge, puis cliquez sur Terminer pour fermer l'assistant.
4. Dans le menu Fichier, sélectionnez Imprimer pour ouvrir la boîte de dialogue Imprimer.
5. Dans la liste déroulante Nom, choisissez l'imprimante à utiliser, puis cliquez sur Fermer pour fermer la boîte de dialogue.
6. Dans le menu Fichier, sélectionnez Mise en page pour ouvrir la boîte de dialogue Mise en page et configurez la page selon vos besoins.
7. Une fois la configuration terminée, cliquez sur OK pour fermer la boîte de dialogue Mise en page.
8. Dans le menu Fichier, sélectionnez Configuration de la connexion à la base de données pour ouvrir l'Assistant Configuration de la base de données.
9. Cliquez sur Fichier texte pour spécifier le type de base de données souhaité, puis cliquez sur Suivant.
10. Sur la page Sélectionner le fichier de l'assistant, cliquez sur le bouton Sélectionner le fichier.
11. Accédez à \\ShippingServer\NewOrders et double-cliquez sur order.txt pour le sélectionner.
12. Cliquez sur Suivant sur la page Sélectionner le fichier de l'assistant.
13. Sur la page Format du fichier de l'assistant, vérifiez que Virgule est sélectionné dans la liste déroulante Séparation des champs, puis cliquez sur Suivant.
14. Sur la page Noms des champs de l'assistant, vérifiez que Attribuer automatiquement des noms de champs séquentiels est sélectionné, puis cliquez sur Terminer.
15. Cliquez sur OK pour fermer la boîte de dialogue Configuration de la base de données.
16. Dans le menu Créer, sélectionnez Texte.
17. Dans la liste déroulante Objets texte, sélectionnez Ligne unique.
18. Cliquez n'importe où sur le modèle pour ajouter l'objet texte.
19. Faites un clic droit sur l'objet texte, puis sélectionnez Propriétés dans le menu contextuel pour ouvrir la boîte de dialogue Propriétés du texte.
20. Dans le volet de navigation à gauche, cliquez sur la source de données de l'objet texte.
21. Dans l'onglet Source de données, cliquez sur à droite du champ Type pour ouvrir l'Assistant Changer le type de source de données.
22. Dans la liste déroulante, sélectionnez Champ de base de données, puis cliquez sur Suivant.
23. Dans la liste déroulante Nom du champ, sélectionnez Champ 2 (dans le fichier texte, le deuxième champ contient le nom de l'acheteur).
24. Dans le champ Données d'exemple du champ, saisissez "nom de l'acheteur" comme donnée d'exemple.
25. Cliquez sur Terminer pour fermer l'assistant.
26. Cliquez sur Fermer pour fermer la boîte de dialogue Propriétés du texte.
27. Si vous souhaitez ajouter d'autres champs de la base de données à votre modèle, revenez simplement à l'étape 16 et associez chaque objet texte au champ approprié de la base de données. Sinon, passez à l'étape 28.
28. Dans le menu Fichier, sélectionnez Enregistrer pour sauvegarder le document BarTender sous le nom NewOrderAddress.btw.
29. Déplacez le fichier de base de données d'exemple, order.txt, hors du dossier surveillé par le service d'intégration et placez-le dans un autre dossier.
30. Fermez BarTender.

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

1. Ouvrez 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 volet Intégration de fichiers, sélectionnez Intégration.
5. Dans le volet Propriétés, saisissez le Nom de votre intégration, par exemple "Chaque commande".
6. Dans la liste déroulante 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 volet Intégration de fichiers, sélectionnez Détection de fichiers.
9. Dans le volet Propriétés, sous Options de détection, sélectionnez "Ordinateur/Réseau" dans la liste déroulante Emplacement.
10. Pour l'option Dossier à analyser, saisissez le chemin ou parcourez jusqu'au dossier que le service d'intégration doit surveiller. Dans ce cas, indiquez le dossier \\ShippingServer\NewOrders que vous avez créé dans la section Préparer le fichier de données ci-dessus.
11. Dans le champ Motif de fichier, tapez "*.txt". (N'incluez pas les guillemets.)
12. Faites défiler jusqu'à la section Actions après détection. Dans la liste déroulante Action, sélectionnez Supprimer le fichier. Lorsque le service d'intégration détecte le fichier, il lit automatiquement toutes les données du fichier et les place dans une variable ; une fois détecté, le fichier n'est plus nécessaire.
13. Dans le volet Intégration de fichiers, cliquez sur Imprimer le document. (C'est l'action par défaut.)
14. Dans le volet Propriétés sous Document, cliquez sur le bouton Parcourir pour sélectionner le document BarTender que vous avez créé précédemment, NewOrderAddress.btw. Cliquez sur Ouvrir.
15. Faites défiler jusqu'à Remplacements de base de données. Dans la liste déroulante Source de données, sélectionnez Données d'entrée de l'intégration.
16. Cliquez sur en haut à gauche d'Integration Builder pour enregistrer le fichier d'intégration sous le nom NewOrderAddress.btin.
17. Cliquez sur Déployer l'intégration pour ouvrir la boîte de dialogue Nouveau déploiement.
18. Entrez un nom et une description pour le déploiement.
19. Vérifiez que le paramètre Fichier d'intégration indique bien NewOrderAddress.btin. Sinon, cliquez sur Parcourir et sélectionnez NewOrderAddress.btin.
20. Pour Serveurs cibles, ajoutez le ou les serveurs sur lesquels vous souhaitez déployer le fichier d'intégration.
21. Pour Planification, sélectionnez Immédiatement.
22. Indiquez les paramètres de Gestion des erreurs souhaités.
23. Cliquez sur OK pour fermer la boîte de dialogue et déployer le fichier d'intégration.
24. La Console d'administration s'ouvrira sur le nœud Intégrations, affichant votre intégration.

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 afficher les détails 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.
3. À l'aide de l'Explorateur Windows, copiez le fichier texte order.txt dans le dossier \\ShippingServer\NewOrders.
4. L'intégration démarre presque immédiatement, supprime le fichier texte du dossier NewOrders et envoie le document BarTender à l'impression.