Intégrer Nectari dans Sage X3

Intégrez Nectari directement dans Sage X3 (disponible depuis Sage X3 v7) pour offrir aux utilisateurs un accès sans faille aux analyses et aux rapports au sein de leur environnement ERP. L'intégration prend en charge l'authentification unique (SSO) et peut être réalisée de deux manières : de base (intégration d'un widget) ou avancée (filtrage dynamique utilisant les champs de données de Sage X3).

Intégration	Description
De base	Intégrez une URL de Nectari dans Sage X3 en tant que widget. Utilisez l'URL complète de Nectari (voir Identifier l'environnement) dans les widgets Sage X3, comme décrit dans la documentation de Sage.
Avancée	Activez le filtrage des vues Nectari en fonction du champ Sage X3 actif. Cela nécessite l'installation d'un correctif et une configuration supplémentaire de Sage X3.

prérequis

• Une version prise en charge de Sage X3 est installée.
• Un compte actif Nectari.

Étapes principales

Étape	Description
Préparer le serveur Sage X3	Configurez les paramètres du serveur et de sécurité pour permettre l'incrustation et l'intégration sécurisée.
Installer le correctif Sage X3	(avancé seulement) Installez le correctif pour activer le filtrage intégré en utilisant les champs de données de Sage X3.
Identifier l'environnement	Obtenez l'ID d'environnement requis et l'URL de Nectari pour l'intégration à Sage X3.
Définir les paramètres de Nectari dans Sage X3	Configurez Sage X3 avec la bonne URL web et l'ID d'environnement pour Nectari.
Configurer les filtres intégrés	(avancé seulement) Configurez les paramètres pour filtrer les vues Nectari en utilisant les champs de Sage X3.
Ajouter un onglet dans une fenêtre Sage X3	Ajoutez l'écran Nectari en tant que nouvel onglet dans une fenêtre Sage X3, comme les Clients.

important

Lors de l'intégration de contenu, le serveur Nectari et l'ERP Sage X3 doivent tous deux utiliser HTTPS pour se conformer aux politiques de sécurité des navigateurs et garantir le bon fonctionnement de l'incrustation et de la SSO. Voir Gestion des cookies pour plus de détails.

Préparer le serveur Sage X3

Pour Syracuse (à partir de X3U9P4)

1. Ouvrez nodelocal.js dans un éditeur de texte. Le chemin par défaut est : C:\sage\syracuse\syracuse\bin.
2. Après le contenu existant, ajoutez une entrée x3fusion et insérez la configuration de sécurité suivante. Mettez à jour les valeurs "child-src" avec les URLs de Nectari.

   security:{
       "http": {
           // En-têtes HTTP ajoutés
           "headers": {
               "content-security-policy": {
                   "child-src": [
                       "'self'",
                       "https://biprod.yourcompany.com:444",
                       "https://bidev.yourcompany.com:444"
                   ]
               },
           }
       },
       "client": {
       
           "iframe": {
               "sandbox": {
                   // Les vignettes html permettent 3 niveaux de sécurité ('low', 'medium' et 'high') pour le sandboxing des iframes
                   "low": "allow-same-origin allow-forms allow-scripts allow-downloads allow-popups",
                   "medium": "allow-same-origin allow-forms allow-scripts allow-downloads allow-popups",
                   "high": "allow-same-origin allow-forms allow-scripts allow-downloads allow-popups"
               }
           }
       }
   }

3. Enregistrez le fichier et redémarrez le serveur Syracuse si nécessaire.

Pour le serveur Web SAFE X3 (à partir de X3 2021 R2)

Complétez ces étapes en plus de la configuration de Syracuse ci-dessus.

1. Connectez-vous à Sage X3.
2. Dans le menu de navigation, sélectionnez Administration.
3. Sous Paramètres, cliquez sur Politiques d'URL externes.
4. Ajoutez des règles pour correspondre aux sources autorisées que vous avez saisies dans nodelocal.js de Syracuse.

Installer le correctif (avancé seulement)

important

Les étapes suivantes sont à titre de référence uniquement. L'installation du correctif doit être supervisée par un expert Sage X3.

1. Dans Sage X3, ouvrez la navigation et sélectionnez Développement.
2. Sous Utilitaires, cliquez sur Intégration de correctif (PATCH).
3. Choisissez le type de client de destination, en fonction de l'endroit où le fichier de correctif est accessible.
4. Activez l'option Intégration de correctif.
5. Dans la liste Dossier, conservez uniquement les fichiers nécessaires à l'installation du correctif.
6. Cliquez sur Ok, puis sélectionnez les fichiers pth_ZBITG_XXXXXXXX_VX.dat et scr_ZURLMAKER_XXXXXXXX_VX.dat.
7. Cliquez à nouveau sur Ok pour compléter l'installation du correctif.

Identifier l'environnement

1. Connectez-vous à Nectari.
2. Dans le panneau de navigation, sélectionnez le bon environnement.
3. Sélectionnez Modèles de données et Vues, développez un modèle de données et ouvrez une vue.
4. Dans le panneau Barre d'outils à droite, sélectionnez l'icône Partage, puis cliquez sur Voir le lien externe.
5. Dans l'URL du lien externe, localisez la valeur envID et copiez-la pour une utilisation dans les étapes suivantes.

Ajuster les paramètres de Nectari dans Sage X3

1. Dans Sage X3, ouvrez la navigation et sélectionnez Configuration.
2. Sous Paramètres généraux, puis Valeurs des paramètres, cliquez sur SUP.
3. Dans chaque dossier requis, mettez à jour les paramètres suivants (ajoutés par le correctif) :

Paramètre	Description	Valeur
ZBIURLEID	ID d'environnement BI	L'envID copié de Nectari.
ZBIURLSRV	URL Web BI	L'URL principale de Nectari.

Configurer le filtre dans l'écran (avancé seulement)

Le correctif fournit deux écrans pour référence :

• ZBITGEX (écran de filtrage générique)
• ZBITGEXA (filtre le client sur [M:BPC0]BPCNUM)

Paramètre d'action	Description
ZURLDES	Valeur envoyée à ZURLMAKER (laisser inchangée).
ZURLFLD*	Spécifie le champ Nectari utilisé pour le filtrage (Table.field).
ZURLKEY*	Spécifie le champ Sage X3 utilisé comme filtre ([mask]field).
ZURLPID	Spécifie l'ID du modèle de données Nectari.
ZURLVID	Spécifie l'ID de la vue Nectari.

• ZURLPID et ZURLVID sont liés à l'ID d'environnement trouvé dans Identifier l'environnement.
• Vous pouvez récupérer les paramètres PID et VID à partir de l'URL du lien externe de la vue Nectari.

Ajouter un onglet dans une fenêtre Sage X3

important

Les étapes suivantes doivent être effectuées par un expert Sage X3.

1. Dans Sage X3, ouvrez le menu de navigation et sélectionnez Développement.
2. Sous Dictionnaire de scripts, cliquez sur Gestion des fenêtres.
3. Trouvez la fenêtre Clients (OBPC).
4. Dans l'onglet Écran, ajoutez une ligne pour inclure l'écran ZBITGEXA sous l'onglet souhaité.