Interrogation des tables dans le script
À l’aide des méthodes de l’API GlideRecord, vous pouvez renvoyer tous les enregistrements d’une table, renvoyer des enregistrements d’une table qui répondent à des conditions spécifiques ou renvoyer des enregistrements qui incluent une chaîne d’une seule table ou de plusieurs tables dans un groupe d’index de texte.
Interrogez les tables à l’aide de l’API GlideRecord. Pour obtenir la référence de l’API, consultez GlideRecord : champ d’application.
Renvoyer tous les enregistrements d’une table
var target = new GlideRecord('incident');La création d’un GlideRecord crée une variable cible qui est un objet GlideRecord pour la table d’incidents.
target.query(); // Issue the query to the database to get all records
while (target.next()) {
// add code here to process the incident record
}Ce script émet la requête () à la base de données. Chaque appel à next() chargerait l’enregistrement suivant pour traitement.
Renvoyer les enregistrements d’une table qui satisfont aux conditions de requête
var target = new GlideRecord('incident');
target.addQuery('priority',1);
target.query(); // Issue the query to the database to get relevant records
while (target.next()) {
// add code here to process the incident record
}l’exemple de script inclut target.addQuery('priority', 1) ;. Cette ligne indique que vous ne voulez que les enregistrements dont le priority champ est égal à 1. En général, la plupart des requêtes que vous souhaitez effectuer sont des requêtes d’égalité ; Demande où vous souhaitez trouver les enregistrements avec un champ égal à une valeur. Pour cette raison, vous n’avez pas besoin de fournir un opérateur d’égalité. Toutefois, supposons que vous souhaitiez rechercher tous les incidents dont le priority champ est supérieur à 1. Dans ce cas, vous indiquerez l’opérateur que vous souhaitez appliquer à la requête.var target = new GlideRecord('incident') ;
target.addQuery('priority','>',1);
target.query(); // Issue the query to the database to get relevant records
while (target.next()) {
// add code here to process the incident record
}Renvoyer des enregistrements à partir d’une table qui inclut une chaîne
Utilisez le nom réservé '123TEXTQUERY321' pour rechercher des correspondances de chaîne dans tous les champs d’une table. Par exemple, ce script renvoie les enregistrements de la table Incident avec des valeurs de champ qui incluent la chaîne « email ».
var now_GR = new GlideRecord('incident');
gr.addQuery('123TEXTQUERY321', 'email');
gr.query();
'123TEXTQUERY321' est une option réservée pour le name paramètre dans la méthode addQuery( ). Vous pouvez utiliser cette option dans une chaîne de requête codée. Par exemple, au lieu de gr.addQuery('123TEXTQUERY321', 'email') ;, vous pouvez utiliser gr.addEncodedQuery('123TEXTQUERY321=email').
La recherche par chaîne n’est pas sensible à la casse. Le système renvoie les mêmes résultats, que vous recherchiez e-mail, E-mail ou E-mail.
Renvoyer les enregistrements de plusieurs tables dans un groupe d’index de texte qui incluent une chaîne
Utilisez le nom réservé '123TEXTINDEXGROUP321 ' pour rechercher une chaîne dans une table à partir d’un groupe d’index de texte. Cette option renvoie des résultats avec des scores de pertinence calculés à l’aide des paramètres du groupe d’index de texte.
var now_GR = new GlideRecord('kb_knowledge');
gr.addQuery('123TEXTQUERY321', 'email');
gr.addQuery('123TEXTINDEXGROUP321', 'portal');
gr.query();Vous pouvez créer une requête similaire pour chaque table supplémentaire du groupe d’index « portail » que vous souhaitez rechercher, puis fusionner les résultats des requêtes individuelles, en affichant en premier les résultats présentant les scores de pertinence les plus élevés. Étant donné que toutes ces requêtes de recherche utilisent les mêmes paramètres de recherche de groupe d’index de texte, les scores de pertinence de leurs résultats sont tous normalisés de manière cohérente. Si vous effectuez une recherche dans le même ensemble de tables sans utiliser la méthode gr.addQuery('123TEXTINDEXGROUP321', 'portal'), les scores de pertinence des requêtes individuelles seront normalisés différemment et ne constitueront pas une base utile pour trier le jeu de résultats fusionné.
'123TEXTINDEXGROUP321 ' est une option réservée pour le name paramètre dans la méthode addQuery( ). Vous pouvez utiliser cette option dans une chaîne de requête codée. Par exemple, au lieu de gr.addQuery('123TEXTINDEXGROUP321', 'portal') ;, vous pouvez utiliser gr.addEncodedQuery('123TEXTINDEXGROUP321=portal').
La recherche de chaîne multi-tables n’est pas sensible à la casse. Le système renvoie les mêmes résultats, que vous recherchiez e-mail, E-mail ou E-mail.
Opérateurs JavaScript disponibles
Décrit les opérateurs qui peuvent être utilisés dans une demande addQuery( ).
| Champ | Définition | addQuery |
|---|---|---|
| = | Le champ doit être égal à la valeur fournie. | addQuery('priorité', '=', 1) ; |
| > | La valeur du champ doit être supérieure à la valeur fournie. | addQuery('priorité', '>', 1) ; |
| < | La valeur du champ doit être inférieure à la valeur fournie. | addQuery('priorité', '<', 3) ; |
| >= | Le champ doit être égal ou supérieur à la valeur fournie. | addQuery('priorité', '>=', 1) ; |
| <= | Le champ doit être inférieur ou égal à la valeur fournie. | addQuery('priorité', '<=', 3) ; |
| != | Le champ ne doit pas être égal à la valeur fournie. | addQuery('priority', ' !=', 1) ; |
| COMMENCE PAR | Le champ doit commencer par la valeur fournie. L’exemple présenté à droite renvoie tous les enregistrements dont le champ short_description commence par le texte Erreur. | addQuery('short_description', 'STARTSWITH', 'Erreur') ; |
| CONTIENT | Le champ doit contenir la valeur fournie quelque part dans le texte. L’exemple montré à droite renvoie tous les enregistrements dans lesquels le champ short_description contient le texte Erreur n’importe où dans le champ. Remarque : L’opération LIKE n’est pas prise en charge. Les administrateurs doivent utiliser CONTAINS dans la requête. |
addQuery('short_description', 'CONTAINS', 'Erreur') ; |
| DANS | Utilise une carte de valeurs qui autorise les virgules et rassemble une collection d’enregistrements qui répondent à une autre condition. Se comporte comme Sélectionnez * <table> d’où short_description IN (« Erreur », « Réussite », « Échec »), ce qui est identique à Sélectionnez * <table> d’où short_description='Erreur'. Par exemple, pour interroger toutes les valeurs variables qui appartiennent à une activité spécifique, utilisez la IN clause et stockez leurs sys_ids dans une carte ou une liste séparée par des virgules. Interrogez ensuite la table de valeurs de variables et fournissez cette liste de sys_ids. |
addQuery('short_description', 'IN', 'Erreur,Réussite,Échec') ; |
| SE TERMINE PAR | Le champ doit se terminer avec la valeur fournie. L’exemple montré à droite renvoie tous les enregistrements dont le champ short_description se termine par une erreur de texte. | addQuery('short_description', 'ENDSWITH', 'Erreur') ; |
| NE CONTIENT PAS | Sélectionne les enregistrements qui ne correspondent PAS au modèle affiché dans le champ. Cet opérateur ne récupère pas les champs vides. Pour les valeurs vides, utilisez les opérateurs « est vide » ou « n’est pas vide ». L’exemple ci-contre renvoie tous les enregistrements dont le champ short_description ne contient pas le mot « Erreur ». | addQuery('short_description', 'NE CONTIENT PAS', 'Erreur') ; |
| PAS DANS | Utilise une carte de valeurs qui autorise les virgules et rassemble une collection d’enregistrements qui répondent à une autre condition. Se comporte comme suit : Sélectionnez * à partir duquel <table> short_description PAS DANS (« Erreur »). |
addQuery('short_description', 'PAS DANS', 'Erreur,Réussite,Échec') ; |
| INSTANCEDE | Opérateur spécial qui récupère uniquement les enregistrements d’une « classe » spécifiée pour les tables étendues. L’exemple de code de droite montre comment récupérer tous les éléments de configuration qui sont classés en tant qu’ordinateurs. | addQuery('sys_class_name', 'INSTANCEOF', 'cmdb_ci_computer') ; |
Pour plus d’informations sur les opérateurs disponibles pour les filtres et les requêtes, reportez-vous à la section Operators available for filters and queries.
var target = new GlideRecord('incident');
target.addNullQuery('short_description');
target.query(); // Issue the query to the database to get all records
while (target.next()) {
// add code here to process the incident record
}var target = new GlideRecord('incident');
target.addNotNullQuery('short_description');
target.query(); // Issue the query to the database to get all records
while (target.next()) {
// add code here to process the incident record
}Pour plus d’informations sur l’API GlideRecord et ses méthodes disponibles, consultez GlideRecord.
Exemples de requêtes GlideRecord
Ces exemples montrent comment effectuer diverses requêtes GlideRecord .
requête
var rec = new GlideRecord('incident');
rec.query();
while(rec.next()) {
gs.print(rec.number + ' exists'); }
mettre à jour
var rec = new GlideRecord('incident');
rec.addQuery('active',true);
rec.query();
while(rec.next()) {
rec.active = false;
gs.print('Active incident ' + rec.number = ' closed');
rec.update(); }
insérer
var rec = new GlideRecord('incident');
rec.initialize();
rec.short_description = 'Network problem';
rec.caller_id.setDisplayValue('Joe Employee');
rec.insert();
supprimer
var rec = new GlideRecord('incident');
rec.addQuery('active',false);
rec.query();
while(rec.next()) {
gs.print('Inactive incident ' + rec.number + ' deleted');
rec.deleteRecord(); }
Interrogation des tables de Catalogue de services
var now_GR = new GlideRecord('sc_item_option_mtom');
gr.addQuery('sc_item_option.item_option_new.name','item_name');
gr.addQuery('sc_item_option.value','item_value');
gr.query();
while(gr.next()) {
gs.addInfoMessage(gr.request_item.number); }Pour plus d’informations, consultez GlideRecord.