Hyperliens

Description

Les hyperliens sont visibles sur les documents chargés dans ARender. En cliquant dessus, vous pouvez accéder à un autre contenu. Vous aurez besoin d’un texte source qui sera le texte sélectionné et qui sera cliquable, et d’une cible.

Utilisations

Pour activer la création d’hyperliens, deux options sont disponibles. En affichant le menu contextuel par clique-droit sur votre document et en choisissant l’option Créer un lien

Ou en activant un bouton spécifique à la création des hyperliens. Ce bouton est affiché dans le toppanel. La création répétée d’hyperliens est aussi disponible.

Propriété	Description	Valeur par défaut
topPanel.annotationMenu.hyperlink	Active le bouton de création d’hyperlien	false
topPanel.annotationMenu.hyperlink.repeat	Active le bouton de création d’hyperlien en mode répété	false

topPanel.annotationMenu.hyperlink=true
topPanel.annotationMenu.hyperlink.repeat=true

Si aucun texte n’est sélectionné au moment de la création, une popup apparaît pour vous demander de sélectionner le texte source et d’appuyer sur Entrée pour valider. La validation par la touche Entrée est activée par défaut. Il est possible de la désactiver avec la propriété indiquée plus bas.

text.selection.hyperlink.use.enter=true

Pour la modification du texte source, la popup ci-dessus apparaît après avoir cliqué sur le crayon dans le panneau de la source. La source peut être modifiée en sélectionnant un nouveau texte.

Après avoir sélectionné votre source, une popup apparaît pour vous demander la cible.

Plusieurs possibilités s’offrent à vous :

Sélectionner une page du document actuel
Fournir un URL
Sélectionner un document externe à ARender grâce au Javascript API. Pour ce faire, vous devez enregistrer une fonction qui sera exécutée au moment où ARender entre ou sort du mode sélection de cible.

var waitingTarget = false;
function arenderjs_init(arenderjs_)
{
    arenderjs_.registerNotifyHyperlinkToggleTargetModeEvent(function(activated){
        waitingTarget = activated;
    });
}

Ensuite, il faudra une fonction permettant d’envoyer la cible à ARender lorsque la cible est demandée.

function armt_notifyHyperlinkTarget(target)
{
    if(waitingTarget)
    {
        getARenderJS().notifyHyperlinkTarget(target);
        waitingTarget = false;
    } 
}

Cette troisième option est activée par défaut. Il est possible de la désactiver avec la propriété indiquée plus bas.

Pour la modification de la cible, la popup ci-dessus apparait après avoir cliqué sur le crayon dans le panneau de la cible. Une fois l’option choisie, la cible sera modifiée. Les mêmes options et configurations sont disponibles.

Propriété	Description	Valeur par défaut
text.selection.hyperlink.use.enter	Autorise la validation de la source grâce à Entrée	true
annotation.hyperlink.externe.target.enabled	Autorise la cible de l’hyperlien à être un document externe	true

text.selection.hyperlink.use.enter =true
annotation.hyperlink.externe.target.enabled=true

Voici un cas utilisateur de la troisième étape, pour mieux comprendre :

Au chargement d’ARender, la fonction registerNotifyHyperlinkToggleTargetModeEvent va être appelée. Elle permet de savoir lorsque le bouton de création d’hyperlien est actionné.
Lorsque la création d’hyperlien est activée, il faut sélectionner du texte si cela n’a pas été fait dans un premier temps.
Une fois le texte sélectionné, il faut choisir la cible. Lorsqu’elle est externe à ARender (un document d’une GED qui n’a pas été chargé dans ARender) il faut choisir ce document directement dans la GED. C’est alors que la fonction notifyHyperlinkTarget s’active et la cible de l’hyperlien est créée avec l’URL du document sélectionné.
L’hyperlien est créée.

Explorateur d’hyperliens

Les hyperliens sont visibles dans l’explorateur d’hyperlien. Par défaut, il est activé.

Propriété	Description	Valeur par défaut
hyperlinkexplorer.enabled	Autorise l’explorateur d’hyperlien	true

Il permet de voir pour chaque hyperlien :

le nom du créateur
la date
le texte source
le document source
la cible

Plusieurs options d’affichage vous sont mises à disposition :

Propriété	Description	Valeur par défaut
annotation.date.display.creationDate	Affiche la date de création sinon la date de la dernière modification	true
annotation.comment.explorer.show.date	Active l’affichage de la date	true
annotation.comment.explorer.creator.name.initial.only	Affiche les initiales du créateur	false
toolbar.securityList.checkOwner	Active la liste de sécurité pour les annotations de l’utilisateur courant	true
annotation.date.display.humanizedDate.enabled	Affiche la date humanisée	false

Filtrer les hyperliens

A partir de l’explorateur des hyperliens il est possible d’appliquer un filtre. Pour cela, vous pouvez utiliser le bandeau en haut de l’explorateur dédié aux filtres et aux tris.

Plusieurs options de filtre sont disponibles :

par document
par créateur

Vous pouvez également utiliser les boutons de filtres mis à disposition dans l’explorateur d’hyperlien. ARender en possède deux.

Un pour filtrer en fonction du nom de l’utilisateur. Il apparaît au survol du nom de l’utilisateur.

Quand ce filtre est activé, il devient bleu. Pour le désactiver, il suffit de cliquer une nouvelle fois dessus.

Le deuxième filtre pour filtrer en fonction de la date. Il apparaît au survol de la date (uniquement si celle-ci est affichée).

Lui aussi est bleu quand il est activé. Pour le désactiver, il suffit de cliquer une nouvelle fois dessus.