Aller au contenu principal
Version: Any 26

URL intelligentes

Une URL intelligente est un lien stable vers un contenu de Any, construit à partir des métadonnées de ce contenu plutôt que de son identifiant interne.

Elle répond au besoin de pointer vers un document depuis l'extérieur (un intranet, un mail, une application métier) sans connaître son identifiant technique, et sans que le lien casse lorsque le document évolue. Le système émetteur connaît en général une référence métier (un numéro de contrat, un nom, un statut) : c'est cette référence qui est placée dans l'URL, et Any retrouve le contenu correspondant au moment du clic.

Principe​

Une URL intelligente se configure en deux parties :

  • Le Modèle déclare les emplacements variables de l'URL, appelés clés intelligentes, sous la forme {clé}. Le modèle {name}/{status} accepte par exemple une URL se terminant par contrat-123/Approved.
  • Le Prédicat GQL décrit le contenu à retrouver, en réutilisant ces clés avec la syntaxe ${clé}.

À l'ouverture du lien, Any lit les valeurs présentes dans l'URL, les injecte dans le prédicat, puis exécute la recherche.

Le prédicat détermine à quoi le lien reste attaché dans le temps. Pour viser une version précise d'un document, utiliser une métadonnée qui l'identifie de façon unique, comme son identifiant :

core.object_id = '${core.object_id}'

Pour que le lien suive les versions du document et pointe toujours vers la plus pertinente, combiner des métadonnées métier. Ce prédicat désigne par exemple la version approuvée du document, quelle qu'elle soit :

core.name = '${core.name}' and standard.status = '${standard.status}'

Se référer au guide de référence GQL pour plus de détails.

Pour afficher l'aperçu d'une URL, cliquer sur l'URL souhaitée : elle s'affiche dans la zone prévue en haut du tableau de configuration.

Copier le lien dans le presse-papiers​

Cette section définit le comportement du menu « copier dans le presse-papiers » proposé sur une sélection de contenus.

L'option Mode désactive la fonctionnalité, ou choisit si le lien copié téléchargera le contenu ou le localisera.

Il est possible d'ajouter des critères, tels que le statut attendu du contenu sélectionné. Les noms complets des attributs de l'aspect doivent alors être utilisés.

  • Modèle : clés intelligentes à utiliser dans le prédicat GQL.
  • Prédicat GQL : prédicat GQL qui correspond au contenu souhaité.

URL de téléchargement​

Cette URL affiche la boîte de dialogue de connexion de Any, puis télécharge le contenu.

  • Modèle : clés intelligentes à utiliser dans le prédicat GQL. Exemple : {name}/{status}.
  • Format : format souhaité, choisi dans la liste déroulante.
  • Prédicat GQL : prédicat GQL qui correspond au contenu souhaité. Exemple : core.name = '${name}' and standard.status = '${status}'.

La sélection d'un élément dans la première colonne déclenche le menu pour permettre de :

  • Modifier l'ordre (déplacer la valeur vers le haut ou vers le bas)
  • Supprimer l'élément

Localiser l'URL​

Cette URL ouvre Any, affiche la boîte de dialogue de connexion, puis localise le contenu dans la section de recherche.

  • Modèle : clés intelligentes à utiliser dans le prédicat GQL. Exemple : {name}/{status}.
  • Prédicat GQL : prédicat GQL qui correspond au contenu souhaité. Exemple : core.name = '${name}' and standard.status = '${status}'.

URL de recherche​

Cette URL ouvre Any, affiche la boîte de dialogue de connexion, puis exécute une recherche. À la différence des précédentes, elle ne vise pas un contenu unique mais rapporte tous les contenus correspondants.

  • Modèle : clés intelligentes à utiliser comme termes de recherche. Exemple : {name}/{status}.
  • Terme : recherche GQL à exécuter. Exemple : core.name = '${name}' and standard.status = '${status}'.