Documentation AEM as a Cloud Service Guide de l’utilisateur

Configurer des formulaires de recherche configuring-search-forms

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Développement

Créé pour :

Administration
Développeur

Adobe Experience Manager as a Cloud Service est fourni avec un puissant mécanisme de recherche.

Il existe également un ensemble d’options prédéfinies pour vous aider à filtrer votre contenu. Ces fonctions contiennent des facettes prédéfinies, telles que Date de modification, État de publication ou État Livecopy, pour vous aider à accéder rapidement aux ressources dont vous avez besoin.

utilisation de la recherche et des filtres

Ensemble, ces outils visent à vous aider à localiser rapidement et facilement votre contenu à partir des éléments suivants :

Rechercher et filtrer
Sélecteur de rail
Navigateur de ressources (lors de la modification de pages)

NOTE

Vous pouvez configurer le service Recherche et indexation de contenu sous-jacent.

À l’aide des Formulaires de recherche, vous pouvez personnaliser et étendre ces panneaux en fonction de vos besoins spécifiques.

Les Formulaires de recherche fournissent une sélection immédiate de prédicats que vous pouvez combiner et définir. Les boîtes de dialogue de configuration de ces formulaires sont accessible via :

Outils
- Général
  - Formulaires de recherche

Formulaires par défaut default-forms

Lorsque vous accédez à la console Formulaires de recherche pour la première fois, vous pouvez constater que toutes les configurations comportent un symbole de cadenas. Cela signifie que la configuration correspondante est la configuration par défaut (prête à l’emploi) et qu’elle ne peut pas être supprimée. Une fois que vous avez personnalisé et enregistré une configuration, le cadenas disparaît. Il réapparaît si vous supprimez votre configuration personnalisée, auquel cas la valeur par défaut (et l’indicateur de cadenas) est rétablie.

présentation de la configuration des formulaires de recherche

Les configurations par défaut (classées dans l’ordre alphabétique) disponibles sont les suivantes :

Rail de recherche d’administrateurs de ressources
Éditeur de page (recherche de documents)
Éditeur de page (recherche des fragments expérience)
Éditeur de page (recherche d’images)
Éditeur de page (recherche de manuscrits)
Éditeur de page (recherche de pages)
Éditeur de page (recherche de paragraphes)
Éditeur de page (recherche de produits)
Éditeur de page (recherche Scene7)
Éditeur de page (recherche de vidéos)
Rail de recherche d’administrateurs de projets
Rail de recherche de traduction de projets
Rail de recherche d’administration de site
Rail de recherche d’administrateurs de fragments de code
Rail de recherche d’administrateurs Stock
Rail de recherche des modèles de fragment de contenu
Rail de recherche d’administrateurs de projets
Rail de recherche de traduction de projets

NOTE

Pour plus d’informations sur les formulaires de recherche liés aux ressources, voir Assets - Facettes de recherche.

Prédicats et paramètres associés predicates-and-their-settings

Prédicats predicates

En fonction de la configuration, les prédicats disponibles sont les suivants :

Prédicat

Objectif

Paramètres

Analyses

Fonctionnalités de recherche/filtrage dans le navigateur Sites lors de l’affichage de données optimisées par l’analyse. Les filtres de recherche Analyses sont chargés de façon à correspondre aux colonnes Analyses personnalisées mappées.

Libellé du champ
Description

État d’approbation

Recherchez selon l’état d’approbation.

Libellé du champ
Nom de la propriété*
Description

Création

Recherchez selon l’auteur.

Espace réservé
Nom de la propriété*
Description

Extraits par

Recherchez des ressources extraites par un utilisateur spécifique.

Libellé du champ
Espace réservé
Description

État d’extraction

Recherchez des ressources ayant un état d’extraction spécifique.

Libellé du champ
Nom de la propriété*
Description

Composants

Permet à un auteur de rechercher/filtrer des pages comportant un composant spécifique. Par exemple, une galerie d’images.

Espace réservé
Nom de la propriété*
Détails de propriété
Description

Période

Recherchez des ressources créées dans une plage spécifiée pour une propriété de date. Dans le panneau Rechercher, vous pouvez spécifier des dates de début et de fin.

Libellé du champ
Espace réservé
Nom de la propriété*
Texte de la plage (De)*
Texte de la plage (À)*
Description

État d’expiration

Recherchez des ressources en fonction de l’état d’expiration.

