Appuyer sur le bouton de démarrage ou laisser les intégrations démarrer automatiquement peut sembler anodin, mais c'est une étape clé du cycle d'intégration. Cette étape indique à l'intégration de commencer à surveiller le déclencheur. Si quelque chose ne va pas ou si l'emplacement du déclencheur n'est plus disponible, l'intégration attendra indéfiniment ou pourra rencontrer une erreur.

Chaque type d'intégration aura un nom différent pour cette information dans votre fichier d'intégration et doit être configuré pour fonctionner. Pour tous les types d'intégrations, les paramètres de votre intégration seront la première sous-section de la section Intégration et indiqueront ce qu'elle recherche. Dans cette capture d'écran, il s'agit d'une intégration de fichiers, donc la sous-section s'appelle Détection de fichiers car elle recherche des fichiers pour déclencher l'intégration.

Souvent, les problèmes à cette étape concernent les autorisations, les noms de fichiers et les paramètres de déclenchement. Si vous essayez de démarrer l'intégration dans Integration Builder, une erreur peut apparaître immédiatement pour vous indiquer le problème.

Voici quelques scénarios pour les types d'intégration les plus courants qui peuvent causer des problèmes à cette étape :

Intégrations de fichiers

Pour les intégrations de fichiers, les autorisations et l'emplacement des fichiers sont essentiels.

• L'emplacement du dossier surveillé est-il correctement saisi ?
• Pour les emplacements de stockage cloud, le nom d'utilisateur et le mot de passe sont-ils corrects ? La clé secrète est-elle correcte ?
• L'utilisateur actuel a-t-il la permission d'accéder à ce dossier ? Il est recommandé de ne pas utiliser des emplacements comme Mes documents ou un lecteur réseau mappé, car les autorisations peuvent devenir complexes.
• L'intégration surveille-t-elle le bon dossier où vous déposez les fichiers ?

