Recherches d’utilisateurs, de groupes et d’organisations

toutes les éditions Suite éditions team professional enterprise

Il est possible d’effectuer des recherches sur les données contenues dans les objets utilisateur, groupe et organisation. Une recherche portant sur ces objets renvoie des profils d’utilisateur et des pages de résumé de groupe et d’organisation, qui répertorient également les tickets associés.

Cet article aborde les sujets suivants :

À propos de la recherche
Mots-clés user et type
Recherches d’utilisateurs
Recherches d’utilisateurs par domaine d’e-mail
Recherches de groupes
Recherches d’organisations
Recherches dans les champs d’utilisateur et d’organisation personnalisés

À propos de la recherche

Vous pouvez faire des recherches sur les utilisateurs, organisations et groupes à l’aide de l’outil de recherche affiché dans la page Utilisateurs.

Si vous effectuez une recherche à partir de cette page, les résultats sont limités aux données de ces utilisateurs.

Si vous effectuez une recherche à l’aide de l’outil de recherche globale, vous devez également utiliser le mot-clé type pour limiter les résultats à certains types de données. Dans le cas contraire, vos résultats de recherche contiendront des correspondances provenant des données de votre instance Zendesk Support.

type:organization tags:premium

Pour en savoir plus au sujet de l’utilisation de la recherche, consultez Recherche de données dans votre Zendesk. Toutes les propriétés de données d’utilisateur pouvant faire l’objet de recherches sont décrites dans les tableaux ci-dessous. Toutes les données pouvant faire l’objet de recherches dans votre instance Zendesk Support (y compris les données de ticket) sont décrites à la section Recherches Zendesk – Principes de base.

Mots-clés user et type

Pour rechercher les données de profil d’un utilisateur, vous avez deux possibilités.

Utilisation du mot-clé user :

user:amy

Ou utilisation du mot-clé type:user :

type:user amy

Quelle est la différence entre les deux ? Le mot-clé user, lorsqu’il n’est pas combiné à type, est un simple raccourci permettant de rechercher des utilisateurs par ID, nom et adresse e-mail. Le mot-clé user, à l’instar des mots-clés de rôle d’utilisateur de ticket (assignee, requester, submitter), accepte l’ID, le nom et l’adresse e-mail comme identifiants utilisateur valides.

user:52789480
user:amy
user:"amy moore"
user:amy@mondocam.com

Si vous souhaitez rechercher d’autres données d’utilisateur, telles que le numéro de téléphone de l’utilisateur, l’organisation à laquelle il appartient, etc., vous devez utiliser type:user.

type:user tags:beta_user organization:customers

Cet exemple démontre également l’utilité du mot-clé type. Il vous permet en effet de rechercher des données communes à plusieurs utilisateurs. Vous pouvez ainsi rechercher des utilisateurs appartenant à la même organisation ou au même groupe, ou toutes autres données d’utilisateur pouvant faire l’objet de recherches. Pour plus d’informations sur le mot-clé type, consultez Utilisation du mot-clé type.

Le mot-clé type sert également à faire des recherches dans les objets groupe et organisation.

type:group name:"level 2"
type:organization name:customers

Recherches d’utilisateurs

L’objet de données d’utilisateur contient toutes les propriétés que vous pouvez définir dans le profil d’utilisateur. Les données du profil d’utilisateur ne peuvent pas toutes faire l’objet de recherches ; celles qui le peuvent sont décrites dans le tableau suivant.

Tableau 1. Mots-clés de propriétés utilisateur
Mot-clé	Description
`name`	Nom partiel ou complet de l’utilisateur. name:"alex anderson"
`role`	Rôle désigné de l’utilisateur. role:admin
`email`	Spécifiez l’adresse e-mail de l’utilisateur ou `none` pour rechercher les utilisateurs sans adresse e-mail. email:alex@mondocam.com
`group`	Nom complet de l’utilisateur. Ne s’applique qu’aux administrateurs et agents. group:"Level 2"
`organization`	Spécifiez le nom ou l’ID de l’organisation de l’utilisateur ou `none` pour rechercher les utilisateurs sans organisation. Si l’utilisateur appartient à plusieurs organisations, la recherche de n’importe laquelle de ces organisations renvoie son profil. organization:mondocam
`created`	Date à laquelle l’utilisateur a été ajouté à votre Zendesk. created<2011-05-01 Pour en savoir plus au sujet de l’utilisation de la date et de l’heure dans vos recherches, consultez Recherche par date et par heure.
`notes`	Tout le texte du champ de notes du profil de l’utilisateur. notes:"manager"
`details`	Tout le texte du champ des détails du profil de l’utilisateur. details:"madison, wi"
`external_id`	Spécifiez l’ID externe de l’utilisateur ou `none` pour rechercher les utilisateurs sans ID externe. external_id:0098884412
`phone`	Spécifiez le numéro de téléphone de l’utilisateur ou `none` pour rechercher les utilisateurs sans numéro de téléphone. phone:555-111-2222
`tags`	Spécifiez les marqueurs du profil de l’utilisateur ou `none` pour rechercher les utilisateurs sans marqueurs. tags:premium tags:wholesale Pour en savoir plus sur le marquage des utilisateurs et des organisations, consultez Ajout de marqueurs à des utilisateurs et des organisations.
`customfield`	Champs d’utilisateur personnalisés. plan_type:platinum Pour en savoir plus, consultez Recherches dans les champs d’utilisateur et d’organisation personnalisés.
`is_verified`	Recherchez les utilisateurs avec ou sans une adresse e-mail vérifiée en utilisant `true` ou `false`. Pour rechercher les utilisateurs avec une adresse e-mail vérifiée : is_verified:true Pour rechercher les utilisateurs sans adresse e-mail vérifiée : is_verified:false
`suspended`	Recherchez les utilisateurs qui sont ou ne sont pas suspendus en utilisant `true` ou `false`. Pour rechercher les utilisateurs qui sont suspendus : is_suspended:true Pour rechercher les utilisateurs qui ne sont pas suspendus : is_suspended:false Pour en savoir plus, consultez Recherches dans les champs d’utilisateur et d’organisation personnalisés.
whatsapp	Recherchez des utilisateurs en utilisant un numéro de téléphone WhatsApp. Pour en savoir plus, consultez Recherche de tickets par numéro de téléphone WhatsApp.

