Cegid XRP Ultimate | I3 Actualisé le 06/10/2022 |
|||
| Décisionnel | |||
| Manuel d'installation du plugin en mode MSI | |||
| Présentation |
| Introduction |
| Excel Addin est un plugin qui vient ajouter des fonctionnalités dans Excel, il permet d'utiliser le vocabulaire de l'entreprise pour un accès simplifié et sécurisé aux données du produit Cegid XRP Ultimate. Composant final de la chaîne décisionnelle, le plugin Excel Addin conjugue l'expertise XRP et décisionnelle de Cegid et la puissance d'Excel pour apporter une solution efficace à des utilisateurs affranchis des techniques de bases de données. Excel Addin offre un accès à l'ensemble des données et indicateurs du produit, sous réserve de définition de critères de confidentialité, et permet de les rapatrier sous Excel sous forme de tableaux de bord personnalisés, pour des prises de décision efficaces. Ce module fonctionne à partir de la version Microsoft Office Excel 2013 et Office 365 avec l'interface utilisateur à partir de la release en version H5.01. Il est nécessaire de l'installer sur chaque poste où il sera utilisé. |
| Mode d'installation |
| Il existe plusieurs modes d'installation pour Excel Addin : * Mode VSTO sur un répertoire réseau via un map ou chemin réseau permanent, * Mode VSTO sur le poste local, * Mode MSI pour l'utilisation d'un master et sur les Terminal Server WTS/RDP, multiples connexions utilisateurs. Tous les fichiers nécessaires pour l'installation sont disponibles sur le serveur Web : ..\tools\dwh\excel\interface. Le mode d'installation par VSTO est préconisé pour un poste de travail individuel stand-alone. Il implique que seul l'utilisateur qui a installé le plugin Excel Addin sur un poste pourra l'utiliser, tout autre utilisateur n'aura pas accès à Excel Addin. Ce mode VSTO (outil de Microsoft Visual Studio permettant de créer des addins d'Office et de les déployer facilement via Click Once) est rapide, plus simple et commun à Office : Office 2013, Office 2016, Office 2019 et Office 365. VSTO répertoire réseau L'installation en mode VSTO sur un répertoire réseau accessible depuis tous les postes permet de centraliser la version d'Excel Addin, ainsi, de simplifier les futures montées de version. Un map réseau ou un chemin réseau doit être permanent sur chaque poste de travail, une vérification de la version est ainsi faite à chaque ouverture d'Excel. Si le lien réseau n'existe plus, Excel Addin fonctionne normalement. La montée d'une nouvelle version sera possible dès que le lien sera rétabli. Il est toutefois recommandé d'utiliser au moins un poste non centralisé afin de tester les montées de version d'Excel Addin. VSTO poste local L'installation en mode VSTO sur le poste de travail est semblable à l'installation VSTO sur répertoire réseau sauf pour la copie des fichiers d'installation qui se fait sur le poste de travail directement, sous C:\Cegid\Addin. La montée de version devra se faire sur tous les postes. Le mode d'installation par package Microsoft Installer MSI est préconisé pour un Terminal Server WTS/RDP. Ce mode MSI permet une installation pour tout utilisateur qui se connectera à un poste Excel avec Excel Addin. A chaque ouverture d'Excel, le chargement du plugin est effectué. La montée de version consiste à rejouer l'installation du MSI sous le répertoire C:\Program Files\cegid\Cegid XRP Ultimate Excel Addin. Cette installation MSI est disponible Office 2013, Office 2016, Office 2019 et Office 365 version 2102 sous 32 bits et 64 bits. |
| Procédure d'installation |
| L'installation en mode MSI doit se faire avec un compte Administrateur de la machine. Elle est préconisée pour un Terminal Server WTS/RDP, ainsi, tout utilisateur qui se connectera à ce serveur aura accès au plugin Excel Addin sous Office Excel. Avec ce mode MSI, le chargement du plugin se fera à chaque ouverture d'Excel. Cette installation est liée à un fichier dépendant de la version d'Office : - pour Office sous 32 bits (x86), le fichier sera CegidXRPUltimate_ExcelAddin_2013_Ixxx.zip, - pour Office sous 64 bits (x64), le fichier sera CegidXRPUltimate_ExcelAddin_2013_x64_Ixxx.zip. Ces fichiers correspondent à la version disponible sur votre serveur Web, fichiers livrés via les bundles ou release sous ...\tools\dwh\excel\interface. Des évolutions post-release sont réalisées sur Excel Addin, la version avec suffixe _Ixxx est liée à la version d'Excel Addin dans la release suivi du numéro de version à chaque évolution. La montée de version d'Excel Addin en mode MSI consiste également à relancer ce fichier d'installation. |
| Prérequis |
| Afin de garantir le fonctionnement de ce plugin (interfaçage entre Office et la technologie VSTO de Microsoft), des prérequis sont à vérifier sur le poste utilisateur. Sous Office 365, ces prérequis sont généralement déjà activés. Lors de la phase d'installation, les divers modules manquants pour Office sont affichés en tant qu'anomalie. On retrouve : - Microsoft Visual Studio Tools for Office Runtime (x86) \VSTOR40\vstor40_x86.exe - Module linguistique Microsoft Visual Studio Tools for Office Runtime (x86) \VSTOR40\vstor40_LP_x86_fra.exe |
| Répertoire de déploiement |
| Création d'un répertoire de déploiement pour Excel Addin sur le serveur, sous C:\Cegid\Addin par exemple. Livraison : Tous les fichiers d'installation sont disponibles sur le serveur Web sous ...\tools\dwh\excel\interface. Le fichier CegidXRPUltimate_ExcelAddin_2013_Ixxx.zip le plus récent (suffixe Ixxx le plus élevé) correspondant à votre version Office en 32 ou 64 bits doit être récupéré. Extraire le contenu de ce fichier (CegidXRPUltimate_ExcelAddin_2013_I210.zip par exemple) sur ce répertoire de déploiement. |
| Installation |
| S'assurer qu'Office Excel ne soit pas en cours. Lancer l'installation avec Cegid_XRP_Ultimate_Excel_Addin_2013.msi. Le programme d'installation vérifie la présence des modules annexes en affichant un message invitant l'utilisateur à lancer l'exécutable adéquat.  Installation proposée sous C:\Program Files\cegid\Cegid XRP Ultimate Excel Addin.    |
| Ouverture d'Office Excel |
Une procédure d'activation du plugin s'exécute automatiquement à l'ouverture d'Excel, elle ne sera faite qu'après la première installation et à chaque migration de version. Le bouton Installer permet l'activation du plugin Excel Addin. |
| Ouverture d'Office Excel : Onglet Cegid XRP Ultimate |
| La barre d'outils ou ruban d'Excel doit présenter un nouvel onglet "Cegid XRP Ultimate" comme ci-dessous : Exemple :  Remarque : suite à l'installation du plugin, l'ouverture d'Excel est plus longue car l'option qui indique à Excel de vérifier la présence d'une mise à jour à chaque ouverture est active. |
| Fichier de configuration |
| Ce plugin d'Excel est lié à un fichier externe nommé CegidXRPUltimate_ExcelAddin_Conf.txt contenant les références de connexion telles que l'utilisateur favori et les adresses des WebServices. Ce fichier doit être disponible pour chaque poste utilisant ce plugin. Si ce fichier CegidXRPUltimate_ExcelAddin_Conf.txt est déjà configuré, copier le sous le répertoire de configuration. Sinon, pour une première configuration, se positionner sur l'option Configuration du groupe Connexion. Lors de la première ouverture, des informations standard sont affichées, modifier l'utilisateur puis appuyer sur le bouton Enregistrer. |
| Répertoire de configuration |
| Ce fichier CegidXRPUltimate_ExcelAddin_Conf.txt peut être localisé : - dans un répertoire préalablement défini dans la base de registre, - dans le répertoire 'Documents' du poste. Si la valeur Configuration sous \Poste de travail\HKEY_CURRENT_USER\Software\Cegid\Cegid XRP Ultimate\Excel Addin est renseignée dans la base de registre, la recherche de ce fichier sera faite dans ce répertoire. Si la valeur Configuration sous \Poste de travail\HKEY_LOCAL_MACHINE\Software\Cegid\Cegid XRP Ultimate\Excel Addin est renseignée dans la base de registre, la recherche de ce fichier sera alors faite dans ce répertoire. Pour les postes en 64 bits, ce sera la valeur Configuration sous \Poste de travail\HKEY_LOCAL_MACHINE\Software\Wow6432Node\Cegid\Cegid XRP Ultimate\Excel Addin. Ce répertoire peut être un map réseau (N:\f-decisionnel) ou un chemin UNC avec le format \\serveur\partage\[dossier]. Ne saisir que le nom du répertoire. Attention, ce répertoire doit être accessible depuis le poste. Lors de la création du fichier par `Configuration', `Enregistrer', le fichier de configuration sera créé dans ce répertoire. Si cette valeur Configuration est nulle ou non définie dans la base de registre, la recherche de ce fichier sera faite dans le répertoire 'Documents' de chaque utilisateur. La valeur est ici une nouvelle entrée dans la partie de droite de la base de registre. |
| Configuration des WebServices |
| Ouvrir le fichier de configuration CegidXRPUltimate_ExcelAddin_Conf.txt via un éditeur ou Wordpad. Renseigner les adresses des WebServices en gardant le format : srv1=< Nom logique affiché >=< Adresse URL > avec une URL préalablement testée. Exemple : srv1=Base Production=http://srvaprod.xrpdemo.com/cegid/rest srv2=Base Recette=http://vmqwebserv/xrprec/rest Le compte saisie dans l'indicateur 'user' est proposé lors de la connexion. Pour une installation sur un poste avec multiples utilisateurs, le code utilisé dans l'applicatif XRP Ultimate devra être saisie. Sauvegarder et fermer le fichier de configuration. Remarques : * Vous avez la possibilité de renseigner 20 adresses de WebServices. * Le nom logique affiché à la connexion est le nom défini dans l'URL proposée dans ce fichier de configuration. * Le format de l'URL pour un mode Rest est http://< serveurWeb >[:< port >]/<contexte application du conteneur >/rest * L'astuce pour définir l'URL est liée au lien d'accès à Cegid XRP Ultimate via un navigateur. En mode Rest, ajouter rest après la saisie de votre http://serveur/contexte/. * Le test de connexion peut se faire par le swagger sous un navigateur en rajoutant /swagger/dist. Ainsi, http://serveur/contexte/swagger/dist via l'entrée security permet de vérifier la connexion. * Pour une connexion sécurisée via https, vous devez affecter 'Tls12' à l'indicateur protocolTls : protocolTls=Tls12 * La version pour un Office 365 doit être égal à 2019. |
| Test du plugin |
| Lancer Microsoft Office Excel. Se connecter en utilisant Connexion de l'onglet Cegid XRP Ultimate et en saisissant le code utilisateur et le mot de passe utilisés pour la connexion au produit Cegid XRP Ultimate. Le plugin Excel Addin est désormais configuré pour utiliser les métiers gérés dans Cegid XRP Ultimate Décisionnel en fonction des droits d'accès associés à l'utilisateur. Remarque : * La fermeture d'Excel est indispensable pour que le plugin charge la nouvelle configuration du fichier. * La visualisation des adresses WebServices est possible depuis l'option Configuration, seule la modification du nom est alors possible. |