Configuration des formulaires de recherche configuring-search-forms
Utilisez des formulaires de recherche pour personnaliser la sélection des prédicats de recherche utilisés dans les panneaux de recherche disponibles dans différents panneaux ou consoles AEM de l’environnement de création. La personnalisation de ces panneaux rend la fonctionnalité de recherche polyvalente selon vos besoins spécifiques.
Une plage de prédicats prête à l’emploi est disponible. Vous pouvez ajouter plusieurs prédicats, dont (entre autres) le prédicat Propriété pour rechercher des ressources correspondant à une propriété unique que vous avez spécifiée ou le prédicat Options pour rechercher des ressources correspondant à une ou plusieurs valeurs que vous spécifiez pour une propriété donnée.
Vous pouvez configurer les formulaires de recherche utilisés dans différentes consoles et l’explorateur des ressources (lors de la modification des pages). Le boîtes de dialogue de configuration de ces formulaires est accessible via :
-
Outils
-
Général
- Formulaires de recherche
-
Lorsque vous accédez à cette console pour la première fois, vous pouvez constater que toutes les configurations comportent un symbole de cadenas. Cela signifie que la configuration appropriée est la configuration par défaut (prête à l’emploi) et qu’elle ne peut pas être supprimée. Une fois la configuration personnalisée, le verrou disparaît, sauf si vous supprimer votre configuration personnalisée, auquel cas la valeur par défaut (et l’indicateur de cadenas) est rétablie.
Configurations configurations
Les configurations par défaut disponibles sont les suivantes :
-
Éditeur de page (recherche de documents) :
Cette configuration définit les options disponibles lors de la recherche de documents dans l’explorateur de ressources (lors de la modification d’une page).
-
Éditeur de page (recherche d’images) :
Cette configuration définit les options disponibles lors de la recherche d’images dans l’explorateur de ressources (lors de la modification d’une page).
-
Éditeur de page (recherche de manuscrits) :
Cette configuration définit les options disponibles lors de la recherche de manuscrits dans l’explorateur de ressources (lors de la modification d’une page).
-
Éditeur de page (recherche de pages) :
Cette configuration définit les options disponibles lors de la recherche de pages dans l’explorateur de ressources (lors de la modification d’une page).
-
Éditeur de page (recherche de paragraphes) :
Cette configuration définit les options disponibles lors de la recherche de paragraphes dans l’explorateur de ressources (lors de la modification d’une page).
-
Éditeur de page (recherche de produits) :
Cette configuration définit les options disponibles lors de la recherche de produits dans l’explorateur de ressources (lors de la modification d’une page).
-
Éditeur de page (recherche dans Dynamic Media Classic, [anciennement Scene7]) :
Cette configuration définit les options disponibles lors de la recherche de ressources Dynamic Media Classic dans l’explorateur de ressources (lors de la modification d’une page).
-
Rail de recherche d’administration de sites :
Cette configuration définit les options de recherche que vous pouvez sélectionner lorsque vous utilisez le rail de recherche de la console Sites.
-
Éditeur de page (recherche de vidéos) :
Cette configuration définit les options disponibles lors de la recherche de vidéos dans l’explorateur de ressources (lors de la modification d’une page).
-
Rail de recherche d’administration de ressources :
Cette configuration définit les options de recherche que vous pouvez sélectionner lorsque vous utilisez le rail de recherche de la console Assets.
-
Rail de recherche d’administration de catalogues :
Cette configuration définit les options de recherche que vous pouvez sélectionner lorsque vous effectuez une recherche dans un catalogue de commerce.
-
Rail de recherche d’administration de commandes :
Cette configuration définit les options de recherche que vous pouvez sélectionner lorsque vous recherchez des commandes de commerce.
-
Rail de recherche d’administration de collections de produits :
Cette configuration définit les options de recherche disponibles lors de la recherche de collections de produits de commerce.
-
Rail de recherche d’administration de produits :
Cette configuration définit les options de recherche que vous pouvez sélectionner lorsque vous recherchez des produits de commerce.
-
Rail de recherche d’administration de projets :
Cette configuration définit les options de recherche que vous pouvez sélectionner lorsque vous effectuez une recherche de projets.
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 :
-
Les prédicats de recherche courants sont définis dans :
/libs/cq/gui/components/common/admin/customsearch/searchpredicates
-
Les prédicats de recherche liés uniquement à siteadmin (IU classique) se trouvent sous :
/libs/cq/gui/components/siteadmin/admin/searchpanel/searchpredicates
- Ils sont obsolètes et disponibles uniquement à des fins de rétrocompatibilité.
/libs
.Paramètres de prédicat predicate-settings
En fonction du prédicat, une sélection de paramètres est disponible pour la configuration :
-
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œudjcr: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œudjcr: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, puis cliquer sur l’icône « + » pour ajouter la sélection à la liste des options valides (puis sur l’icône « - » pour la 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
Dans la pratique, il est identique au
Chemin d’accès aux options, à la différence qu’il s’agit du champ de prédicat commun, l’autre étant 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, Opérations, Rechercher dans Forms.
-
Sélectionnez la configuration que vous souhaitez personnaliser.
-
Utilisez la variable 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 existante est existante, vous pouvez sélectionner un champ existant et mettre à jour les paramètres.
-
Sélectionnez Terminé pour enregistrer 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 :
-
Ouvrir 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é.
Aperçu de la configuration de recherche previewing-the-search-configuration
-
Sélectionnez l’icône Aperçu :
-
Les formulaires de recherche s’affichent 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
-
Ouvrir la configuration personnalisée pour la mise à jour.
-
Sélectionnez le champ de prédicat (à droite), ouvrez le Paramètres , puis sélectionnez la variable 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.
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).
Ajout de 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.
Les nœuds pour les différentes options ont besoin de propriétés :
jcr:title
: libellé de champ à afficher dans le champ de recherchevalue
: valeur de la propriété à rechercher
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’administration de sites.
Ensuite, cliquez/appuyez sur le bouton Modifier les formulaires de recherche icône .
-
Selon la configuration, ajoutez une Options ou 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 Rechercher. 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 :
Autorisations d’utilisateur user-permissions
Le tableau ci-dessous répertorie les autorisations nécessaires à la modification, à la suppression et à l’aperçu dans des formulaires de recherche.