Cegid XRP Ultimate | I3 Actualisé le 06/10/2022 |
|||
| Fondations | |||
| Module Editions : Installation et lancement de l'outil | |||
| Installation de l'outil |
| L'installation du Module Editions se fait en deux phases : |
| Installation partie web |
| Pour que l'outil puisse communiquer avec la base de données Cegid XRP Ultimate, sur le serveur web, il faut configurer une nouvelle servlet. Il conviendra donc de s'assurer que le fichier $QUALIACWEB_HOME/WEB-INF/web.xml comporte bien la déclaration de la servlet QJDBC. La déclaration de la servlet dans le fichier web.xml est faite de la manière suivante : <servlet> <servlet-name>QJDBC</servlet-name> <servlet-class> com.qualiac.utj.jdbc.driver.qhttp.SrvFacade </servlet-class> </servlet> <servlet-mapping> <servlet-name>QJDBC</servlet-name> <url-pattern>/QJDBC/*</url-pattern> </servlet-mapping> Pour tester le bon fonctionnement de la servlet, il faut : - Récupérer l'URL d'accès à Cegid XRP Ultimate RIA ; - Remplacer dans celle-ci la chaîne commençant à partir du terme "ria" inclus par "QJDBC" ; Exemple : - URL d'accès à Cegid XRP Ultimate RIA : http://serveur/contexte/ria/Qualiac.html ; - URL d'accès à la servlet QJDBC : http://serveur/contexte/QJDBC. La page affichée par cette nouvelle URL doit afficher l'ensemble des informations relatives à la servlet. |
| Installation partie cliente |
| Première installation : Pour installer l'outil, il suffit de récupérer l'archive d'installation et de la décompresser dans le répertoire souhaité (local ou centralisé). La page de téléchargement est construite de la manière suivante : - Récupérer l'URL de connexion au RIA. Exemple : http://serveur/environnement/ria/Qualiac.html - Remplacer dans celle-ci la chaîne commençant à partir du terme "/ria" inclus par "/tools/qed/index.html". Exemple : http://serveur/environnement/tools/qed/index.html Il est possible de récupérer ce lien, par l'intermédiaire de la nouvelle page permettant de lancer le Module Editions, en cliquant sur "Installer Module Editions". Une fois l'archive récupérée, à l'aide d'un outil de décompression, extraire le contenu de l'archive, dans le répertoire souhaité. Les composants sont générés dans un répertoire racine appelé "qualiactools". L'installation d'un environnement java n'est pas nécessaire car le kit d'installation en embarque déjà un. Mises à jour ultérieures : A l'occasion de passage de patch ou d'une nouvelle version et sauf indications contraires, il faudra réitérer cette procédure en décompressant l'archive d'installation, dans le même répertoire. |
| Lancement du Module Editions |
| Via Cegid XRP Ultimate |
| Pour ouvrir le Module Editions depuis l'interface utilisateur RIA, il faut passer par la commande "Gestion de la mise en forme". Une fois le job lancé, la page suivante s'ouvre dans un nouvel onglet. |
| Si le job lancé se termine à l'état T (Terminé), une page s'affiche invitant à faire appel à l'installation locale pour accéder à la mise en forme créée. Si elle n'est pas déjà présente sur le poste utilisateur, cette installation devra alors être effectuée. |
| Via l'exécutable |
| Si on souhaite lancer l'outil, sans passer par l'interface utilisateur RIA, il suffit juste de lancer l'exécutable qedfrontal.exe, pour lancer le Module Editions et qgefrontal.exe, pour le Générateur d'états, présent dans le répertoire d'installation de l'outil. Le lancement du Module Editions, directement via l'exécutable, permet uniquement de modifier une mise en forme qui a été déjà créée. Si on souhaite créer une mise en forme, on est obligé de passer par l'interface utilisateur RIA pour lancer un job. Le job de création de la mise en forme doit se terminer à l'état T (Terminé). |
| Configuration des environnements Cegid XRP Ultimate |
| Si l'outil est lancé depuis Cegid XRP Ultimate RIA, il n'est pas nécessaire de configurer l'outil. Sinon, si on utilise directement l'exécutable, il est obligatoire de paramétrer l'outil pour définir le ou les environnements que l'on souhaite utiliser. Si aucun environnement n'est sauvegardé, à chaque ouverture, l'outil demande de définir un environnement. Pour cela, deux cas sont possible : |
| Connexion HTTP (via la servlet QJDBC) |
| Le Module Editions peut communiquer avec la base via une URL HTTP. Cette URL doit être accessible depuis le poste souhaitant utiliser l'outil. Dans le cas où l'environnement voulu n'est pas disponible, il est possible d'accéder à la configuration de l'outil via le menu "Module Editions" → "Configurer les environnements...". |
| L'écran ci-dessus, liste l'ensemble des environnements sauvegardés pour l'outil. Si aucun environnement n'est défini, l'écran s'affiche directement en mode création. Si on souhaite créer un nouvel environnement, il faut cliquer sur le menu "Environnement" → "Ajouter". Pour créer un nouvel environnement, dans l'onglet "Environnement", il faut saisir : - dans le champ URL : l'URL de Cegid XRP Ultimate RIA. Dans le cas où, plusieurs sources de données sont disponibles, pour une URL, il faut renseigner l'URL de la servlet QJDBC suivi du nom de l'environnement tel qu'il est défini dans Cegid XRP Ultimate RIA (Exemple : http://serveur/contexte/QJDBC/datasource1). - dans le champ nom : le nom que l'on souhaite associer à cet environnement. Ce nom est libre. Dans le cas où l'accès se fait via un proxy, dans l'onglet "Proxy", il faut renseigner : - Nom du proxy ; - Port du proxy ; - Utilisateur du proxy ; - Mot de passe du proxy. Une fois la configuration de l'environnement validée, il est possible de le "Modifier", "Supprimer" ou "Dupliquer" via les menus disponible dans le menu "Environnement". Dès que l'ensemble des environnements sont validés, il est possible de sauvegarder cette liste pour qu'elle soit proposée lors du prochain lancement via le menu "Gestionnaire" → "Sauvegarder". Ces environnements seront mémorisés dans le fichier qualiacurl.properties présent au même niveau que l'exécutable. |
| Connexion JDBC (connexion directe) |
| Dans le cas où la connexion HTTP ne peut pas fonctionner (politique de sécurité trop spécifique), il est possible de se connecter directement à la base via une connexion JDBC. Etant donné que cette nouvelle version de l'outil est sensé fonctionner via une connexion HTTP, il n'y a pas d'écran de configuration des environnements en mode JDBC. Il faut donc créer un fichier qualiacdb.properties au même niveau que l'exécutable. Ce fichier doit avoir la même syntaxe que le fichier qualiacdb.properties du serveur de traitement ou serveur web Cegid XRP Ultimate. Les informations saisies dans ce fichier devront permettre au poste utilisant l'outil d'accéder à la base via un nom de machine (ou adresse IP), port et nom de la base. |
| Ouverture d'une mise en forme |
| Lorsqu'on lance l'outil sans passer par l'interface utilisateur RIA et que l'ensemble des environnements sont correctement configurés, l'écran ci-dessus apparait. La partie "Environnement" permet de sélectionner l'environnement sur lequel on souhaite se connecter. De plus, il faut saisir l'utilisateur et son mot de passe. La connexion ne peut se faire uniquement avec un utilisateur simple. Les connexions utilisant d'autres types de connexion (tel que le LDAP, SSO, ...), ne sont pas gérés actuellement. Il se peut que l'environnement sélectionné ne soit pas utilisable. Dans ce cas, aucun autre champ ne sera accessible. Pour en connaitre la raison, il suffit de cliquer sur le bouton présent à droite de la liste des environnements disponibles. Un ensemble d'informations apparaissent dont un message expliquant pourquoi l'environnement n'est pas utilisable. Dans ce cas, il ne sera pas possible d'ouvrir l'outil (bouton "Ouvrir l'application"). Pour pouvoir lancer le Module Editions, il faut en plus renseigner soit : - Le traitement et l'identifiant de la mise en forme ; - Un numéro de job terminé sans erreur et lancé en mode "élaboration" d'une mise en forme (modification d'une mise en forme). Dans le cas où la mise en forme sélectionnée est une mise en forme virtuelle (GTEMF), un message apparait pour demander si on souhaite ouvrir la mise en forme équivalente. |