Présentation

Le but de cet exemple est de créer une intégration qui imprime un document BarTender spécifié après avoir détecté un fichier déclencheur vide. Les techniques utilisées ici sont également applicables aux exemples suivants.

Scénario

Une usine de fabrication de pièces doit imprimer un article avec un numéro de série à la fin d'une chaîne d'assemblage. Sur cet article, il n'y a pas d'autre information dynamique ou changeante, à part le code-barres incrémenté. Ce qui génère le fichier déclencheur est un « capteur de présence laser » placé vers la fin de la chaîne d'assemblage, qui détecte les pièces et génère un fichier texte vide. Ce fichier texte est déposé dans un dossier spécifique surveillé par le service d'intégration. Lorsqu'il est détecté, le service d'intégration supprime le fichier vide et imprime le document spécifié.

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.

Configurer le fichier déclencheur vide

1. Créez le dossier réseau où le fichier vide sera enregistré. C'est ce dossier que le service d'intégration surveillera. Dans cet exemple, il sera appelé \\AssemblyLine\NextPart.
2. Dans un autre répertoire, créez un fichier texte vierge nommé "part.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. Un nouveau document s'affiche 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 souhaitée, puis cliquez sur Fermer pour quitter la boîte de dialogue Imprimer.
6. 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.
7. Une fois la configuration terminée, cliquez sur OK pour fermer la boîte de dialogue Mise en page.
8. Dans le menu Créer, sélectionnez Code-barres.
9. Dans la boîte de dialogue Sélectionner un code-barres, choisissez un type de code-barres et cliquez dessus. Cliquez sur le bouton Sélectionner pour fermer la boîte de dialogue.
10. Cliquez n'importe où sur le modèle pour ajouter l'objet code-barres.
11. Double-cliquez sur le code-barres pour ouvrir la boîte de dialogue Propriétés du code-barres.
12. Dans le volet de navigation à gauche, cliquez sur la source de données du code-barres.
13. Cliquez sur l'onglet Transformations.
14. À droite du champ Sérialisation, cliquez sur l'icône  pour ouvrir la boîte de dialogue Sérialisation.
15. Dans l'onglet Sérialisation, sélectionnez Incrémenter.
16. Cliquez sur OK pour fermer la boîte de dialogue Sérialisation.
17. Cliquez sur Fermer pour quitter la boîte de dialogue Propriétés du code-barres.
18. Dans le menu Fichier, sélectionnez Enregistrer sous et enregistrez le document BarTender sous le nom Serialized.btw.
19. Fermez BarTender.

Créer et déployer l'intégration

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 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 pièce".
6. Dans la liste déroulante Démarrer l'intégration, sélectionnez Automatique.
7. Sous Compte utilisateur, choisissez si vous souhaitez hériter des autorisations du service.
8. Notez que par défaut, les actions héritent du compte utilisateur spécifié dans le nœud Intégration, vous n'aurez donc pas besoin de le définir à nouveau dans le nœud Actions.
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 vous souhaitez que le service d'intégration surveille. Dans ce cas, indiquez le dossier \\AssemblyLine\NextPart que vous avez créé dans la section Configurer le fichier déclencheur vide 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. Le fichier n'est plus nécessaire après sa détection.
13. Dans le volet Intégration de fichiers, cliquez sur l'action 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, Serialized.btw. Cliquez sur Ouvrir.
15. Cliquez sur  en haut à gauche d'Integration Builder pour enregistrer le fichier d'intégration sous le nom NewPart.btin.
16. Cliquez sur  Déployer l'intégration pour ouvrir la boîte de dialogue Nouveau déploiement.
17. Saisissez un nom et une description pour le déploiement.
18. Assurez-vous que le paramètre Fichier d'intégration indique bien NewPart.btin. Sinon, cliquez sur Parcourir et sélectionnez NewPart.btin.
19. Pour Serveurs cibles, ajoutez le ou les serveurs sur lesquels vous souhaitez déployer le fichier d'intégration.
20. Pour Planification, sélectionnez Immédiatement.
21. Définissez les paramètres de Gestion des erreurs selon vos besoins.
22. Cliquez sur OK pour fermer la boîte de dialogue et déployer le fichier d'intégration.
23. 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 pièce" pour afficher les détails de l'intégration.
2. Lorsque vous exécutez le scénario à 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 vierge part.txt dans le dossier \\AssemblyLine\NextPart.
3. L'intégration démarre presque immédiatement, supprime le fichier texte vide du dossier NextPart et envoie le document BarTender à l'impression. À chaque exécution du scénario, le code-barres sur le document imprimé est incrémenté de 1.