Comparaison de pages

...

...

...

...

Installation d'Harmony

L'architecture 3 tiers d'Harmony distingue trois composants : le serveur d'applications, le client léger et le serveur de données.

On sera donc amené à installer, selon l'organisation adoptée sur le site :

...

Attention : Les versions 2016 et ultérieures d'Harmony nécessitent le Framework 4.6.2 de Microsoft.Net.

Vérification des produits disponibles

L'assistant d'installation d'Harmony permet d'interroger un serveur de Divalto pour obtenir la liste des masters et des correctifs disponibles pour la version en cours d'installation.
Si la version installée n'est pas à jour, un simple clic sur une URL permet de télécharger la dernière version ou ses correctifs.
Attention :
Cette interrogation nécessite une connexion internet car elle invoque un service Web hébergé par un serveur de Divalto. Elle peut toutefois être désactivée en décochant la case Contrôler la version du master s'il n'y a pas de connexion internet disponible.
Vous trouverez la description détaillée de cette fonctionnalité dans le livre Téléchargement des masters et des correctifs Divalto.

Installation d'un serveur d'applications

Les opérations à réaliser pour installer un serveur d'applications (ou un poste "client lourd") dépendent de la configuration adoptée.
Les rubriques suivantes décrivent successivement :

...

Installation des fichiers d'aides
Installation d'un serveur multi-bases
Installation multi-environnement
Installation sous Windows Terminal Serveur
Profils de connexion
Profils utilisateur

Installation de Harmony Power Foundation

Sur le serveur d'applications, exécutez le programme InstallDivalto.exe. Ce programme lance l'Assistant d'installation de Divalto. Après avoir accepté les termes du contrat de licence, sélectionnez le produit "Harmony Power Foundation".
Entrez ensuite les renseignements demandés :

...

Opérations réalisées par l'installateur

Le programme d'installation de "Harmony Power Foundation" réalise en particulier les opérations suivantes :

...

Installation du serveur en mode Socket

On privilégiera le mode Socket pour des connexions dans un réseau local d'entreprise ou dans le cadre d'un réseau virtuel privé, réseaux pour lesquels l'ouverture d'un port de communication particulier n'est généralement pas un problème. En effet :

...

Pour les connexions par sockets TCP/IP, le service DhsTerminalServer doit être démarré sur le serveur d'applications. C'est ce service qui attend les connexions des postes client :
Ce type de connexion nécessite l'ouverture d'un port de communication TCP/IP entre le client et le serveur au niveau des Firewalls. Par défaut, le serveur écoute le port 1246.
Paramétrage du port
Si le port 1246 n'est pas disponible ou ne convient pas, il peut être changé dans la base de registre globale du serveur (HKEY_LOCAL_MACHINE), par l'utilitaire XDivaltoMajini. Le choix de la section de la base de registre à traiter s'effectue à partir du menu « Lecture » de cet utilitaire.
Le port du client doit évidemment être en adéquation avec celui du serveur : le paramétrage du port coté client se trouve dans le profil de connexion.
Redémarrage automatique du service DhsTerminalServer en cas de défaillance
Le gestionnaire des services de Windows permet de spécifier le comportement d'un service en cas de défaillance (onglet Récupération de la boîte des propriétés du service). Les options de redémarrage automatique peuvent être appliquées au service DhsTerminalServer pour autoriser ce dernier à redémarrer s'il s'avère défaillant :

Installation du serveur en mode Service Web

On privilégiera le mode Service Web pour des connexions de postes nomades, l'accès depuis Internet n'autorisant pas le dialogue sur des ports de communication « privés ».
Ce type de connexion nécessite la présence du service IIS de Microsoft sur le serveur d'applications (Cf. rubrique Installation du serveur Web IIS).
Pour qu'une page asmx du serveur soit accessible depuis le Web, il faut créer une application IIS 32 bits pointant le répertoire contenant cette page. On crée ainsi un répertoire virtuel, alias d'un chemin dans l'arborescence des fichiers du serveur. Exemple :
Pour accéder au serveur via l'URL http://www.monserveur.fr/LCWebService/DHTerminalServer.asmx, créez sur le serveur une application IIS nommée "LCWebService" et pointant le répertoire physique contenant la page DHTerminalServer.asmx.
Remarque importante :
On utilisera de préférence le répertoire x:\Divalto\Internet\LCWebService.
Ce répertoire contient en effet le modèle vers lequel il faut faire pointer le chemin d'accès physique de l'application IIS. Le répertoire physique peut être changé, mais dans ce cas, il ne faudra pas oublier de reprendre le modèle livré par Divalto en cas de mise à jour dans une version future d'Harmony.

Tous les paramétrages qui suivent concernant IIS s'effectuent par le Gestionnaire des Services Internet (IIS), accessible depuis le panneau de configuration.
Pool d'applications IIS
Une application IIS appartient toujours à un pool d'applications. Il est possible de créer son propre pool d'applications ou utiliser l'un des pools proposés par Windows :


Configurer le pool d'applications
Cliquez sur la ligne Pools d'applications dans l'arbre des Connexions. Dans la fenêtre Pools d'applications (à droite de l'écran), sélectionnez le pool choisi pour votre application puis éditez ses paramètres avancés. Les options suivantes sont impératives :

...

Mise en oeuvre d'une compression des trames
Voir la rubrique Compression des trames pour un client léger Web.
Tests de premier niveau
Avant de procéder à un essai complet du client léger Divalto, vous pouvez déjà vous assurer que le paramétrage de base de l'application IIS est correct.
Depuis un navigateur exécuté sur votre serveur, connectez-vous à la page asmx configurée pour le client léger. Pour cela, entrez l'url http://localhost/lcwebservice/dhterminalserver.asmx (exemple de paramétrage donné plus haut).
Vous devez obtenir une page Web du style :

