Définir une extraction


  1. Gérer les dossiers
  2. Créer un fichier de définition
  3. Modifier la description de l'extraction
  4. Modifier un fichier de définition
    1. Créer un composant de type thesaurus
    2. Créer un composant de type requête
    3. Créer un composant de type compteur
    4. Créer un composant de type table de correspondance
    5. Les clauses
    6. Ajouter des variables de clause
    7. Ajouter des variables pour les colonnes optionnelles
    8. Modifier un nœud
    9. Supprimer un nœud
    10. Sauvegarder ou annuler les modifications
  5. Renommer un fichier de définition
  6. Supprimer un fichier de définition
  7. Actions sur le partage des extractions
    1. Droits sur l'extraction
      1. Outil
      2. Actions

Gérer les dossiers

Les extractions peuvent être enregistrées dans des dossiers ou sous-dossiers. 

Les boutons de la catégorie "Dossier" sont disponibles : 

  • permet de créer un nouveau dossier sous le nœud sélectionné
  • Les actions Renommer Supprimer et sont également disponibles.

Créer un fichier de définition

Dans l'onglet 'Extractions', après avoir sélectionné un dossier, cliquez sur le bouton 'Nouveau' :

Renseignez le nom du fichier de définition, un nouveau fichier est créé dans le répertoire WEB-INF/param/extraction/definitions/<Dossier>.

L'outil 'Détails de l'extraction' s'ouvre, la racine de l'arbre est présente, ainsi que les nœuds qui permettent de définir des variables de clauses et des colonnes optionnelles.

Vous pouvez maintenant créer les composants de votre extraction.

Modifier la description de l'extraction

Dans l'onglet 'Extractions', cliquez sur le bouton 'Modifier la description' :

L'outil de modification de contenu s'ouvre et vous permet de modifier la description de l'extraction.

Modifier un fichier de définition

Créer un composant de type thesaurus

Dans l'outil 'Détails de l'extraction', sélectionnez un nœud et cliquez sur le bouton 'Thesaurus' de l'onglet 'Extractions' :

Une boîte de dialogue s'affiche vous permettant de renseigner les informations nécessaires à la création d'un composant de type thesaurus :

  • Nom du tag : Vous pouvez choisir le nom de l'élément XML qui sera créé dans le fichier de résultats pour ce composant. Ce nom doit respecter les règles de nommage des éléments XML. Seuls certains caractères sont autorisés comme les lettres, les chiffres, les tirets, ... Ce champ n'est pas obligatoire, s'il n'est pas renseigné, on utilisera le terme 'thesaurus'.
  • Thesaurus : Liste déroulante avec les noms des thesaurii disponibles. Choisissez le thesaurus sur lequel rechercher des termes. Ce champ est obligatoire.
  • Microthesarus : Liste déroulante avec les noms des microthesaurii disponibles pour le thesaurus choisi. Choisissez le microthesaurus sur lequel rechercher des termes. Si vous changez de thesaurus, ce champ se réinitialise. Ce champ est obligatoire.
  • Niveau maximum : Profondeur maximum à laquelle rechercher les termes spécifiques. L'autopostage descendant permettra de remonter les contenus correspondant aux termes spécifiques de niveaux inférieurs.

Un nœud Thesaurus est créé dans l'arbre, sous le nœud sélectionné.

Créer un composant de type requête

Dans l'outil 'Détails de l'extraction', sélectionnez un nœud et cliquez sur le bouton 'Requête' de l'onglet 'Extractions' :

Une boîte de dialogue s'affiche vous permettant de renseigner les informations nécessaires à la création d'un composant de type requête :

  • Nom du tag : Vous pouvez choisir le nom de l'élément XML qui sera créé dans le fichier de résultats pour ce composant. Ce nom doit respecter les règles de nommage des éléments XML. Seuls certains caractères sont autorisés comme les lettres, les chiffres, les tirets, ... Ce champ n'est pas obligatoire, s'il n'est pas renseigné, on utilisera le terme 'query'.
  • Clauses : Champ texte contenant une requête solr. Vous pouvez renseigner plusieurs requêtes, en cliquant sur le bouton '+'. Pour plus d'informations, Regarder les explications sur les clauses.
  • Groupes : Vous pouvez choisir de grouper les résultats d'une requêtes en fonctions des champs des contenus remontés. Les champs sont séparés par des virgules. L'autocomplétion vous permettra de renseigner les champs disponibles pour les types de contenu sélectionnés.
  • Type de requête : Spécifiez si vous souhaitez utiliser une requête enregistrée ou créer la requête de toutes pièces.

