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.

    Objectifs

    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,

    Définition

    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 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.

    Gardons l’exemple du dossier client évoqué précédemment 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. Pour commencer, créez une classe de tag ReferenceClient de type chaîne de caractères.

    Pour cela, suivez les étapes ci-dessous :

    • Allez dans la console d’administration,
    • Ouvrez la section Composants > Classes de tags,
    • Cliquez sur le bouton + pour démarrer la création,
    • Sélectionnez le type de valeur Chaîne de caractères puis passez à l’étape suivante,
    • Dans le formulaire affiché, saisissez la valeur ReferenceClient comme identifiant de cette classe de tag,
    • Cliquez sur Créer.

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

    Le dossier client

    Pour pouvoir créer les instances de dossiers clients, il est nécessaire de créer la classe de dossier virtuel DossierClient référençant la classe de tag ReferenceClient.

    Pour cela, suivez les étapes ci-dessous :

    • Allez dans la console d’administration,
    • Ouvrez la section Composants > Classes de dossiers virtuels,
    • Cliquez sur le bouton + pour démarrer la création,
    • Dans le formulaire affiché, saisissez la valeur DossierClient comme identifiant de la classe,
    • Dans l’onglet Tags, cliquez le bouton Ajouter et sélectionnez la classe de tag ReferenceClient,
    • Dans l’onglet Recherche, cliquez sur Filtres puis Ajouter pour initier une nouvelle recherche permettant de lier les document,
    • Ajoutez un critère de recherche avec pour nom l’identifiant ReferenceClient, l’opérateur EQUALS_TO et pour valeur la variable ${tags.ReferenceClient},
    • Et pour finir, cliquez sur Créer.

    Les documents clients

    Afin de créer des instances de documents clients, il est nécessaire de créer la classe de document DocumentClient.

    Pour cela, suivez les étapes ci-dessous :

    • Allez dans la console d’administration,
    • Ouvrez la section Composants > Classes de documents,
    • Cliquez sur le bouton + pour démarrer la création,
    • Dans le formulaire affiché, saisissez la valeur DocumentClient comme identifiant de cette classe,
    • Dans l’onglet Tags, cliquez le bouton Ajouter et sélectionnez la classe de tag ReferenceClient,
    • Et pour finir, cliquez sur Créer.

    Afin de valider le bon fonctionnement de ce qui a été mis en place, commencez 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, sélectionnez la classe DocumentClient et saisissez une valeur pour le tag ReferenceClient (par exemple : 1234).


    Ensuite, allez dans la console d’administration et créez un dossier virtuel de classe DossierClient :

    • Ouvrez la section Composants > 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, 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éé et vérifiez qu’il contient le document ajouté.


    Ressources :

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