Référence sur la recherche avancée

Utilisez ces paramètres et opérateurs de recherche pour créer des requêtes de recherche précises.

Correspondance exacte

En règle générale, n’utilisez des guillemets doubles que pour les champs qui correspondent à des chaînes de caractères. Évitez de les utiliser pour les champs numériques, de date et booléens. Les deux principaux cas d’utilisation des guillemets doubles sont les suivants :

1. Recherche de termes séparés par des espaces : utilisez des guillemets doubles lorsque vous recherchez plusieurs mots ou expressions où l’ordre est important.

   Exemples :

   • owner="Doe John" recherche les éléments dont le propriétaire est John Doe. Les caractères tels que la virgule, le point ou le deux-points sont ignorés dans le but de faire trouver les articles dont « Doe, John » est propriétaire.
   • ITEM_DETAILS:DESC_CHANGE="Rayure sur aluminium" recherche les articles contenant cette expression exacte dans la valeur de champ.

2. Recherche de mots exacts : utilisez des guillemets doubles pour ne trouver que des mots complets.

   Exemples :

   • red trouve « predator » (correspondance partielle).
   • "red" trouve « blue red wheel » mais pas « Predator ».

Les astérisques ne sont pas nécessaires pour les correspondances partielles. L’outil de recherche utilise automatiquement des caractères génériques lorsqu’il n’y a pas de guillemets doubles.

Opérateurs conditionnels

Utilisez des parenthèses avec des opérateurs conditionnels (AND/OR) pour créer des requêtes complexes. Par exemple, utilisez cette requête pour rechercher des articles où la liste de sélection est définie sur « Moyen » ou contient le mot « test » dans les espaces de travail Articles et nomenclatures ou Ordres de modification : (ITEM_DETAILS:PRIORITY=Medium OR test) AND (workspaceId=9 OR workspaceId=8).

Opérateurs relationnels

Utilisez des opérateurs relationnels (supérieur à, inférieur à, égal à, etc.) avec des champs numériques et de date. Par exemple, utilisez cette requête pour rechercher des articles créés en janvier 2019 et contenant le mot « test » : test AND createdOn>=2019-01-01 AND createdOn<=2019-01-31.

Recherche dans plusieurs espaces de travail

Limitez les recherches à des espaces de travail spécifiques. Étant donné que les articles ne peuvent pas appartenir à plusieurs espaces de travail simultanément, utilisez OR au lieu de AND entre les ID d’espace de travail. Par exemple, utilisez cette requête pour rechercher des articles appartenant à John dans l’espace de travail 9 ou 26 : ownerName=John AND (workspaceId=9 OR workspaceId=26).

Tri

Par défaut, les résultats de recherche sont classés par pertinence (score). À l’heure actuelle, l’interface utilisateur ne prend pas en charge le tri personnalisé, mais l’API peut trier selon les champs suivants :

• Score (pertinence, non visible dans les informations de l’enregistrement) – par défaut
• Dernière modification
• Créé le
• Descripteur d’article

Les résultats peuvent apparaître dans l’ordre croissant (« asc » pour « ascending » en anglais) ou décroissant (« desc » pour « descending » en anglais). Par exemple, utilisez ces requêtes pour rechercher le mot « test » dans l’espace de travail 9, en renvoyant toutes les révisions :

• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=score asc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=lastModifiedOn desc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=createdOn asc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=itemDescriptor desc

Conseils

• Par défaut, la recherche renvoie uniquement la dernière version des espaces de travail soumis au contrôle des révisions. Utilisez &revision=2 dans les appels d’API pour récupérer tous les articles, puis filtrez-les à l’aide des champs isLatestVersion et isWorkingVersion.

• Tous les opérateurs conditionnels (AND/OR) doivent être saisis en majuscules.

• Utilisez des plages de dates pour rechercher des années ou des mois spécifiques.

• Les opérateurs booléens peuvent être saisis en majuscules ou en minuscules.

• La recherche est effectuée dans tous les onglets indexés. Depuis février 2019, les détails de l’article (à l’exception des données de classification) et les pièces jointes (titres et noms de fichiers uniquement) sont indexés pour la recherche.

• S’il n’y a pas de guillemets doubles, les espaces dans les requêtes de recherche agissent comme des opérateurs OR.

• Les caractères suivants ne sont pas autorisés dans les requêtes de recherche :

  • `
  • (
  • )
  • :
  • <
  • >
  • =
  • \
  • /
  • ]
  • [
  • {
  • }