En fonction du type de requête sélectionné, de nouvelles informations doivent être renseignées :

Si vous souhaitez utiliser une requête sauvegardée :

  • Requête enregistrée : Liste déroulante avec les noms des requêtes enregistrées disponibles.
  • Utilisation des colonnes : Vous pouvez choisir de n'utiliser que les colonnes définies par la requête enregistrée, surcharger ces colonnes ou ajouter des colonnes à celles de la requête enregistrée.
  • Colonnes : Indiquez les champs qui doivent apparaitre dans le fichier de résultats pour ce composant. Les champs sont séparés par des virgules. Pour rendre une colonne optionnelle, renseignez entre parenthèse le nom de la variable dont l'affichage de la colonne dépend. Exemple :

    metadata_A (optianalA),metadata_B

    Regarder la création de variables pour les colonnes optionnelles. L'autocomplétion vous permettra de renseigner les champs disponibles pour les types de contenu sélectionnés.

  • Utilisation du tri : Vous pouvez choisir de n'utiliser que le tri défini par la requête enregistrée, surcharger ce tri ou ajouter des champs à la suite de ceux de la requête enregistrée.
  • Tri : Indiquez les champs sur lesquels les résultats doivent être triés. Les champs sont séparés par des virgules. Par défaut, le tri est ascendant. Vous pouvez renseigner l'ordre entre parenthèse. Exemple :

    metadata_A (DESC),metadata_B (ASC), metadata_C

Si vous souhaitez créer une requête de toutes pièces :

  • Types de contenu : Arbre contenant de types de contenu disponibles. Vous pouvez sélectionner plusieurs types de contenus. Ce champ est obligatoire.

  • Colonnes : Indiquez les champs qui doivent apparaitre dans le fichier de résultats pour ce composant. Les champs sont séparés par des virgules. Pour rendre une colonne optionnelle, renseignez entre parenthèse le nom de la variable dont l'affichage de la colonne dépend. Exemple :

    metadata_A (optianalA),metadata_B

  • Tri : Indiquez les champs sur lesquels les résultats doivent être triés. Les champs sont séparés par des virgules. Par défaut, le tri est ascendant. Vous pouvez renseigner l'ordre entre parenthèse. Exemple :

    metadata_A (DESC),metadata_B (ASC), metadata_C

 

 


Un nœud Requête est créé dans l'arbre, sous le nœud sélectionné.

Créer un composant de type compteur

Dans l'outil 'Détails de l'extraction', sélectionnez un nœud et cliquez sur le bouton 'Compteur' de l'onglet 'Extractions' :

Une boîte de dialogue s'affiche vous permettant de renseigner les informations nécessaires à la création d'un composant de type compteur.

Un composant de type compteur correspond à un composant de type Requête. Les paramètres à renseigner sont globalement les mêmes.

La différence vient du fait que pour un composant de type compteur, on ne remonte que le nombre de contenus renvoyés par la requête. Aucun paramètre correspondant aux colonnes et au tri ne sont donc demandés.

Un nœud Compteur est créé dans l'arbre, sous le nœud sélectionné.

Créer un composant de type table de correspondance

Dans l'outil 'Détails de l'extraction', sélectionnez un nœud et cliquez sur le bouton 'Requête de correspondance' de l'onglet 'Extractions' :

Une boîte de dialogue s'affiche vous permettant de renseigner les informations nécessaires à la création d'un composant de type requête de correspondance.

Un composant de type requête de correspondance correspond à un composant de type Requête. Les paramètres à renseigner sont globalement les mêmes.

La différence vient du fait que les contenus renvoyés par la requête d'un composant de type requête de correspondance ne sont pas affichés. La requête de correspondance est invisible. De ce fait, aucun paramètre correspondant aux groupe, aux colonnes et au tri ne sont demandés. Le paramètre concernant le nom du tag n'est pas demandé non plus.

