Difference between revisions of "Search Syntax/fr"

From CollectiveAccess Documentation
Jump to: navigation, search
(Created page with "Peu importe le moteur de recherche que vous configurez avec CA, la [http://lucene.apache.org/java/2_3_2/queryparsersyntax.html syntaxe de recherche Lucene] ...")
(Updating to match new version of source page)
Line 39: Line 39:
 
=== Chercher des dates ===
 
=== Chercher des dates ===
  
To search on a date or date range, simply restrict your search to a date range element and then search on the desired date, using one of the formats described on the [[DateAndTimeFormats|date and time format page]]. You can use any supported format and any precision - the search engine will find any date (and optionally times) that overlap your search date range. Matching is by default very loose: items with any overlap will be returned. You can restrict matching to items with dates that are completely encompassed by your search date by prepending a "#" to your search data. Eg. "#May 10 2005"
+
To search on a date or date range, simply restrict your search to a date range element and then search on the desired date, using one of the formats described on the [[Date and Time Formats|date and time format page]]. You can use any supported format and any precision - the search engine will find any date (and optionally times) that overlap your search date range. Matching is by default very loose: items with any overlap will be returned. You can restrict matching to items with dates that are completely encompassed by your search date by prepending a "#" to your search data. Eg. "#May 10 2005"
  
 
=== Chercher des longueurs et des largeurs ===
 
=== Chercher des longueurs et des largeurs ===
Line 47: Line 47:
 
<code><pre>ca_objects.width:12in</pre></code>
 
<code><pre>ca_objects.width:12in</pre></code>
  
You can use almost any unit abbreviation listed on the [[Measurement_Input_Formats|measurement input format page]]. A few, such as " for inches and ' for feet have special meaning in the Lucene search syntax and should not be used.
+
You can use almost any unit abbreviation listed on the [[Measurement input formats|measurement input format page]]. A few, such as " for inches and ' for feet have special meaning in the Lucene search syntax and should not be used.
  
 
If you want to search for items within a range of measurements, specify the upper and lower bounds of the range with units. The boundary values should be separated with the word "to" and enclosed in square brackets. Do not put spaces between the quantity and units. For example:
 
If you want to search for items within a range of measurements, specify the upper and lower bounds of the range with units. The boundary values should be separated with the word "to" and enclosed in square brackets. Do not put spaces between the quantity and units. For example:
Line 89: Line 89:
 
<code><pre>ca_objects.georeference:ca_objects.georeference:"[40.5759250,-73.9911350 ~ 5km]"</pre></code>
 
<code><pre>ca_objects.georeference:ca_objects.georeference:"[40.5759250,-73.9911350 ~ 5km]"</pre></code>
  
As with the bounding box query, enclose the search expression in square brackets and quotes. The maximum distance from the point can be specified in any of the units of length [[Measurement_Input_Formats|supported]] by the "Length" attribute type. The above query will find anything geocoded as being within 5 kilometers of the specified point.
+
As with the bounding box query, enclose the search expression in square brackets and quotes. The maximum distance from the point can be specified in any of the units of length [[Measurement input formats|supported]] by the "Length" attribute type. The above query will find anything geocoded as being within 5 kilometers of the specified point.
 +
 
 +
=== Searching for blank values ===
 +
 
 +
As of version 1.4 you may search for item that have no content in a specific field using the special ''[BLANK]'' search term. ''[BLANK]'' must be used in conjunction with field specification.
 +
The following example will return all objects lacking descriptions:
 +
 
 +
<code><pre>ca_objects.description:[BLANK]</pre></code>
  
 
=== Points d'accès ===
 
=== Points d'accès ===
Line 130: Line 137:
 
=== Chercher par dates de création et de modification ===
 
=== Chercher par dates de création et de modification ===
  
 +
<span class="mw-translate-fuzzy">
 
Vous pouvez chercher les dates de création et de modification des enregistrements à l'aide des points d'accès spéciaux ''created'' et ''modified'' combinés avec une [[DateAndTimeFormats|expression date/heure valide]]. Par exemple, pour trouver tout ce qui a été créé le 12 avril 2012, vous pouvez chercher avec :
 
