Créer un lien hypertexte
Créer un lien hypertexte
But
L'hyperlien sert à afficher une URL dans la fenêtre courante à partir de l'attribut. L'hyperlien peut être une simple URL statique (”http://www.meteo.fr”). L'URL peut être décrite avec des paramètres issus du document.
Création d'un hyperlien
Les références aux attributs du document sont écrites entre les caractères % en indiquant l'identifiant de l'attribut.
Soit l'attribut US_MAIL définissant le mail d'une personne. Pour déclencher l'édition d'un mail vers une personne il suffit de mettre l'hyperlien suivant :
mailto:%US_MAIL%
Autre exemple, soit l'attribut SI_TOWN indiquant la ville de la famille société. Pour avoir la météo de la ville il suffit de mettre l'hyperlien suivant :
http://www.viamichelin.com/viamichelin/fra/dyn/controller/weatherAmbiguous?strLocation=%SI_TOWN%&strCountry=EUR
Le mot-clef %SI_TOWN% sera remplacé par la valeur de cet attribut. S'il n'y aucune valeur pour un des attributs de l'URL, l'hyperlien ne sera pas affiché (on ne pourra pas cliquer sur l'attribut).
Deux mots-clefs spéciaux peuvent être utilisés pour la composition de l'URL :
- %S% : est remplacé par l'URL vers FreeDom avec le numéro de session. Il doit être utilisé en début de lien.
- %I% : est remplacé par le numéro de référence du document.
Les propriétés du document peuvent aussi être utilisées comme %FROMID% par exemple afin d'avoir l'identifiant de la famille du document.
Création d'une relation entre documents
Relation simple
Pour créer une relation entre deux documents nous utiliserons le type 'docid'. Pour créer une relation entre le document et un document de la famille 'X' nous déclarerons l'attribut suivant
| id | type | visibility |
|---|---|---|
| MA_RELATION | docid(“X”) | W |
Cela donnera en édition une aide à la saisie classique vers un document de la famille X. En consultation l'utilisateur verra le titre du document lié avec un hyperlien vers celui-ci. Si la famille n'est pas précisé dans le type l'aide à la saisie ne sera pas proposée.
Par contre, seul la n° du document sera stocké et donc l'utilisateur ne pourra pas rechercher par le titre. Si vous voulez que cette relation soit recherchable par le titre il faut rajouter l'option doctitle.
| id | type | visibility | options |
|---|---|---|---|
| MA_RELATION | docid(“X”) | W | doctitle=auto |
Cela créera automatiquement un deuxième attribut 'MA_RELATION_TITLE' qui sera caché mais disponible à la recherche. Il contiendra le titre de la relation.
Relation détaillé
L'aide à la saisie peut être personnalisée. Les documents ci-dessous donne plus d'explications sur la création de liens entre documents :
Soit US_IDSOC l'attribut identifiant le document société de la famille personne. Pour créer un hyperlien vers le document lié il faut saisir l'URL suivante :
%S%app=FDL&action=FDL_CARD&id=%US_IDSOC%
Cette URL indique que l'application FREEDOM va effectuer l'action FDL_CARD (affichage d'un document) dont l'identificateur est celui défini dans l'attribut US_IDSOC.
Il est possible d'indiquer un texte lorsque le curseur est sur le lien en utilisant l'option “ltitle”.
| Link | … | Options |
|---|---|---|
| %S%app=FDL&action=FDL_CARD&id=%US_IDSOC% | ltitle=détail de la société |
Créer un extra lien
L'extra lien permet d'afficher un bouton supplémentaire lors de l'édition d'un document. Ce bouton est spécifié par un lien comme pour les hyperlien défini ci-dessus. Cet extra-lien est utilisé le plus souvent pour que l'utilisateur crée ou modifie un document secondaire lors de l'édition d'un document principal.
Il est possible de préfixer le lien pour changer le caractère sur la bouton (par défaut '+') et le texte surgissant affiché.
| id | type | vis | link | … | eLink | … | Options |
|---|---|---|---|---|---|---|---|
| MA_RELATION | docid(“FACT”) | W | %S%app=GENERIC&action=GENERIC_EDIT&classid=FACT&id=%MA_RELATION% | eltitle=éditer une facture¦elsymbol=$ |
L'exemple ci-dessus affichera le bouton '$' avec le texte surgissant « éditer une facture ». Le lien GENERIC_EDIT est l'action par défaut d'édition de document.