Un nœud Requête de correspondance est créé dans l'arbre, sous le nœud sélectionné.

 

Les clauses

Une clause peut contenir des variables, définies dans un autre nœud de l'arbre. Regarder la création de variables de clause. Le nom de la variable est mise entre accolades, précédées du signe '$'. Exemple :

${le_nom_de_ma_variable}

Une clause peut également servir à faire une joiture avec les composants parents. Le lien vers le composant parent est mis entre accolades, précédé du signe '$'. Utilisez la notation '..' pour remonter au parent direct. Pour remonter aux parents plus lointains, utilisez autant de fois que nécessaire "../". Vous pouvez également indiquer le nom d'une metadonnée du parent ciblé. Exemples :

${..}

 

Contenu du parent direct

${../../../..}

 

Contenu du parent N+4

${../metadata_A}

 

Metadaonnée metadata_A du contenu du parent direct

${../../metadata_A.metadata_B}

 

Metadonnée metadata_B du contenu lié par la metadonnée metadata_A du contenu du parent N+2

Lors d'une jointure sur une metadonnée multivaluée ou lors de l'autopostage pour les thesaurii, la requête spécifiée peut être modifiée avant son exécution pour tester toutes les valeurs attendues. Exemple, la requête suivante :

my_metadata_A:${../my_parent_multivalued_metadata_A}

 

 devient

my_metadata_A:my_parent_metadata_A_value_1 OR my_metadata_A:my_parent_metadata_A_value_2 OR ...

Vous pouvez ajouter des groupes qui permettent de ne dupliquer que certaines parties des requêtes et non les requêtes entière. Cela permet que ces requêtes, exécutées un certain nombre de fois soient beaucoup plus performantes. Le groupe est mis entre accolades, précédé du signe '#' :

#{my_metadata_A:${../my_parent_mutlivalued_metadata_A}} OR {!ametys join=linkContent->my_metadata_B q='#{id:"${../my_parent_multivalued_metadata_B}"}'}

devient

(my_metadata_A:my_parent_metadata_A_value_1 OR my_metadata_A:my_parent_metadata_A_value_2 OR ...) OR ({!ametys join=linkContent->my_metadata_B q='(id:"my_parent_metadata_A_value_1 OR id:my_parent_metadata_A_value_2 OR ...")'})

Plusieurs règles sont à connaître :

  • S'il n'y a pas de groupe dans la clause, la clause elle-même est considérée comme un groupe.
  • S'il y des groupes dans la clause, aucune variable ne peut être utilisée en dehors d'un groupe.
  • A l'intérieur d'un groupe, on peut utiliser plusieurs fois la même variable de jointure.
  • A l'intérieur d'un groupe, on ne peut pas utiliser plusieurs variables de jointure différentes.

 

Ajouter des variables de clause

Une variable de clause est définie par un nom et un type de contenu. Sa valeur est fournie à l'exécution via un contenu appartenant au type de contenu spécifié. La valeur peut ensuite être utilisée dans les clauses des composants.

Le noeud Variable de clause contient toutes les variables de clause. Il est automatiquement créé lors de la création du fichier de définition.

 Dans l'outil 'Détails de l'extraction', sélectionnez le noeud Variables de clause et cliquez sur le bouton 'Modifier' de l'onglet 'Extractions'. Une boîte de dialogue s'affiche vous permettant d'ajouter des variables de clause ou de modifier les variables existantes :

  • Nom : nom de la variable, à utiliser ensuite dans les clauses.
  • Type de contenu : Liste déroulante contenant de types de contenu disponibles. Ce champ est obligatoire.

Vous pouvez ajouter des variables en cliquant sur le bouton '+'.



Ajouter des variables pour les colonnes optionnelles

Pour rendre une colonne optionnelle, on utilise des variables. A l'exécution, l'utilisateur choisit pour chaque variable si les colonnes qui dépendent de cette variable seront affichées ou non.

Le nœud Colonnes optionnelles contient toutes ces variables. Il est automatiquement créé lors de la création du fichier de définition.

