Cegid XRP Ultimate | I3 Actualisé le 06/10/2022 |
|||
| Décisionnel | |||
| Manuel d'installation du plugin en mode VSTO | |||
| 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 |
| Le processus de l'installation de Excel Addin par VSTO est adapté au poste de travail stand-alone. Il est rapide, plus simple et commun à Office mais seul l'utilisateur qui a installé le plugin Excel Addin sur un poste pourra l'utiliser. |
| 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 accessible depuis le poste. Ce répertoire peut être : * un Map réseau (ou chemin UNC) en mode VSTO sur répertoire réseau accessible depuis plusieurs postes afin de centraliser la version de ce plugin, sous D:\Cegid\Addin par exemple. Ce Map réseau devra être permanent sur chaque poste, une vérification de la version d'Excel Addin est 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. * un répertoire du poste de travail en mode VSTO poste local, sous C:\Cegid\Addin par exemple. Attention, il est important de choisir un répertoire sans distinction de version afin de faciliter une prochaine montée de version. Livraison : Tous les fichiers d'installation sont disponibles sur le serveur Web sous ..\tools\dwh\excel\interface. Le fichier CegidXRPUltimate_ExcelAddin_Vsto_Ixxx.zip le plus récent (suffixe Ixxx le plus élevé) permet d'être utilisé par toutes les versions d'Office. Extraire le contenu de ce fichier sur ce répertoire de déploiement. Remarque : Les fichiers CegidXRPUltimate_ExcelAddin_Vsto_Ixxx.zip disponibles dans le répertoire du serveur Web sont alimentés par le passage de bundle. La version Ixxx est liée à la version d'Excel Addin dans la release suivi du numéro de version à chaque évolution. Par exemple, chez un client en release I2.01, vous trouverez la première évolution de Excel Addin écrite pour la release I2.01 dans le fichier CegidXRPUltimate_ExcelAddin_Vsto_I211.zip. |
| Installation |
| S'assurer qu'Office Excel ne soit pas en cours sur le poste. Lancer l'installation avec 'Cegid XRP Ultimate Excel Addin.vsto' ou le setup.exe depuis le répertoire de déploiement (map réseau ou répertoire du poste) puis suivre les indications. 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. Un message suivant va terminer l'installation :  |
| 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 clé 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 clé 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 clé 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 clé 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. |
| 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. |