La configuration des composants de votre environnement se gère à l'aide de ce programme. Vous serez ainsi en mesure de configurer les éléments suivants :
Déclaration des ressources (Fichiers d'implicites)
Service d'indexation (Search)
Traitements en tâche de fond (Services Diva)
Echanges de données SOAP (Services Web)
Accès depuis des terminaux codes-barres (Telnet)
Gestion des fichiers d'implicites
Le menu « Implicites » de l'outil d'administration vous permet de modifier le contenu des fichiers d'implicites. Chaque environnement dispose par défaut d'une seule instance de base. Chaque instance est systématiquement composée de deux fichiers d'implicites. Le premier est destiné à l'exploitation (Utilisateur) et le second à l'administration et au développement (Administrateur).
Remarques :
Les modifications effectuées se reflètent automatiquement dans la prévisualisation du contenu du fichier d'implicites.
Les modifications sont apportées indépendamment sur chaque type de fichier d'implicites (Administrateur / Utilisateur) pour chaque couple d'instance/variante et ceci est valable pour chaque environnement.
Chaque section du programme doit faire l'objet d'une validation (Touche F10) afin d'enregistrer la saisie et de déverrouiller les autres sections.
L'instance 'standard' correspond à l'instance fournie par défaut et qui s'applique si aucune autre instance n'existe.
Pour supprimer une instance/variante, vous devez d'abord sélectionner celle-ci. Les fichiers contenus dans la structure ne seront pas automatiquement supprimés. Vous devrez préalablement veiller à ce qu'aucun utilisateur ni modèle n'exploite cette configuration.
La section « ERP Divalto » vous délivre des informations relatives aux versions exploitées sur votre environnement. Si vous souhaitez modifier ces versions, vous devez utiliser l'outil « xCloudManage ». L'outil vous affichera les versions des éléments indiqués ci-dessous :
Version de l'ERP
Version du Service Pack ERP
Groupe de hotfix
Version Pack DSN (Si applicable)
La section « Spécifiques » interagit sur l'activation ou la désactivation des déclarations concernant les programmes spécifiques ou uniquement sur les programmes spécifiques en cours de validation (specifs\tmp). Par défaut, les programmes spécifiques sont actifs mais les programmes spécifiques en cours de validation ne le sont pas.
La section « Add-ons » gère l'activation et l'ordre des Add-ons. Chaque site est associé à un distributeur et ce dernier à la possibilité de mettre à disposition de ces clients des Addons.
L'outil supporte plusieurs versions différentes d'un même « Addon » et optionnellement des hotfix associés à chaque version.
Plusieurs « Addons » peuvent être actifs sur un même environnement et l'ordre de déclaration au niveau des fichiers d'implicites est réglable en utilisant les flèches du menu.
Par défaut, les sites sont associés mais n'ont pas accès aux « Addons » de leurs distributeurs respectifs. Une demande au centre de support est nécessaire pour que les Addons souhaités soient disponibles dans le tableau du site concerné.
Le nommage des fichiers d'implicites est réalisé de la manière suivante : « Implicites(Type).txt ».
« ImplicitesDefaut.txt » : Fichier d'implicites minimaliste orienté utilisateur.
« ImplicitesAdmin.txt » : Fichier d'implicites complet orienté administrateur.
Ces noms de fichiers d'implicites peuvent être définis par exemple sur un modèle d'utilisateur.
Gestion des paramètres des Services Divalto PowerSearch
La gestion du service « DhsSearchServer » permet la configuration des paramètres du service d'indexation. Ce service étant propre à chaque environnement, il vous sera demandé de sélectionner l'environnement souhaité avant de poursuivre.
Le programme affiche et permet de modifier les différents fichiers de configuration dont les principaux sont :
Le fichier « search_param.xml » qui ne doit pas être modifié car il contient les paramètres nécessaires au fonctionnement du service.
Les fichiers « dico_document_xxx.xml » qui contiennent les dictionnaires de documents en relation avec chaque domaine fonctionnel. Vous pouvez éditer les dictionnaires de documents existants dans le but d'y ajouter des données spécifiques.
Le fichier « search_scheduler.xml » qui permet de définir la périodicité des indexations
Le fichier « search_security.xml » qui contient la correspondance entre les noms des serrures associées aux documents et les codes d'accès de l'utilisateur permettant d'ouvrir ces serrures (donc d'accéder aux documents). Ce fichier étant présent par défaut, les confidentialités s'appliquent aux résultats des requêtes Search.
Après modification ou création d'un nouveau fichier de configuration, vous devez recharger la configuration en utilisant l'action « Relire les paramètres ». Certaines modifications, notamment au niveau de la sécurité, nécessitent une nouvelle indexation du document impacté.
Lors de l'édition d'un fichier, la touche « F10 » vous permettra d'enregistrer vos modifications.
Gestion des paramètres des Services Diva
Les services Diva gèrent les traitements en tâche de fond comme (Scrutateurs, BPM, ...)
L'administration des « Services Diva » (Divalto DhsServices) permet de visualiser et de modifier la définition des services (Ajout/Suppression de services). Vous pourrez également contrôler l'état de chaque service Diva (Arrêt / Démarrage).
La configuration des services Diva s'applique à l'ensemble des environnements d'un même site.
L'écran principal affiche la liste des services qui sont actuellement déclarés. Par défaut, aucun service ne figure dans cette liste. Vous pouvez démarrer ou arrêter chaque service en fonction de vos besoins. Le bouton « Editer » permet d'ouvrir la configuration du fichier « DhsServices.txt » qui contient la définition des services.
Ce fichier étant global à l'ensemble des environnements du site, nous vous invitons à suffixer les noms des services par le nom de l'environnement. Le nom du service doit impérativement être unique.
Le programme doit être disponible dans l'environnement concerné
L'utilisateur « $Service » peut être utilisé pour exécuter ces programmes. Il n'est pas nécessaire d'affecter de licence à ce compte.
Les modifications doivent être validées par la touche « F10 »
Gestion des paramètres des Services Web Diva
Les services Web Diva permettent de réaliser des échanges de données avec des programmes tiers. Un code action est défini en association avec le programme qui sera en charge du traitement de la demande.
Vous avez la possibilité de définir de nouvelles actions ou de modifier / supprimer des actions existantes. Vous ne pouvez cependant pas modifier les actions « DLMT_SYNCHRO » et « SYNCHRO_INFINITY_AGILEO » car elles sont nécessaires au bon fonctionnement de votre environnement Divalto.
Vous pouvez spécifier pour chaque action les modes d'accès que vous autorisez (REST, SOAP, Webhook). Par exemple, si un code action ne sera utilisé qu'avec le mode REST, il est recommandé de désactiver SOAP.
L'adresse du service Web intègre votre numéro de site ainsi que le nom de l'environnement :
REST : https://api.divaltocloud.com/[NUMEROSITE]/[ENVIRONNEMENT]/api/v1/...
SOAP : https://websvc.divaltocloud.com/[NUMEROSITE]/[ENVIRONNEMENT]/WebServiceDiva.asmx
Gestion des paramètres REST
L'API REST RecordSQL nécessite de déclarer au préalable la liste des fichiers DHOQ qui seront utilisés.
Cette déclaration permet d'autoriser l'accès à ces fichiers au travers de l'API REST RecordSQL mais également de générer les fichiers XML associés aux fichiers DHOQ.
Cette seconde étape est nécessaire afin de mettre en cache les éléments dans une optique d'optimisation des performances. Elle permet également de générer les documentations en lien avec chaque fichier DHOQ que vous pourrez ensuite consulter.
Pour ajouter un nouveau fichier DHOQ, vous pouvez utiliser le raccourci clavier 'F8' puis sélectionner le fichier souhaité dans la liste. En cas d'ajout ou de suppression de fichier dans cette liste, vous devrez patienter jusqu'à 10 minutes pour que la configuration soit prise en compte.
Lors de la validation de vos modifications, il vous sera proposé de générer les fichiers XML qui contiendront la liste des RecordSQL, les dictionnaires de données et les documentations associées. Il est important d'effectuer cette opération afin de bénéficier de l'ensemble des fonctionnalités et d'optimiser les performances de l'API. Vous pouvez réaliser cette opération à tout moment en utilisant le bouton « Liste des records SQL » notamment si vous réalisez des modifications sur les fichiers DHOQ ou les dictionnaires de données.
La fenêtre de génération des fichiers XML requiert de vérifier le chemin des objets DHOQ puis éventuellement de compléter le chemin des surcharges des objets DHOQ.
Le traitement peut nécessiter plusieurs minutes selon le nombre de fichiers à traiter. Un rapport complet s'affiche à la fin de l'opération.
A la suite de la définition des fichiers DHOQ puis de la génération des fichiers XML, vous pouvez :
Utiliser l'API REST RecordSQL (Se référer au chapitre concernant l'utilisation de ce service)
Consulter les fichiers XML générés (Bouton « Lire les fichiers XML »)
Consulter les documentations associées à chaque fichier DHOQ afin d'obtenir des informations sur la manière d'exploiter les RecordSQL (Bouton « Lire la doc sur un record SQL »)
Exemple d'affichage de la documentation du RecordSQL « CODEPOSTAL » lié au fichier « GTRSTAB.DHOQ » :
Gestion des paramètres Telnet
La configuration du service Divalto Telnet est propre à chacun des environnements pour lesquels vous disposez d'un service Telnet. Vous pouvez accéder à la configuration du service par l'outil d'administration Cloud (xCloudAdmin) qui figure dans le menu suivant : « Administration > Paramètres > Cloud »
Remarques générales :
Chaque service Telnet est associé à un environnement Divalto ERP
Un numéro de port est attribué à chaque environnement
L'interface permet d'éditer la configuration des services Telnet associés aux environnements pour lesquels vous disposez du service. Vous pourrez modifier certains paramètres dont :
L'activation ou la désactivation de chaque service
Le nom du programme à exécuter lors d'une connexion client
Le programme indiqué doit figurer au sein de l'un de vos chemins d'implicites
Par défaut le programme « demoxtelnet.dhop » est défini
Le message d'accueil à la connexion en utilisant 'MSGCONNECT'
Le fichier de définition des touches
« vt220.txt » pour l'émulation vt52/vt100/vt220 (Par défaut)
« ttelnet.txt » pour l'émulation de base
Des paramètres optionnels de 'PARAMSYTELNET' ou 'PARAMSHARMONY' (à indiquer entre guillemets)
L'écran principal détaille les services Telnet associés à votre site.
Pour chaque service associé à un environnement, vous pourrez modifier les paramètres (Nom du programme, message d'accueil, paramètres optionnels).
Les modifications sont prises en compte automatiquement dès validation de la fenêtre principale. Les sessions Telnet qui sont en cours d'exécution ne sont pas affectées par ces changements.