ユーザー、グループ、組織の検索

現在のプランを確認

Suite

すべてのプラン

Support

すべてのプラン

エンドユーザー、チームメンバー、グループ、組織の各オブジェクトのデータは、それぞれのページで検索することができます。

この記事では、次のトピックについて説明します。

• 検索の概要
• userおよびtypeキーワード
• ユーザーを検索する
• メールドメインでユーザーを検索する
• グループを検索する
• 組織を検索する
• カスタムユーザーフィールドとカスタム組織フィールドを検索する

検索の概要

ユーザーの管理や整理に関連する各ページの上部には、検索バーがあります。これらのページでの検索は、ページ内の範囲に限定されます。つまり、「チームメンバー」ページで検索すると、検索条件を満たすチームメンバーのみが表示され、同様に「組織」ページで検索すると、検索条件を満たす組織のみが表示されます。

グローバル検索ツールを使用して検索する場合、結果を特定の種類のデータに絞り込むには、typeキーワードを使用する必要があります。このキーワードを使用しない場合、Zendesk Supportインスタンス全体が検索対象となり、全体を検索した結果が表示されます。

type:organization tags:premium

検索の使用について詳しくは、「Zendesk Supportデータの検索」を参照してください。検索可能なユーザーデータのすべてのプロパティについて、下の表に説明します。検索可能なZendesk Supportインスタンス内のすべてのデータ（チケットデータも含む）については、「Zendesk検索リファレンス」を参照してください。

userおよびtypeキーワード

ユーザーのプロフィールデータを検索するには、次の2つのオプションがあります。

userキーワードを使用するか、

user:amy

type:userキーワードを使用する

type:user amy

この2つのオプションは何が違うのでしょうか。キーワードuserは、typeと組み合わせて使用しない場合、ユーザーをID、名前、およびメールアドレスで検索するための簡単な手段です。userキーワードは、ticket user roleキーワード（担当者、リクエスタ、送信者）と同じように、ID、名前、メールアドレスを有効なユーザーIDとして受け入れます。

user:52789480
user:amy
user:"amy moore"
user:[e-mail]

ユーザーの電話番号、所属組織などのその他のユーザーデータを検索する場合は、type:userを使用する必要があります。

type:user tags:beta_user organization:customers

この例では、typeキーワードの便利な点も示しています。このキーワードを使うと、複数のユーザーで共有されているユーザーデータを検索することができます。同じ組織またはグループ内のユーザーまたはその他の検索可能なユーザーデータを検索できます。typeキーワードの詳細については、「typeキーワードを使用する」を参照してください。

typeキーワードは、グループおよび組織データオブジェクトの検索にも使用されます。以下に例を示します。

• type:group name:"level 2"

• type:organization name:customers

ユーザーを検索する

ユーザーデータオブジェクトには、エンドユーザーおよびチームメンバーのユーザープロフィールで設定できるすべてのユーザープロパティが含まれています。ユーザープロフィールデータをすべて検索できるわけではありません。検索可能なプロパティについては、以下の表で説明します。

表1. ユーザープロパティのキーワード

キーワード	説明
name	ユーザーの名前の一部またはフルネーム。 name:"alex anderson"
role	ユーザーに指定されたロール。 role:admin
email	ユーザーのメールアドレスを指定するか、noneを指定してメールアドレスのないユーザーを検索します。 email:[e-mail] email:"none" ヒント：メールアドレスの検索では、ワイルドカードは使えません。たとえば、次のような検索では結果が返されません。 email:dwight*
group	ユーザーグループの名前。管理者とエージェントにのみ該当します。 group:"Level 2"
organization	組織の名前またはIDを指定するか、noneを指定して組織に所属していないユーザーを検索します。ユーザーが複数の組織に所属している場合は、それらの組織のいずれかを検索すると、そのプロフィールが返されます。 organization:mondocam
created	ユーザーがZendeskに追加された日付。 created<2011-05-01 日付と時刻を指定して検索する方法について詳しくは、「日時で検索する」を参照してください。
notes	ユーザープロフィールのメモフィールド内のすべてのテキスト。 notes:"manager"
details	ユーザープロフィールの詳細フィールド内のすべてのテキスト。 details:"madison, wi"
external_id	ユーザーの外部IDを指定するか、noneを指定して外部IDのないユーザーを検索します。 external_id:0098884412
phone	ユーザーの電話番号を指定するか、noneを指定して電話番号のないユーザーを検索します。 phone:[phone]
tags	ユーザーのプロフィールのタグを指定するか、noneを指定してタグのないユーザーを検索します。 tags:premium tags:wholesale ユーザーと組織へのタグ付けの詳細については、「ユーザーおよび組織へのタグの追加」を参照してください。
customfield	カスタムユーザーフィールドです。 plan_type:platinum 詳細については、「カスタムユーザーおよび組織フィールドを検索する」を参照してください。
is_verified	ユーザーのメインのメールアドレスが確認されたかどうかを示します。 「is_verified:false Sunita」と指定すると、確認されていないメインのメールアドレスを持つSunitaという名前のすべてのユーザーが返されます。 「is_verified:true」と指定すると、確認済みのメインのメールアドレスを持つすべてのユーザーが返されます。
is_suspended	ユーザーが一時停止されているかどうかを示します。 is_suspended:true Sunita：Suitaという名前の一時停止されたユーザーをすべて返します。 is_suspended:true：一時停止されたすべてのユーザーを返します。
whatsapp	WhatsAppの電話番号に基づいてユーザーを検索します。 詳しくは、「WhatsAppの番号を使用してチケットを検索する」を参照してください。

