Présentation

Le connecteur d'impression BarTender pour Dynamics 365 Business Central est un plug-in pour Business Central
qui offre une solution dédiée et configurable par l'utilisateur pour intégrer directement le moteur d'impression
de renommée mondiale BarTender dans Business Central.

Ce guide vous expliquera comment installer le connecteur d'impression BarTender pour Dynamics 365 Business Central, le connecter à BarTender Cloud et configurer tous les paramètres nécessaires pour être prêt à imprimer.

S'applique à

BarTender Cloud

Microsoft Dynamics 365 Business Central

Informations

Pour utiliser le connecteur d'impression BarTender pour Dynamics 365 Business Central, vous devez utiliser les applications suivantes :

• BarTender Cloud avec l'abonnement Automation
• Dynamics 365 Business Central Cloud

Installation du plug-in

Pour installer le connecteur d'impression BarTender pour Dynamics 365 Business Central, utilisez l'une des méthodes suivantes :

• Dans le Microsoft AppSource store, recherchez BarTender, puis cliquez pour télécharger et
  installer le plug-in.
• Dans Business Central, saisissez BarTender dans la barre de recherche, cliquez sur BarTender Connector sous
  Obtenir depuis Microsoft AppSource, puis cliquez pour télécharger et installer le plug-in.

Préparation de BarTender Cloud

Avant de connecter le connecteur d'impression BarTender, vous devez effectuer quelques étapes dans BarTender Cloud :

• Créez un compte BarTender Cloud à utiliser avec le connecteur d'impression BarTender. Il ne doit pas s'agir d'un compte utilisateur existant, mais d'un compte créé spécifiquement à cet effet.
• Configurez le compte que vous avez créé pour un accès par mot de passe et enregistrez le connecteur d'impression BarTender auprès de BarTender Cloud. Cela permettra à Business Central d'accéder à votre espace locataire BarTender Cloud. Consultez Authentification REST API BarTender Cloud avec OAuth basé sur mot de passe pour les instructions.

Connexion à BarTender Cloud

Pour connecter Business Central à BarTender Cloud et synchroniser les bibliothèques de données, suivez ces étapes :

1. Dans Business Central, cliquez sur l'icône de recherche en haut à droite, puis saisissez BarTender dans
   la barre de recherche.
2. Sous Accéder aux pages et tâches, cliquez sur Configuration BarTender.
3. Sur la page de configuration BarTender, configurez les paramètres suivants :
   • URL racine : Saisissez l'URL de base de votre locataire BarTender Cloud si elle n'est pas déjà
     spécifiée. Vous pouvez obtenir l'URL en vous connectant à BarTender Cloud et en la copiant depuis la barre d'adresse de votre navigateur. L'URL de base aura cette forme :
     

      https://YourOrganizationDomainID.Datacenter.bartendercloud.com

      Si vous avez besoin d'aide pour trouver votre Organization Domain ID ou votre datacenter, consultez la section Premiers pas dans Comment gérer votre organisation dans BarTender Cloud.
   • ID d'application et Secret client : Saisissez votre ID d'application BarTender Cloud et votre secret client dans les champs correspondants. Vous pouvez les trouver dans Gérer le compte Cloud > API BarTender Cloud en cliquant sur l'icône de points de suspension verticale à droite du connecteur d'impression BarTender enregistré et en sélectionnant Afficher l'ID & le secret.
   • Nom d'utilisateur : Saisissez votre nom d'utilisateur BarTender Cloud.
   • Mot de passe : Saisissez votre mot de passe BarTender Cloud.
   • Délai d'impression : Facultatif, configurez le nombre de secondes à attendre
     avant qu'une tâche d'impression BarTender n'expire. Par exemple, vous pouvez allonger le
     délai si certaines impressions prennent plus de temps que prévu
     pour se terminer.
4. Cliquez sur Tester la connexion pour vérifier que les informations de connexion sont correctes. Si vous rencontrez des difficultés pour vous connecter à BarTender Cloud, consultez cet article.
5. Cliquez sur Synchroniser les bibliothèques pour synchroniser vos imprimantes, modèles d'étiquettes et champs de données de modèles BarTender Cloud avec Business Central. Toutes les étiquettes que vous souhaitez utiliser doivent déjà être présentes et configurées dans BarTender Cloud pour pouvoir être importées par Business Central. Consultez Créer un document BarTender avec l'assistant de modèle dans BarTender Cloud pour plus de détails.
6. Cliquez sur le bouton Retour pour quitter la page de configuration BarTender.

Résolution des problèmes de configuration de BarTender

Si vous recevez une erreur lors de la configuration de BarTender ou si le champ Secret client est manquant, il se peut que vous deviez mettre à jour l'application connecteur d'impression BarTender pour Dynamics 365 Business Central.

1. Commencez par cliquer sur l'icône Paramètres en haut à droite de Dynamics 365 et sélectionnez Centre d'administration.

2. Cliquez sur l'environnement que vous souhaitez mettre à jour.

3. Cliquez sur Applications en haut de l'écran.

4. Sélectionnez Installer la mise à jour à droite de l'entrée du connecteur d'impression BarTender.

Vous devrez peut-être redémarrer Dynamics 365 une fois la mise à jour terminée.

Configuration des correspondances de modèles

Avant de pouvoir imprimer sur BarTender Cloud depuis Business Central, vous devez configurer les correspondances de modèles
pour lier les tables sources et les champs de base de données de Business Central aux champs cibles de votre
modèle d'étiquette BarTender.

Pour cela, suivez ces étapes :

1. Dans Business Central, cliquez sur l'icône de recherche en haut à droite, puis saisissez BarTender dans
   la barre de recherche.
2. Sous Accéder aux pages et tâches, cliquez sur Correspondances de modèles BarTender.
3. Cliquez sur Nouveau.
4. Dans la section Général, configurez les paramètres suivants :
   • ID de la table source : Utilisez le menu déroulant pour sélectionner l'ID de la table Business Central souhaitée. Votre sélection s'affichera dans le champ Nom de la table source.
   • Nom du modèle : Sélectionnez le nom du modèle de document BarTender souhaité.
   • Imprimante : Sélectionnez l'imprimante à laquelle vous souhaitez envoyer la tâche d'impression. Si vous sélectionnez PDF,
     vous devez configurer les paramètres supplémentaires suivants :
     
     • Nom du fichier PDF : Saisissez un nom pour le fichier PDF enregistré.
   • Description : Saisissez une description pour la correspondance. Notez que cette description sera affichée aux utilisateurs lors de l'impression.

Il existe des options supplémentaires que vous pouvez activer dans la section Paramètres de l'imprimante, toutes deux explicites :

• Fermer le document après impression
• Enregistrer après impression

Correspondance des champs

1. Dans la section Correspondance des champs de la page de correspondance de modèle BarTender, associez les champs de la
   table source sélectionnée aux champs du modèle BarTender en configurant les paramètres suivants :
   • N° du champ source : Saisissez l'ID du champ source à associer. Pour cela, cliquez sur les points de suspension
     pour afficher la page de recherche de champs, puis sélectionnez le champ souhaité.
   • Nom du champ cible : Sélectionnez le nom du champ cible à associer.

Pour ajouter d'autres correspondances, cliquez sur la ligne suivante et répétez cette étape pour configurer d'autres champs source
et cible.

2. Cliquez sur le bouton Retour pour fermer la page de correspondance de modèle BarTender. Votre modèle sera désormais inclus dans la liste des étiquettes prêtes à imprimer.

Ressources supplémentaires

Impression avec le connecteur d'impression BarTender pour Dynamics 365 Business Central