Dans l'outil 'Détails de l'extraction', sélectionnez le nœud Colonnes optionnelles et cliquez sur le bouton 'Modifier' de l'onglet 'Extractions'. Une boîte de dialogue s'affiche, vous permettant de créer une ou plusieurs variables pour les colonnes optionnelles :

  • Noms : nom des variables pour les colonnes optionnelles, séparées par une virgule.


Modifier un nœud

Dans l'outil 'Détails de l'extraction', sélectionnez un nœud et cliquez sur le bouton 'Modifier' de l'onglet 'Extractions' :

Une boîte de dialogue s'affiche vous permettant de modifier les informations du nœud sélectionné. Les champs de la boîte de dialogue dépendent du nœud sélectionné.

Supprimer un nœud

Dans l'outil 'Détails de l'extraction', sélectionnez un nœud et cliquez sur le bouton 'Supprimer' de l'onglet 'Extractions' :

Après confirmation de votre part, le nœud sélectionné et tous ses enfants sont supprimés.

Sauvegarder ou annuler les modifications

Lorsque vous effectuez une modification sur une extraction, une étoile s'affiche dans le nom de l'outil 'Détails de l'extraction' correspondant. Vous pouvez sauvegarder les modifications apportées à l'extraction en cliquant sur le bouton 'Sauvegarder' de l'onglet 'Extractions' :

Sinon, vous pouvez annuler ces modifications en cliquant sur le bouton 'Annuler' de l'onglet 'Extractions' :

Renommer un fichier de définition

Dans l'outil 'Extractions', sélectionnez un fichier de définition et cliquez sur le bouton 'Renommer' de l'onglet 'Extractions' :

Vous pouvez également cliquer sur le bouton 'Renommer' depuis l'outil 'Détails de l'extraction'.

Supprimer un fichier de définition

Dans l'outil 'Extractions', sélectionnez un fichier de définition et cliquez sur le bouton 'Supprimer' de l'onglet 'Extractions' :

Actions sur le partage des extractions

Les actions sur le partage des extractions sont disponibles sous la rubrique "Partage",

et sont accessibles quand une extraction est sélectionnée. 

  • Le bouton Visibilité permet de modifier la visibilité d'une extraction: 
  • Publique  : l'extraction peut être modifiée et/ou exécutée par l'ensemble des utilisateurs
  • Partagée : l'extraction peut être modifiée et/ou exécutée uniquement aux utilisateurs choisis via le bouton "Droits sur la requête", présenté ci-dessous. 
  • Privée : l'extraction ne peut être modifiée et exécutée que par l'utilisateur courant. 

Droits sur l'extraction

Ce bouton est disponible uniquement si l'extraction sélectionnée possède une visibilité partagée et permet d'ouvrir l'outil "Droits sur l'extraction"

Outil

Cet outil liste les utilisateurs ou groupes ayant accès en lecture et en lecture/écriture sur l'extraction sélectionnée. 

Les utilisateurs ou groupes ayant accès en lecture pourront uniquement visualiser l'extraction, sans pouvoir la modifier. 

Les utilisateurs ou groupes ayant accès en lecture/écriture pourront visualiser l'extraction, et également la modifier. 

Actions

Les actions de l'outil "Droits sur l'extraction"  sont disponibles dans un onglet "Partage". 

  • Ce bouton est disponible à partir du moment où au moins une catégorie (lecture ou lecture/écriture) est sélectionnée. 

Il permet d'ajouter un ou plusieurs utilisateurs à la/les catégorie(s) sélectionnées, et donc ajouter le droit correspondant. 

Une fenêtre s'ouvre et permet de sélectionner les utilisateurs à qui donner le droit correspondant.  

  •  Ce bouton est disponible à partir du moment où au moins une catégorie (lecture ou lecture/écriture) est sélectionnée. 

Il permet d'ajouter un ou plusieurs groupes à la/les catégories sélectionnées, et donc ajouter le droit correspondant. 

Une fenêtre s'ouvre et permet de sélectionner les groupes à qui donner le droit correspondant. 

  • Ce bouton est disponible à partir du moment où au moins un utilisateur ou groupe est sélectionné. 

Il permet de supprimer cet utilisateur ou ce groupe de la catégorie sélectionnée. 

Une fenêtre pop-up s'ouvre pour demander confirmation. 

 

Retour en haut