Lier un composant à un autre

Utiliser le plugin LinkFreeListPlugin pour lier vos composants entre eux.


Quand vous aurez terminé ce module de formation, vous pourrez lier un composant à un autre en utilisant le plugin LinkFreeListPlugin.

A quoi sert le plugin

Ce plugin permet de lier un composant à un autre.

Prenons comme exemple une solution dans laquelle les utilisateurs vont pouvoir déposer une candidature pour une offre d’emploi. Pour la gestion de la candidature, il est important que la candidature référence l’offre d’emploi pour pouvoir déterminer l’objet de la candidature.


L’utilisation de ce plugin permet à partir d’une liste de valeurs (tag de type FREE_LIST) de :

  • parcourir l’ensemble des offres d’emploi afin de sélectionner celle correspondante,
  • accéder à n’importe quel moment à l’offre d’emploi référencée à travers une icône.

Comment on l’utilise

Le plugin LinkFreeListPlugin est un plugin Javascript pour lequel il est nécessaire de préciser un tableau avec les options suivantes :

Options Description
toPopulate L’identifiant du tag servant de lien (tag de type FREE_LIST)
category La catégorie de composant des objets à lier (ou proposer)
classId L’identifiant de la classe de composants des objets à lier (ou proposer)
tagsToDisplay Les identifiants de tags à utiliser pour afficher les objets à lier
title Le titre de la popup présentant les détails du composant lié
description La description de la popup présentant les détails du composant lié

Pour l’activer, une seule fonction est nécessaire : bind()

Un exemple pratique

Pour aborder un exemple pratique, nous allons reprendre l’exemple cité précédemment concernant le dépôt de candidature sur une offre d’emploi émise depuis FlowerDocs.

Les composants manipulés

Dans cet exemple, nous disposons des deux composants :

L’offre d’emploi

Point de départ de cet exemple, l’offre d’emploi est une tâche de classe JobOffer disposant des tags obligatoires suivants :

  • RH_Service : liste des services concernés
  • RH_Job : liste des types de poste

La candidature

La candidature est une tâche de classe ApplicationSubmission avec le tag RH_OfferLink qui nous permettra de stocker le lien vers l’offre d’emploi à laquelle le candidat postule.

A l’action !

Ajout du script

Pour l’utiliser, tout comme n’importe quel script personnalisé, vous pouvez passer à travers la console d’administration.

Pour cela, rendez-vous la section Administration puis dans la sous-section Configuration et ensuite Script. Vous pouvez désormais créer votre nouveau script avec le contenu suivant :

var plugin = new LinkFreeListPlugin({
	toPopulate: 'RH_OfferLink',
	category: 'TASK',
	classId: 'JobOffer',
	tagsToDisplay: ['RH_Service', 'RH_Job'],
	title: "Consultez l'offre",
	description: "Accéder aux détails de l'offre d'emploi publiée."
});
plugin.bind()

Le résultat

  • Nous commençons par créer une offre d’emploi avec un service et un poste pour que notre faux candidat puisse postuler.

  • Nous lançons ensuite la création d’une candidature. Dans le formulaire affiché, nous observons que le tag RH_OfferLink contient l’offre d’emploi créée précédemment et que les valeurs saisies pour ses tags RH_Service et RH_Job sont affichées.. Vous pouvez sélectionner l’offre et valider la création de la candidature.


Si vous ouvrez la candidature créée, vous pourrez voir qu’à côté du tag RH_OfferLink, une icône est apparue. En cliquant sur cette icône, une popup s’ouvre et affiche les tags de l’offre d’emploi référencée (ou liée). Le bouton Ouvrir vous permet d’accéder à l’écran de consultation de l’offre d’emploi afin de visualiser à la fois les tags et les pièces jointes de cette tâche.