Recherches d’utilisateurs par domaine d’e-mail

Tous les utilisateurs appartenant au même domaine d’e-mail peuvent être renvoyés avec l’instruction de recherche suivante :

type:user mondocam.com

Pour rechercher plusieurs domaines d’e-mail en même temps, il suffit d’ajouter d’autres domaines à la recherche :

type:user mondocam.com zendesk.com

Recherches de groupes

Voici la liste des propriétés de groupe qui peuvent faire l’objet d’une recherche.

Tableau 2. Mots-clés de propriété de groupe
Mot-clé	Description
`name`	Nom du groupe. name:"level 2"
`created`	Date d’ajout du groupe. created<2011-05-01 Pour en savoir plus au sujet de l’utilisation de la date et de l’heure dans vos recherches, consultez Recherche par date et par heure.

Recherches d’organisations

Voici la liste des propriétés d’organisation qui peuvent faire l’objet d’une recherche.

Tableau 3. Mots-clés de propriétés d’organisation
Mot-clé	Description
`name`	Nom partiel ou complet de l’organisation. name:mondocam
`created`	Date d’ajout de l’organisation. created<2011-05-01 Pour en savoir plus au sujet de l’utilisation de la date et de l’heure dans vos recherches, consultez Recherche par date et par heure.
`notes`	Tout le texte du champ de notes du profil de l’utilisateur. notes:EMEA
`details`	Tout le texte du champ des détails du profil de l’organisation. details:london
`tags`	Spécifiez les marqueurs qui ont été ajoutés à l’organisation ou `none` pour rechercher les organisations sans marqueurs. tags:premium Pour en savoir plus sur le marquage des utilisateurs et des organisations, consultez Ajout de marqueurs à des utilisateurs et des organisations.
`customfield`	Champs d’organisation personnalisés. plan_type:platinum Pour en savoir plus, consultez Recherches dans les champs d’utilisateur et d’organisation personnalisés.
`external_id`	L’ID externe de l’organisation ou none pour rechercher les utilisateurs sans ID externe. external_id:00112345

Recherches dans les champs d’utilisateur et d’organisation personnalisés

Vous pouvez rechercher des données dans les champs d’utilisateur et d’organisation personnalisés en utilisant la clé qui identifie le champ personnalisé.

Pour trouver la clé d’un champ personnalisé, cliquez sur l’icône Admin () et sélectionnez Champs d’utilisateur ou Champs d’organisation, puis cliquez sur le nom d’un champ personnalisé. La clé du champ se trouve dans le panneau des propriétés sur la droite.

Vous pouvez rechercher des utilisateurs et des organisations qui n’ont aucune valeur dans un champ personnalisé spécifique, en utilisant « none » comme terme de recherche, en plus de la clé de champ personnalisé. Par exemple, si vous avez la clé de champ personnalisé foo et si vous recherchez foo:none, la recherche renvoie tous les utilisateurs et toutes les organisations avec le champ personnalisé foo vide.

Remarque – Vous ne pouvez pas rechercher de données dans les champs de ticket personnalisés comme vous le faites dans les champs d’utilisateur et d’organisation personnalisés. pour les champs de ticket personnalisés, vous pouvez rechercher des données dans les champs de listes déroulantes et de cases à cocher en vous servant de leurs marqueurs. Pour en savoir plus, consultez Recherches de champs personnalisés.

Type de champ	Opérateurs	Exemples
Liste déroulante	:	Trouvez des utilisateurs ou des organisations avec un plan_type platinum : plan_type:platinum Trouvez des utilisateurs ou des organisations avec un plan_type platinum ou gold : plan_type:platinum plan_type:gold
Texte Texte multiligne	:	Trouvez des utilisateurs ou des organisations avec un product_name qui contient widget : product_name:widget
Expression régulière	:	Trouvez des utilisateurs ou des organisations avec un product_name qui contient l’expression « red widget » : product_name:"red widget"
Numérique	>, <, >=, <=, :	Trouvez des utilisateurs ou des organisations avec un num_agents de 5 exactement : num_agents:5 Trouvez des utilisateurs ou des organisations avec un num_agents compris entre 4 et 10 : num_agents>4 num_agents<10
Décimal	>, <, >=, <=, :	Trouvez des utilisateurs ou des organisations avec un avg_score supérieur à 14,5 : avg_score>14.5 Trouvez des utilisateurs ou des organisations avec un avg_score entre 10,1 et 15,3 non compris : avg_score>10.1 avg_score<15.3
Case à cocher	:	Trouvez des utilisateurs ou des organisations avec un is_active vrai : is_active:true
Date	>, <, >=, <=, :	Trouvez des utilisateurs ou des organisations avec une subscription_date antérieure au 23/06/2013 : subscription_date<2013-06-23 Trouvez des utilisateurs ou des organisations avec une subscription_date entre le 23/05/2012 et le 23/06/2013, non compris : subscription_date>2012-05-23 subscription_date<2013-06-23