Si l'intégration ne peut pas accéder au dossier, elle rencontrera probablement une erreur d'autorisation ou d'accès. Il est recommandé que les dossiers surveillés n'utilisent pas de lettre de lecteur virtuel (c'est-à-dire pas un lecteur physique) et ne soient pas dans Mes documents ou sur le bureau.

Il est également conseillé que le dossier surveillé soit hébergé uniquement sur un système Windows. Si vous prévoyez d'utiliser Unix, Linux ou un autre système d'exploitation pour héberger votre dossier surveillé, envisagez d'utiliser un emplacement cloud comme FTP.

Si c'est un dossier réseau, élevez les autorisations de votre intégration pour qu'elle ait le bon accès.

Intégrations de bases de données

L'accès à la base de données est primordial. Vérifiez les points suivants :

• La base de données est-elle en ligne ?
• Le nom d'utilisateur et le mot de passe sont-ils corrects ?

Tous ces paramètres se trouvent dans la boîte de dialogue des paramètres de connexion. Comme pour le dépannage d'une connexion à une base de données sur une étiquette, ouvrir cette boîte via le bouton Configuration de la connexion à la base de données... permettra de vérifier si la connexion fonctionne. Sinon, une erreur s'affichera.

Intégrations socket

La connectivité réseau est très importante. Si vous ne pouvez pas établir de connexion, commencez par vérifier la connexion elle-même.

• Les ports sont-ils ouverts ?
• Un pare-feu ou un antivirus interfère-t-il ?
• Quelque chose d'autre utilise-t-il le même port ?

Les intégrations nécessitent un port libre. Si autre chose utilise le port, l'intégration échouera généralement et indiquera que le port n'est pas disponible. Comme pour les autres intégrations, un message d'erreur vous indiquera souvent le problème et comment le résoudre.

Points clés à retenir

Bien que cette étape puisse différer selon le type d'intégration, il y a quelques points essentiels pour le dépannage de cette étape pour tous les types :

• Les autorisations sont très importantes.
• Assurez-vous toujours que l'intégration a accès au déclencheur.
• Les échecs provoquent souvent une erreur dès le démarrage de l'intégration.

Une fois l'intégration démarrée, il faut attendre l'arrivée du déclencheur. Cela peut sembler être une étape qui ne nécessite aucun dépannage, mais que faire si vous restez bloqué indéfiniment en attente ? Que se passe-t-il si le déclencheur n'arrive jamais ? Si vous êtes bloqué dans un état où "rien ne se passe", diagnostiquer cette étape peut vous aider à comprendre pourquoi.

Tous les types d'intégrations attendent qu'un événement se produise ou qu'une donnée arrive. Il peut s'agir d'un fichier, de données sur un port réseau, d'un enregistrement dans une table ou d'une heure précise. Tous les paramètres de détection du déclencheur sont listés au même endroit que l'étape précédente, dans la première sous-section sous l'en-tête Intégration.

Voici quelques points à vérifier selon les types d'intégration courants :

Intégrations de fichiers

• Le fichier déclencheur est-il bien déposé dans le dossier surveillé indiqué dans l'intégration ?
• Le fichier déclencheur correspond-il au motif de fichier attendu ? Si l'intégration attend un .csv et que vous déposez un .css, le motif ne correspond pas.
• Une autre intégration ne récupère-t-elle pas les fichiers en premier ?

Intégrations de bases de données

• Les données sont-elles insérées dans la bonne table ?
• La méthode de détection des données est-elle correcte ? Si une intégration surveille une valeur incrémentée et que vous mettez à jour un horodatage, les méthodes ne correspondent pas.
• Le champ surveillé est-il bien incrémenté ou l'horodatage mis à jour ?

Intégrations socket et services web

• Les données sont-elles envoyées à la bonne adresse ?
• Un pare-feu bloque-t-il le port ?

Points clés à retenir

• Assurez-vous que le déclencheur arrive bien au bon endroit.
• Vérifiez qu'aucun élément ne bloque ou ne récupère le déclencheur avant sa détection.

Comme pour l'étape précédente, cette étape semble simple. Parfois, une erreur peut apparaître si un problème survient ici, mais d'autres fois, le problème ne sera visible que lorsque le cycle d'intégration se répétera.

Cette action concerne ce que fait l'intégration une fois qu'elle a reçu les données. Seuls deux types d'intégrations utilisent des actions après détection. Tous les autres types peuvent passer cette étape. Voici ce qu'il faut vérifier pour les intégrations courantes qui ont des actions après détection :

Intégrations de fichiers

De tous les types d'intégrations, ce sont celles qui génèrent le plus de messages à cette étape. Si un problème survient lors des actions après détection, l'intégration affichera une erreur et vous indiquera ce qui ne va pas. Les problèmes courants concernent les autorisations pour modifier les fichiers ou dossiers et les chemins de fichiers incorrects.

Les actions après détection pour une intégration de fichiers sont listées ici :

Intégrations socket

À cette étape, les problèmes avec une intégration socket sont moins évidents qu'avec une intégration de fichiers. Si votre intégration socket est peu sollicitée, il se peut que vous n'ayez pas de problème ici, mais si elle est très sollicitée, vous pouvez voir apparaître cette erreur de temps en temps : "Erreur : Impossible d'accéder à un objet supprimé."

Ce qui se passe ici, c'est que le socket ne se ferme pas après avoir reçu les données, donc de nouvelles données arrivent alors qu'il n'est pas prêt. L'intégration n'est pas prête à traiter de nouvelles données, donc elle ne sait pas quoi en faire et les ignore, pensant qu'il s'agit de données inutiles. Le socket laisse passer des données, et des impressions peuvent être perdues.

Si vous remarquez ce comportement, consultez cet article pour savoir comment le corriger : Erreur d'intégration lors de l'exécution d'une intégration socket.

Points clés à retenir

• Cette étape concerne deux types d'intégrations en particulier.
• Les erreurs à cette étape ne sont pas toujours évidentes.

Les actions d'intégration sont toutes les étapes que votre intégration effectue pour traiter et imprimer une étiquette. Toutes les actions sont listées sous l'en-tête d'action :

Cet exemple est assez simple car il ne comprend qu'une action d'impression. Cependant, certaines intégrations peuvent inclure plusieurs étapes comme des boucles, de l'analyse de données, l'envoi de messages ou d'e-mails, ou des instructions conditionnelles. Voici un exemple plus complexe où les données sont extraites d'un déclencheur à l'aide d'une série d'actions nommées Rechercher et Supprimer, puis les données sont utilisées dans une action Imprimer un document :

Cela augmente la complexité de cette étape et multiplie les points où quelque chose peut mal tourner. La meilleure approche est de commencer simplement. Réduisez les actions au strict minimum pour limiter le nombre d'étapes autant que possible (généralement seulement les actions utilisées lors de la création d'une nouvelle intégration depuis le menu Nouveau, plus le minimum nécessaire pour traiter les données) et partez de là.

