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).
L'utilisation d'instances supplémentaires vous permet de disposer de différents fichiers d'implicites sur un même environnement.

• Une instance est toujours en lien avec une variante sans forcément que cette dernière soit active. Cette affirmation n'est pas valable pour l'instance par défaut.

• Chaque couple instance/variante va disposer de sa propre arborescence d'éléments spécifiques avec les déclarations associées dans les fichiers d'implicites.

• Plusieurs variantes peuvent exploiter la même instance.

Les fichiers d'implicites intègrent les trois éléments indiqués ci-dessous à l'exception de l'instance par défaut qui n'intègre pas la notion de variante.

• Des déclarations communes (Socle commun)

  • Dossiers de programmes standards (Objets, sources, hotfix, ...)

  • Base de données

  • Dossiers de l'environnement (fichiers, transfert, ...)

  • Pack DSN (optionnel)

• Des déclarations complémentaires (Instance)

  • Dossiers de programmes spécifiques (Objets, fichiers, sources, navigation, projets, ...)

  • Définition d'un ou plusieurs Addons (optionnel)

• Des déclarations alternatives optionnelles en complément (Variante)

  • Dossiers de programmes spécifiques (Objets, fichiers, sources, navigation, projets, ...)

La notion de variante peut s'avérer utile si vous souhaitez appliquer une même base d'éléments spécifiques à des utilisateurs (affectés au niveau d'une instance) mais avec certaines particularités en fonction des cas d'usage. Chaque cas particulier disposera de sa variante et donc de son propre fichier d'implicites tout en conservant les éléments communs à un seul emplacement sur l'instance.
Le programme de gestion des fichiers d'implicites vous donne la possibilité de créer de nouvelles instances et d'y associer une ou plusieurs variantes en utilisant le bouton « Créer une instance/variante » à partir du menu.

L'opération s'effectuera sur l'environnement sélectionné. Vous serez en mesure de pouvoir définir un nom pour une nouvelle instance (ou de sélectionner une instance existante) puis un nom pour la variante (même si vous ne comptez pas exploiter cette dernière dans l'immédiat).
Le nom de l'instance est limité à 6 caractères et le nom de la variante est limité à 4 caractères. Vous pouvez sélectionner une instance existante dans le but d'ajouter une variante supplémentaire.
Par défaut, les éléments associés à la variante sont désactivés. L'activation de la variante peut également s'effectuer par la suite.
Dès lors qu'un nouveau couple instance/variante existe, le menu de sélection vous proposera de le sélectionner. Vous devez également choisir le type de clients (Administrateur / Utilisateur) afin d'interagir avec le fichier d'implicites souhaité.

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 associés aux nouvelles instances est réalisé de la manière suivante : « Implicites(Type){}(Instance){}(Variante).txt ». Le nommage de l'instance par défaut se limite à « Implicites(Type).txt »

• « ImplicitesDefaut_Inst1_Var1.txt » : Fichier d'implicites minimaliste orienté utilisateur de l'instance 'Inst1' avec la variante nommée 'Var1'.

• « ImplicitesAdmin.txt » : Fichier d'implicites complet orienté administrateur de l'instance fournie par défaut (standard) avec chaque environnement

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.

...

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 » :

...

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.