Présentation

Le but de cet exemple est d'utiliser une intégration de service Web pour imprimer un document BarTender. Un service Web est un système logiciel conçu pour permettre l'interaction entre machines via un réseau. Toute application capable d'envoyer une requête à un service Web peut déclencher l'intégration.

Dans cet exemple, un service Web envoie une requête GET au service d'intégration BarTender via une intégration de service Web. Le service Web transmettra des valeurs que l'intégration utilisera pour les sources de données nommées dans le document BarTender.

Scénario

Une entreprise disposant d'un système ERP externe doit remplir un champ texte et une valeur de code-barres sur un document BarTender à l'aide d'une requête Web. Pour cela, les données de la requête Web seront transmises à une intégration, qui les transmettra ensuite aux sources de données nommées du document BarTender spécifié. Les sources de données nommées alimentent alors l'objet texte et l'objet code-barres du document au moment de l'impression.

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.

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 Nouveau Document. Un nouveau document apparaît dans BarTender.
4. Dans le menu Fichier, sélectionnez Imprimer pour ouvrir la boîte de dialogue Imprimer.
5. Dans la liste déroulante Nom, sélectionnez l'imprimante que vous souhaitez utiliser.
6. Cliquez sur Fermer pour fermer la boîte de dialogue Imprimer.
7. Dans le menu Fichier, sélectionnez Mise en page pour ouvrir la boîte de dialogue Mise en page et configurez votre page selon vos besoins.
8. Une fois la configuration terminée, cliquez sur OK pour fermer la boîte de dialogue Mise en page.
9. Dans le menu Créer, sélectionnez Texte, puis Ligne unique.
10. Cliquez sur le modèle pour placer l'objet texte.
11. Dans le menu Créer, sélectionnez Code-barres, puis Code 128.
12. Cliquez sur le modèle pour placer l'objet code-barres.
13. Double-cliquez sur la bordure autour de l'objet texte pour ouvrir la boîte de dialogue Propriétés du texte.
14. Dans l'onglet Source de données, à droite du champ Nom, cliquez sur pour ouvrir l'Assistant Changer le nom de la source de données.
15. Dans le champ Nom, saisissez "Company" (sans les guillemets).
16. Cliquez sur OK pour fermer l'Assistant Changer le nom de la source de données.
17. Laissez le Type sur Données intégrées.
18. Dans le champ Données intégrées, saisissez le nom de votre entreprise.
19. Cliquez sur Fermer pour fermer la boîte de dialogue Propriétés du texte.
20. Double-cliquez sur l'objet code-barres pour ouvrir la boîte de dialogue Propriétés du code-barres.
21. Dans l'onglet Source de données, à droite du champ Nom, cliquez sur pour ouvrir l'Assistant Changer le nom de la source de données.
22. Sélectionnez Nommer la source de données.
23. Dans le champ Nom, saisissez "IDNumber" (sans les guillemets).
24. Cliquez sur OK pour fermer l'Assistant Changer le nom de la source de données.
25. Laissez le Type sur Données intégrées.
26. Dans le champ Données intégrées, saisissez n'importe quel nombre à 4 chiffres.
27. Cliquez sur Fermer pour fermer la boîte de dialogue Propriétés du code-barres.
28. Enregistrez le fichier sous GETSampleDocument.btw.
29. Fermez BarTender.

Créer 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 Service Web puis sur OK.
4. Dans le panneau Intégration de service Web, assurez-vous que Service est sélectionné.
5. Dans le panneau Intégration de service Web, sélectionnez Intégration.
6. Dans le panneau Propriétés, nommez votre intégration et saisissez une description si vous le souhaitez.
7. Dans la liste déroulante Démarrer l'intégration, sélectionnez Automatique.
8. Dans le panneau Intégration de service Web, sélectionnez Réponse.
9. Dans le panneau Propriétés sous Réponse, sélectionnez application/json dans la liste déroulante Type de contenu.
10. Dans la liste déroulante Source, sélectionnez Résumé de l'action, afin de recevoir un résumé après l'exécution de votre intégration.
8. Dans le panneau Intégration de service Web, sélectionnez Variables.
8. Faites défiler jusqu'en bas du panneau Propriétés et cliquez sur Dans le champ Nom, saisissez "Company" (sans les guillemets).
8. Cliquez sur pour créer une nouvelle variable. Dans le champ Nom, saisissez "IDNumber" (sans les guillemets).
11. Dans le panneau Intégration de service Web sous Actions, sélectionnez Imprimer le document.
12. Dans le panneau Propriétés sous Document, saisissez le chemin et le nom du fichier du document BarTender créé précédemment, GETSampleDocument.btw.
12. Cliquez sur pour ajouter les Sources de données nommées et les Remplacements d'options d'impression à l'intégration.
13. Faites défiler jusqu'à Sources de données nommées. Si ce n'est pas déjà activé, cochez Spécifier les valeurs pour les sources de données nommées.
14. Dans la liste Sources de données nommées, supprimez la valeur actuelle pour la source de données nommée Company.
15. À droite de la colonne Valeur, cliquez sur et sélectionnez Variables.
16. Dans la boîte de dialogue Insérer une variable, sélectionnez Company et cliquez sur OK. Cela définira la valeur de la source de données nommée Company sur %Company%.
17. Dans la liste Sources de données nommées, supprimez la valeur actuelle pour la source de données nommée IDNumber.
18. À droite de la colonne Valeur, cliquez sur et sélectionnez Plus de variables.
19. Dans la boîte de dialogue Insérer une variable, sélectionnez IDNumber et cliquez sur OK. Cela définira la valeur de la source de données nommée IDNumber sur %IDNumber%.
20. Cliquez sur en haut à gauche d'Integration Builder pour enregistrer le fichier d'intégration sous WebRequestPrint.btin.

L'intégration est maintenant prête à être déployée.

Déployer l'intégration

1. Dans la barre d'outils d'Integration Builder, cliquez sur Déployer l'intégration pour ouvrir la boîte de dialogue Nouveau déploiement.
2. Dans la boîte de dialogue Nouveau déploiement, saisissez un nom et une description pour votre déploiement.
3. Assurez-vous que le paramètre Fichier d'intégration affiche bien WebRequestPrint.btin. Sinon, cliquez sur Parcourir puis recherchez et sélectionnez WebRequestPrint.btin.
4. Pour Serveurs cibles, ajoutez le ou les serveurs sur lesquels vous souhaitez déployer le fichier d'intégration.
5. Spécifiez 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.

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

1. Le service d'intégration BarTender surveille le service Web sélectionné. Envoyez la requête Web via l'URL en utilisant la méthode de votre choix. L'URL ressemblera à ceci : http://<host>/Integration/WebRequestPrint/Execute.

2. Le service d'intégration lit la requête Web et transmet les valeurs à BarTender.
3. Les sources de données nommées du document BarTender sont maintenant alimentées par les valeurs de la requête Web.
4. Le document BarTender s'imprime.