Rechercher des tickets

Recherchez un ou plusieurs tickets et renvoyez le ou les ID correspondants. L'ID du ticket peut être utilisé avec une autre carte pour lire le ticket, mettre à jour ses informations, et plus encore.

Options

Champ	Définition	Type	Obligatoire
Retour	Choisissez Un seul ticket ou Tous les tickets correspondants. Un seul ticket : si cette option est sélectionnée, cette carte renvoie le premier ticket qui correspond à votre recherche. Utilisez cette option lorsque vous recherchez un ticket spécifique. Tous les tickets correspondants : si cette option est sélectionnée, cette carte renvoie une collection de tickets qui correspondent à votre recherche. Utilisez cette option lorsque vous recherchez un ensemble filtré de tickets.	Liste déroulante	TRUE

Champ

Définition

Type

Obligatoire

Retour

Choisissez Un seul ticket ou Tous les tickets correspondants.

Un seul ticket : si cette option est sélectionnée, cette carte renvoie le premier ticket qui correspond à votre recherche. Utilisez cette option lorsque vous recherchez un ticket spécifique.

Tous les tickets correspondants : si cette option est sélectionnée, cette carte renvoie une collection de tickets qui correspondent à votre recherche. Utilisez cette option lorsque vous recherchez un ensemble filtré de tickets.

Liste déroulante

TRUE

Entrée

Utilisez un ou plusieurs champs de saisie pour rechercher des tickets. Tous les résultats que vous ne souhaitez pas utiliser pour la recherche doivent être masqués de la carte.

Remarque :

Si vous spécifiez plusieurs critères de recherche, ils sont combinés pour créer la requête. La sortie résultante est le groupe qui correspond à tous les critères.

Cependant, si vous ne spécifiez aucun critère de recherche, la carte retourne tous les champs pour les enregistrements disponibles.

Champ	Définition	Type	Obligatoire
Ticket
Objet	Objet du ticket.	Texte	FALSE
Description	Description (ou premier commentaire) d'un ticket.	Texte	FALSE
Type	Type de ticket ; options : `problem`, `incident`, `question` ou `task`.	Liste déroulante	FALSE
Priorité	Priorité du ticket ; options : `urgent`, `high`, `normal` ou `low`.	Liste déroulante	FALSE
Statut	État du ticket (`new`, `open`, `pending`, `hold`, `solved` ou `closed`).	Liste déroulante	FALSE
Demandeur	ID de l'utilisateur qui a demandé le ticket.	Nombre	FALSE
Responsable	ID de l'agent à qui le ticket est affecté.	Texte	FALSE
Organisation	ID de l'organisation à qui appartient le demandeur.	Texte	FALSE
Groupe	ID du groupe auquel le ticket est affecté.	Texte	FALSE
Date d'échéance	Date d'échéance du ticket s'il est de type « task ». La date doit être au format ISO 8601.	Texte	FALSE
Balises	Liste des balises associées au ticket. Le ticket doit comporter chacune des balises de cette liste pour être inclus dans les résultats de la recherche.	Liste	FALSE
Via un canal	Une description de la façon dont le ticket a été créé ; les valeurs possibles sont `api`, `web` ou `mobile`.	Liste déroulante	FALSE
Formulaire de ticket	ID du formulaire de ticket qui a été utilisé pour rendre ce ticket, le cas échéant.	Texte	FALSE
Marque	ID de la marque associée à ce ticket.	Texte	FALSE
A une pièce jointe ?	Si la valeur `True` est sélectionnée, seuls les tickets avec des pièces jointes seront inclus dans les résultats. Si la valeur est `False`, seuls les tickets sans pièces jointes seront inclus dans les résultats.	Vrai/Faux	FALSE
Nom de la pièce jointe	Nom de fichier d'une pièce jointe.	Texte	FALSE
Cc	ID de tout utilisateur qui est actuellement mis en copie sur le ticket.	Texte	FALSE
Valeur de champ personnalisé	Recherche une valeur correspondante dans chaque champ personnalisé du ticket.	Texte	FALSE
ID externe	ID externe pour le ticket.	Texte	FALSE

Sortie

Champ	Définition	Type
ID de ticket	ID du premier ticket renvoyé par la recherche ; renvoyé lorsque l'option Un seul ticket est sélectionnée.	Texte
ID de ticket	ID de tous les tickets renvoyés par la recherche ; renvoyé lorsque l'option Tous les tickets correspondants est sélectionnée.	Liste