• Supprimez les étapes superflues. Commencez avec le minimum.
• Ajoutez chaque étape une à une et testez pour vous assurer que le problème ne vient pas de cette action en particulier.

Le plus grand défi ici est de tester cette étape. Si le problème se situe dans une étape ultérieure du cycle d'intégration, il persistera tout au long des tests. Même si c'est le cas, il reste essentiel de tout vérifier à ce stade. Voici des problèmes courants qui peuvent survenir avec les étapes minimales d'une intégration :

Emplacement du document

Pour imprimer une étiquette, l'intégration doit bien sûr pouvoir ouvrir un document. Si l'emplacement ou le nom du document est invalide, l'intégration affichera probablement une erreur de document indiquant qu'il y a eu un problème lors de l'ouverture du document. Vous pouvez trouver le nom du document aux emplacements suivants :

• Action Imprimer un document : dans la section Document de l'onglet Document. Si le document est déterminé par une variable, vérifiez d'où provient cette variable (généralement d'un champ de base de données, d'une action Définir une variable ou d'une des actions de recherche) et assurez-vous que la donnée de cette variable est correcte.
• Action Script de commande d'impression : dans les données du déclencheur, dans le paramètre /AF
• Action Imprimer BTXML : dans les données du déclencheur, dans la balise <Format>

Si aucun document n'est indiqué dans une action Imprimer un document, l'intégration échouera immédiatement au démarrage avec un message d'erreur mentionnant le document manquant.

Nom de l'imprimante

De la même façon qu'il est impossible d'imprimer sans document, vous ne pouvez pas imprimer sans imprimante valide. Dans la plupart des cas, l'intégration affichera une erreur, généralement une erreur d'imprimante invalide ou le code d'erreur Windows 1801 (Windows rencontre un problème avec cette imprimante). Ce dernier cas sort du cadre de ce guide car il nécessite des corrections côté Windows. Le premier peut être vérifié aux emplacements suivants :

• Action Imprimer un document : dans le champ Imprimante de l'onglet Options d'impression
• Action Script de commande d'impression : dans les données du déclencheur, dans le paramètre /P
• Action Imprimer BTXML : dans les données du déclencheur, dans la balise <Printer>

Si aucune imprimante n'est indiquée, l'intégration utilisera l'imprimante enregistrée avec l'étiquette. Si votre intégration ne précise pas d'imprimante, ouvrez l'étiquette dans BarTender Designer et allez dans Fichier > Imprimer. C'est l'imprimante utilisée par votre intégration.

Parfois, une étiquette est envoyée à une imprimante différente de celle attendue ou disparaît tout simplement. Cela est dû au système de redirection d'imprimante qui envoie le travail d'impression à la première imprimante disponible. Si vous constatez ce comportement étrange, veuillez consulter cet article pour résoudre le problème : Les impressions d'intégration sont envoyées à la mauvaise imprimante ou à des imprimantes aléatoires.

Type de base de données ou nom de champ non correspondant

Si votre intégration utilise une base de données et reçoit des données d'une intégration, vous devez vous assurer que le type de base de données correspond. Par exemple, si votre étiquette est connectée à une base de données de type CSV (valeurs séparées par des virgules), mais que votre intégration envoie des données séparées par des tabulations ou un format complètement différent comme XML, cela provoque un décalage entre les types de base de données et le document ne peut pas comprendre les données reçues. Cela peut entraîner diverses erreurs d'intégration, mentionnant des problèmes avec la base de données, les champs ou des données vides.

De plus, même si les types de base de données correspondent, si les noms ou l'ordre des champs diffèrent, cela peut également provoquer des erreurs similaires.

Pour vérifier que les bases de données correspondent bien, vous pouvez faire ce qui suit :

• Ouvrez le fichier d'étiquette dans BarTender Designer. Allez dans Fichier > Configuration de la connexion à la base de données. Dans cette fenêtre, vous pouvez vérifier les noms des champs et le type de base de données connecté à votre étiquette.
• Vous pouvez également trouver le nom de la base de données connectée dans cette fenêtre et l'ouvrir sur votre ordinateur pour vérifier le format (par exemple, CSV ou tabulations) et les noms des champs.
• Comparez la base de données connectée aux données incluses dans le déclencheur.

Si la base de données de votre étiquette n'est pas un fichier texte (ou un fichier Excel dans BarTender 2019 R5 et versions ultérieures), l'intégration échouera toujours avec une erreur de type de base de données. Si votre étiquette est connectée à une base de données non prise en charge, vous devez changer la connexion pour une base compatible et reconfigurer vos objets sur l'étiquette pour pointer vers le nouveau champ.

L'étiquette n'affiche que les données par défaut

Cela se produit parce que l'intégration ne transmet pas les données à l'étiquette lors de l'impression. La cause est probablement que l'intégration n'a pas été configurée pour le faire (comportement par défaut) et cela ne se produit que dans une action Imprimer un document. Voici les deux scénarios concernés et comment les corriger :

• Transmission des informations de la base de données : L'intégration doit être configurée pour remplacer les informations. Cela se trouve dans la section Remplacements de base de données de l'action Imprimer un document, dans l'onglet Options d'impression. Vous devez remplacer la base de données par Données d'intégration ou EventData pour transmettre les données du déclencheur à l'étiquette.
• Sources de données nommées non définies : Les intégrations doivent savoir comment associer les variables aux sources de données nommées sur l'étiquette. Si vous constatez qu'il manque des sources de données nommées sous le même nom dans l'onglet Sources de données nommées, cliquez sur le bouton Importer les paramètres du document dans l'onglet Documents puis associez les sources de données importées aux variables de l'intégration.

Points clés à retenir

• Pour diagnostiquer au mieux cette étape, réduisez le nombre d'actions au strict minimum puis ajoutez-les une à une pour voir où se situe le problème.
• Les données sont souvent la source du problème à cette étape. Les corriger ici évite des soucis dans les étapes suivantes.

La partie impression du cycle d'intégration repose sur une version formatée de XML appelée BTXML. Elle contient les informations du document et de l'imprimante ainsi que toutes les données du fichier déclencheur que vous avez choisi de transmettre à l'étiquette.

Bien que vous puissiez créer votre propre BTXML et l'envoyer via une intégration en utilisant l'action Imprimer BTXML, ce n'est pas nécessaire ! L'intégration convertit automatiquement vos données et paramètres de l'action d'impression en BTXML.

Si vous avez suivi tous les conseils de dépannage des étapes précédentes, le BTXML sera correctement converti et vous pouvez passer à l'étape suivante.

L'étape finale du cycle d'intégration, avant qu'il ne recommence, est l'impression proprement dite. Tout cela est géré automatiquement par le service Print Scheduler et suit un déroulement simple. Voici un extrait du schéma en haut de cet article :

Une fois que le script BTXML est envoyé au Print Scheduler depuis l'étape précédente du cycle, cette étape démarre immédiatement. Le service se charge d'ouvrir le moteur d'impression puis d'interpréter quel fichier d'étiquette doit être ouvert (s'il n'est pas déjà ouvert dans un moteur). Une fois le document ouvert, les données sont placées aux bons endroits sur l'étiquette si elles sont envoyées par l'intégration, soit via un remplacement de base de données, soit via des sources de données nommées. Après le traitement des données, l'étiquette est envoyée à l'imprimante indiquée dans le BTXML ou liée à l'étiquette si aucune n'est précisée.

Tout cela étant fait automatiquement par un service, que se passe-t-il si quelque chose ne fonctionne pas ? Comment diagnostiquer le problème ? Comme la plupart du travail a été fait dans les étapes précédentes, le dépannage de cette étape est plus simple qu'il n'y paraît.

Comme mentionné dans l'introduction de ce guide, les moteurs d'impression utilisés par le service Print Scheduler sont en réalité BarTender Designer fonctionnant en tant que service. Cela signifie que vous pouvez diagnostiquer cette étape en utilisant Designer lui-même. 

Dépannage de base

Au moment de l'impression, un moteur d'impression imprime automatiquement un fichier d'étiquette selon les instructions du script BTXML. Si vous deviez imiter ce script, vous ouvririez une étiquette, iriez dans Fichier > Imprimer, changeriez le nom de l'imprimante, puis imprimeriez le document. Il existe quelques étapes supplémentaires qu'un script BTXML peut effectuer, mais cette action simple peut déjà révéler beaucoup de choses sur ce qui se passe dans un moteur d'impression invisible.

Ouverture et impression du document

Le comportement le plus basique d'un moteur d'impression est d'ouvrir et d'imprimer les documents. Alors que les étapes précédentes vérifiaient que le document était au bon endroit, l'ouverture du document permet de s'assurer que le moteur d'impression peut bien l'utiliser lors de l'impression.

• Essayez d'ouvrir le document. S'ouvre-t-il correctement ou voyez-vous des erreurs ou des messages apparaître ?
• Si vous essayez d'imprimer le document, l'impression se lance-t-elle ou des erreurs ou avertissements apparaissent-ils ?

Si l'une ou l'autre de ces actions fait apparaître une boîte de dialogue d'avertissement ou d'erreur, cela peut interférer avec le processus d'impression automatique. La section suivante peut vous aider à gérer ces boîtes de dialogue.

Boîtes de dialogue d'erreurs et d'avertissements

Bien qu'un moteur d'impression puisse ignorer la plupart des boîtes de dialogue, certaines peuvent faire échouer ou annuler l'impression. Parfois, un moteur d'impression ne communique pas correctement ces informations dans les journaux d'intégration, donc vérifier et surveiller ces boîtes de dialogue peut aider à trouver le problème.

Voici quelques exemples de boîtes de dialogue qui peuvent être ignorées mais qui pourraient tout de même causer des problèmes d'intégration :

• Boîte de dialogue d'ajustement de page : Lorsqu'une imprimante utilise un support légèrement différent, BarTender ajuste automatiquement l'étiquette. Si l'étiquette semble étrange, il peut s'agir d'une différence de support. Ajustez l'étiquette et enregistrez-la avec l'imprimante de l'intégration pour éviter que cette boîte de dialogue n'apparaisse.
• Avertissement de rognage : Dans les premières versions de BarTender 2019, cet avertissement était une erreur qui arrêtait l'impression. Si l'impression s'arrête ici, veuillez mettre à jour votre logiciel.
• Message de substitution de police TrueType : ce message peut être désactivé dans la boîte de dialogue d'impression. Il ne pouvait pas être ignoré, il est donc recommandé de désactiver cette boîte de dialogue.

Voici quelques boîtes de dialogue qui peuvent faire échouer ou arrêter l'impression. Elles peuvent aussi apparaître dans les messages d'intégration :

• Erreur dans la boîte de dialogue de taille de page : Ce message peut apparaître alors que l'intégration peut automatiquement redimensionner un document si le modèle est défini sur une taille statique ou si la taille dépasse les spécifications du fabricant de votre imprimante. Si cela se produit, ouvrez la boîte de dialogue de page via Fichier > Mise en page et vérifiez les détails et paramètres de l'onglet Page. Vérifiez également qu'il n'y a pas trop de colonnes ou de lignes dans l'onglet Disposition.
• Erreurs de connexion à la base de données : Elles peuvent survenir si un fichier de base de données a été déplacé ou n'est plus disponible. Rétablissez le lien via Fichier > Configuration de la connexion à la base de données puis enregistrez le document.
• Le modèle ne référence pas de champs de base de données : Veuillez consulter Erreur 3600 : Le modèle ne référence aucun champ de base de données.
• Images ou objets liés manquants : Cette erreur peut apparaître si des images ou objets liés ont été déplacés ou se trouvent sur un emplacement réseau qui n'est plus disponible. BarTender n'imprimera pas tant que les objets ou images n'auront pas été reliés à nouveau.
• Erreur mentionnant TMP : L'étiquette ou une ressource liée est probablement corrompue. Il est recommandé de restaurer une sauvegarde de l'étiquette ou de la recréer.

Cette liste n'est pas exhaustive, mais elle couvre les problèmes les plus courants que vous pourriez rencontrer lors du dépannage.

Points clés à retenir

• Cette étape automatisée peut être vérifiée à l'aide de BarTender Designer.
• Les boîtes de dialogue peuvent souvent indiquer la source du problème.

Parfois, le problème ne peut pas être identifié directement dans le cycle d'intégration. Voici quelques ressources supplémentaires qui pourraient vous aider dans des situations diverses non mentionnées dans l'article ci-dessus.

Général

L'intégration s'arrête soudainement

Les intégrations peuvent s'arrêter pour de nombreuses raisons, dont plusieurs sont abordées dans l'article ci-dessus. La raison la plus courante non mentionnée est que la ressource devient soudainement indisponible. Cela arrive surtout avec les intégrations de bases de données et les intégrations de fichiers utilisant des emplacements de stockage cloud. BarTender 2021 tentera de redémarrer l'intégration lorsque la ressource redevient disponible, mais les versions antérieures arrêtaient simplement l'intégration.

Si votre intégration s'arrête soudainement, consultez les journaux pour trouver la dernière erreur et en déterminer la cause.

Intégrations de fichiers

L'intégration fonctionne lentement

De nombreux facteurs peuvent ralentir une intégration de fichiers, mais ce type d'intégration est particulièrement sensible à certains d'entre eux. La taille du dossier de surveillance est importante. Comme une intégration de fichiers repose sur la surveillance de ce dossier pour détecter de nouveaux fichiers, si le nombre de fichiers devient très élevé, la recherche prend de plus en plus de temps à mesure que d'autres fichiers y sont ajoutés.

Si votre intégration n'est pas configurée pour supprimer ou déplacer un fichier déclencheur une fois le traitement terminé, ces fichiers déclencheurs vont s'accumuler avec le temps. Si vous remarquez un ralentissement, supprimez les fichiers déclencheurs déjà traités du dossier de surveillance pour voir si cela améliore la vitesse.

Intégrations de bases de données

Doublons ou impressions multiples

Si une intégration de base de données analyse une table et que l'étiquette est également connectée à cette même table, vous risquez d'obtenir des étiquettes en double. Veuillez consulter ces articles pour savoir comment corriger cette situation et comment configurer correctement votre intégration de base de données et vos étiquettes :

• Impression de multiples quantités d'enregistrements sélectionnés à partir d'une intégration de base de données 
• Imprimer un document à l'aide de déclencheurs de base de données (Vidéo - 7:27) 

L'intégration met du temps à récupérer les enregistrements

Les intégrations peuvent être lentes pour de nombreuses raisons, mais il existe une situation particulière pour les intégrations de bases de données. Une intégration de base de données analyse toute une table pour vérifier la présence de nouveaux enregistrements correspondant à ce qui est spécifié dans la section de déclenchement. Si la table devient très volumineuse, ce processus ralentit à mesure que de nouveaux enregistrements sont ajoutés, ce qui surcharge le serveur de base de données à chaque requête.

Il est recommandé de nettoyer régulièrement les enregistrements inutilisés dans la base de données ou de configurer l'intégration pour supprimer les enregistrements après traitement afin de réduire la charge sur la base de données et l'intégration.

Intégrations socket

Erreur « Impossible d'accéder à l'objet supprimé »

Si vous remarquez que votre intégration saute des étiquettes, vous pouvez trouver une erreur « Impossible d'accéder à l'objet supprimé » dans les journaux. Cela signifie que le socket ne se ferme pas correctement entre les tâches. Pour résoudre ce problème, veuillez consulter Erreur d'intégration lors de l'exécution d'une intégration socket.