Utiliser la fenêtre de recherche d'items avancée

Cette procédure explique comment créer de nouvelles recherches d'items avancées et plus largement comment utiliser les options disponibles de cette fenêtre.

Prérequis

Ouvrir la fenêtre de recherche d'items avancée

Cliquez sur Recherche d'items... en haut à droite de l'atelier.

Truc & astuceRaccourci clavier

Ctrl + Shift + F

Procédure
  1. Définissez la portée et les critères de la recherche.

    Truc & astuce

    • Ajoutez autant de critères que nécessaires à l'aide du bouton +.

    • Le choix ET / ET SAUF : permet de choisir d'inclure le critère dans la recherche (ET, alors les items trouvés par ce critère doivent être présentés dans les résultats) ou de l'exclure (ET SAUF, alors les items trouvés par ce critère ne doivent pas être présentés dans les résultats)

    • Cliquez sur pour supprimer un critère.

    • Le bouton permet de remplacer le critère actif par un autre. Par exemple, transformer le critère Texte en Chemin de l'item, xPath, Code de l'item ou Titre, ou remplacer une option de Portée par une autre, afin d'ajuster votre recherche facilement en cas de besoin.

    ComplémentPortée

    La Portée permet de définir le spectre de la recherche d'items que vous effectuez ; c'est à dire de cibler ou d'exclure des espaces et/ou des items de l'explorateur.

    Vous pouvez choisir comme portée de la recherche :

    • Tout l'atelier ;

    • Dans un espace... (+ choix d'un espace) ;

    • Réseau descendant d'un item... (+ choix d'un item) ;

    • Réseau ascendant d'un item... (+ choix d'un item) ;

    • Items liants un item... (+ choix d'un item), c'est-à-dire uniquement les items parents directs ;

    • Items liés par un item... (+ choix d'un item), c'est-à-dire uniquement les items enfants directs.

    Remarque : Plusieurs critères Portée peuvent être ajoutés afin préciser le spectre de la recherche, notamment au sein de groupes de critères en incluant ou excluant des portées.

    ComplémentTexte

    Permet de rechercher un caractère, un mot ou un groupe de mots dans le contenu des items (= recherche full-text). Il est possible de restreindre cette recherche en cochant les options :

    • Respecter la casse : les résultats remontés respecteront strictement la casse du mot saisi.

    • Mot entier : les résultats remontés se limiteront aux caractères saisis.

    ComplémentCode de l'item

    Permet de rechercher des items en fonction de leur code[1] dans l'explorateur.

    ComplémentTitre

    Permet de cibler une recherche de texte à l'intérieur d'une balise Titre d'un item.

    Cochez la case Expression régulière pour paramétrer une recherche à l'aide de ce langage informatique qui portera sur les balises Titre des items.

    Quelques exemples

    Saisissez...

    ...pour rechercher des items dont le titre contient...

    .*port.*

    la chaîne de caractères port.

    \d\d-\d\d

    une chaîne de caractères constituée de 2 chiffres, un tiret et à nouveau 2 chiffres.

    Documentation de référence pour l'expression régulière

    ComplémentItem commenté

    Permet de retrouver des items contenant des commentaires[2] ouverts et/ou fermés.

    ComplémentGroupe de critères (...ET...) et Groupe de critères (...OU...)

    Un Groupe de critères permet d'effectuer des recherches complexes. Comme son nom l'indique, il permet de combiner plusieurs critères et de choisir, par exemple, d'exclure ces critères de la recherche, ou à l'inverse, de choisir qu'ils soient obligatoirement respectés par les résultats de la recherche. In fine, c'est l'équivalent d'une sous-recherche.

    Vous pouvez choisir d'ajouter un :

    • Groupe de critère ET, alors tous les critères définis dans le groupe doivent être remplis.

      L'option ET SAUF permet d'exclure un critère de la recherche.

    • Groupe de critère OU, alors un seul des critères définis dans le groupe doit être rempli.

      L'option OU SAUF permet d'inclure un critère dans la recherche.

    Les Groupes de critères peuvent être imbriqués les uns dans les autres afin d'affiner la recherche.

    ComplémentItems orphelins

    Permet de retrouver les items orphelins[3] de l'atelier.

    ComplémentStatut de l'item

    Permet de rechercher des items en fonction de leur statut dans l'explorateur (en erreur, valide...).

    ComplémentDate de modification

    Permet de rechercher des items en fonction de leur dernière date de modification.

    Définissez une date dans le calendrier et choisissez si les items trouvés doivent avoir été modifiés pour la dernière fois :

    • avant le...

    • à partir du...

    • le...

    ComplémentDernière personne à avoir modifié l'item

    Permet de rechercher des items en fonction du ou des derniers utilisateurs à les avoir modifiés.

    Détails : Utilisez la combinaison Ctrl + clic pour sélectionner plusieurs utiliateurs puis cliquez sur Sélectionner pour valider votre choix.

    Astuce : Cliquez sur ou pour rechercher au sein de la liste des utilisateurs, des groupes ou les deux.

    ComplémentType de l'item

    Sélectionnez le ou les types d'items que vous recherchez dans la sur-fenêtre qui s'affiche parmi tous les types d'items pouvant être rencontrés dans l'atelier (y compris des types d'items non reconnus (erreurs) ou que vous n'avez pas/plus le droit de créer).

    Détails : Utilisez la combinaison Ctrl + clic pour sélectionner plusieurs types d'items puis cliquez sur Sélectionner pour valider votre choix.

    ComplémentCycle de vie et recherche d'items

    Le moteur de recherche permet de retrouver des items en fonction de l'état de leur Cycle de vie.

    ComplémentAtelier calque de travail et recherche d'items

    Le moteur de recherche des calques de travail propose le critère Etats du calque de travail.

    Cliquez sur celui (ou ceux) des états que vous souhaitez ajouter aux critères de recherche.

    Ce type de recherche permet, par exemple, de retrouver les items ayant été modifiés, créés ou supprimés, afin de valider les modifications ou de les abandonner.

    ComplémentAtelier dérivé et recherche

    Le moteur de recherche des ateliers dérivés propose le critère Propriétés de dérivation.

    Cliquez sur celui (ou ceux) des 9 statuts que vous souhaitez ajouter aux critères de recherche.

    Rappel :

    • Violet : item surchargé mais jamais marqué achevé,

    • Vert : item surchargé marqué achevé,

    • Rouge brique : item déphasé, à contrôler.

    Ce type de recherche permet, par exemple, de retrouver les items ayant été surchargés et/ou déphasés, afin de marquer "achevée" la dérivation de ces items, de supprimer la surcharge,...

    ComplémentCondition XML avancée

    Permet de programmer une requête complexe, exploitant directement le langage interne de recherche de Scenari.

    ComplémentChemin de l'item

    Permet de saisir une recherche portant sur le classement des items dans l'explorateur (le chemin).

    • Saisissez le code d'un espace[4] pour réduire la recherche à cet espace.

    • Pour réduire la portée à un sous-espace, ajoutez un  /  entre chaque nom d'espaces.

      Exemple : docs/installation/images ne remontera que les items dans l'espace images de l'espace installation de l'espace docs.

    ComplémentxPath

    Permet d'effectuer des recherches complexes au sein de la structure Xml des items. Il est nécessaire de connaître le langage Xpath et le schéma Xml interne de votre modèle documentaire pour effectuer de telles requêtes.

    La syntaxe à respecter est //nomBalise.

    Exemple pour recherche la présence d'au moins une balise xml "prefix:maBalise" dans les items : //prefix:maBalise

    Documentation de référence pour le langage Xpath

    ComplémentSous-requête...

    La sous-requête permet de réduire le résultat de la requête principale aux items pour lesquels les conditions de la sous-requête sont respectées.

    Les sous-requêtes permettent en particulier de conditionner la sélection d'un item aux caractéristiques du réseau d'items qu'il lie ou auquel il est lié.

  2. Visualisez et éditez les résultats de la recherche.
    • La liste et le nombre des items trouvés s'affichent dans la colonne de gauche :

      • Cliquez sur Voir plus pour afficher tous les résultats (quand il y en a plus de 30).

      • Cliquez sur Relancer pour mettre à jour la liste après avoir modifié les critères de recherche ou des items des résultats.

    • Un unique clic sur un résultat de recherche affiche l'item trouvé à droite de la fenêtre. Vous pouvez modifier, prévisualiser,... l'item depuis cette zone d'édition.

    • Un double-clic sur un résultat de recherche referme la fenêtre de recherche avancée et affiche l'item trouvé dans la fenêtre principale.

  3. Enregistrez la requête (optionnel).

    Si vous le souhaitez vous pouvez donner un nom à cette requête (libellé) en bas de la fenêtre et cliquez sur Enregistrer pour la sauvegarder dans le volet Recherche d'items.

    1. La requête est enregistrée sous la forme d'un onglet dans le volet Recherche d'items.

  4. Partagez la requête (optionnel).
    • Cliquez sur Copier la requête pour mettre dans votre presse-papiers la requête actuellement définie dans la fenêtre. Cela permet de la partager avec un collaborateur en la collant dans un mail ou un chat, par exemple.

    • Cliquez sur Coller la requête pour coller une requête qu'un collaborateur aura partagé avec vous. Les critères seront alors définis en fonction du contenu de votre presse-papiers.

  5. Réinitialisez la requête (optionnel).

    Cliquez sur Réinitialiser le formulaire de recherche pour effacer la requête paramétrée actuellement.

  6. Exportez des archives (optionnel).

    Remarque

    L'export réalisé est fonction de la recherche affichée, paramétrée dans la fenêtre de recherche avancée.

    Archive SCWSP

    1. Cliquez sur SCWSP (Créer une archive avec les items trouvés) pour exporter les résultats de recherche sous la forme d'une archive SCENARI .scwsp[5]

      → L'archive est téléchargée sur votre poste.

    Archive CSV

    1. Cliquez sur CSV (Créer un CSV avec les propriétés des items trouvés) pour exporter les résultats de recherche sous la forme d'un fichier .csv que vous pourrez ouvrir à l'aide d'un tableur (ex : Excel ou LibreOffice) ou d'un éditeur de texte (ex : bloc-notes).

      → La fenêtre d'export s'affiche.

    2. Si besoin, configurez le fichier à exporter :

      • Flèches ◁ et ▷ pour ajouter/retirer des colonnes dans le fichier exporté,

      • Flèches △ et ▽ pour changer l'ordre des colonnes dans le fichier exporté,

      • pour réinitialiser la configuration,

      • pour sauvegarder cette configuration pour un prochain export OU pour utiliser une configuration enregistrée.

    3. Cliquez sur Exporter....

      → Le fichier .csv est téléchargé sur votre poste.

    4. Lorsque vous ouvrez ce fichier, si l'application vous le propose, veillez à utiliser l'encodage Unicode  (UTF-8).