Les noms

Cette leçon explique la notion de nom utilisée pour faciliter le déploiement rapide de modules.

A chaque bloc Storga (paragraphe, formulaire, état, page, etc) est associé un identifiant unique et stable. Cette identifiant qui dans la version actuelle de Storga prend la forme 'nom_du_site / id_du_document / id_du_bloc' peut être consulté, en mode éditer, en affichant les propriétés du bloc : il est alors indiqué au niveau de la ligne de sous titre 'Références ...'

Un programme Storga, qui souhaite utiliser un état pour trouver le nom correspondant à un code SIRET, pourrait utiliser l'identifiant du bloc. Par exemple :

var Str s nn := lookup "test/BOM4GBZM/0KD3EE701" siret organisation s

'var Str s n' déclare deux variables s et n de type chaîne de caractères.
L'instruction 'lookup' se lit de la manière suivante : dans le formulaire dont l'identifiant Strorga est 'test/BOM4GBZM/0KD3EE701' chercher la ligne dont la valeur de la colonne 'siret' est 's', et retourner la valeur de la colonne 'organisation' sur cette même ligne. Autrement dit, trouver le nom de l'organisation correspondant au code SIRET indiqué.

En pratique, on préférera attribuer un nom à l'état, par exemple 'organisations_list', puis écrire le programme sous la forme :

var Str s nn := lookup @organisations_list siret organisation s

Attribuer un nom

Généralement, on a besoin d'attribuer des noms à trois types de blocs, qui sont les formulaires, les états et les page, mais la manière de le faire varie :

Type de bloc	Le nom se trouve indiqué
Formulaire	On attribue pas le nom au niveau du formulaire. On encapsule le formulaire dans un bloc modèle, puis on rempli le champ 'Nom du modèle dans les programmes' au niveau des propriétés de ce bloc modèle.
Etat	On rempli le champ 'Nom de l'état dans les programmes' au niveau des propriétés du bloc état.
Page	On rempli le champ 'Nom de la page dans les programmes' au niveau des propriétés de la page. Il existe deux manières d'accéder aux propriétés d'une page : Soit depuis la page en question, en mode éditer, en cliquant sur l'icône 'Page' (juste sous le mot 'action'). Soit depuis la page mère, où la page est affichée sous la forme d'une ligne avec un triangle suivit du titre de la page. On clique alors, en mode éditer, sur le triangle pour sélectionner la page, puis sur le bouton 'Propriétés' au niveau du menu contextuel de la page.

Visualiser la liste des noms

Revenir à la page racine de votre site, puis en mode éditer, cliquer sur l'icône 'Page'. (juste sous le mot 'action')

Vous pouvez constater / vérifier, que le champ 'Type de page' est positionné sur 'répertoire'. Ensuite, utilisez le lien 'Voir les noms défini dans les sous pages' juste dessous pour accéder à la liste des noms défini au niveau du site. Chaque nom est affiché sous la forme d'un lien vers la page où se trouve le bloc portant ce nom (sauf pour les pages où le lien conduit directement au contenu de la page portant le nom).

Corriger les conflits de noms

Si vous attribuez le même nom à deux blocs, le nom pointera vers le premier.
Les problèmes commencent si vous supprimer ce premier bloc, ou que vous changez son nom. En effet, on attendrait que Storga fasse automatiquement pointer le nom vers le second, mais ce n'est pas toujours automatique. Souvent, il faudra accéder aux propriétés du second bloc définissant le nom, puis changer deux fois la valeur du champ nom pour que le 'mapping' du nom vers ce second bloc s'établisse correctement. En cas de doute, revenir sur la page racine du site, visualiser la liste des noms, et cliquer sur le nom pour lequel on a un doute, pour voir à quelle page il mène. Quand vous être dans la page en question, en mode visualiser, vous pouvez cliquer sur l'icône boussole pour visualiser où elle se trouve dans l'arborescence du site Storga.

Utilisation avancée des noms

Le paragraphe qui suit ne s'adresse qu'aux utilisateurs très expérimentés de Storga. Il n'est pas nécessaire de le comprendre avant de poursuivre votre autoformation.

Nous venons de voir que la liste des noms défini pour un site Storga se trouve généralement au niveau de la page racine du site, qui porte l'attribut 'répertoire'. En fait, on peut techniquement avoir sur un site Storga plusieurs pages répertoires, ce qui permet de gérer plusieurs blocs portant le même nom sans qu'il y ai nécessairement conflit. En effet, quand un programme cherche à trouver le bloc auquel un nom correspond, il remonte l'arborescence en direction de la racine, et s'arrête à la première page munie d'un répertoire dans lequel le nom est défini. Cela signifie que quand un nom est utilisé, la signification n'est pas trouver le bloc portant le nom, mais plus exactement trouver le bloc portant le nom dans la même zone de l'aborescence des pages Storga du site.
Si vous avez l'intention d'utiliser cette possibilité d'avoir plusieurs blocs portant le même nom au niveau d'un seul site Storga, merci de prendre contact avec Hubert Tonneau pour lui expliquer votre application, car il n'est pour l'instant pas certain que cette possibilité sera maintenue en l'état à l'avenir.

Nouveau message

From :
Message Title:
Message: