Dossier métier

Modélisez un dossier métier à l’aide d’un dossier virtuel en définissant un tag pivot et des agrégations.


Quand vous aurez terminé ce module de formation, vous pourrez :

  • Définir une classe de dossier virtuel,
  • Agréger le contenu d’un dossier virtuel à partir d’un tag pivot,
  • Action de création si permission UPDATE_CONTENT,
  • Vue tabulaire ou ARender (si document),
  • Switcher de mode (avec explication des feuilles selon le mode).

Le principe

Un dossier virtuel est un dossier pour lequel le contenu (ou les enfants) est résolu de manière dynamique. Aucun lien physique n’existe entre le dossier virtuel et ses enfants.

Ces enfants sont déterminés à partir d’une ou plusieurs recherches définies au niveau de la classe du dossier virtuel. Ces recherches peuvent contenir des critères avec des variables afin que les résultats de recherches dépendent des tags du dossier virtuel ou tout simplement de l’utilisateur connecté.


Ainsi deux dossiers virtuels de classe DossierClient peuvent avoir des contenus différents en ajoutant un critère ReferenceClient avec la valeur ${tags.ReferenceClient}. Lors de l’affichage d’un dossier virtuel, la variable ${tags.ReferenceClient} sera remplacée par la valeur du tag ReferenceClient du dossier virtuel.

Exemple d’un dossier client

Gardons l’exemple de dossier client évoqué plus haut pour tester la mise en place d’un cas concret.

La référence client

La référence client est, dans cet exemple, le tag pivot permettant de faire le lien entre un dossier client et son contenu. Nous allons donc commencer par créer une classe de tag ReferenceClient de type chaîne de caractères.

Pour cela, suivez les étapes ci-dessous :

  • Aller sur la console d’administration,
  • Ouvrir la section Composant > Classes de tags,
  • Cliquer sur le bouton + pour démarrer la création,
  • Sélectionner le type de valeur Chaîne de caractères puis passer à l’étape suivante,
  • Dans le formulaire affiché, saisir la valeur ReferenceClient pour l’identifiant de cette classe de tag,
  • Cliquer sur Créer.

Bravo ! Vous avez créé la classe de tag ReferenceClient qui nous permettra de classer les documents d’un client au sein d’un même dossier.

Le dossier client

Pour pouvoir obtenir des dossiers clients, nous allons avoir besoin de disposer d’une classe de dossier virtuel DossierClient qui référence la classe de tag ReferenceClient.

Pour cela, suivez les étapes ci-dessous :

  • Aller sur la console d’administration,
  • Ouvrir la section Composant > Classes de dossiers virtuels,
  • Cliquer sur le bouton + pour démarrer la création,
  • Dans le formulaire affiché, saisir la valeur DossierClient pour l’identifiant de cette classe,
  • Dans l’onglet Tags, cliquer le bouton Ajouter et sélectionner la classe de tag ReferenceClient,
  • Dans l’onglet Recherche, cliquer le bouton Ajouter pour initier une nouvelle recherche qui permettre de lier les document,
  • Ajouter un critère de recherche avec pour nom l’identifiant ReferenceClient, l’opérateur égal à et pour valeur la variable ${tags.ReferenceClient},
  • Et pour finir, cliquer sur Créer.

Les documents clients

Pour qu’il soit possible de créer des documents clients, nous allons créer une classe de document DocumentClient :

  • Aller sur la console d’administration,
  • Ouvrir la section Composant > Classes de documents,
  • Cliquer sur le bouton + pour démmarrer la création,
  • Dans le formulaire affiché, saisir la valeur DocumentClient pour l’identifiant de cette classe,
  • Dans l’onglet Tags, cliquer le bouton Ajouter et sélectionner la classe de tag ReferenceClient,
  • Et pour finir, cliquer sur Créer.

Testons l’exemple

Afin de tester l’exemple mis en place dans la partie précédente, nous allons commencer par créer un document client. Pour cela, rendez-vous sur l’onglet Insérer, insérez un fichier puis cliquez sur Suivant afin de passer à l’étape d’indexation.

Dans le formulaire d’indexation affiché, sélectionnez la classe précédemment créée DocumentClient et saisissez une valeur pour le tag ReferenceClient (par exemple : 1234).


Ensuite, retournez dans la console d’administration et lancez la création d’un dossier virtuel DossierClient :

  • Ouvrez la section Composant > Classes de dossiers virtuels,
  • Sélectionnez la classe de dossier virtuel DossierClient,
  • Cliquez sur le bouton Créer une instance.

Dans le formulaire d’indexation affiché, saisissez les informations suivantes :

  • un nom pour le dossier client,
  • la valeur précédemment saisie pour tag ReferenceClient du document créé.

Puis cliquez sur Créer.


Votre premier dossier métier a été créé ! Pour valider le modèle de données réalisé, ouvrez le dossier client créé (en passant, par exemple, par une recherche) et vérifiez que le dossier virtuel contient bien le document ajouté.


Ressources :

Pour faciliter la gestion de client entre le dossier virtuel et les documents, utiliser le plugin permettant de lier un composant à un autre.