Remarque : Cette page peut apparaître après un délai relativement long s'il s'agit de la première tentative de connexion à IIS.
En cas d'erreur : L'affichage de cette page est une condition sine qua non du bon fonctionnement du client léger en mode Service Web. Tant qu'elle n'apparaît pas, il est donc inutile de tenter de modifier le paramétrage "Divalto" du client léger.
Bien entendu, ce premier test peut être fait également depuis un navigateur exécuté sur un poste client (en remplaçant localhost par l'adresse du serveur, par exemple www.monserveur.fr).

Droits d'accès
En effectuant le test précédent, l'erreur suivante apparaît lorsque l'utilisateur n'a pas les droits pour accéder à la page asmx :

Remarque : En se connectant en client léger Divalto, on obtient cette erreur :

Il faut alors en supplément donner les droits de lecture et d'exécution aux utilisateurs autorisés (éventuellement à "Tout le monde") sur tout le répertoire physique pointé par l'application IIS (x:\Divalto\Internet\LCWebService en standard). Les droits se définissent en cliquant droit sur le nom du répertoire dans l'explorateur de fichiers de Windows et en sélectionnant le choix "Propriétés" du menu surgissant. Sélectionnez alors l'onglet "Sécurité" et cliquez sur le bouton "Modifier" :


Diffusion du client léger
La mise en œuvre d'un serveur IIS est aussi une opportunité pour une diffusion simple et conviviale du client léger.

Configuration du service DhsDivaAgent

• Les applications Diva lancées depuis le client léger sont exécutées, sur le serveur d'applications, par le service DhsDivaAgent (qui doit donc être démarré sur le serveur) :

  

• Avant d'exécuter un programme, ce service s'impersonne avec le compte de l'utilisateur Windows du client. Le programme Diva s'exécute donc sous ce compte utilisateur et en hérite les droits. C'est pourquoi le compte Windows et son mot de passe doivent être renseignés dans les options avancées de connexion. Le compte peut-être un compte local au serveur ou un compte du Domaine (dans ce cas, on écrit User@Domaine) :

  

• Attention : Pour réaliser l'opération d'impersonnation, le service DhsDivaAgent doit être autorisé à interagir avec le bureau :

  

Installation du client léger Wpf

Le "Client léger Harmony" est le processus chargé de la présentation des applications Harmony.
Nous nous intéressons ici au cas où ce processus s'exécute sur un ordinateur distinct du serveur d'applications.
ATTENTION : Si Harmony Power Foundation est déjà installé sur le poste client, il n'y a pas lieu d'installer le client léger. En effet :

...

Pour utiliser le mode client léger Wpf, installez le client léger sur le poste client, par un installateur de type « Microsoft Installer » (.msi). Cette installation est décrite dans le livre Installation du client léger (Msi).
Remarque :
Le lancement direct du client léger depuis un navigateur Internet par la technologie Xbap est obsolète avec l'introduction du client léger Html5. En conséquence, le connecteur XBAP n'est plus diffusé à partir de la version 2016.
Voir aussi :[ Installation multi-environnement|#Top_of_Installation_multi_enviro]
Installation du connecteur Divalto pour Outlook sur un poste client léger

Installation du client léger (Msi)

Un installateur simplifié du type « Microsoft Installer » (.msi) permet, en quelques clics, d'installer le client léger Harmony sur un poste client.
De plus, le poste client est directement utilisable si l'installateur crée un profil de connexion par défaut, configuré de manière à autoriser une connexion immédiate au serveur d'applications. Il suffit pour cela de personnaliser le fichier d'installation "DivaltoSetup.msi", à l'aide du logiciel Microsoft Orca.
Les rubriques suivantes décrivent successivement :

...

Installation de Microsoft Orca

Le logiciel Microsoft Orca est un éditeur de base de données servant à modifier des fichiers "Windows Installer". Il n'est disponible qu'en anglais, mais son utilisation est particulièrement simple.
Sa documentation est disponible à l'adresse suivante : http://support.microsoft.com/kb/255905.
Pour l'installer, lancez d'abord l'exécutable Orca.Msi, situé dans le répertoire ORCA à la racine du CD Divalto. Après avoir accepté les conditions d'utilisation, choisissez le type d'installation « typical ». Une fois l'installation terminée, cochez la case « Launch Application When Finished » (« Lancer l'application une fois l'installation terminée »).

Paramétrage du fichier (.msi) d'installation du client léger

Avant de distribuer le fichier d'installation du client léger, il est possible de le personnaliser, à l'aide du logiciel Microsoft Orca.
La personnalisation va permettre de pré-paramétrer l'installation, afin de rendre le poste client immédiatement utilisable, en proposant un profil de connexion par défaut configuré de manière à autoriser une connexion immédiate au serveur d'applications.
Mais ATTENTION : La personnalisation du fichier .msi annule la signature numérique de l'installateur. La signature confirme l'identité de l'auteur du code et garantit que ce code n'a pas été modifié ou corrompu depuis qu'il a été signé. Elle assure en particulier que les logiciels Antivirus ne perturbent pas le lancement de l'installation.

...

L'exécutable d'installation du client léger inclut maintenant les paramètres de connexion que vous avez choisis et le profil créé sera proposé à l'utilisateur dans sa boîte de connexion avancée au premier lancement du client léger. Tant que l'utilisateur ne change pas de profil, ce profil continuera à être proposé lors de ses connexions ultérieures.
Attention en cas d'utilisation du choix du menu "Save As..." :
Le fichier résultat renommé ne sera pas correct si vous n'avez pas au préalable activé l'option "Copy Embedded streams during 'Save As'" :

Déploiement du client léger (Msi)

Une fois le fichier d'installation .msi personnalisé et prêt à l'emploi, vous pouvez le distribuer en le mettant à disposition sur un serveur d'entreprise. Cette mise à disposition peut être faite :

...

Un lien vers le fichier DivaltoSetup.msi personnalisé ou vers la page d'accueil du téléchargement peut-être envoyé aux utilisateurs qui chargeront le client en quelques clics.

Installation du client léger sur un poste client (Msi)

Le client léger doit être installé sur chaque poste client.
Après que l'utilisateur clique sur le lien « Installer » de la page Web que vous aurez mise à sa disposition, l'installation se déroule de la manière suivante :

...

Installation du .msi en ligne de commande

L'installation peut être lancée en ligne de commande et, dans ce cas, il est possible d'utiliser les propriétés publiques :

...

Exemple :
msiexec.exe /i "C:\DivaltoSetup.msi" /qn INSTALLDIR="C:\Divalto" CLOUDINSTALL="true"

Mise à jour du client léger (Msi)

Lorsque la version du serveur change, il faut installer sur les postes clients la version correspondante du client léger. Vous pouvez configurer le serveur d'applications pour qu'un client léger qui se connecte au serveur avec une ancienne version non compatible se voit automatiquement proposer d'installer la nouvelle version :

...

Installation du client léger (Divalto Web Access)

Avant l'introduction du client léger HTML5, la connexion à un serveur Divalto depuis un navigateur utilisait la technologie XBAP. Cette technologie permettait, de manière transparente pour l'utilisateur, d'installer un client Wpf sur le poste client.
Cette technologie est aujourd'hui obsolète et le connecteur XBAP n'est plus diffusé à partir de la version 2016.

Installation d'un serveur de données (ou d'un poste autonome)

Les rubriques suivantes décrivent successivement :

...

Voir aussi :
Complément d'installation d'un poste client lourd
RecordSQL et DataBase

Installation du serveur SQL

Avant d'installer l'ERP Divalto infinity, il faut installer le logiciel de gestion de la base de données cible (Microsoft SQL Server, Oracle ou IBM DB2) sur le serveur de données et que celle-ci soit opérationnelle. Il faut également créer une base de données dans laquelle seront stockées les tables de l'ERP et éventuellement une base de données pour les tables de Divalto BI. Le nom de la base, sensible à la casse, doit impérativement être en majuscules.
Attention : Consultez les dernières rubriques de ce livre pour prendre connaissance des particularités de chaque base de données. Par exemple, consultez la rubrique "Base de données Microsoft Sql Server - Particularités" si vous installez l'ERP sur le serveur SQL de Windows.
Maintenance et évolution des bases
Ce point est assuré par l'utilitaire XPSQL : voir le livre consacré à Xlan SQL.

Installation du serveur de données

Sur un serveur de données, installez Harmony Power Foundation et l'ERP Divalto. Le cas échéant, installez aussi le Connecteur Divalto pour Outlook.
L'installation de l'ERP va vous permettre de configurer le connecteur SQL. En version 7, l'accès aux données s'effectue par deux canaux :

...

Connecteur SQL

Le connecteur SQL accède à la base de données par une connexion ADO.net.
L'installateur de l'ERP demande les paramètres suivants pour créer les tables et copier les données dans la base SQL :

...

Emplacement du fichier des connexions
L'installateur SQL crée le fichier connexions.xml dans le répertoire /Divalto/Sys s'il n'existe pas. Si le fichier de connexions existe déjà, l'installateur n'y touche pas mais crée un fichier de connexions portant le nom de la base de données avec l'extension .xml (par exemple ErpDivalto.xml) dans le sous-répertoire /Divalto/BasedeDonnees (par exemple /Divalto/ErpDivalto/ErpDivalto.xml).
La personne qui installe pourra ensuite copier/coller la connexion correspondante dans le fichier des connexions (/Divalto/Sys/connexions.xml).

Fichier paramètres des connexions

Le fichier paramètre Connexions.xml est utilisé par le connecteur SQL.
Il contient une liste de connexions vers les bases de données. Pour chaque connexion, on définit :

...

Chaque connexion est identifiée par un nom (attribut "nom" de la balise connexion).
La connexion « default » est utilisée par défaut.
Ce fichier doit être stocké dans le répertoire du fichier des utilisateurs (clé ServeurXLOGF du chapitre [System] de xDivaltoMajIni).
Lors de la connexion, pour utiliser les informations de connexion de Windows, il faut mettre dans la chaîne de connexion : "Trusted_Connection=Yes;".
Si, au contraire, vous voulez utiliser un compte générique, local au serveur SQL, il faut mettre : "User Id=xxxx; Password=xxxx;".

Fichier paramètre des implicites SQL

C'est un fichier paramètre facultatif au format xml :

...

RecordSQL et DataBase

Le connecteur SQL accède à la base de données en faisant référence à un RecordSQL. Il s'agit d'un objet décrivant l'accès aux tables. Les RecordSQL sont stockés dans des dictionnaires de RecordSQL.
Chaque table est rattachée à une base de données par un paramètre DataBase. Ce paramètre peut ensuite être utilisé pour définir le lien avec la base de données réelle. Ainsi, on pourra par exemple mettre l'ensemble des tables de la paye dans une base de données distincte de celle des autres produits de l'ERP.

Installation de Divalto Business Intelligence

Pour installer Divalto Business Intelligence, consultez la fiche expert d'installation de l'offre Divalto BI.
La fiche "Fiche_Expert_Installation_BI.doc", disponible en téléchargement sur MyDivalto, décrit notamment :

...

Base de données Microsoft Sql Server - Particularités

Version minimale de SQL Server
L'ERP Divalto infinity version 7 nécessite impérativement un serveur de bases de données Microsoft SQL Server 2008 R2. Celui-ci doit être installé et opérationnel avant l'installation de l'ERP.
Création des bases de données
Attention :

...

Divalto BI
Pour l'utilisation de Divalto BI, il est impératif d'installer le serveur avec l'option "Authentification mixte". L'option par défaut proposée est Windows. Attention, il est préférable d'activer l'option lors de l'installation de SQL Server. (Elle peut toutefois être modifiée ultérieurement ou sur un serveur déjà installé sans cette option) :
Driver et chaîne de connexion ODBC
Le service Xlan accède à la base de données Microsoft SQL Server 2008 par le driver ODBC 32bits SQL Server Native Client 10.0 :
La chaîne de connexion ODBC à fournir au connecteur SQL sera par exemple la suivante :
DSN=sql2008;Description=sql2008;Trusted_Connection=Yes;APP=Divaltoinfinity;WSID=TL; DATABASE=ERPDIVALTO;

Ports TCP utilisés par SQL Server
Dans une installation simple, seul le port 1433 est utilisé. Pour plus de détails, reportez-vous à la documentation Microsoft (http://msdn.microsoft.com/fr-fr/library/cc646023.aspx).

En cas d'installation de plusieurs instances de SQL Server
Lors de l'installation de l'ERP, il faut alors renseigner le paramètre "Nom de l'instance" pendant la phase de paramétrage du connecteur SQL. Attention : Avec la version SQL Express, il faut impérativement renseigner ce nom d'instance (SQLEXPRESS par défaut).

Complément d'installation d'un poste client lourd

Sur un poste "client lourd", on installe Harmony Power Foundation.
Et si l'option ServeurXLOGF (gestion centralisée des utilisateurs) n'est pas active, il convient d'installer localement, dans le répertoire /Divalto/Sys :

...

Installation standard des aides utilisateur Harmony et de l'ERP Divalto

Cette rubrique concerne les aides affichées par les applications s'exécutant en mode client léger (aides au format WebHelp).
Il s'agit en particulier des aides de l'ERP Divalto et des aides "utilisateur" du système Harmony . Ces dernières sont incluses dans l'aide A5faide de l'ERP Divalto, ce qui les rend accessible depuis le menu Divalto.
Pour rapidement installer et paramétrer l'accès aux aides (hors connexion en mode Service Web) :

...

Configuration des serveurs d'aides et d'applications

Cette rubrique concerne les aides affichées par les applications s'exécutant en mode client léger (aides au format WebHelp).
Elle explique comment configurer votre site,en cas d'installation personnalisée des aides des applications ou si vous désirez héberger les aides sur un serveur Web. En cas d'installation "standard", reportez-vous à la rubrique Installation des aides utilisateur Harmony et de l'ERP Divalto.

Déploiement des aides
Tous les constituants d'une aide au format WebHelp sont regroupés dans un même dossier. Lorsqu'une ou plusieurs applications proposent plusieurs aides, on obtient plusieurs dossiers. Par exemple, l'ERP Divalto propose une aide pour l'application "Commerce et logistique", une aide pour l'application "Comptabilité", etc. Chacune de ces aides fait l'objet d'un dossier distinct (gtfaide, ccfaid, ...).
Sur l'ordinateur qui hébergera les fichiers d'aides, tous ces dossiers doivent être déployés sous un même répertoire « racine ». Le chemin d'accès à ce répertoire est paramétré, côté serveur d'applications, dans la base de registre de l'utilisateur.
Remarque : Chaque dossier contient lui-même une "page de lancement", portant le même nom que le nom du dossier avec l'extension .htm. Par exemple, le dossier gtfaide contient la page de lancement gtfaide.htm.
Par exemple :
c:/Divalto/WebAide : répertoire "racine"
gtfaide : dossier <=> aides de l'application "Commerce et logistique"
gtfaide.htm, ... : fichiers constituants avec la page de lancement gtfaide.htm
ccfaid : dossier <=> aides de l'application "Comptabilité"
ccfaid.htm, ... : fichiers constituants avec la page de lancement ccfaid.htm
etc.
Remarque à l'attention des développeurs :
Le nom du fichier d'aides spécifié dans les programmes et les masques doit être identique au nom du dossier d'aides correspondant (gtfaide ou ccfaid dans l'exemple ci-dessus). Cf. Aide à la programmation de Xwin, Chapitre "Aides fenêtrées : Manuel de référence", Rubrique "Saisie et génération d'un fichier d'aides".

Configuration des serveurs d'aides et d'applications
Deux méthodes permettent d'accéder aux aides déployées sur un ordinateur serveur :

...

Attention :
Pour un utilisateur donné, le chemin d'accès aux aides est dans tous les cas unique pour l'ensemble des aides. En particulier, il faut installer les aides spécifiques au même endroit que les aides utilisateur Harmony et de l'ERP Divalto.
Voir aussi :
Installation des aides sur un site multi-environnement
Installation des aides sur un site multi-langue

Centralisation des fichiers d'aides de la version 6

Cette rubrique concerne les fichiers d'aide affichés par les applications tournant encore en version 6 (hors client léger).
Il est intéressant, en particulier pour simplifier leur mise à jour, de centraliser les fichiers d'aides des applications.
Par xDivaltoMajIni, ajoutez pour ce faire dans le chapitre System la clé :
CheminAides=xxxxx où xxxxx spécifie le chemin d'accès Windows à un dossier partagé sur le réseau. Exemple : CheminAides=//Serveur/FichiersAides
Remarque : Tout fichier d'aides sera recherché en priorité dans le répertoire indiqué ; si le fichier ne s'y trouve pas, une seconde recherche sera faite sans préciser de répertoire (le fichier doit alors se trouver dans un dossier recensé dans la liste des "Paths" de Windows ou dans le dossier "courant", en général dans x:/Divalto/Sys). Ainsi, on pourra par exemple placer les fichiers d'aides applicatifs dans un répertoire spécifique et laisser les fichiers d'aides "système" dans /Divalto/Sys.
MAIS ATTENTION : En standard, Windows interdit l'appel à un fichier d'aides (.chm) distant. Toutefois, cette restriction imposée pour des raisons de sécurité peut être contournée de la manière suivante :

...

Installation des aides sur un site multi-environnement

Rappelons que la notion de système multi-environnement donne la possibilité à un utilisateur de changer dynamiquement son environnement de travail. Ceci peut s'avérer pratique, sur une installation en mode ASP, pour mettre à disposition des aides de versions différentes ou des aides traduites en langue étrangère selon les clients hébergés. Un environnement Harmony détermine un serveur Xlogf (base de données des utilisateurs Harmony), un serveur de fichier paramètres des langues, un serveur d'aides pour les applications s'exécutant en mode client léger et un serveur d'aides pour les applications tournant encore en version 6. Changer d'environnement permet alors de changer les chemins d'accès aux aides (V7 et V6). La valeur de la clé correspondant à un environnement comporte donc quatre paramètres (séparés entre eux par une virgule).
Par exemple :
[Environnement]
Serveur1=//serveur_un/divalto/sys,//serveur_un/divalto/sys,file://serveur_un/divaltowebaide,//serveur_un/divalto/sys
Serveur2=//serveur_deux/divalto/sys,//serveur_deux/divalto/langues,http://serveur_aides/Client1_webaide,//serveur_deux/divalto/Client1_aides

Installation des aides sur un site multi-langue

1. Aides affichées par les applications s'exécutant en mode client léger
Pour qu'un utilisateur affiche une aide traduite en langue étrangère, il faut stocker les fichiers d'aides traduits dans un répertoire « racine » spécifique et faire pointer le chemin des aides sur ce répertoire pour les utilisateurs concernés. La méthode optimale consiste ici à utiliser le système des environnements.
Exemple sans environnement :
CheminAidesWeb=file://serveur/DivaltoWebAide_DE
Partage DivaltoWebAide_DE <=> répertoire « racine » pour un utilisateur allemand
gtfaide
ccfaid dossiers contenant les aides traduites en allemand
etc..
Exemple avec environnements :
[Environnement]
User_DE=...,file://serveur/DivaltoWebAide_DE
User_EN=...,file://serveur/DivaltoWebAide_EN
Partage DivaltoWebAide_DE <=> répertoire « racine » pour un utilisateur allemand
gtfaide
ccfaid dossiers contenant les aides traduites en allemand
etc..
Partage DivaltoWebAide_EN <=> répertoire « racine » pour un utilisateur anglais
gtfaide
ccfaid dossiers contenant les aides traduites en anglais
etc..
Attention en cas de traduction partielle :
Il se peut que vous ne disposiez pas d'une traduction dans la langue de l'utilisateur pour toutes les aides applicatives ou système. Comme le chemin des aides est unique pour un utilisateur, vous devez dans ce cas :

...

• c:/MesAides/ficaide_de.chm

• ficaide_de.chm

• c:/MesAides/ficaide_en.chm

• ficaide_en.chm

• c:/MesAides/ficaide.chm

• ficaide.chm
  

  Ancre
  Top_of_Installation_d_un_serveur_2 Top_of_Installation_d_un_serveur_2

  
  

Installation d'un serveur multi-bases

Ce chapitre explique les principes de mise en oeuvre de Divalto en mode ASP.
Architecture
Le concept général est de mutualiser Divalto sur un serveur d'applications (ou une ferme de serveurs) pour des entreprises clientes différentes. Chaque entreprise cliente est indépendante, et n'a aucun accès aux données des autres entreprises hébergées sur le même serveur.

...

ATTENTION : cette fonctionnalité est uniquement disponible si vous lancez l'utilitaire par la commande <Exécuter> du menu Démarrer de Windows avec le paramètre /propager. Par exemple :
xDivaltoMajini.exe /propager

Installation sous Windows Terminal Serveur

Qu'est-ce que Terminal Serveur ?

Windows Terminal Serveur Edition (TSE) est un système d'exploitation de Microsoft permettant de travailler en multiposte sous Windows. Chaque poste de travail client se comporte comme un ordinateur virtuel opérant sous ce système.
L'application s'exécute sur le serveur d'applications ; l'image de la session en cours s'affiche sur le poste client. Le protocole de communication entre le serveur et le poste client se nomme RDP (Remote Desktop Protocol) sous système TSE natif, ou ICA (Independent Computing Architecture) sous système Citrix.
Quelques avantages de ce type de système :

...

Licences concurrentes Divalto pour TSE

Comme dans une installation classique, les licences concurrentes sont comptabilisées par poste client (une licence par produit pour toutes les tâches d'un poste).

Architectures TSE

En fonction du nombre de postes connectés, on peut envisager deux architectures :

...

Installation d'Harmony pour TSE

L'installation d'Harmony sur un serveur d'applications TSE doit être effectuée sous un compte d'administration et après l'installation de TSE. Elle diffère uniquement d'une installation classique sous Windows par quelques particularités, que nous allons détailler dans les rubriques qui suivent.
En particulier, si vous installez Harmony sur un pool de serveurs TSE (ou Citrix), en mode "Load balancing", prenez connaissance des particularités liées à ce mode de fonctionnement à la rubrique Installation sur un site comportant plusieurs serveurs TSE.
Remarque importante : Ne passez pas par « Ajout/Suppression de Programmes » pour installer Harmony sous Windows TSE.

Profils d'utilisateur Windows

Sous Windows, chaque utilisateur du système est identifié par un code d'utilisateur. Il est impératif de s'identifier avec ce code pour ouvrir une session. Chaque code est rattaché à un compte d'utilisateur qui décrit les propriétés de cet utilisateur, notamment :

...

...

Redémarrage de Windows

Après le redémarrage du poste, on poursuivra la procédure d'installation standard (installation et configuration éventuelle d'un serveur Xlan, installation des applications, etc.) puis on effectuera les opérations décrites ci-après.

Configuration des imprimantes sous TSE

xDivaltoPrinters stocke la configuration des imprimantes dans la section Divalto.ini de la base de registre. Sous TSE, cette section est propre à l'utilisateur en cours. Lorsque vous ajoutez ou modifiez des paramètres d'imprimantes, xDivaltoPrinters vous propose de propager les nouveautés chez les autres utilisateurs : voir Modification de Divalto.ini.
ATTENTION : cette fonctionnalité est uniquement disponible si vous lancez xDivaltoPrinters par la commande <Exécuter> du menu Démarrer de Windows avec le paramètre /propager :
xDivaltoPrinters.exe /propager

Installation sur un site comportant plusieurs serveurs TSE

Lorsque le site comporte plusieurs serveurs d'applications, TSE (ou CITRIX) propose un mode de fonctionnement dénommé "Load balancing". Dans ce mode :

...

Remarque :
Il peut arriver qu'un serveur ne soit pas totalement équivalent aux autres. Par exemple, une imprimante "locale" peut être connectée à un serveur particulier. Dans ce cas, le paramétrage de cette imprimante sera propre à ce serveur. Harmony gère parfaitement ce cas mais n'oubliez pas que les états édités par l'application n'ont pas l'assurance de sortir sur cette imprimante puisque le serveur sur lequel elle va s'exécuter n'est pas connu à l'avance.

Arrêt et redémarrage automatisés

Cf. utilitaire xDivaltoRestart.

Ajout d'un nouvel utilisateur

Pour ajouter un nouvel utilisateur (par exemple à l'occasion de l'ajout d'un nouveau terminal), créez d'abord un compte d'utilisateur sous Windows puis dans le fichier des utilisateurs d'Harmony (Xlogf). Ensuite, ouvrez une session sous ce compte.

Ajout d'une nouvelle application

Après avoir installé une nouvelle application sous un compte d'administration, effectuez la mise à jour des paramètres pour chaque utilisateur. Vous pouvez :

...

Remarque : l'ouverture d'une session par un utilisateur non connecté provoquera automatiquement la mise à jour de ses paramètres.

Modification de Divalto.ini

Chaque utilisateur dispose de sa propre section Divalto.ini dans la base de registre. Les modifications qui y sont faites sont par défaut locales à cet utilisateur. Mais les utilitaires Harmony qui manipulent Divalto.ini (xDivaltoPrinters, xDivaltoMajIni) permettent de répercuter les modifications pour tous les comptes d'utilisateur :

...

Il faut impérativement donner l'autorisation de lecture/écriture pour tous les utilisateurs au répertoire Installlog. Attention : sur le réseau, il y a deux niveaux : les droits de partage et les droits utilisateur. Il faut que tous les utilisateurs puissent lire, écrire et créer des fichiers.

Utilisation de la base de registres de Windows

Harmony stocke des paramètres dans la base de registres, notamment les positions et les tailles des fenêtres, l'ordre et la largeur des colonnes des objets tableau. Ces informations sont liées à l'utilisateur.

Installation d'Harmony Web

Architecture Harmony Web

...

• Une session Web est activée lorsqu'une page d'extension .aspx est soumise depuis le Web (.asmx pour un service Web). La réception de cette page est assurée par le gestionnaire de services Internet (IIS) de Microsoft. Son « exécution » nécessite l'installation du Framework .Net de Microsoft.

• Le service Divalto Agent Diva doit également s'exécuter (il est lancé automatiquement au démarrage de l'ordinateur). Il a pour mission de lancer et de surveiller les programmes Harmony Diva lorsque des sessions ou des services Web sont activés.

• Pour faciliter l'installation de vos serveurs Harmony Web, Divalto fournit un répertoire « exemple » contenant en particulier :

• Une page aspx générique qui peut être librement dupliquée et renommée.

• Des fichiers de configuration « standard ».

• Les dll (assembly .net) nécessaires au dialogue avec les programmes Diva.

• Une mini-application (HelloWorld) permettant de réaliser un test de premier niveau.

Installation du serveur Web IIS

Les applications Harmony Web s'exécutent sur un ordinateur serveur Web, sur lequel doivent être installés les éléments suivants :

...

Service IIS
IIS tourne sous la forme d'un service qui peut empêcher de renommer ou déplacer des répertoires, si ces derniers sont pointés par des répertoires virtuels. La solution pour pallier cette difficulté consiste à arrêter momentanément le serveur Web. Pour cela, stoppez le service de Publication World Wide Web depuis le gestionnaire de services (Panneau de configuration à Outils d'administration à Services).

Création d'une application IIS sur le serveur Web

Pour qu'une page (fichier .aspx, .asmx ou .html) de votre serveur soit accessible depuis le Web, il faut créer une application IIS 32 bits pointant le répertoire contenant cette page. On crée ainsi un répertoire virtuel, alias d'un chemin dans l'arborescence des fichiers du serveur.
Exemple : Pour accéder à votre application via l'URL http://www.monserveur.fr/magasin/commande.aspx, créez sur le serveur une application IIS nommée "Magasin" et pointant (par exemple) le répertoire "c:\Divalto\Internet\WebServeur" ; placez dans ce répertoire la page Commande.aspx (créée à partir de la page générique fournie par Divalto).
Pool d'applications IIS
Une application IIS appartient toujours à un pool d'applications. Il est possible de créer son propre pool d'applications ou utiliser l'un des pools proposés par Windows :


Configurer le pool d'applications
Cliquez sur la ligne Pools d'applications dans l'arbre des Connexions. Dans la fenêtre Pools d'applications (à droite de l'écran), sélectionnez le pool choisi pour votre application puis éditez ses paramètres avancés. Les options suivantes sont impératives :

...

Remarque : Vous pouvez créer autant d'applications IIS que vous le souhaitez.

Configuration du site Web

Paramètres IIS
Il est possible de paramétrer un site Web IIS par l'intermédiaire du fichier Web.Config situé au même niveau que la page aspx. Deux paramètres particuliers de Web.Config (au format Xml) :

...

Installation de services Web

Comme les applications Harmony Web, les services Web Diva s'appuient sur le serveur IIS et le Framework .Net de Microsoft (pour leur installation, voir la rubrique Installation du serveur Web IIS).
Le principe des répertoires virtuels IIS reste également valable.
Installer les services Web Diva consiste simplement, au niveau de IIS, à créer un répertoire virtuel pointant le répertoire Divalto\Internet\WebServiceDiva (qui peut être déplacé et/ou renommé).
Attention : Les services Web démarrent toujours sous le compte utilisateur $WEBSERVICE. Ce compte doit donc toujours exister dans le fichier Harmony des utilisateurs.
Exemple :
IIS : Alias = servicediva --> répertoire = C:\Divalto\Internet\WebServiceDiva
L'URL à spécifier pour accéder aux services est alors : http://www.monserveur.fr/servicediva/WebServiceDiva.asmx
Remarque

...

Les services résidents travaillent pour un environnement donné lors de leur chargement initial.

Choix du compte utilisateur Windows pour les programmes Web

Par défaut, le service Divalto Agent Diva s'exécute sous le compte système local (voir Développement d'applications Web : paramétrages complémentaires ).
Il est conseillé de laisser le service Divalto Agent Diva sous ce compte. Mais cela implique que les programmes Diva lancés par ce service tournent également sous ce compte et, de fait, que les programmes Diva ne peuvent pas envoyer de mails à travers l'interface Mapi, cette dernière ne fonctionnant que pour un compte utilisateur.
Pour permettre à un programme Web (ou à un service Web) d'émettre des mails, il faut paramétrer le service Divalto Agent Diva pour que les programmes Diva lancés s'exécutent sur un compte utilisateur « standard ».
Méthode
Modifier le fonctionnement du service Divalto Agent Diva pour que celui-ci exécute les programmes et les services sous un compte utilisateur Windows.