Libellé du champ
Nom de la propriété*
Description

Taille de fichier

Filtrez des ressources en fonction de leur taille.

Libellé du champ
Nom de la propriété*
Chemin d’accès aux options
Description

Type de fichier

Recherchez des ressources en fonction du type de fichier/MIME.

Libellé du champ
Nom de la propriété*
Chemin de type MIME
Description

Texte intégral

Prédicat de recherche pour les recherches de texte intégral. Il est mappé à l’opérateur jcr:contains.

Espace réservé
Nom de la propriété
Description

Groupe

Prédicat de recherche pour le groupe (utilisé uniquement dans le prédicat Insights).

Libellé du champ
Description

Filtre masqué

Filtrez selon la propriété et la valeur, invisible pour l’utilisateur.

Nom de la propriété*
Valeur de la propriété*
Description

Insights

Recherchez selon une sélection de paramètres Insights.

Il s’agit d’un prédicat complexe composé de plusieurs prédicats :

Groupe
Plage
Options

Membre de la collection

Recherchez des ressources qui sont membres d’une collection.

Description

Propriété à plusieurs valeurs

Recherchez plusieurs valeurs d’une propriété spécifiée.

Libellé du champ
Espace réservé
Nom de la propriété*
Prise en charge des délimiteurs
Délimiteurs d’entrée
Ignorer la casse
Description

Options

Les options sont des nœuds de contenu créés par l’utilisateur.

Pour plus d’informations, voir Ajout d’un prédicat Options.

Libellé du champ
Nom de la propriété*
Sélection simple
Ajouter des options
Manuel
sa description ;

Propriété des options

Recherchez une ou plusieurs propriétés de l’option.

Libellé du champ
Nom de la propriété*
Chemin d’accès au nœud d’options
Détails de propriété
Sélection simple
Description

Statut de la page

Filtrez des pages en fonction de leur état.

Libellé du champ
Nom de la propriété de publication*
Nom de propriété de pages verrouillées*
Description

Chemin

Filtrez selon un chemin d’accès spécifique. Vous pouvez spécifier plusieurs chemins d’accès sous la forme d’options.

Libellé du champ
Ajouter les chemins de recherche
Description

Explorateur de chemins d’accès

Fournissez un navigateur de chemins d’accès pour effectuer une recherche sous un chemin racine prédéfini.

Espace réservé
Chemin d’accès racine
Description

Chemin masqué

Filtrez selon le chemin, invisible pour l’utilisateur.