Vous pouvez chercher les dates de création et de modification des enregistrements à l'aide des points d'accès spéciaux ''created'' et ''modified'' combinés avec une [[DateAndTimeFormats|expression date/heure valide]]. Par exemple, pour trouver tout ce qui a été créé le 12 avril 2012, vous pouvez chercher avec :
 +
</span>
  
 
<code><pre>created:"April 12 2012"</pre></code>
 
<code><pre>created:"April 12 2012"</pre></code>
Line 146: Line 155:
 
Veuillez noter que le nom d'utilisateur est séparé du point d'accès par un point (".") et que le nom d'utilisateur indiqué est son login, '''pas''' son prénom, ni son nom. Le login d'un utilisateur peut être son adresse email, mais ce n'est pas toujours le cas.
 
Veuillez noter que le nom d'utilisateur est séparé du point d'accès par un point (".") et que le nom d'utilisateur indiqué est son login, '''pas''' son prénom, ni son nom. Le login d'un utilisateur peut être son adresse email, mais ce n'est pas toujours le cas.
  
 +
<span class="mw-translate-fuzzy">
 
[[Category:Users_Guide|Guide de l'utilisateur]]
 
[[Category:Users_Guide|Guide de l'utilisateur]]
 
[[Category:Search|Recherche]]
 
[[Category:Search|Recherche]]
 +
</span>

Revision as of 17:24, 14 September 2013

[Valide pour la version 1.3]

Peu importe le moteur de recherche que vous configurez avec CA, la syntaxe de recherche Lucene sera toujours utilisée pour définir les expressions de recherche. Ceci permet de fournir une expérience cohérente pour les utilisateurs même avec différentes implémentations et permet également de mettre en oeuvre la syntaxe Lucene, bien définie et largement adoptée. Notez que tous les moteurs de recherche ne supportent pas tous les aspects de la syntaxe Lucene. En général, vous pouvez considérer que les fonctionnalités de base sont largement supportées : la recherche textuelle, la limitation au niveau d'un champ, le parenthésage et les booléens. Des fonctionnalités tels que la pondération, la correspondance partielle et les recherches sur des intervalles peuvent ne pas être disponible sur les moteurs de recherche qui ne sont pas basés sur Lucene (par exemple des moteurs autres que PHP Lucene et Apache SOLR). A l'opposé, d'autres fonctionnalités comme la conversion des unités lors de la recherche sur les dimensions longueur et largeur sont (actuellement) uniquement supportées dans le moteur MySQLFullText.

Recherche plein texte

Pour chercher à travers tous les champs indexés de la base de donnée (tels que définis dans le fichier de configuration search_indexing.conf, saisissez simplement un ou plusieurs mots. Selon le moteur de recherche utilisé, votre recherche peut comprendre des variantes (les suffixes retirés avant une comparaison avec l'index des mots) pour améliorer les résultats. La plupart des moteurs retourneront des résultats uniquement si tous les mots spécifiés sont présents, mais certains peuvent employer une logique propre pour retourner des résultats partiels repérés comme pertinents.

Limiter votre recherche à un champ spécifique

Si vous voulez restreindre votre recherche à un champ spécifique dans la base de données CA, utilisez le nom de la table et le champ séparés par un point, comme ici :

<table>.<field> (ex. ca_object_labels.name)

Une requête sous la forme de

ca_object_labels.name:Rollercoasters

retournera uniquement des objets dont le label (par exemple leur titre) contient le mot rollercoasters

Remarquez que ceci s'applique uniquement aux champs "intrinsèques" qui sont encodés en dur dans la base de données. Pour simplifier, ces champs sont toujours présentés quelle que soit votre configuration de CA - même si vous ne les utilisez pas. Il y a uniquement quelques champs de ce type d'usage courant : les champs labels (pour ca_objects, ca_entities...), les identifiants (idno), et les champs quantité et unités de la quantité, extent et extent_units (pour ca_objects et ca_object_lots).

Limiter votre recherche à des éléments de métadonnées spécifiques

Les éléments de metadonnees sont des champs de données spécifiques à votre installation. Ils peuvent exister ou non dans d'autres installations. Y chercher des informations est similaire à la recherche sur les champs intrinsèques.

<table>.<nom d'élément ou identifiant> (ex. ca_objects.inscription_sur_cadre pour chercher les éléments ''inscription_sur_cadre'' attachés à l'objet)

ou

ca_objects.<nom d'élément ou identifiant>(ex. ca_objects.inscription_sur_cadre)

You can see a list of all metadata elements (and their codes) available in your configuration in the metadata element editor available under the "System Configuration" option in the "Manage" menu. (Note: only system administrators have access to this editor).

In all engines you can perform text searches on any element. In some engines - specifically the MysqlFulltext engine that is the default engine upon installation - you can also perform specialized searches on certain types of elements. These searches are described in the following section.

Chercher des dates

To search on a date or date range, simply restrict your search to a date range element and then search on the desired date, using one of the formats described on the date and time format page. You can use any supported format and any precision - the search engine will find any date (and optionally times) that overlap your search date range. Matching is by default very loose: items with any overlap will be returned. You can restrict matching to items with dates that are completely encompassed by your search date by prepending a "#" to your search data. Eg. "#May 10 2005"

Chercher des longueurs et des largeurs

To search on a length or width, restrict your search to a length or width element and use the desired quantity with units specified. You must specify units - there is no default no matter what your "units of measurement" preference is set to (this preference governs display of measurements only). If you want to find items that match a measurement exactly simply search on the quantity. CA will convert the quantity to the required units for comparison, so even if an item was measured in inches, a metric search will find it - if the measurements match of course.

ca_objects.width:12in

You can use almost any unit abbreviation listed on the measurement input format page. A few, such as " for inches and ' for feet have special meaning in the Lucene search syntax and should not be used.

If you want to search for items within a range of measurements, specify the upper and lower bounds of the range with units. The boundary values should be separated with the word "to" and enclosed in square brackets. Do not put spaces between the quantity and units. For example:

ca_objects.width:[12in to 24in]

would find all objects with a width between 12 and 24 inches (inclusive). Note that there is no space between "12" and "in" and "24" and "in"

Chercher des nombres

Searching on numbers is very similar to searching on measurements, except that no units are necessary. To search on an integer or decimal value element restrict your search to the element and specify the number either singly or as a range. For example, to find objects with a user_ranking value of 5:

ca_objects.user_ranking:5

Pour trouver des objets avec des estimations utilisateurs [user_ranking] entre 1 et 5 (inclus) :

ca_objects.user_ranking:[1 to 5]

Chercher un montant financier

Searching on currency is very similar to searching on numbers, except that a currency type is required. To search on an currency value element restrict your search to the element and specify the currency amount either singly or as a range. The amount should be prefixed with a three letter currency specified (eg. EUR for Euros, USD for US dollars) or one of the supports symbolic specifiers ($, ¥, £ and €). For example, to find objects with an appraisal_value value of $500:

ca_objects.appraisal_value:$500

Pour trouver des objets dont l'attribut appraisal_value (valeur estimée) est de 500 $ ou moins :

ca_objects.appraisal_value:[$0 to $500]

Chercher des emplacements géographiques

Lors d'une recherche sur des emplacements géographiques, vous avez deux choix. Le premier est de chercher dans une zone géographique définie par deux paires de coordonnées latitude/longitude ; le second est de chercher tout ce qui se trouve à une distance définie d'un point défini par ses latitude/longitude.

Pour chercher dans une zone géographique :

ca_objects.georeference:ca_objects.georeference:"[40.341,-71.011 to 45.322, -75.963]"

Note that the latitudes and longitudes should be decimal and separated with "to", " - " or ".."; the entire range should be enclosed in both square brackets ("[" and "]) and quotes. If you don't use quotes on the part of the query up to the first space will be parts as geographic - not what you want.

Pour chercher une zone au sein d'un rayon spécifique depuis un point, utilisez ce genre de recherche :

ca_objects.georeference:ca_objects.georeference:"[40.5759250,-73.9911350 ~ 5km]"

As with the bounding box query, enclose the search expression in square brackets and quotes. The maximum distance from the point can be specified in any of the units of length supported by the "Length" attribute type. The above query will find anything geocoded as being within 5 kilometers of the specified point.

Searching for blank values

As of version 1.4 you may search for item that have no content in a specific field using the special [BLANK] search term. [BLANK] must be used in conjunction with field specification. The following example will return all objects lacking descriptions:

ca_objects.description:[BLANK]

Points d'accès

Typing ca_objects.texte_im_bild:grafitti every time you want to search for the word "grafitti" in the element "texte_im_bild" gets old quick, and certainly doesn't look very pretty. To simplify the specification of field and element-limited searches, CA supports the definition of "access points." Access points are simply lists of field and element specifications, defined in the search_indexing.conf configuration file, the names of which may be used in place of the actual specification. For example, you could do the 'texte_im_bild' search like this:

picText:grafitti

en supposant qu'un point d'accès comme celui-ci a été défini dans le fichier search_indexing.conf:

picText = {
	fields = [ca_objects.texte_im_bild]
},

Combinaison booléenne

Les expressions de recherche peuvent être combinées à l'aide des opérateurs standards booléens "AND" et "OR". Utilisez les simplement entre les expressions de recherche à connecter avec les mots AND ou OR. Par exemple, la recherche

ca_objects.appraisal_value:[$0 to $500] AND ca_objects.description:broken

va trouver tous les objets comprenant à la fois une valeur d'estimation de 500 $ ou moins et le mot "broken" dans leur description. Au contraire la requête

ca_objects.appraisal_value:[$0 to $500] OR ca_objects.description:broken

va retourner les objets contenant SOIT une valeur de $500 ou moins SOIT le mot "cassé" dans leur description.

Si vous ne saisissez pas AND/OR entre deux expressions de recherche, AND est implicite.

Troncature

L'asterisque ("*") est utilisé comme caractère "joker". Il remplace n'importe quel texte. Les joker peuvent être utilisés uniquement à la fin d'un mot, pour trouver les mots qui commencent par les caractères saisis avant l'étoile. Par exemple :

wri*

would find records associated with words starting with the text "wri" Note that if your installation has "stemming" enabled, many English language words will automatically have their suffixes truncated and a wildcard appended. Thus, with stemming on, a query for "baking" or "baked" or "baker" would be transformed to "bak*" The stemmer is smart enough to not attempt truncation of a term you've added a wildcard to yourself. If you search for "bake*" the stemmer will leave it as-is.

Chercher par dates de création et de modification

Vous pouvez chercher les dates de création et de modification des enregistrements à l'aide des points d'accès spéciaux created et modified combinés avec une expression date/heure valide. Par exemple, pour trouver tout ce qui a été créé le 12 avril 2012, vous pouvez chercher avec :

created:"April 12 2012"

ou

created:"4/12/2012"

ou avec toute autre expression valide de date/temps. Toute plage temporelle fonctionnera, y compris celles qui sont précises à la minute ou celle qui le sont au niveau d'un mois ou d'une année.

Vous pouvez limiter le nombre d'éléments retournés à ceux créés ou modifiés par un utilisateur spécifique en ajoutant un nom d'utilisateur valide à un point d'accès. Par exemple, pour trouver les objets modifiés par l'utilisateur "catherine" en avril 2012, vous pouvez chercher à l'aide de :

modified.catherine:"4/2012"

Veuillez noter que le nom d'utilisateur est séparé du point d'accès par un point (".") et que le nom d'utilisateur indiqué est son login, pas son prénom, ni son nom. Le login d'un utilisateur peut être son adresse email, mais ce n'est pas toujours le cas.

Namespaces

Variants
Actions
Navigation
Tools
User
Personal tools