Loftware Integration - Oracle EBS (Auparavant Loftware Oracle Agent) est un composant qui permet de prendre en charge Loftware solutions à intégrer à Oracle® E-Business Suite (EBS) afin que les applications Oracle® Warehouse Management (WMS) puissent recevoir et traiter les demandes d'impression d'étiquettes. Loftware Integration - Oracle EBS peut être mis à jour indépendamment du Loftware solution, garantissant que la solution peut disposer des capacités d'intégration les plus récentes disponibles.
Un administrateur Oracle installe Loftware Integration - Oracle EBS dans la base de données du système Oracle EBS et le configure pour se connecter en toute sécurité à un Loftware solution. Un administrateur du Loftware La solution peut configurer une intégration Oracle à utiliser avec des modèles d'étiquettes sans avoir besoin de saisir les informations d'identification Oracle.
Ce guide vous aide à déployer la configuration de NiceLabel Automation pour la prise en charge du Loftware Integration - Oracle EBS et explique les procédures d’intégration.
Le dernier Loftware Integration - Oracle EBS la version prend en charge nativement NiceLabel.
Comment se procurer le logiciel ?
Si vous êtes un nouveau client et que Loftware Integration - Oracle EBS vous intéresse, ou un client existant de NiceLabel et que vous souhaitez utiliser Loftware Integration - Oracle EBS en conjonction avec NiceLabel, contactez le Service des ventes Loftware.
Le fichier Automation integration .zip contient :
-
Configuration de NiceLabel Automation (fichier
.misx)Note
NiceLabel Automation est une application qui automatise les tâches répétitives.
Plus d’informations sur NiceLabel Automation.
-
Intégration de NiceLabel Automation avec le guide de Loftware Integration - Oracle EBS
Avant de commencer, contrôlez la Configuration système requise.
Loftware Integration - Oracle EBS
Pour une intégration réussie, la configuration requise correspondant à Loftware Integration - Oracle EBS est la suivante :
-
Base de données Oracle 19c
-
Le Loftware Integration - Oracle EBS doit être installé dans votre base de données Oracle EBS. Pour une description du processus d’installation, voire le guide d’utilisation de Loftware Integration - Oracle EBS.
NiceLabel
Pour une intégration réussie, la configuration requise correspondant à NiceLabel est la suivante :
-
Installation de NiceLabel :
-
LMS Enterprise 10.5 ou version ultérieure
-
-
Conditions requises pour NiceLabel Automation :
-
Les pilotes d’imprimante doivent être installés. Vous pouvez installer les pilotes d’imprimante directement sur votre ordinateur ou vous pouvez enregistrer les pilotes depuis le serveur d’impression, si vous en avez un.
Note
Pour optimiser votre expérience d’impression, nous vous conseillons d’installer les pilotes d’imprimante de Loftware.
Pour installer des pilotes d’imprimante Loftware, consultez le Guide d’installation de pilote d’imprimante.
Si vous disposez déjà des pilotes du fabricant de l’imprimante, vous pouvez les remplacer par les pilotes d’imprimante de Loftware pour optimiser votre processus d’impression.
Si vous disposez déjà des pilotes d’imprimante de Loftware, nous vous conseillons de les mettre à jour aux dernières versions. Voir Mise à niveau des pilotes d'imprimante.
-
Le compte utilisateur que le NiceLabel Automation Le service s'exécute à partir duquel vous devez disposer d'une autorisation de lecture sur le ou les dossiers du stockage de documents, où les étiquettes sont stockées.
-
Toutes les imprimantes doivent être visibles pour l’ordinateur et le compte utilisateur sur lequel s’exécute le service Automation. Automation crée des tâches d’impression sur cet ordinateur et les envoie aux imprimantes avec Windows Spooler. Les imprimantes doivent être accessibles pour le compte utilisateur sur lequel le service Automation s’exécute. Veillez à utiliser un compte utilisateur réel quand vous utilisez des imprimantes en réseau (n’utilisez pas un compte de système local).
-
-
Autres éléments de configuration système requis par NiceLabel.
NiceLabel
Votre produit NiceLabel vous permet de créer et de modifier des étiquettes (Desktop Designer) et d’accéder à un stockage de documents avec une gestion des versions, des processus d’approbation, une gestion des utilisateurs et un historique des impressions (Control Center) et il fournit un système d’intégration (Automation).
Votre produit NiceLabel contient :
-
NiceLabel Desktop Designer est une application conçue pour créer et imprimer des étiquettes. Installez Desktop Designersur votre ordinateur et connectez-le au Control Center. Dans Control Center, vous pouvez voir tous les périphériques connectés à votre Desktop Designer.
-
NiceLabel Control Center est une application basée sur le Cloud qui vous permet de partager et de stocker vos fichiers d’étiquettes et étiquettes à imprimer. Control Center se connecte à toutes les imprimantes de tous les utilisateurs dont Desktop Designer est connecté à Control Center.
-
NiceLabel Automation est une application qui automatise les tâches répétitives, comme l’impression automatisée.
Quand NiceLabel Automation reçoit une charge utile de données depuis le Loftware Integration - Oracle EBS, il cherche d’abord la bonne étiquette depuis Documents dans Control Center, remplit les champs dans le modèle avec les données d’entreprise fournies dans la charge utile Oracle, et imprime une étiquette sur l’imprimante d’étiquettes demandée.
NiceLabel Automation expose les API HTTP REST qui sont utilisées par Loftware Integration - Oracle EBS. NiceLabel Automation envoie simultanément la réponse pour chaque appel.
NiceLabel Automation
L’ensemble d’intégration fournit un connecteur (déclencheur) NiceLabel Automation préintégré. Vous déployez la configuration de Automation fournie (fichier .zip) et démarrez le déclencheur. La configuration de NiceLabel Automation contient un déclencheur de Cloud qui fournit le point de terminaison de l’API pour le Loftware Integration - Oracle EBS.
L’action dans un déclencheur repose sur le fichier de commande d’exécution Oracle XML à action intégrée. Cette action peut analyser la charge utile XML provenant du Loftware Integration - Oracle EBS et exécuter les actions d’impression en conséquence.
Toutes les actions précédant celle-ci visent à assurer que les noms d’étiquettes dans le XML comprennent un préfixe d’URL complet pour l’emplacement dans votre page Documents dans Control Center. L’URL est lue depuis le fichier de configuration de NiceLabel et ajoutée dans la charge utile XML.
Une fois que les actions dans le déclencheur sont terminées, une réponse JSON est renvoyée au Loftware Integration - Oracle EBS.
Création d’étiquettes dans Desktop Designer de NiceLabel
Avec Desktop Designer de NiceLabel, vous pouvez créer et modifier des étiquettes et les connecter à des sources de données dynamiques. Voir la section sur la création d’une nouvelle étiquette dans Desktop Designer.
Quand Loftware Integration - Oracle EBS consomme l’API NiceLabel, il fournit à la charge utile JSON les données pour NiceLabel Automation, notamment les paires clé-valeur pour les variables d’étiquettes.
Chaque étiquette, connectée à une source de données dynamiques, contient les variables sous force de sources de données pour les objets d’étiquettes. Ces variables se connectent aux objets d’étiquettes et fournissent les valeurs correspondant à ces objets au moment de l’impression.
Les variables définies dans l’étiquette doivent avoir les mêmes noms que les champs de données dans les applications Oracle. Vous pouvez créer des variables manuellement dans l’étiquette, mais vous pouvez également importer des variables depuis les étiquettes existantes ou les charges utiles Oracle XML.
Noms de référencement d’étiquette
Vous devez stocker vos étiquettes dans les Documents dans votre Control Center. Référencez le nom de vos étiquettes depuis le dossier racine dans Documents.
Par exemple, si vous avez une étiquette label.nlbl stockée dans un dossier appelé Étiquettes , qui se trouve dans le dossier Project1, la forme appropriée du chemin d’accès complet au modèle est /Project1/Labels/label.nlbl.
Si vous ne fournissez pas le nom complet des modèles d'étiquettes dans dans ton Control Center, y compris le chemin d'accès complet au modèle d'étiquette, Automation doit trouver un modèle d'étiquette :
-
le même dossier où MISX est stocké
-
dossier .\Étiquettes
-
dossier ..\Étiquettes
-
dossier d'étiquettes par défaut
Voir Utilisation des dossiers de projet pour gérer les fichiers nécessaires sur l'étiquette ou le formulaire pour plus d'informations.
Déploiement de NiceLabel Automation
Pour déployer la version préconfigurée de Automation, vous devez la charger dans le gestionnaire NiceLabel Automation et démarrer les déclencheurs.
Installation et activation de NiceLabel Automation
NiceLabel Automation fait partie de l’installation d’application de bureau NiceLabel. Le module requis pour exécuter les configurations de Automation est « Automation ».
Pour plus de détails, voir le NiceLabelGuide d'Installation.
Pour activer NiceLabel Automation, voir Licences et activationNiceLabel.
Déploiement de déclencheurs dans Automation
Avant de commencer à déployer les déclencheurs, assurez-vous que NiceLabel Automation est installé sur votre ordinateur et que votre produit NiceLabel est activé.
Pour activer LMS Enterprise, voir Activation de NiceLabel LMS Pro/LMS Enterprise et connexion au Centre de licences.
-
Procédez à l’extraction du fichier
.zipvers un dossier dans Documents dans votre Control Center. -
Exécutez le gestionnaire NiceLabel Automation.
-
Allez dans Déclencheurs, puis cliquez sur le bouton +Ajouter.
-
Dans la fenêtre Ouvrir, trouvez votre fichier
.misxet cliquez sur Ouvrir.Le gestionnaire Automation charge la configuration et présente une liste des déclencheurs dans le volet de droite.
-
Sélectionnez tous les déclencheurs et cliquez sur Démarrer sur l’un quelconque des déclencheurs. Tous les déclencheurs démarrent. Les icônes des déclencheurs deviennent verts et leur état passe à « En cours d’exécution ».
Important
Une fois lancés, les déclencheurs démarrent automatiquement au redémarrage du serveur.
Le point de terminaison d’URL pour les produits NiceLabel sur site est personnalisé (sur votre serveur), mais il vous faut encore une clé d’intégrateur pour authentifier l’appel à l’API.
Note
Ton NiceLabel la clé d'intégrateur peut être créée avant ou après Loftware Integration - Oracle EBS est installé.
Pour générer la clé d’intégrateur :
-
Dans votre navigateur, ouvrez votre instance locale de Control Center. L’URL est adaptée à votre installation, par exemple,
http(s)://<NomDeVotreServeur>/epm.Remplacez <NomDeVotreServeur> par le nom ou l’adresse IP de votre serveur sur lequel vous votre Control Center est installé.
Note
L’utilisation de http ou de https dépend de la capacité de cryptage de votre serveur Web.
-
Aller dans Intégrations > Intégrations dans le Cloud.
-
Cliquer sur Ajouter.
-
Saisissez le nom de l'intégrateur. La clé d’intégrateur est générée automatiquement.
-
Cliquez sur Enregistrer.
Pour utiliser l’API, employez l’URL suivante :
|
API |
URL |
|---|---|
|
Déclencheur de Loftware Integration - Oracle EBS |
http(s)://<NomDeVotreServeur>/epm/api/trigger/Api-OracleEbs |
Chaque requête d’API doit inclure une entête personnalisée avec le nom Integrator-Key. Sa valeur est la clé d’abonnement obtenue dans Authentification pour les API de NiceLabel.
Remplacez <NomDeVotreServeur> par le nom ou l’adresse IP du serveur sur lequel vous votre NiceLabel Control Center est installé.
L’utilisation de http ou de https dépend de la capacité de cryptage de votre serveur Web.