Chaînes de requêtes codées
Une chaîne de requête codée représente un filtre complexe sur une liste d’enregistrements.
Utilisez des chaînes de requête codées pour inclure un filtre dans le cadre d’un paramètre d’URL, tel que , Accéder à un enregistrement ou à un module à l’aide d’une URL ou comme qualificatif de référence afin de restreindre les données sélectionnables pour un champ de référence.
Pour construire une chaîne de requête codée, générez une requête de liste, puis copiez-la à partir du filtre de liste. Il s’agit de la méthode recommandée, car l’alternative consiste à créer la chaîne manuellement.
Pour créer manuellement une chaîne de requête codée, vous devez connaître les noms et les opérateurs de table et de champ pertinents.
| Titre | Exemple |
|---|---|
| Référence aux valeurs booléennes ou de chaîne | Pour créer une chaîne de requête sur les champs booléens, utilisez cette syntaxe : field=true ou field=false. Par exemple, pour renvoyer uniquement les enregistrements actifs d’une table, utilisez :Pour créer une chaîne de requête avec un champ qui a une valeur de chaîne spécifique, utilisez cette syntaxe : field=value. Par exemple, pour renvoyer des enregistrements d’incidents où la catégorie est réseau, utilisez : |
| Référence aux champs de référence | Pour créer une chaîne de requête qui fait référence à un champ de référence dans une autre table, utilisez cette syntaxe : field_in_referenced_table=valeur. Par exemple, pour renvoyer les utilisateurs ayant le rôle itil dans le champ de référence Affecté à du formulaire Incident, utilisez : |
| Référence aux valeurs de liste de choix | Pour créer une chaîne de requête qui fait référence à une option de liste de choix , utilisez la valeur de la liste de choix, et non l’étiquette, avec la syntaxe suivante : liste de choix field=value. Par exemple, pour renvoyer des éléments de configuration (CI) avec l’état Installé, qui a une valeur de 1 dans la liste de choix, utilisez :Consultez Valeurs à associer à des étiquettes de choix pour scripting afin de trouver les options pour les valeurs. |
| Utilisation de plusieurs conditions | Pour utiliser deux conditions jointes par un opérateur ET, utilisez le symbole de carat ^ dans cette syntaxe : field1=value1^field2=value2. Par exemple, pour renvoyer tous les utilisateurs actifs avec le rôle « itil », utilisez :Pour utiliser deux conditions jointes par un opérateur OU, utilisez le symbole du carat avec OU avec cette syntaxe : field1=value1^ORfield1=value2. Par exemple, pour renvoyer tous les utilisateurs ayant les rôles « itil » ou « admin », utilisez : Pour utiliser la condition de l’opérateur LIKE, utilisez la syntax :fieldLIKEsubstring. Par exemple, pour renvoyer tous les utilisateurs ayant des rôles contenant la chaîne « it », utilisez : Pour utiliser la condition par un opérateur IN, utilisez la syntaxe : fieldINvalue1,value2,value3. Par exemple, pour renvoyer tous les utilisateurs ayant des rôles « itil », « admin » ou « user », utilisez : Pour ajouter plusieurs conditions où une condition est une fonction JavaScript, utilisez cette syntaxe : javascript :'field=value^' + function(). La fonction doit renvoyer une chaîne qui peut être concaténée avec la première chaîne pour produire une chaîne de requête valide. Par exemple, pour renvoyer tous les utilisateurs actifs et remplir les conditions de la fonction getGroupQualifier(), utilisez : |
| Valeurs d’énumération dans l’ordre | Pour trier les données en fonction d’un champ spécifique, utilisez la condition ORDERBY avec la syntaxe suivante : field1=value^ORDERBYfield2. Par exemple, pour renvoyer les jours de la semaine dans l’ordre de la table Jour de la semaine [sys_cal_unit], utilisez : Dans la table Jour de la semaine, unit_name est le champ qui spécifie le jour, la semaine ou le mois, et la valeur est une valeur numérique pour chaque jour compris entre 1 (lundi) et 7 (dimanche). La chaîne de requête renvoie une liste des jours de la semaine dans l’ordre, de la valeur la plus basse, qui représente le lundi, à la valeur la plus grande, qui représente le dimanche. Remarque : Les qualificatifs de référence ne prennent pas en charge la condition ORDERBY. Dans les qualificatifs de référence, vous pouvez trier la liste de recherche de référence à l’aide de contrôles de liste standard. Pour spécifier l’ordre d’une liste de saisie semi-automatique pour un champ de référence, utilisez l’attribut dictionnaire ref_ac_order_by. |
| Y compris une requête de liste connexe | À la fin de l’instruction query, entourez les informations de la liste connexe avec ^RLQUERY et ^ENDRLQUERY et la quantité. Par exemple, dans une requête de la table Problème qui inclut des problèmes avec au moins un incident associé, utilisez :Vous pouvez également spécifier des conditions dans la table connexe. Par exemple, pour inclure la condition selon laquelle au moins un des incidents associés est de priorité critique, utilisez : Remarque : Les requêtes de liste connexe doivent être activées dans la liste des propriétés système v3. Cochez la case Autoriser l’ajout des conditions de requête de la liste connexe via le filtre pour l’activer . Vous pouvez créer une requête de liste connexe pour une liste qui utilise la liste v2, mais les conditions de filtre ne peuvent pas être modifiées tant que vous n’avez pas supprimé la condition de liste connexe dans le fil d’Ariane. |
| Y compris une requête de terme de recherche | Pour inclure un terme de recherche dans une requête, utilisez la variable réservée 123TEXTQUERY321. Par exemple, pour renvoyer des résultats contenant le terme de recherche « e-mail », utilisez cette chaîne de requête codée. |
| Y compris une requête de groupe d’index de texte | Pour inclure un groupe d’index de texte dans une requête, utilisez la variable réservée 123TEXTINDEXGROUP321. Par exemple, pour renvoyer des résultats dans le groupe d’index de texte portal_index_group dans la table Groupes d’index de texte [ts_index_group], utilisez cette chaîne de requête codée. |