Nom de propriété (path)
Valeur de propriété (https://experienceleague.adobe.com/content/dam?lang=fr)

Propriété

Effectuez une recherche sur une propriété spécifiée.

Libellé du champ
Espace réservé
Nom de la propriété
Recherche partielle
Ignorer la casse
Description

Statut de publication

Filtrez des ressources en fonction de leur état de publication.

Libellé du champ
Nom de la propriété*
Description

Plage

Recherchez des ressources figurant dans une plage spécifiée. Vous pouvez spécifier, dans le panneau Rechercher, les valeurs minimale et maximale de la plage concernée.

Libellé du champ
Nom de la propriété*
Description

Évaluation

Recherchez des ressources en fonction de leur note moyenne.

Libellé du champ
Nom de la propriété*
Chemin d’accès aux options
Description

Date relative

Filtrez des ressources en fonction de la date relative de leur création. Par exemple, il y a 1 semaine, 1 mois.

Libellé du champ
Nom de la propriété*
Date relative
Description

Plage du curseur

Prédicat de recherche courant étendant le prédicat de plage avec la fonctionnalité de curseur. La valeur de la propriété recherchée doit être comprise entre les limites du curseur.

Libellé du champ
Nom de la propriété*
Chemin d’accès au nœud d’options
Description

État

Effectuez une recherche en fonction de l’état d’approbation et d’extraction.

Il s’agit d’un prédicat complexe composé de plusieurs prédicats :

État d’approbation
État d’extraction

Balises

Effectuez une recherche en fonction de balises.

Niveau de champ
Espace réservé
Nom de la propriété*
Option d’affichage de correspondance de toutes les balises
Chemin d’accès aux balises racines
Description

Modèles

Effectuez une recherche en fonction du modèle sélectionné.

Espace réservé
Nom de la propriété*
Description

État de traduction

Effectuez une recherche en fonction de l’état de traduction.

Libellé du champ

NOTE

Les prédicats de recherche courants sont définis dans :
/libs/cq/gui/components/common/admin/customsearch/searchpredicates

Ces informations sont proposées à titre de référence uniquement. Vous ne devez pas modifier /libs.

Paramètres de prédicat predicate-settings

En fonction du prédicat, une sélection de paramètres est disponible pour la configuration, y compris :

Libellé du champ

Libellé qui s’affiche sous forme d’en-tête réductible ou de libellé de champ du prédicat.
Description

Informations descriptives à l’intention de l’utilisateur.
Espace réservé

Texte non renseigné ou espace réservé du prédicat au cas où aucun texte de filtrage ne serait saisi.
Nom de la propriété

Propriété selon laquelle effectuer la recherche. Elle utilise un chemin relatif et les caractères génériques */*/* pour spécifier la profondeur de la propriété par rapport au nœud jcr:content (chaque astérisque représente un niveau de nœud).

Si vous souhaitez effectuer une recherche uniquement sur le nœud enfant de premier niveau de la ressource, dont la propriété x est égale au nœud jcr:content, utilisez */jcr:content/x.
Détails de propriété

Détails maximum selon lesquels rechercher cette propriété dans les ressources. Une recherche sur cette propriété peut donc être exécutée sur une ressource et des enfants récursifs jusqu’au niveau auquel les enfants sont égaux à la profondeur spécifiée.
Valeur de la propriété

Valeur de la propriété sous forme de chaîne absolue ou de langage utilisant des expressions ; par exemple, cq:Page ou

${empty requestPathInfo.suffix ? "/content" : requestPathInfo.suffix}.
Texte de la plage

Libellé du champ de plage dans le prédicat Plage de dates.
Chemin d’accès aux options

L’utilisateur peut sélectionner le chemin d’accès à l’aide de l’Explorateur de chemins d’accès dans l’onglet Paramètres de prédicat, Après avoir sélectionné l’icône +, ajoutez la sélection à la liste des options valides (puis l’icône - à supprimer si nécessaire).

Les options sont des nœuds de contenu créés par l’utilisateur, qui possèdent la structure suivante :

(jcr:primaryType = nt:unstructured, value (String), jcr:title (String))
Chemin d’accès au nœud d’options
Globalement identique à Chemin d’accès aux options, à la différence qu’il se trouve dans le champ de prédicat commun, tandis que l’autre est spécifique aux ressources.
Sélection simple
Si cette case est cochée, les options sont présentées sous forme de cases à cocher qui ne permettent qu’une sélection simple. Si cette option est sélectionnée par erreur, vous pouvez désélectionner la case à cocher correspondante.
Nom des propriétés de publication et Live Copy
Libellés des cases à cocher Publication et Live Copy pour le prédicat spécifique aux sites.
L’astérisque (*) figurant dans les libellés de champ de l’onglet Paramètres désigne les champs obligatoires, pour lesquels un message d’erreur s’affiche s’ils ne sont pas renseignés.

Configuration des formulaires de recherche configuring-your-search-forms

Création et ouverture d’une configuration personnalisée creating-opening-a-customized-configuration

Accédez à Outils, Général, Formulaires de recherche.
Sélectionnez la configuration à personnaliser.
Cliquez sur l’icône Modifier pour ouvrir la configuration à mettre à jour.
S’il s’agit d’une nouvelle personnalisation, vous allez probablement ajouter de nouveaux champs de prédicat et définir les paramètres requis. Si une personnalisation existe, vous pouvez sélectionner un champ existant et mettre à jour les paramètres.

Sélectionnez Terminé pour enregistrer la configuration. Vos modifications seront visibles lors de la prochaine utilisation de la configuration.

note note
NOTE
Les configurations personnalisées sont enregistrées (de façon appropriée) sous :
`/apps/cq/gui/content/facets/<option>` `/apps/commerce/gui/content/facets/<option>`

Ajout et modification d’un champ de prédicat et définition des paramètres de champ add-edit-a-predicate-field-and-define-field-settings

Vous pouvez ajouter ou modifier des champs et définir/mettre à jour leurs paramètres :

Ouvrez la configuration personnalisée pour la mise à jour.
Si vous souhaitez ajouter un nouveau champ, ouvrez l’onglet Sélectionner le prédicat et faites glisser le prédicat souhaité vers l’emplacement souhaité. Par exemple, le prédicat de période :
Selon que :
- Vous ajoutiez ou non un nouveau champ :
  
  Après l’ajout du prédicat, l’onglet Paramètres s’ouvre et affiche les propriétés qui peuvent être définies.
- Vous souhaitiez ou non mettre à jour un prédicat existant :
  
  Sélectionnez le champ de prédicat (à droite), puis ouvrez l’onglet Paramètres.
Par exemple, les paramètres du prédicat de période :
Apportez les modifications nécessaires et confirmez-les en cliquant sur Terminé. Vos modifications seront visibles lors de la prochaine utilisation de la configuration.

Aperçu de la configuration de recherche previewing-the-search-configuration

Sélectionnez l’icône Aperçu :
Affiche les formulaires de recherche tels qu’ils apparaissent (totalement développés) dans la colonne Rechercher de la console appropriée.
Fermez l’aperçu pour terminer la configuration.

Suppression d’un champ de prédicat deleting-a-predicate-field

Ouvrez la configuration personnalisée pour la mise à jour.
Sélectionnez le champ de prédicat (à droite), ouvrez l’onglet Paramètres, puis sélectionnez l’icône Supprimer (en bas à gauche).
Une boîte de dialogue vous invite à confirmer la suppression.
Confirmez la suppression et les autres modifications en cliquant sur Terminé.

Suppression d’une configuration (pour rétablir la valeur par défaut) deleting-a-configuration-to-reinstate-the-default

Une fois que vous avez personnalisé une configuration, cette option remplace les valeurs par défaut. Vous pouvez rétablir la configuration par défaut en supprimant la configuration personnalisée.

NOTE

Vous ne pouvez pas supprimer les configurations par défaut.

Les configurations personnalisées doivent être supprimées à partir de la console :

Sélectionnez une configuration (par exemple, Éditeur de page (Recherche de paragraphes)), puis cliquez sur l’icône Supprimer de la barre d’outils :
La configuration personnalisée est supprimée et la valeur par défaut est rétablie (le symbole de cadenas réapparaît dans la console).

Ajouter des prédicats d’options adding-options-predicates

Les prédicats d’options (options, propriété d’options) permettent de configurer un élément à rechercher. Ils servent généralement à rechercher un élément directement sous la page, par exemple, une propriété sur le nœud de page.

L’exemple ci-dessous (pour effectuer une recherche en fonction du modèle utilisé pour créer une page) illustre la procédure :

Créez le nœud définissant la propriété à rechercher.

Vous avez besoin d’un nœud racine contenant les définitions des différentes options disponibles pour l’utilisateur ou l’utilisatrice.

Les nœuds pour les différentes options ont besoin de propriétés :

jcr:title : libellé de champ à afficher dans le champ de recherche
value : valeur de la propriété à rechercher

Définition de prédicat

note note
NOTE
Vous ne devez *rien* modifier dans le chemin `/libs`.
En effet, le contenu de `/libs` est remplacé dès que vous mettez à niveau votre instance (et risque de l’être si vous appliquez un correctif ou un Feature Pack).
La méthode recommandée pour la configuration et d’autres modifications est la suivante :
Recréez l’élément nécessaire, tel qu’il existe dans `/libs`, sous `/apps`. Dans ce cas dans : `/libs/cq/gui/content/common/options/predicates` Apportez les modifications désirées dans `/apps.`

Ouvrez la console Formulaires de recherche et sélectionnez la configuration à mettre à jour. Par exemple, le rail de recherche d’administrateurs de sites. Sélectionnez ensuite Modifier.
Selon la configuration, ajoutez des Options ou une Propriété Options à la configuration.
Mettez à jour les champs, notamment :
- Nom de la propriété
  
  Spécifique à la propriété du nœud à rechercher sur les nœuds cibles. Par exemple :
  
  jcr:content/cq:template
- Chemin d’accès du nœud d’option
  
  Sélectionnez le chemin d’accès vers lequel vos options sont conservées. Par exemple :
  
  /apps/cq/gui/content/common/options/predicates/templatetype
Sélectionnez Terminé pour enregistrer la configuration.
Accédez à la console appropriée (dans cet exemple, Sites) et ouvrez le rail Recherche – Filtres. Les formulaires de recherche qui viennent d’être définis, ainsi que les différentes options, sont visibles. Sélectionnez l’option nécessaire pour afficher les résultats de la recherche.