...

Choix de l'environnement pour les services web

Si un même serveur héberge plusieurs entités utilisant les services web, il faut pouvoir préciser dans quel environnement le service web doit s'exécuter.
Pour mettre en place les environnements, il convient de créer une page asmx d'accueil pour chaque environnement. Pour cela :

...

Développement d'applications Web : paramétrages complémentaires

Pour développer une application ou un service Web et bénéficier du débogueur de Xwin :

...

Création d'un site Harmony Web

Par la suite, nous nommerons Base le répertoire de base de votre application (celui pointé par le répertoire virtuel IIS associé). Pour créer un nouveau site :

...

En cas d'erreur
Lors d'une tentative d'affichage d'une page aspx, un problème de droit d'accès peut entraîner une erreur du type : « Impossible de charger la DLL 'dhx2yweb.dll' : Le module spécifié est introuvable. (Exception de HRESULT : 0x8007007E) »
(Cf. le site Microsoft http://support.microsoft.com/kb/332167 ; chapitre <Configure Sub-Authentication on an IIS 6.0 Upgrade in Worker Process Isolation Mode>, point 2 : Exécuter tous les processus de travail qui utilisent l'authentification anonyme sous l'identité du système local).
La solution consiste à reconfigurer la propriété Identité du modèle de processus dans les paramètres avancés du pool d'applications : utiliser le compte LocalSystem (système local) plutôt que NetworkService (service réseau).

Installation d'un site Web multilingue

Les applications Web peuvent être traduites en langue étrangère (voir le livre du manuel de référence intitulé "Traduction").
Pour que la traduction soit bien mise en oeuvre :

...

Tester si le navigateur accepte les cookies

Pour tester si le navigateur accepte les cookies, vous pouvez insérer du code JavaScript dans votre page aspx. Ce code crée un cookie et vérifie si la création a fonctionné.
Exemple
<%@ Page language="c#" Codebehind="WebForm1.aspx.cs" AutoEventWireup="false" Inherits="DhXwebForm.WebForm1" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" >
<HTML>
<HEAD>
<title>WebForm1</title>
<meta content="Microsoft Visual Studio .NET 7.1" name="GENERATOR">
<meta content="C#" name="CODE_LANGUAGE">
<meta content="JavaScript" name="vs_defaultClientScript">
<meta content="http://schemas.microsoft.com/intellisense/ie5"
name="vs_targetSchema">
<LINK href="style/style.css" type="text/css" rel="stylesheet">
</HEAD>
<SCRIPT>
function testCookie(){
var checkCookie = 'checkCookie' + (new Date().getTime());
document.cookie = checkCookie + '=cookieValue';
var yesCookie = document.cookie.indexOf(checkCookie) != -1;
if (yesCookie){
alert("Votre navigateur supporte les cookies");
}else{
alert("Votre navigateur ne supporte pas les cookies");
}
deleteCookie(checkCookie);
}
function deleteCookie (cookieName) {
var expire = new Date();
document.cookie = cookieName + "=" + "; expires=Thu, 01-Jan-70 00:00:01 GMT" +
"; path=/";
}
</SCRIPT>

<body MS_POSITIONING="GridLayout">
<FORM id="form1" name="form1" method="post" runat="server">
<asp:Label id="parametres" runat="server"
Visible="False"><program>commande.dhop<user>demo</asp:Label>
</FORM>
</body>
<SCRIPT>
testCookie();
</SCRIPT>
</HTML>

Licence d'utilisation d'Harmony

• Licences nommées (système de licences prévalant à partir de la génération 10 de l'ERP Divalto).

• Licences concurrentes (système de licences prévalant avant la génération 10 de l'ERP Divalto).

Licences nommées

A partir de la génération 10, l'utilisation de l'ERP Divalto est soumise à des licences nommées, c'est-à-dire que chaque utilisateur de l'ERP doit être identifié par son compte et son mot de passe Windows. A chaque utilisateur est associé un profil qui détermine les fonctionnalités de l'ERP auxquelles il aura accès. Le tarif Divalto décrit les profils existants pour chaque gamme et chaque déclinaison métier de l'ERP.
Chaque site dispose d'un certificat de licences comprenant les informations suivantes :

...

Ces informations permettent de s'identifier auprès d'un serveur de DIVALTO, afin d'activer les licences du site.
L'activation des licences d'un site s'effectue en appelant l'utilitaire Divalto Licenses Management Tool (DLMT) et requiert impérativement une connexion au réseau Internet depuis le serveur de licences (à défaut, depuis un des postes du site). DLMT est automatiquement lancé au moment de l'installation de l'ERP ou de Divalto Power Foundation sur un ordinateur.
DLMT est également l'outil permettant de gérer les licences du site. Il peut être exécuté à n'importe quel moment en cas d'évolution de la configuration des licences (par exemple, l'ajout de profils complémentaires ou l'affectation d'un profil existant à un autre utilisateur). Il s'exécute sur le serveur de licences ou sur un poste quelconque du réseau local connecté au serveur de licences. Il doit aussi disposer d'une connexion à Internet.
La documentation complète de DLMT peut être consultée à partir du choix Aide ce cet utilitaire.

Licences concurrentes

Ce livre décrit le système de licences prévalant pour les générations de l'ERP Divalto inférieures à la génération 10.

Principes du système de licences concurrentes

Le logiciel Harmony, ainsi que tous les logiciels diffusés par Divalto sont soumis à une licence d'utilisation. Une licence est accordée pour chaque ordinateur utilisant le logiciel (plusieurs tâches d'un même ordinateur exécutant le même logiciel utilisent une seule licence).
Pour l'ensemble des logiciels installés, un code d'utilisation devra être demandé à Divalto dans un délai de 7 jours suivant l'installation. Ce code permet de valider le droit d'utilisation des logiciels (pendant la période de 7 jours, un code d'utilisation provisoire vous est affecté).
Trois modes de fonctionnement pour la gestion des licences sont possibles :

...

Mise en oeuvre du système de licences concurrentes

Le programme d'installation de licences (xDivaltoLicense.exe) est automatiquement lancé par l'installateur après la copie des fichiers. Il permet de récupérer le code qui valide le droit d'utilisation des logiciels.
Au lancement du programme, une première boîte de dialogue affiche les renseignements déjà connus : numéro du site, nom du client, code complémentaire et code de configuration. Lors de la première installation, seuls le numéro du site (renseigné en début d'installation) et le code complémentaire sont connus.
Les choix suivants sont possibles :

...

Ajout ou retrait partiel de licences
Sur un serveur de licences opérationnel, vous pouvez à tout moment modifier la configuration des licences (à condition, bien entendu, de ne pas dépasser le quota de licences spécifié dans votre certificat). Après adaptation de la grille des licences, refaites une demande de code d'utilisation.

Désinstallation des licences
Voir la rubrique Désinstallation des licences.

Licences concurrentes temporelles

Les licences du produit EBICS TS sont accordées pour une durée initiale d'un an. Ensuite, elles sont renouvelées chaque année par tacite reconduction pour une nouvelle période d'un an. A la fin d'une période, il est nécessaire de mettre à jour le serveur de licences pour prolonger la validité des licences temporelles du produit. L'utilisateur est averti lorsque les licences du serveur doivent être actualisées.
Attention :
Au-delà d'un délai de 15 jours, le produit ne pourra plus être utilisé sans une mise à jour du serveur de licences.
Procédure de mise à jour du serveur de licences
Le serveur de licences peut être actualisé par une simple connexion au service Web de mise à jour des licences du site (voir rubrique Mise en oeuvre du système de licences) ou "manuellement" (voir rubrique Saisie manuelle du code d'utilisation).

...

Licences concurrentes de secours

Il s'agit d'une fonctionnalité soumise à conditions visant à tendre vers une haute disponibilité en cas de défaillance du serveur de licences.
Principe
Le site est équipé de deux serveurs de licences redondants. Harmony est installé sur les deux serveurs. Le serveur actif est installé avec les licences pour le site et ces licences ne sont pas installées sur le serveur de secours. En cas de défaillance du serveur actif, il convient d'activer les licences sur le serveur de secours.
Activation des licences sur le serveur de secours
Le choix de l'utilitaire xDivaltoLicense.exe "Demander des licences de secours" permet d'obtenir le code d'utilisation pour activer les licences du serveur de secours. La demande peut être effectuée par le distributeur soit par téléphone, soit par Internet.
Nombre de licences de secours
L'activation des licences de secours active la moitié des licences du serveur principal. Par exemple, pour un site comportant 40 licences Divalto Edition Complète, le serveur de secours mettra 20 licences à disposition.
Durée de validité
Les licences de secours ont une validité de 7 jours à partir de leur activation sur le serveur de secours. Si plus de 7 jours sont nécessaires pour la remise en état du serveur principal, une nouvelle demande peut être effectuée pour 7 jours supplémentaires.
Responsabilité
La responsabilité de Divalto ne saurait être engagée en cas de retard dans la fourniture du code d'utilisation pour l'activation des licences de secours, quelle qu'en soit la raison.

Saisie manuelle du code d'utilisation

Après l'installation des logiciels, vous avez 7 jours pour introduire le code d'utilisation. Passé ce délai, les logiciels ne peuvent plus être utilisés.
Pour introduire le code manuellement :

...

Cliquez sur le bouton Demander les licences manuellement. Cliquez ensuite sur le bouton Saisir le code d'utilisation.

Désinstallation des licences concurrentes

xDivaltoLicense permet de désinstaller les licences actuellement configurées sur un serveur de licences :

...

Présentation du client léger Harmony Wpf

Dans l'architecture 3 tiers d'Harmony, la couche Présentation et la couche Application métier sont séparées. Cela signifie que le processus qui exécute l'application Diva (XrtDiva.exe) est distinct du processus chargé de sa présentation (Xwpf.exe). Ces deux processus peuvent s'exécuter :

...

Options de connexion avancées

Lorsque l'utilisateur clique sur le bouton Options Avancées de la boîte de connexion, la boîte de dialogue suivante est ouverte :

Si l'utilisateur n'a pas les droits d'administration, le bouton est aussi affiché à droite du bouton Actualiser.

Les champs à saisir permettent de configurer la connexion au serveur, de sélectionner son environnement de travail, de choisir ses préférences (thème de couleurs, couleur des polices par défaut, langues d'affichage et d'impression) :

...

Passage en mode administrateur (bouton )
Lorsque l'utilisateur ne dispose pas du droit d'administration (voir la rubrique Profils de connexion), certaines options de connexion avancées ne sont pas disponibles. Un bouton en forme de cadenas est toutefois affiché pour les rendre accessibles. Pour passer en mode administrateur, cliquez sur ce bouton, renseignez le mot de passe et validez.

Conseils de mise en place d'une stratégie de sécurité Divalto

Pour obtenir une sécurité optimale lors de la connexion des utilisateurs, il est conseillé d'effectuer le paramétrage suivant :

...

Raccourcis vers l'application

Un raccourci est un lien vers un élément (tel qu'un fichier, un dossier ou un programme) de l'ordinateur. Des raccourcis peuvent être créés et placés à un endroit approprié, par exemple sur le Bureau ou dans la section Favoris du volet de navigation (le volet gauche) d'un dossier, pour pouvoir accéder facilement à l'élément avec lequel le raccourci établit un lien. Les raccourcis se distinguent du fichier d'origine grâce à la flèche qui apparaît sur l'icône.
Le raccourci permettant de lancer une application depuis le client léger Divalto est le suivant (exemple où le dossier Divalto se trouve sur le disque C) :


Raccourci vers l'application en précisant le profil utilisateur
Si l'on est amené à utiliser Divalto dans différents contextes et donc à employer plusieurs profils d'utilisation, il peut être intéressant de créer autant de raccourcis que de profils. Avec l'option "Toujours utiliser ce profil", cela permet d'ouvrir directement la fenêtre de l'application, sans répondre à aucune question préalable, quelque soit le contexte d'exécution.
Exemple :
Un commercial a besoin d'une connexion au réseau local d'entreprise lorsqu'il travaille au sein de sa société et d'une connexion par service Web lorsqu'il est en déplacement. Sur son poste, après avoir défini les profils utilisateur "Entreprise" et "Deplacement", il crée deux raccourcis (par exemple sur son Bureau) qui lui permettront de se connecter automatiquement au serveur d'applications de sa société, en utilisant l'un ou l'autre profil selon son lieu de travail.
Pour ce faire, il faut ajouter au nom de l'exécutable Xwpf.exe l'option –profil suivie du nom du profil.
Exemples :
C:\divalto\sys\Xwpf.exe -profil Entreprise C:\divalto\sys\Xwpf.exe -profil Deplacement

Paramètres avancés d'un raccourci vers l'application
D'autres paramètres peuvent être ajoutés au raccourci :

...

Outils du client léger Harmony

En plus de Xwpf, le client léger Harmony comporte quelques outils qui peuvent s'exécuter soit en mode local, soit en mode connecté au serveur d'applications (les menus de ces outils comportent des choix permettant de se connecter ou déconnecter d'un serveur).
Lors du paramétrage avec ces outils, on prendra soin de vérifier le mode d'exécution car en mode local, les paramètres sont stockés dans la base de registre du poste local alors qu'en mode connecté, ils sont stockés sur le serveur d'applications. Le mode courant (local ou connecté) est rappelé dans le bandeau de la fenêtre.
Remarque : Lorsque le client léger s'exécute sur le serveur d'applications, le mode affiché dans le bandeau est "Local" mais dans ce cas, les paramètres locaux ou serveur sont évidemment les mêmes.
DivaltoViewer
DivaltoViewer gère l'aperçu avant impression. Il peut fonctionner en mode local (par exemple, pour visualiser un fichier d'impression .dhvw stocké sur le poste local) ou en mode connecté (en liaison avec le serveur d'applications).
Lors d'une impression avec aperçu, DivaltoViewer est lancé à l'initiative du serveur d'applications et fonctionne donc en mode connecté.
xDivaltoPrinters
xDivaltoPrinters permet de paramétrer les imprimantes.
Signalons qu'un état, même destiné à être imprimé côté client, est toujours généré sur le serveur d'applications.
xDivaltoMajini
xDivaltoMajini permet de consulter ou de mettre à jour la base de registre pour les sections qui concernent Harmony. En mode local, il s'agit de la base de registre du poste client alors qu'en mode connecté, il s'agit de celle du serveur.

Client léger Harmony Web

Dans l'architecture 3 tiers d'Harmony, la couche Présentation est assurée par le client léger Harmony. Deux types de client léger coexistent : le client léger Wpf, qui s'exécute de manière classique sur un poste client équipé du système Windows, et le client léger Web (ou client léger Html) qui s'exécute à partir et dans un navigateur Web.
Ce livre présente les spécificités du client léger Web. Il contient les chapitres :

...

Remarque :
Le "Client léger Html" et "Harmony Web" sont deux produits totalement distincts, qui utilisent deux technologies différentes et ne doivent pas être confondus. Les documentations d'installation et de paramétrage de ces deux produits font d'ailleurs l'objet de livres totalement séparés.

Installation et paramétrage d'un serveur de clients légers Web

Les applications Harmony accessibles depuis un client léger Web s'exécutent sur un ordinateur qui sert à la fois de serveur Web et de serveur d'applications.
Ce premier livre décrit d'abord l'installation et le paramétrage du serveur Web , avec les chapitres :

...

Le côté serveur d'applications fait l'objet du livre Installation du serveur d'applications. Les explications qui y sont fournies restent valables pour le client léger Html, en dehors des chapitres décrivant l'installation du serveur en mode Socket et en mode Service Web qui s'appliquent uniquement au client léger Wpf. En particulier, il faut installer Harmony Power Foundation et configurer le service DhsDivaAgent sur le serveur.
Au chapitre Gestion des utilisateurs en client léger Web, ce livre décrit ensuite quelques spécificités du client léger Web.

Installation automatisée du serveur de clients légers Web

Pour installer un serveur de clients légers Web, exécutez le choix Paramétrage : Installation serveur client léger Web du menu Harmony. L'utilitaire xLcwebInstall.dhop lancé par ce choix permet :

...

Plusieurs serveurs Web peuvent être installés sur un même ordinateur, sur un ou plusieurs sites distincts (y compris le site par défaut). Un même site peut en effet héberger plusieurs applications IIS.
Des explications complémentaires concernant la configuration de l'application IIS, ainsi que les opérations réalisées par l'installateur sur ce point, sont décrites à la rubrique Création et configuration manuelles d'une application IIS sur le serveur de clients légers Web. Voir aussi la rubrique Compression des trames pour un client léger Web.
Utilisez le bouton "Ouvrir la console IIS" pour visualiser le serveur Web créé par l'installateur.

Mise à jour d'un ou plusieurs serveurs
ATTENTION :
Après une mise à jour du runtime d'Harmony, il faut impérativement actualiser toutes les instances du client léger Web créées par l'installateur .
La liste des serveurs installés par xLcwebInstall.dhop est conservée (dans le fichier DivaltoWebServer.txt) et récapitulée dans le tableau affiché sous l'onglet "Mise à jour".
Pour exécuter une mise à jour, sélectionnez le(s) serveur(s) à actualiser (Ctrl+A sélectionne tous les serveurs) et validez.
Remarque : La mise à jour d'un serveur Web "standard" (application IIS pointant le répertoire x:\Divalto\Internet\Lcweb) n'est pas nécessaire.

Installation manuelle de IIS sur le serveur de clients légers Web

Le service IIS de Microsoft doit être installé sur l'ordinateur exécutant les applications Harmony accessibles depuis un client léger Web.
Pour installer IIS
Pour installer le composant IIS de Windows (ou modifier la liste de ses fonctionnalités), sélectionnez le choix "Programmes et fonctionnalités" du Panneau de configuration, puis le choix Activer ou désactiver des fonctionnalités Windows. Sélectionnez ensuite le composant "Internet Information Services" (IIS).
Les fonctionnalités suivantes de la famille "Services World Wide Web" doivent être impérativement ajoutées (si elles ne sont pas proposées par défaut) :

...

Lorsque IIS est installé, tous les paramétrages qui le concernent s'effectuent par le Gestionnaire des Services Internet (IIS), accessible depuis le panneau de configuration, outils d'administration (voir la rubrique Création et configuration d'une application IIS sur le serveur de clients légers Web). Voir aussi la rubrique Compression des trames pour un client léger Web.

Service IIS
IIS est un service qui peut empêcher de renommer ou déplacer des dossiers si ceux-ci sont pointés par des applications IIS. La solution pour pallier cette difficulté consiste à arrêter momentanément le serveur Web. Pour cela, stoppez le service de Publication World Wide Web depuis le gestionnaire de services (Panneau de configuration : Outils d'administration : Services).

Création et configuration manuelles d'une application IIS sur le serveur de clients légers Web

Après l'installation et la configuration de IIS, tous les paramétrages le concernant s'effectuent par le Gestionnaire des Services Internet (IIS), accessible depuis le panneau de configuration, outils d'administration. Le client léger Harmony Web nécessite la création d'une application dans un site Web, attachée à un pool d'applications.
Pool d'applications IIS
Une application IIS appartient toujours à un pool d'applications. Il est possible d'utiliser l'un des pools proposés par défaut mais il est plutôt conseillé de créer un pool d'applications dédié, de manière à ne pas interférer avec d'autres applications Web. Pour créer et configurer un pool d'applications :

...

Voir aussi : Gestion des utilisateurs en client léger Web.

Compression des trames pour un client léger Web

Les clients légers Html et Wpf (en mode de connexion par service Web) permettent de dialoguer avec un serveur IIS sur lequel la compression des données a été mise en œuvre. La compression améliore sensiblement les temps d'affichage sur le poste client.
Pour activer la compression sur le serveur Web, il faut se positionner sur l'application concernée (en standard, LCWEB ou LCWEBSERVICE, respectivement pour les clients Html ou Wpf), sélectionner l'icône Compression (cadre IIS) et cocher la case "Activer la compression du contenu dynamique".
Si cette case est grisée, il est nécessaire d'installer le composant dans IIS. A partir du panneau de configuration :

...

Installation des images sur le serveur de clients légers Web

Tout site Web IIS est identifié par un alias pointant un répertoire physique du serveur. Pour des raisons de sécurité, les fichiers d'une application Web (pages html / aspx / ..., sources Java Script et CSS, images, sons, vidéos, ...) ne sont accessibles aux navigateurs que s'ils sont stockés dans une branche du disque incluse dans ce répertoire physique.
Nous avons vu précédemment comment installer un site Web IIS pour le client léger Html et le faire pointer le répertoire physique /Divalto/Internet/Lcweb (ou une copie de ce répertoire). Pour que les navigateurs aient accès aux fichiers images (et sons) référencés par les applications Harmony, il est donc impératif qu'ils soient placés sous ce répertoire physique.
Dans la suite de cette rubrique, nous prendrons comme exemple le répertoire physique "Lcweb".

Les applications Harmony référencent trois sortes d'images :

...

Attention :
Les fichiers images (fixes et variables) doivent aussi être accessibles à XrtDiva.
Un chemin implicite doit donc pointer chaque dossier contenant ce type d'images. En pratique, c'est généralement le cas à partir du moment où l'on utilise également ces images en client lourd ou léger Wpf. Si un chemin implicite ne pointe pas directement le dossier "/Lcweb/Tmp/Images", il faudra donc stocker les images fixes à deux endroits : celui habituellement utilisé pour leur affichage en client lourd ou léger Wpf et le répertoire des images du serveur Web "/Lcweb/Tmp/Images".

Installation des aides sur le serveur de clients légers Web

Pour que le client léger Web ait accès aux fichiers d'aides, il faut configurer le serveur Web de la même manière qu'un serveur d'applications classique fonctionnant en accès distant avec les aides délivrées par un serveur Web (voir le livre Installation des fichiers d'aides).

Gestion des utilisateurs en client léger Web

• En client léger Web, l'utilisateur doit se connecter en spécifiant son nom d'utilisateur et son mot de passe Windows. Le compte utilisateur "Divalto" est obligatoirement le compte Windows ayant servi à la connexion au serveur de clients légers Web. Il est donc nécessaire de créer des codes d'utilisateur "Divalto" identiques aux codes d'utilisateur Windows.

• Lors de la connexion, un profil utilisateur est demandé. Il est donc nécessaire de créer des profils utilisateur sur le serveur, en appelant le choix "Gestion des profils utilisateur" de l'interface d'accueil (accessible depuis le piano). On y indiquera le nom et le mot de passe du compte Windows de l'utilisateur, ainsi que son environnement.

Configuration du navigateur pour le client léger Web

Le client léger Html s'exécutant dans un navigateur, aucune installation n'est requise côté client.
Toutefois, le navigateur utilisé :

...

Voir aussi : Enregistrement des paramètres de l'utilisateur.

Connexion au serveur de clients légers Web

Pour se connecter à un serveur de clients légers Web, l'utilisateur doit spécifier une url de la forme :
Http://nom_du_serveur/nom_du_site_web[/ia.aspx]

...

Après validation, l'interface d'accueil est affichée.
Rappelons qu'en client léger Web, le compte utilisateur "Divalto" est obligatoirement le compte Windows ayant servi à la connexion.

Enregistrement des paramètres de l'utilisateur

Les paramètres de l'utilisateur (profil, taille des fenêtres, liste, largeur et ordre d'affichage des colonnes des tableaux, état d'ouverture des volets et des accordéons, tailles des cellules de grilles, etc.) sont stockés côté client. Toutefois, ils ne sont pas enregistrés dans la base de registres locale au poste client (inaccessible depuis un navigateur) mais dans une entité de stockage local propre au Web nommée « Local Storage » (plus ou moins similaire aux cookies).
Attention :

...

Effacement du Local Storage.
L'utilisateur peut effacer les données enregistrées dans le Local Storage de son navigateur en appelant, depuis ce même navigateur, la page LocalStorageClear.html.
L'accès à cette page se fait par l'url :
Http://nom_du_serveur/nom_du_site_web/LocalStorageClear.html
La signification des différents éléments composant cette url est donnée à la rubrique Connexion au serveur de clients légers Web.

Restrictions d'utilisation du client léger Web par rapport au client léger Wpf

Les clients légers Web et Wpf sont en grande partie iso-fonctionnels, aussi bien en ce qui concerne l'interface utilisateur que le développement d'applications. Toutefois, le client léger Web s'exécute dans un navigateur Web et certaines fonctionnalités, habituellement offertes par le système Windows et accessibles avec Xwpf, ne sont pas mises à disposition sur le Web (en particulier pour des raisons de sécurité). De plus, quelques autres fonctionnalités n'ont pas été implémentées ou sont utilisées différemment dans la version Web du client léger.
Cette rubrique présente les différences majeures entre les deux clients légers.
Les développeurs trouveront le détail des spécificités et des restrictions concernant la programmation des applications Harmony dans la documentation Xwin - Programmation.

...

Configuration et paramétrage d'Harmony

Menu d'Harmony

Dans le menu Démarrer de Windows, sélectionnez le choix <Tous les programmes : Divalto : Harmony> : le menu "système" d'Harmony Harmony.dhop est affiché. Le cas échéant, validez par "O" la création du fichier des modèles d'imprimantes Fprinters.
Remarque : le bon fonctionnement du logiciel nécessite :

...

Quelques autres paramètres sont situés dans la base de registre (section Divalto.ini).

Fichiers de configuration des serveurs et des chemins Harmony

Deux solutions sont possibles pour le stockage des tables des serveurs et des chemins Harmony :

...

Dans les deux cas, les tables peuvent être garnies à l'aide d'un zoom (voir les rubriques Déclaration des serveurs de données et Déclaration des chemins Harmony).
Remarque : Le bouton "Export dans .cfg" du zoom des serveurs ou du zoom des chemins permet de créer les deux fichiers .cfg à partir d'un fichier Fconfig existant.

Format d'une ligne "Serveur" dans la table des serveurs
<NAME>Nom<ADDRESS>AdresseIp<SQLPATH>CheminSql<COMMENT>Commentaire<TYPE>Type<OS>WINDOWS<PORT>port
Format d'une ligne "Chemin" dans la table des chemins
<NAME>NomDuChemin<PATH>CheminDuChemin<MULTIBASE>OptionMultibase<SHARENAME>NomPourLesReservations

Déclaration des serveurs de données

Harmony utilise une table de serveurs de données. Chaque élément de cette table sert à identifier un serveur (Xlan ou SQL) et à définir les paramètres nécessaires à la connexion au réseau. Les serveurs de fichiers auxquels un client doit avoir accès sont localement paramétrés dans le fichier Fconfig.dhfi ou dans le fichier texte DivaltoServer.cfg (voir la rubrique Fichiers de configuration des serveurs et des chemins Harmony).
Un zoom, accessible depuis le menu d'Harmony (choix Paramétrage : Serveurs)) ou depuis l'utilitaire Xpath.dhop (bouton Serveurs ou choix du menu Outils : Zoom des serveurs), permet ce paramétrage.
Les paramètres d'un serveur sont les suivants :

...

Les paramètres d'un serveur sont spécifiques à chaque type de réseau/serveur. Suivant le type de réseau à installer, on pourra au besoin se reporter à la rubrique :
Déclaration des serveurs Unix du client Windows. Déclaration des serveurs Windows du client Windows.
(**) Cas particulier d'un serveur SQL : pour configurer un serveur de type "SQL", appelez le programme Xpsql.dhop et consultez la documentation en ligne (XlanSql).

Chemins implicites

Sous Harmony, chaque utilisateur dispose d'une liste de chemins d'accès dits "implicites". Ainsi, lorsque le chemin d'accès complet à un fichier n'est pas précisé (ce qui est généralement le cas), Harmony le recherche d'abord en suivant le premier chemin implicite puis, si nécessaire, en suivant le second, le troisième et ainsi de suite jusqu'à trouver le fichier.
La notion de chemin implicite est détaillée au chapitre Accès aux fichiers d'Harmony.

Déclaration des chemins Harmony

Sous Harmony, les chemins d'accès aux fichiers peuvent référencer des chemins spécifiques, appelés "chemins Harmony". Leur emploi est facultatif en local mais obligatoire au niveau d'un serveur Xlan.
La notion de chemin Harmony est détaillée au chapitre Accès aux fichiers d'Harmony.
Les chemins Harmony utilisés sur un ordinateur sont localement paramétrés dans le fichier Fconfig.dhfi ou dans le fichier texte DivaltoPath.cfg (voir la rubrique Fichiers de configuration des serveurs et des chemins Harmony).
Un zoom accessible depuis le menu d'Harmony (choix Paramétrage : Chemins Harmony) ou depuis l'utilitaire Xpath.dhop (bouton Chemins ou choix du menu Outils : Zoom des chemins) permet ce paramétrage.
Chaque chemin contient les deux premiers paramètres suivants :

...

Déclaration des chemins implicites

Une liste de chemins implicites est enregistrée dans un fichier .txt (un fichier par liste). La constitution d'un tel fichier s'obtient en faisant appel à l'utilitaire Xpath.dhop.
Chaque ligne d'un fichier d'implicites contient un chemin d'accès (local ou réseau). Le nombre total de lignes n'est pas limité.
Exemples :
/divalto/sys/ d:/src/ //serveurcompta/fichiers/comptabilité
Remarques :
S'il n'est pas présent dans une liste, le chemin implicite /Divalto/Sys/ (qui mène au dossier "système" d'Harmony) est automatiquement ajouté en fin de liste.
Pour améliorer les performances, il est conseillé :

...

Fichiers de chemins implicites et utilisateurs

Chaque utilisateur déclaré dans la base des utilisateurs d'Harmony (Cf. rubrique Implantation des fichiers d'implicites sur un réseau client-serveur Harmony) peut disposer de son propre fichier de chemins implicites mais un même fichier peut aussi être affecté à plusieurs utilisateurs.
Remarque : si aucun fichier n'est spécifié dans les paramètres d'un utilisateur, Harmony lui affecte automatiquement le fichier ImplicitesDefaut.txt.
En pratique, le plus simple est de limiter au maximum le nombre de fichiers présents sur le site. A cet effet, on pourra par exemple affecter le même fichier aux utilisateurs qui exécutent les mêmes applications (et qui, par voie de conséquence, accèdent aux mêmes fichiers).
Exemple :
Sur un site, les utilisateurs LISE, JEAN, PAUL et MAX travaillent sur la compta et la gestion commerciale ; LINE et CATY uniquement sur la compta ; LUC uniquement sur la paie. On simplifie le paramétrage se limitant à 3 fichiers d'implicites :

...

Implantation des fichiers d'implicites sur un réseau client-serveur Harmony

Les fichiers d'implicites peuvent être stockés en local. Mais dans ce cas, les fichiers communs à plusieurs utilisateurs (voir l'exemple de la rubrique Fichiers de chemins implicites et utilisateurs) devront être créés plusieurs fois.
Pour éviter cette redondance, on aura intérêt à centraliser la gestion des fichiers d'implicites et donc à implanter ces fichiers sur le serveur. La centralisation de la gestion des fichiers d'implicites va de pair avec celle des utilisateurs : pour l'obtenir, il faut modifier (par XdivaltoMajIni) la clé ServeurXlogf du chapitre [System] de Divalto.ini sur les postes client (Cf. rubrique Déclaration des utilisateurs d'un réseau Harmony).
Conseils pratiques :

...

Utilisateurs d'Harmony

Tout utilisateur travaillant sous Harmony doit s'identifier, de manière à mettre en place ses chemins implicites et ses droits d'accès Harmony. A cet effet, Harmony utilise une table stockée dans le fichier XLOGF.

Déclaration des utilisateurs

La gestion de Xlogf se fait par l'utilitaire Xlog1.dhop, après identification par Xlog.dhop avec le code utilisateur ROOT.
Voir aussi : Livre "Import et synchronisation des utilisateurs d'un annuaire LDAP".

Identification automatique au lancement d'une tâche Harmony (version 6)

Par défaut, aucun code utilisateur n'est affecté à une fenêtre Harmony lancée depuis le gestionnaire de programmes de Windows. Ceci oblige l'utilisateur à s'identifier à chaque ouverture de fenêtre Harmony.
Une identification implicite (avec affectation correspondante des chemins implicites et des droits d'accès de l'utilisateur) est toutefois possible, à condition de renseigner la variable d'environnement X_USER. Pour ce faire, modifiez la base de registres pour y ajouter/modifier la clé X_USER avec la valeur correspondante dans le chapitre ENVIRONMENT de HKEY_CURRENT_USER.
Vous accédez aussi aux variables d'environnement par le panneau de configuration : Choix Système, Onglet Avancé, Bouton Variables d'environnement, cadre Variables utilisateur.
Conseil : à l'installation du run-time d'Harmony, garnissez la zone Code utilisateur pour affecter automatiquement une valeur à X_USER.
Vous pouvez donner les valeurs suivantes à X_USER :

...

Remarque : lorsque X_USER est défini, le Login est tout de même demandé, au premier chargement d'une fenêtre Harmony, si un mot de passe est défini dans Xlogf pour l'utilisateur (voir la rubrique Gestion des mots de passe Harmony).
Attention : de plus, définir X_USER n'affranchit pas du fait qu'il faut déclarer les utilisateurs dans la base Harmony, par Xlog1.dhop.

Gestion des mots de passe Harmony

Le mot de passe d'un utilisateur peut être modifié de deux manières :

...

Déclaration des utilisateurs d'un réseau Harmony

Tout utilisateur qui désire accéder à un serveur de fichiers Xlan doit être déclaré dans le fichier des utilisateurs du serveur. En principe, tous les utilisateurs du réseau doivent donc être déclarés deux fois : une fois dans le fichier Xlogf des serveurs d'applications (ou des postes client fonctionnant en mode local) et une fois dans le fichier Xlogf du serveur de fichiers !
Pour éviter cette redondance, on aura intérêt à centraliser la gestion des utilisateurs sur le serveur de fichiers.
Il faut pour cela que les clients du serveur de fichiers référence non le fichier Xlogf local (cas par défaut) mais le fichier Xlogf du serveur de fichiers. Pour ce faire, modifiez par XdivaltoMajIni le chapitre [System] de la section Divalto.ini de la base de registre des clients (serveurs d'applications ou postes fonctionnant en mode local) pour y inclure la clé :
ServeurXlogf=nom_du_serveur
où nom_du_serveur est le nom Harmony du serveur concerné.
Remarques :
La centralisation de la gestion des utilisateurs va de pair avec celle des fichiers de chemins implicites (voir rubrique Implantation des fichiers d'implicites sur un réseau client-serveur Harmony).
Xlogf est recherché : - En local, dans le dossier /Divalto/Sys/. - En réseau, dans le dossier //nom_du_serveur/Divalto/Sys/, où nom_du_serveur est le nom spécifié dans la clé ServeurXlogf de Divalto.ini.
Cas d'une installation multi-bases (mode ASP) :
Plusieurs fichiers Xlogf peuvent cohabiter sur une installation (sur un ou plusieurs serveurs). Pour déterminer le fichier Xlogf à utiliser pour un poste client, modifiez sur ce poste la valeur de la clé ServeurXlogf comme suit :

...

Attention :
Si votre serveur de fichiers est un serveur Windows et si votre site nécessite d'être sécurisé, consultez la rubrique Installation d'un serveur Xlan sécurisé.
Voir aussi :
Rubrique Installation d'Harmony sous plusieurs comptes / profils utilisateur.

Utilisateur par défaut pour Odbc

Le choix Paramétrage : Utilisateur par défaut pour ODBC du menu d'Harmony (qui lance l'utilitaire xDefautUserForOdbc) permet de définir un utilisateur par défaut, qui sera utilisé lors des connexions à Odbc pour le compte courant.
Si un utilisateur par défaut est défini, la boîte de dialogue de connexion n'est plus affichée, ce qui permet en particulier :

...

Profils de connexion

Lorsqu'un poste client léger dialogue avec un serveur d'applications, il doit préciser et paramétrer le mode de transport qui permettra de véhiculer les informations. Les paramètres à spécifier sont regroupés dans un "Profil de connexion". Un ou plusieurs profils de connexion peuvent être utilisés sur un même serveur d'applications.
Types de connexion
Il existe trois types de connexion :

...

Choix d'un profil de connexion par l'utilisateur
L'utilisateur choisit le profil adapté dans les Options Avancées de la boîte de dialogue de connexion au serveur d'applications.
Attention, un changement de profil ne concerne pas les tâches Harmony déjà chargées mais sera pris en compte lors des ouvertures de fenêtre Harmony ultérieures. Voir aussi : Profils utilisateur.
Choix d'une stratégie de sécurité pour Divalto
Lorsque l'utilisateur lance une application Divalto, une boîte de connexion est normalement ouverte pour lui permettre de (ou le forcer à) s'identifier. Plusieurs solutions d'identification sont disponibles (pour en connaître la liste et le fonctionnement, voir le paramètre Options d'identification de la boîte des Options de connexion avancées).
Au niveau du paramétrage des profils de connexion, l'administrateur peut forcer une méthode d'identification donnée pour tous les utilisateurs de ce profil ou, au contraire, laisser ces utilisateurs libres de choisir eux-mêmes leur méthode.
Voir la rubrique Conseils de mise en place d'une stratégie de sécurité Divalto.
Limitation de l'accès aux options de connexion avancées
Au niveau du paramétrage des profils de connexion, l'administrateur peut aussi préciser si l'utilisateur a toute liberté pour modifier les options de connexion avancées ou si certaines options lui sont interdites. Dans ce deuxième cas, l'administrateur qui se rend sur le poste d'un utilisateur peut, sous réserve de saisie d'un mot de passe, récupérer ponctuellement le droit d'accès à toutes les options (voir le paragraphe Passage en mode administrateur de la rubrique Options de connexion avancées).

Remarque :
Sur un poste client, les profils de connexion ne sont jamais supprimés, même s'ils n'existent pas ou plus sur le serveur d'applications, cela pour éviter de perdre une connexion qui n'aurait pas été définie ou qui aurait été supprimée côté serveur. Côté client, la suppression des profils de connexion obsolètes doit donc être effectuée à la main.
Les profils de connexion sont stockés dans la base de registre du poste client à l'adresse suivante :
HKEY_CURRENT_USER\Software\Divalto\divalto.ini\ProfilConnexion

Gestion des profils de connexion

L'utilitaire xConfigProfil.dhop permet de gérer les profils de connexion d'un serveur d'applications.
Pour y faire appel, sélectionnez le choix "Gestion des Profils de connexion en client léger" du menu "Paramétrage" du menu Harmony.
Vous pouvez créer, modifier ou supprimer des profils, à la manière habituelle avec un objet "Tableau".
Un profil de connexion comporte les paramètres suivants :

...

Profils utilisateur

Les Options de connexion Avancées du client léger comportent :

...

Remarque :
L'utilisation d'un thème de couleurs spécifique à chaque profil peut être une manière pratique d'identifier visuellement et immédiatement le contexte d'exécution de chaque fenêtre Harmony.
Création, modification et suppression de profils utilisateur
Contrairement aux profils de connexion ou aux environnements de travail, la gestion des profils utilisateur s'effectue directement sur le poste client, non pas avec un utilitaire de saisie mais depuis les Options Avancées de la boîte de connexion au serveur.
L'utilisateur peut définir un profil par défaut qui lui sera systématiquement proposé à chaque nouvelle connexion au serveur.
Si l'utilisateur ne crée pas de nouveaux profils, il utilisera le profil par défaut créé à l'installation du client léger (ce profil ne porte pas de nom mais il peut être personnalisé, en particulier pour ce qui concerne les préférences de l'utilisateur).
Remarque : Les profils de connexion sont stockés, sur le poste client, dans la base de registres de l'utilisateur (chapitre [ProfilClientLeger] de la section Divalto.Ini). Chaque profil fait l'objet d'une clé dans ce chapitre.
Choix du profil par l'utilisateur
L'utilisateur choisit son profil dans la boîte de connexion du client léger. S'il a défini un "profil par défaut", celui-ci lui est proposé à chaque nouvelle connexion au serveur. Il peut alors éventuellement sélectionner un autre profil dans la liste proposée par le multi-choix "Profil" de la boîte de connexion.
Attention, la sélection d'un profil différent ne concerne pas les tâches Harmony déjà chargées.
Raccourcis vers l'application en précisant le profil utilisateur
Si l'on est amené à utiliser Divalto dans différents contextes et donc à employer plusieurs profils d'utilisation, il peut être intéressant de créer autant de raccourcis que de profils. Avec l'option "Toujours utiliser ce profil", cela permet d'ouvrir directement la fenêtre de l'application, sans répondre à aucune question préalable, quelque soit le contexte d'exécution.
Exemple :
Un commercial a besoin d'une connexion au réseau local d'entreprise lorsqu'il travaille au sein de sa société et d'une connexion par service Web lorsqu'il est en déplacement. Sur son poste, après avoir défini les profils utilisateur "Entreprise" et "Deplacement", il crée deux raccourcis (par exemple sur son Bureau) qui lui permettront de se connecter automatiquement au serveur d'applications de sa société, en utilisant l'un ou l'autre profil selon son lieu de travail.
Pour créer ces raccourcis, reportez-vous au paragraphe "Raccourci vers l'application en précisant le profil utilisateur" de la rubrique Raccourcis vers l'application.

Installation multi-environnement

Objectif
La notion de système multi-environnement a été introduite pour donner la possibilité à un utilisateur de changer dynamiquement son environnement de travail Harmony. Ceci s'avère pratique :

...

Exemples :
Raccourci "Au bureau" :
xDivaltoSelectEnv.exe /env:"bureau" ou, si on veut lancer le menu Divalto : xDivaltoSelectEnv.exe /env:"bureau" /cmd:"c:\divalto\sys\xrtdiva.exe divalto.dhop"
Raccourci "A la Maison" :
xDivaltoSelectEnv.exe /env:"maison" ou xDivaltoSelectEnv.exe /env:"maison" /cmd:"c:\divalto\sys\xrtdiva.exe divalto.dhop"

Gestion des environnements

L'utilitaire xConfigEnv.dhop permet de gérer les environnements Harmony d'un serveur d'applications.
Pour y faire appel, sélectionnez le choix "Gestion des Environnements" du menu "Paramétrage" du menu Harmony.
Vous pouvez créer, modifier ou supprimer des environnements, à la manière habituelle avec un objet "Tableau".
Un environnement Harmony comporte les paramètres suivants :

...

Déclaration des unités imprimante et V24

Il existe deux cas pour lesquels vous devez déclarer une voie de type V24 :

...

Pour déclarer ces unités, appelez le choix <Paramétrage : Unités V24> du menu Harmony.dhop. Une unité est définie par un chemin d'accès (nom Windows du port d'entrée/sortie : COM1:, COM2:, LPT1:, LPT2:, ...), par son type (voie série ou parallèle) et, dans le cas d'une voie série, par ses paramètres de communication (vitesse, protocole, etc.).

Pool des tâches

Le pool de tâches est une fonctionnalité d'Harmony qui permet de réduire notablement le temps de chargement des programmes.
Le principe général est le suivant : Des tâches (xRtDiva.exe côté serveur et xWpf.exe côté client) restent résidentes en mémoire après la fin des programmes. Elles sont ainsi immédiatement disponibles lorsque l'utilisateur relance de nouveaux programmes. De plus, Harmony anticipe un lancement ultérieur de manière à toujours conserver au moins une tâche libre en avance dans le pool.
Exemple schématique :

...

Un nouveau pool est créé à chaque appel de l'IA. Tous les programmes ou zooms appelés ensuite depuis cet IA sont rattachés à ce pool.
Remarque : Un pool est identifié de manière unique. xConsole permet de visualiser les tâches inactives (si l'option "Filtrer les tâches inactives des pools" est désactivée). La colonne "Pool Id" indique le numéro du pool, la colonne "Pool en attente" affiche "A" pour les tâches du pool en attente.
Pour améliorer encore les temps de chargement, il est possible de paramétrer les pools de tâches : voir la rubrique suivante Paramétrage du pool des tâches.

Paramétrage du pool des tâches

Dans le but d'optimiser les temps de chargement des programmes au moment où l'utilisateur y fait appel, il est possible de paramétrer le pool des tâches sur les points suivants :

...

Divalto.ini

Gestion de Divalto.ini

Le paramétrage du système Harmony s'effectue, dans la base de registre, dans les sections HKEY_LOCAL_MACHINE\Software\Divalto\Divalto.ini et HKEY_CURRENT_USER\Software\Divalto\Divalto.ini :

...

Les paramètres d'installation ou de configuration doivent être ajoutés, supprimés ou mis à jour avec les utilitaires Harmony adéquats, à savoir xDivaltoMajIni, xDivaltoPrinters ou DivaltoViewer.
Voir aussi : Modification de Divalto.ini sous TSE
Remarque : Divalto.ini évolue au fur et à mesure des versions d'Harmony. Toutefois, en cas de mise à jour de version, le paramétrage existant n'est pas cassé. Ainsi, les adaptations qui y ont été apportées ne sont pas perdues.

Structure de Divalto.ini

Les sections Divalto.ini dans la base de registre sont structurés en CHAPITRES. Dans la documentation d'Harmony, les chapitres sont représentés entourés de crochets.
Un chapitre contient une ou plusieurs valeurs, chaque valeur étant identifiée par une clé. Dans la documentation d'Harmony, une valeur est représentée par sa clé, suivie immédiatement du caractère "=" et de la valeur proprement dite.
Attention, les espaces sont presque toujours significatifs ; par contre, les caractères majuscules et minuscules sont équivalents.
Exemple :
[System] <==> chapitre System
NbFichiersIndexes=100 <==> clé NbFichiersIndexes, valeur 100
NbFichiersDivers=20 <==> clé NbFichiersDivers, valeur 20

Configuration de la mémoire commune

La section HKEY_LOCAL_MACHINE\Software\Divalto\Divalto.ini de la base de registre contient en particulier des paramètres utilisés par le programme d'initialisation de la mémoire commune d'Harmony DhsDivalto.exe :

...

Nous recommandons de laisser les clés NbReservEntitesMax et NbReservEnregMax à leur valeur par défaut (0) et de laisser Harmony gérer automatiquement les seuils de réservations.
Dans les cas où il serait nécessaire de personnaliser les nombres de réservations, il est impératif de connaître finement les besoins minimaux de l'architecture concernée car l'utilisation des deux clés sus-mentionnées outrepasse les garde-fous précédemment en place et présente des risques de stabilité des applications pour les utilisateurs.
Attention : une modification sur ces paramètres n'est pas immédiatement répercutée (relancez Windows ou arrêtez et relancez Harmony par xDivaltoRestart.exe).

Résumé et conseils pratiques

Résumé de la procédure d'installation (serveur d'applications ou client en mode local)

1. Installation du run-time (et éventuellement de l'atelier de développement) par DivaltoInstall.exe.

2. Introduction de la clé d'activation.

3. Lancement du programme Harmony.dhop depuis le gestionnaire de programmes de Windows (groupe Divalto) ; création du fichier Fprinters : O.

4. Paramétrage du serveur de fichiers.

5. Paramétrage des chemins Harmony (facultatif hors serveur Xlan).

6. Création des fichiers de chemins implicites.

7. Création et paramétrage des utilisateurs par XLOG1.dhop.

Conseils d'installation pratiques

• Dans la table des serveurs de fichiers Harmony, identifiez les serveurs par leur nom NetBios (nom qui apparaît dans le voisinage réseau).

• Centralisez la gestion des utilisateurs et des chemins implicites. Dans le chapitre [System] de Divalto.ini des clients du serveur de fichiers (serveurs d'applications ou postes fonctionnant en mode local), ajoutez la ligne : ServeurXlogf=nom_du_serveur Remarque : la gestion des serveurs et des chemins Harmony ne peut pas être centralisée.

• Il est généralement inutile de créer des chemins Harmony sur les postes autonomes ou les clients d'un serveur de fichiers. Réservez les chemins Harmony aux serveurs Xlan.

• Limitez au maximum le nombre de fichiers de chemins implicites. Pour cela, affectez le même fichier aux utilisateurs qui exécutent les mêmes applications. Utilisez le fichier d'implicites par défaut ImplicitesDefaut.txt pour les utilisateurs "majoritaires". Créez de nouveaux fichiers uniquement pour les autres utilisateurs.

Désinstallation d'Harmony

Comment désinstaller Harmony

Après l'installation d'Harmony, le produit est répertorié comme un produit installé, dans la boîte de dialogue "Ajout / Suppression de programmes" du panneau de configuration de Windows. Pour désinstaller, il suffit de sélectionner "Harmony" dans cette boîte et d'actionner le bouton "Ajouter / Supprimer".
Cette procédure doit être utilisée en cas de changement d'ordinateur ou de changement de disque dur, afin d'obtenir une clé de désinstallation.

Opérations effectuées par le désinstallateur

La désinstallation supprime :

...

Ce certificat (ou ces informations) vous permettent de réintégrer les licences pour ce site et de les réutiliser sur un autre poste. Pour cela, vous devez transmettre ce certificat au service des commandes de Divalto.

Installation d'une application

XINSTALL.dhop est un logiciel d'installation d'applications pour Harmony sous Windows. L'installation peut se faire aussi bien sur un poste autonome que sur un poste connecté au serveur de fichiers en réseau Xlan.
Après avoir indiqué le numéro du lecteur utilisé, répondez aux questions suivantes :

...

Voir aussi :
Installation d'un serveur de données (ou d'un poste autonome)

Traduction des applications

Harmony permet d'exécuter les applications dans une autre langue que la langue utilisée lors du développement. La mise en route de cette fonctionnalité nécessite un paramétrage particulier, décrit dans le livre consacré à la traduction des applications (et en particulier à la rubrique de ce livre Paramétrage).

Connecteur Divalto pour Outlook

Le "Connecteur Divalto pour Outlook" ajoute des boutons spécifiques "Divalto" au ruban de Outlook et dans certaines de ses boîtes de dialogue.
Attention : Ce connecteur ne concerne que Outlook versions 2010 ou supérieures (32 bits ou 64 bits). Il n'est pas utilisable avec Outlook 2007.
Pour installer le connecteur depuis un client léger Html5, reportez-vous à la rubrique Connecteur Outlook pour un client léger Html5.

Composants nécessaires à l'installation du connecteur pour Outlook

L'installation et le bon fonctionnement du connecteur nécessitent le Framework .NET 4.0, VSTO 4.0 et Windows Installer 3.1 de Microsoft.
Si ces produits ne sont pas déjà installés, le programme d'installation du connecteur propose de les télécharger à partir du site Web de Microsoft prévu à cet effet : ceci nécessite bien entendu d'avoir accès à Internet au moment d'installer le connecteur.
Remarque : Pour un poste n'ayant pas accès à Internet, téléchargez ces éléments depuis le site Web de Microsoft, copiez-les sur cd-rom et installez-les sur le poste client avant d'installer le connecteur pour Outlook.
Il faut télécharger les produits suivants :

...

De plus, l'option "Prise en charge de la programmabilité .Net" doit être activée dans Office :

Installation du connecteur Divalto pour Outlook

Sur un poste où Harmony Power Foundation est installé, exécutez le fichier x:\divalto\Internet\LCWebService\index.html et cliquez sur le bouton Installer le connecteur Outlook :

Remarque : Ce choix installe aussi la dernière version de DivaltoLoadFiche.dll dans x:\Divalto\Sys (le connecteur fait le lien entre Outlook et cette dll).

Installation du connecteur Divalto pour Outlook sur un poste client léger

Attention : Quitter Outlook avant de procéder à l'installation.
Si l'utilisateur d'un client léger désire interagir avec Outlook du poste client, il est nécessaire d'installer le connecteur Outlook. Celui-ci s'installe de la même manière que le client léger :

Valider le choix « Installer ».
Le répertoire x:\Divalto\Internet\LCWebService contient l'installateur de la personnalisation de Outlook (ConnecteurDivaltoPourOulook2010.vsto ou DivaltoLoadFicheOutlook2010.vsto selon la version).
Un lien vers l'installation du connecteur Outlook apparaît également dans la page Web de l'installation du Client léger. Un simple Clic sur le lien permet de télécharger puis d'installer le connecteur.

Désinstallation du connecteur Divalto pour Outlook

Pour désinstaller le Connecteur Divalto pour Outlook, lancez le choix « Programmes et fonctionnalités » du Panneau de configuration et sélectionnez la ligne « Divalto Connecteur pour Outlook » :

Si le connecteur Divalto pour Outlook ne fonctionne pas

Le Connecteur s'installe dans les compléments d'Outlook. Pour voir cette liste, appelez le choix Fichier : Options : Compléments du menu de Outlook :




Remarque importante :
Si les boutons du connecteur Divalto pour Outlook ne s'affichent pas, vérifiez que le connecteur est bien dans la liste des compléments d'Outlook et qu'il est bien actif : Dans la fenêtre précédente, cliquez sur le bouton Atteindre… et, le cas échéant, réactivez la coche sur le complément "Divalto Connecteur pour Outlook" :

Description des boutons Divalto

Au démarrage, Outlook charge le connecteur Divalto et installe les boutons spécifiques "Divalto" dans l'onglet Divalto du ruban général et dans la boîte de dialogue de visualisation et de création des messages.
Nota bene : Outlook peut ne pas afficher immédiatement les boutons car il attend qu'il y ait un mail en cours dans sa fenêtre de droite. Il suffit alors de cliquer sur un mail pour faire apparaître les boutons. Ce comportement ne se produit qu'au démarrage de Outlook : ensuite, les boutons restent toujours présents.



Description des boutons :

...

Boutons paramétrables dans Outlook

Un programme de paramétrage de l'ERP Divalto permet de mettre en place des boutons paramétrables et de les associer à un programme Diva. Un fichier paramètre contient la description des boutons à mettre en place.
Chaque bouton est décrit par les balises suivantes :

...

Connecteur Outlook pour un client léger Html5

Une version du connecteur pour Outlook, gérant l'interface avec l'ERP sans qu'Harmony soit installé sur le poste client, permet son utilisation avec un client léger Html5. Ce connecteur dialogue avec le serveur par un service Web.
Les trois fonctionnalités offertes par le connecteur Outlook classique sont disponibles :
• L'affichage de la fiche tiers
• La génération d'un événement
• L'accès aux contacts.
Sur le poste client, il faut installer les éléments suivants :

...

Cette installation s'effectue par le choix "Installation Serveur Client léger Web" du menu "Paramétrage" d'Harmony puis par l'onglet "Autre Services Web".
Outlook du poste client
Dans Outlook du poste client, il est nécessaire d'effectuer les paramétrages particuliers suivants :

Attention : les URL du service Web et du client léger Html5 doivent rigoureusement correspondre au paramétrage effectué sur le serveur.

Cas où le serveur de webservices est différent du serveur HTML5
Dans ce cas, il faut, dans le répertoire du service web, créer un fichier DivaltoEnv.txt (il existe peut-être déjà).
Il faut y rajouter deux balises :
<Outlook_WebServer_Path> : Chemin au format Windows d'un dossier où seront stockés temporairement les éléments envoyés par le client
<Outlook_Harmony_Path> : Chemin au format Harmony de ce même dossier
En effet, le client envoie des informations via un webservice et le client HTML5 doit pouvoir y accéder. Si des deux serveurs sont distincts, il faut renseigner ces deux paramètres pour indiquer à chacun où trouver les informations envoyés par le client.

Connecteur Harmony pour Lotus Notes

Le « connecteur Harmony pour Lotus Notes » est documenté dans le fichier LotusNotes.chm.

Configuration et paramétrage du CTI

CTI est un sigle signifiant Couplage Téléphonie - Informatique. Cette rubrique décrit la configuration et le paramétrage de l'interface entre Divalto et un appareillage téléphonique, cette interface étant assurée par le module YCTI :

Choix du type d'interface
Lancez le choix « Paramétrage : Paramètres CTI » du menu Harmony.dhop :

Puis sélectionnez le type d'interface en fonction du matériel téléphonique utilisé :

...

Connecteur Divalto pour TAPI 2.0 (montée de fiche)

A la réception d'un appel entrant, un driver de téléphonie (TSP) peut, via ce connecteur, envoyer un événement à une application Harmony. La fonction « Montée de fiche » de Divalto fait par exemple appel au "Connecteur Divalto pour Tapi".
Remarque :
Le connecteur Divalto pour Tapi utilise la technologie Tapi 2.x. Il ne fonctionne pas avec un driver qui serait uniquement en Tapi 1.x ou Tapi 3.x (Tapi 3.x étant en réalité un objet COM, d'une toute autre technologie que la 1.x et la 2.x). La plupart des constructeurs de téléphonie proposent la norme Tapi 2.x.

Composants nécessaires à l'installation du connecteur Divalto pour TAPI

Pour permettre au "Connecteur Divalto pour Tapi" de fonctionner, il est nécessaire d'installer le driver TSP Tapi 2.x fourni avec votre logiciel de téléphonie.
Après l'installation, vérifiez que ce driver est visible par la couche logicielle Tapi de Windows. Pour cela, lancez le choix « Téléphone et modem» du Panneau de configuration :

Et vérifiez que votre driver TSP figure bien dans la liste des fournisseurs de téléphonie :


Attention :

...

Installation et paramétrage du connecteur Divalto pour TAPI

L'installation standard de Harmony (à partir de la version 6.3, cd 103a) installe les modules Tapi de Divalto.
Après l'installation de Harmony, lancez le choix « Paramétrage : Paramètres CTI » du menu Harmony.dhop :

...

Désinstallation du connecteur Divalto pour TAPI

Il n'y a pas de désinstallation.
Arrêtez simplement le CTI via le menu Divalto : Relation-Tiers : Utilitaires : CTI : Arrêt du CTI.

Mise en oeuvre du CTI dans Divalto

La mise en fonction du CTI se fait par le menu Divalto : Relation-Tiers : Utilitaires : CTI : Mise en fonction du CTI :


Ce choix lance le connecteur Divalto pour Tapi et affiche une fenêtre d'informations plus une icône dans la barre des tâches de Windows (zone de notification - traybar) :

Si le nom de la ligne est erroné, vous obtenez le message suivant :


Lors d'un appel entrant et si le numéro existe dans la base de données du CRM de Divalto, la fenêtre d'informations affiche les propriétés du correspondant. Le bouton à gauche permet d'appeler la fonction "Montée de fiche" (lorsque celle-ci n'est pas automatique) :


Un clic droit à la souris soit sur le bouton du Connecteur Divalto pour Tapi de la traybar, soit dans la fenêtre d'informations permet d'afficher le menu suivant :

...

Introduction

La plateforme Harmony offre la possibilité d'utiliser la suite G Suite de Google de manière similaire à Outlook, pour les entreprises possédant déjà un compte d'entreprise G Suite, ou désirant basculer vers la plateforme de Google.
Cette documentation vise à décrire le paramétrage nécessaire, aussi bien au niveau des outils Harmony que du compte d'entreprise G Suite.

Prérequis

Pour utiliser la plateforme G Suite de Google, il faut posséder un compte d'entreprise Google
Un tel compte peut être créé à l'adresse suivante : +https://support.google.com/business/answer/6085339?hl=fr+
Contrairement aux outils Google grand public, la suite professionnelle G Suite n'est pas gratuite. La tarification est à aborder avec Google à la souscription du compte d'entreprise.

Remarque :

Les interfaces d'administration de la plateforme Google Cloud Platform sont susceptibles de changer pouvant quelque peu altérer les modes opératoires décrits dans cette documentation.

Création/Sélection d'un projet

L'autorisation et le paramétrage de l'accès au compte G Suite par les outils d'Harmony, se fait via un projet sur le compte G Suite de l'entreprise cliente.
Pour ce faire, il faut se connecter sur la plateforme d'administration du compte G Suite (https://console.cloud.google.com) en disposant des droits d'administration.
Le bandeau supérieur de la page d'administration permet de sélectionner le projet courant.

L'interface de sélection de projet permet de sélectionner un projet existant, ou de créer un nouveau projet.
N'importe quel projet peut être utilisé pour l'interfaçage entre Harmony et G Suite, cependant nous conseillons fortement de créer un projet spécifique dédié uniquement à cette fonction, notamment pour permettre au client de déléguer la gestion de ce projet à son distributeur, sans risque d'impacter ou de compromettre le reste de ses projets.
Pour plus de détails sur la création et la gestion des projets, se référer à la documentation Google https://cloud.google.com/resource-manager/docs/creating-managing-projects.

Principe

Afin de dialoguer avec G Suite, les outils Harmony vont devoir utiliser un compte de service.
Il s'agit d'un compte anonyme (non rattaché à un utilisateur), permettant de réaliser certaines opérations au nom de chaque utilisateur du domaine G Suite (dans la limite de ce que l'administrateur du projet aura autorisé pour ce compte).

Création d'un compte de service

Dans les menus d'administration du projet, sélectionner le menu "IAM et administration" puis le sous-menu "Comptes de service".
Choisissez ensuite "CRÉER UN COMPTE DE SERVICE".
Il faudra donner un nom de compte. Lors de la création, il faut cocher les options indiquer une nouvelle clé privée et activer la délégation G Suite au niveau du domaine (cette option est nécessaire pour que le compte de service puisse agir sur les comptes des utilisateurs pour envoyer des mails par exemple).
Lors de la création du compte de service, une clé de compte sera également créée, stockée sous forme de fichier au format JSON.
Une fois le compte créé, il apparait dans l'interface d'administration des comptes de service. C'est ici que l'on pourra trouver l'id du compte de service qui sera utile plus tard.

Pour plus de détails sur l'administration des comptes de service, se référer à la documentation Google Cloud Platform : +https://cloud.google.com/iam/docs/creating-managing-service-accounts+

Activation de l'accès aux API

L'interface entre Harmony et G Suite se fait au moyen d'API mises à disposition par Google, mais qu'il faut activer au niveau de la console d'administration du compte G Suite (https://admin.google.com)
Ceci se fait dans le menu "Sécurité" puis "Document de référence sur les API". Vérifier que l'accès aux API est bien activé (case à cocher).

Autorisations du compte de service

Une fois que l'accès aux API est activé, il faut maintenant configurer les droits d'actions dont le compte de service disposera sur le domaine.
Dans l'interface "Sécurité" de la console d'administration du compte G Suite, ouvrir le sous-menu "Paramètres Avancés", puis sur "Gérer l'accès au client API".
C'est ici que l'on va associer les droits d'action au compte de service que nous avons créé plus dans les étapes précédentes.
Le compte de service est identifié grâce à son Id.
Dans la zone de saisie destinée à recevoir les droits, il faut énumérer chacun des droits, séparés par des virgules, mais sans espace.

...

La chaîne finale à coller dans la zone de saisie des droits est donc ; https://www.googleapis.com/auth/calendar.readonly,https://www.googleapis.com/auth/contacts.readonly,https://www.googleapis.com/auth/tasks.readonly,https://www.googleapis.com/auth/gmail.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.member.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/contacts,https://www.googleapis.com/auth/tasks,https://www.googleapis.com/auth/gmail.send,https://www.googleapis.com/auth/gmail.insert,https://www.googleapis.com/auth/gmail.metadata,https://www.googleapis.com/auth/gmail.compose,https://www.googleapis.com/auth/gmail.modify,https://www.googleapis.com/auth/gmail.labels

Activation des API

Les API doivent maintenant être activées au niveau du projet.
Dans la console d'administration Google Cloud Platform (https://console.cloud.google.com/home), allez dans le menu "API et Services" puis le sous-menu "Bibliothèque".
Les API à activer pour le lien avec Harmony sont les suivantes :

...

Création d'un attribut personnalisé pour les comptes G Suite.

Une fois connecté à la console d'administration du compte d'entreprise G Suite (https://admin.google.com), il faut se rendre sur la page d'administration des utilisateurs.
De là, il faut aller dans la section de gestion des attributs personnalisés (Menu "Plus > Gérer les attributs personnalisés" comme indiqué dans la capture d'écran ci-dessous).


Il faut ensuite créer l'attribut personnalisé "DivaltoInfinityWinAccount" (cliquer sur "Ajouter un attribut personnalisé"). Saisir le nom (DivaltoInfinityWinAccount) dans les champs Catégorie et Nom du nouvel attribut à créer. On peut aussi saisir une Description.
Cet attribut devra avoir les propriétés suivantes :

...

Attribution des comptes Windows aux comptes G Suite.

Sur la page d'administration des utilisateurs, sélectionner un compte d'utilisateur.
Sur la page de l'utilisateur, étendre la section "Information utilisateur", puis aller à la catégorie "DivaltoInfinityWinAccount" et cliquer sur "Ajouter DivaltoInfinityWinAccount".
Renseigner le compte Windows qui pourra utiliser le compte utilisateur G Suite en cours de paramétrage, puis sauvegarder les modifications ("Enregistrer").
On peut associer plusieurs compte Windows à un même compte utilisateur G Suite.
Il faut répéter cette opération pour chaque utilisateur G Suite.

Paramétrage des serveurs Harmony.

Il faut maintenant permettre au serveur d'application Harmony de récupérer et exploiter ces nouvelles informations.
Pour cela, il faut lancer le programme diva xdivaltoparammapigsuite.dhop.
Ce programme va lire la liste des utilisateurs G Suite et extraire les comptes Windows associés à chaque utilisateur (en accédant à l'attribut personnalisé qui a été paramétré dans les étapes précédentes).

Il est nécessaire de renseigner un compte d'utilisateur G Suite (service@diva.com dans la capture ci-dessus). Ce compte DOIT disposer des droits d'accès en lecture aux informations des utilisateurs.
Pour autant, ce compte n'a pas besoin de droits d'administration, et non recommandons de ne pas utiliser un compte d'administration pour cette opération.
Remarque :
Les opérations décrites dans cette section rendent obsolète la Saisie des comptes G Suite dans Divalto Infinity.
Si des comptes G Suite ont déjà été renseignés dans l'ERP par des utilisateurs, il est conseillé que ceux-ci suppriment les paramètres qu'ils ont saisis car il pourrait y avoir conflit avec les DivaltoInfinityWinAccount du compte G Suite.

...