メールドメインでユーザーを検索する

次の検索文を使用して、同じメールドメインに属するすべてのユーザーを検索できます。

type:user mondocam.com

複数のメールドメインを一度に検索する場合は、次の例のように、メールドメインをスペースで区切って検索文に追加するだけです。

type:user mondocam.com zendesk.com

グループを検索する

検索可能なグループプロパティの一覧を以下に示します。

表2. グループプロパティのキーワード

キーワード	説明
name	グループの名前。 name:"level 2"
created	グループが追加された日付。 created<2011-05-01 日付と時刻を指定して検索する方法について詳しくは、「日時で検索する」を参照してください。

組織を検索する

検索可能な組織のプロパティの一覧を以下に示します。

表3. 組織プロパティのキーワード

キーワード	説明
name	組織の名称の一部または正式名称。 name:mondocam
created	組織が追加された日付。 created<2011-05-01 日付と時刻を指定して検索する方法について詳しくは、「日時で検索する」を参照してください。
notes	ユーザープロフィールのメモフィールド内のすべてのテキスト。 notes:EMEA
details	組織プロフィールの詳細フィールド内のすべてのテキスト。 details:london
tags	組織に追加されたタグを指定するか、noneを指定してタグのない組織を検索します。 tags:premium ユーザーと組織へのタグ付けの詳細については、「ユーザーおよび組織へのタグの追加」を参照してください。
customfield	カスタム組織フィールドです。 plan_type:platinum 詳細については、「カスタムユーザーおよび組織フィールドを検索する」を参照してください。
external_id	組織の外部IDを指定して検索するか、noneを指定して外部IDのないユーザーを検索します。 external_id:00112345

カスタムユーザーフィールドとカスタム組織フィールドを検索する

カスタムフィールドを特定するキーを使用することで、カスタムユーザーフィールドおよびカスタム組織フィールド内のデータを検索できます。

カスタムフィールドのキーを見つけるには

1. カスタムフィールドのリストに移動します。
   • 管理センターで、サイドバーにあるメンバーアイコン（）をクリックし、「設定」>「組織フィールド」を選択します。
   • 管理センターで、サイドバーにあるメンバーアイコン（）をクリックし、「設定」>「ユーザーフィールド」を選択します。
2. カスタムフィールドの名前をクリックします。

   フィールドキーが、右側のプロパティパネルに表示されます。

カスタムフィールドキーとともに検索語に「none」を指定して、特定のカスタムフィールドに値のないユーザーと組織を検索できます。たとえば、カスタムフィールドキーfooがあるとして、「foo:none」を検索すると、カスタムフィールドfooが空のすべてのユーザーと組織が返されます。

メモ：カスタムユーザーフィールドやカスタム組織フィールドでの検索と同じ方法で、カスタムチケットフィールド内のデータを検索することはできません。カスタムチケットフィールドでは、ドロップダウンフィールドおよびチェックボックスフィールド内のデータを、それらのデータのタグに基づいて検索できます。詳細については、「カスタムチケットフィールドを検索する」を参照してください。

フィールドタイプ	演算子	例
ドロップダウンリスト	:	plan_typeがplatinumのユーザーまたは組織を検索します。 plan_type:platinum plan_typeがplatinumまたはgoldのユーザーまたは組織を検索します。 plan_type:platinum plan_type:gold
テキスト 複数行テキスト	:	product_nameにwidgetが含まれるユーザーまたは組織を検索します。 product_name:widget
正規表現	:	product_nameに複数語から成るフレーズ"red widget"が含まれるユーザーまたは組織を検索します。 product_name:"red widget"
数値	>、<、>=、<=、:	num_agentsが5と等しいユーザーまたは組織を検索する場合： num_agents:5 num_agentsが4以上10以下であるユーザーまたは組織を検索します。 num_agents>4 num_agents<10
小数	>、<、>=、<=、:	avg_scoreが14.5より大きいユーザーまたは組織を検索します。 avg_score>14.5 avg_scoreが10.1より大きく15.3未満であるユーザーまたは組織を検索します。 avg_score>10.1 avg_score<15.3
チェックボックス	:	is_activeがtrueであるユーザーまたは組織を検索します。 is_active:true
日付	>、<、>=、<=、:	subscription_dateが2013年6月23日より前であるユーザーまたは組織を検索します。 subscription_date<2013-06-23 subscription_dateが2012年5月23日～2013年6月23日の間であるユーザーまたは組織を検索します。 subscription_date>2012-05-23 subscription_date<2013-06-23
ルックアップリレーションシップ		ルックアップリレーションシップフィールドの値による検索はサポートされていません。