Accès aux fichiers d'Harmony
Ancre
Un "nom de fichier complet" est le nom qui permet d'identifier un fichier (ou un programme) de manière absolue dans l'ordinateur. Par exemple :
c:/divalto/sys/xtools.dhop
d:/fichiers/comptabilité/c3f.dhfi
Le "chemin d'accès" est la suite de dossiers menant au fichier. Dans l'exemple :
c:/divalto/sys/
d:/fichiers/comptabilité/Ancre
Chemins Harmony
Pour raccourcir les noms de fichier ou convenir de noms de chemin plus parlants, des "chemins Harmony" peuvent remplacer tout ou partie des chemins d'accès réels aux fichiers.
Par exemple :
Divalto | c:/divalto |
Compta | d:/fichiers/comptabilité |
Si un nom de fichier Harmony commence par "/", le premier segment du chemin d'accès est un nom de chemin Harmony : ce nom sera remplacé par le chemin réel qu'il représente pour donner le nom de fichier complet. Par exemple :
/Divalto/sys/xtools.dhop ==> c:/divalto/sys/xtools.dhop
/Compta/c3f.dhfi ==> d:/fichiers/comptabilité/c3f.dhfi
Remarque : Chaque ordinateur dispose de sa propre table de chemins Harmony. L'emploi de chemins Harmony est facultatif en local mais obligatoire au niveau d'un serveur de réseau Xlan, comme nous allons le voir dans les rubriques suivantes.Ancre
Noms de fichier en réseau Xlan
Pour ses accès réseau, Harmony utilise une table de serveurs. Chaque élément de cette table sert à identifier un serveur et à définir les paramètres nécessaires à la connexion réseau. Par exemple :
...
Le nom d'un fichier situé sur le réseau doit commencer par "//" suivi du nom du serveur dans la table. Xlan client réalise la connexion réseau, élimine le nom du serveur et transmet, telle quelle, la partie restante du nom du fichier au serveur. Par exemple :
Nom du fichier Nom du fichier Xlan client transmis au serveur //ServeurGestion/Fic/fichier ----> /Fic/fichier
Derrière le nom du serveur, il est interdit, pour des raisons de sécurité ( * ) , de spécifier un nom de fichier complet : le nom du serveur doit être suivi du nom d'un chemin Harmony (déclaré et interprété sur le serveur). Ainsi :
//ServeurGestion/CheminHarmony/fichier.dhfi est un nom de fichier valide dès lors que CheminHarmony est bien déclaré dans la table des chemins Harmony du serveur.
//ServeurGestion/c:/divalto/fichiers/fichier.dhfi est par contre invalide.
( * ) Cette règle assure que l'utilisateur passant par Xlan depuis son poste client ne peut accéder qu'aux seuls dossiers référencés par des chemins Harmony déclarés sur le serveur. Si les noms tels que //serveur/c:/…étaient autorisés, l'utilisateur aurait la possibilité d'explorer n'importe quel dossier du serveur via Xlan.
Remarque :
Il est possible de déclarer sur un poste client un chemin Harmony faisant référence à un serveur et d'utiliser ensuite ce chemin pour accéder à un fichier réseau. Par exemple, le fichier //ServeurCompta/d:/fichiers/comptabilité/c3f.dhfi pourra s'appeler /Compta/c3f.dhfi avec le chemin Harmony Compta déclaré localement :
Compta | //ServeurCompta/Fic |
et le chemin Harmony Fic déclaré sur le serveur ServeurCompta :
Fic | d:/fichiers/comptabilité |
Exemple complet de traduction d'un nom de fichier :
Client : /Compta/c3f.dhfi
Table des chemins du client Compta <=> //ServeurCompta/Fic
==> //ServeurCompta/Fic/c3f.dhfi
Table des serveurs du client ServeurCompta <=> 192.0.1.1
Serveur : /Fic/c3f.dhfi
Table des chemins du serveur Fic <=> d:/fichiers/comptabilité
==> Sur le serveur 192.0.1.1, accès à d:/fichiers/comptabilité/c3f.dhfi
Remarques importantes :
Chaque ordinateur dispose de sa propre table de serveurs.
Un chemin Harmony serveur doit mener sur celui-ci à un dossier local : en effet, Harmony ne permet pas d'appeler plusieurs serveurs "en cascade".
Comme nom de serveur, il est conseillé de prendre le nom NetBios de l'ordinateur (le nom qui apparaît dans le voisinage réseau). Dans ce cas uniquement, vous pourrez utiliser les mêmes chemins Harmony sur le client et sur le serveur (ce qui est pratique lorsque le serveur est lui-même utilisé comme poste de travail, car les chemins implicites attachés aux utilisateurs pourront être partagés entre clients et serveur). Exemple : le serveur a pour nom NetBios ServeurGestion et les postes clients ont une entrée dans leur table de serveurs référençant ServeurGestion. Pour ces clients, un nom de fichier réseau aura la forme : //ServeurGestion/CheminHarmony/… Sur le serveur, le fichier est local mais il est tout de même possible de lui affecter ce même nom de fichier : Harmony détectera que le nom du serveur correspond au nom NetBios de l'ordinateur et accédera localement au fichier.
| Ancre | ||||
|---|---|---|---|---|
|
Chemins d'accès implicites
Dans la plupart des cas, on ne précise pas sous Harmony le nom complet d'un fichier mais uniquement son nom proprement dit.
Par exemple, pour appeler le programme Xtools.dhop, on va saisir uniquement Xtools.dhop et non son nom complet c:/divalto/sys/xtools.dhop. De même, une application qui traite le fichier c3f.dhfi ne va pas ouvrir d:/fichiers/comptabilité/c3f.dhfi mais simplement c3f.dhfi.
Deux raisons à cela : pour les utilisateurs, ne pas être obligé de préciser le nom complet des fichiers dans les dialogues ; ne pas figer l'emplacement physique des fichiers au niveau des programmes : c'est l'installateur qui décide de cet emplacement et non le développeur.
Pour ce faire, Harmony affecte à chaque utilisateur une liste de chemins d'accès dits "implicites" : si le chemin complet d'un fichier n'est pas indiqué, Harmony le recherche d'abord dans le premier dossier implicite puis, si nécessaire, dans le second, le troisième et ainsi de suite jusqu'à trouver le fichier ; ce n'est que si la dernière tentative échoue à son tour que le système détectera un "Fichier non trouvé".
Le format des chemins implicites est identique au format des noms de fichier (mnémonique du fichier proprement dit exclus). Les chemins implicites sont stockés dans des fichiers .txt, où chaque ligne contient un chemin.
Exemple :
Avec le fichier d'implicites suivant :
/divalto/sys/
d:/src/
//serveurcompta/fic/
l'accès au fichier c3f.dhfi sera successivement tenté avec les noms suivants :
/divalto/sys/c3f.dhfi (<=> c:/divalto/sys/c3f.dhfi)
d:/src/c3f.dhfi
//serveurcompta/fic/c3f.dhfi (<=> d:/fichiers/comptabilité/c3f.dhfi sur serveurcompta)
Après concaténation du chemin implicite et du nom de fichier, Harmony applique les règles de traduction des noms de serveur et de chemin Harmony décrites précédemment.
Utilisez l'utilitaire Xpath.dhop pour gérer vos fichiers de chemins implicites.
Par Xlog1.dhop, associez un fichier de chemins implicites à chaque utilisateur.
| Ancre | ||||
|---|---|---|---|---|
|
Règles générales applicables aux noms de fichier Harmony
Dans tous les cas :
Le nom complet d'un fichier (chemin d'accès + nom proprement dit) ne doit pas dépasser 255 caractères.
Les utilitaires et outils d'Harmony limitent la longueur du fichier proprement dit à 32 caractères.
Aucune distinction n'est faite entre caractères minuscules et majuscules, à quelque niveau que ce soit (serveur, "chemin Harmony", unité disque, dossier, nom de fichier).
Dans les chemins d'accès, les séparateurs "\" et "/" peuvent être employés indifféremment.
Le chemin Harmony Divalto est prédéfini : il correspond au dossier x:/Divalto où x est l'unité disque sur laquelle a été installé le run-time d'Harmony.
Le dossier /Divalto/Sys est réservé aux fichiers et utilitaires "système".
| Ancre | ||||
|---|---|---|---|---|
|
Paramétrage des serveurs Harmony
Pour ses accès réseau à partir d'un poste client, Harmony utilise une table de serveurs. Chaque élément de cette table sert à identifier un serveur Harmony et à définir les paramètres nécessaires à la connexion au réseau. Le passage par cette table de serveurs est obligatoire en réseau Xlan.
Les serveurs Harmony sont localement déclarés dans le fichier /divalto/sys/Fconfig.dhfi. Les paramètres d'un serveur sont les suivants :
Numéro de serveur | Clé d'identification dans le fichier des serveurs. |
Nom de l'ordinateur | Mnémonique identifiant le serveur Harmony (32 caractères maximum). |
Adresse | Cette zone dépend du type du serveur :
|
Chemin SQL | Utilisé uniquement pour les entrées de type « Base SQL ». Représente la localisation du répertoire contenant les fichiers et les dictionnaires de la base. Par défaut, c'est « /divalto/nom de la base ». Via ce paramètre, on peut modifier cet emplacement. Par exemple : « /divalto/bases/client1/erpdivalto ». Pour les programmes, ce paramétrage est transparent. On continue à accéder à la base via le chemin « //serveur/nomBase/fichier.dhfi ». |
Commentaire | Texte libre. |
Type | Groupe de boutons radio précisant le type de serveur : |
Système d'exploitation du serveur | Système sur lequel tourne le serveur : Unix ou Windows. |
Numéro de port | Numéro du port TCP/IP du serveur Xlan : ce numéro doit être égal au paramètre NumeroService du fichier Divalto.ini du serveur. |
( * ) 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).
| Ancre | ||||
|---|---|---|---|---|
|
Paramétrage des chemins Harmony
Les chemins Harmony utilisés sur un ordinateur sont localement déclarés dans le fichier /divalto/sys/Fconfig.dhfi. Chaque ligne contient les deux premiers paramètres suivants :
...
| Ancre | ||||
|---|---|---|---|---|
|
Paramétrage des chemins implicites
Sous Harmony, chaque utilisateur dispose d'une liste de chemins d'accès dits chemins 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.
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/
Remarques :
...
Implantation des fichiers d'implicites en réseau
Les fichiers d'implicites peuvent être stockés en local. Mais dans ce cas, les fichiers communs à plusieurs utilisateurs (voir l'exemple précédent) 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. Pour demander à Harmony de chercher les fichiers d'implicites sur le serveur plutôt qu'en local (la recherche en local étant la méthode par défaut), il faut modifier le chapitre [System] du fichier Divalto.ini des postes client pour y faire figurer la ligne :
ServeurXlogf=nom_du_serveur
où nom_du_serveur est le nom Harmony du serveur concerné dans la table des serveurs.
Remarques :
Sur le serveur, les fichiers d'implicites doivent être rangés dans le dossier /Divalto/Sys.
La centralisation de la gestion des fichiers d'implicites va de pair avec celle des utilisateurs.
...