この記事では、使用できるデータプロパティキーワードとその値のリストと、検索の絞り込みに使用できる一般的な検索演算子について説明します。また、高度な検索メソッドとフォーマットについても説明します。
この記事は、Zendesk Supportマネージャーの全データにフルアクセス権を持つ管理者とサポート部門のマネージャーを対象としています。エージェントの方は、まず「Zendesk Supportデータの検索」を参照したうえで、さらに高度な検索を行う必要がある場合にのみ、この記事を参考にしてください。
この記事には、高度な検索メソッドに関する次のトピックについて説明します。
この記事には、以下の項目に関する表形式のリファレンスも含まれます。
検索に使用する語と定義
検索語
検索語はユーザー定義の語や語句、値です。例:
- 3245227
- Greenbriar
- シリアル番号
- 「稲葉 理恵」
検索語は大文字と小文字を区別しません。たとえば、「App」と「app」を入力した場合、どちらも同じ結果が返されます。
1つの語は、データに次の形で含まれている場合に結果として返されます。
- 1つの語
- 長い語句に含まれる1つの語
- より長い語の接頭語
次の形で含まれている場合は結果として返されません。
- 語の中に含まれている
- 語末に含まれている
例えば、検索語が「top」である場合、「top」、「top tier」、「Top Ten Trucking」、「Tip-Top Mops」、「Big Top Entertainment」、「Dessert Toppings、Inc」に一致しますが、「Desktop Solutions」や「One-Stop Publishing」には一致しません。
Please upgrade my account
プロパティのキーワード
プロパティのキーワードと検索条件や演算子を組み合わせることで、検索結果を絞り込むことができます。以下に例を示します。
status<solved
プロパティのキーワードは、チケット、ユーザー、組織、グループ内の名前です。例:
- assignee
- created
- name
すべてのプロパティや詳細については、以下のプロパティのキーワードをリファレンスを参照してください。
プロパティ検索の例:
Search | プロパティのキーワード | 検索結果 |
---|---|---|
priority>普通 | priority | 優先度が「高」または「緊急」であるチケット |
subject:2fa | subject | 検索語の「2fa」が件名に含まれるチケット |
email:jdoe@example.com | jdoe@example.comというメールアドレスを持つユーザー |
一部のプロパティにはプリセットの値があります。たとえば、チケットステータスプロパティには「新規、オープン、保留中、待機中、解決済み、終了」というプリセットの値があり、検索できるのはこれらの値のみです。検索例:status:open
。各プロパティの詳細については、プロパティのキーワードのリファレンスを参照してください。
その他のプロパティは、ユーザーが指定した検索語を受け付けます。例:subject:2fa
「検索語」を参照してください。プロパティ検索には、接頭語の一致を除き、同じ一致規則が適用されます。検索語が長い単語の接頭語として出現した場合、結果は返されません。たとえば、検索語が「tier」の場合、「tier 1」と「tier 2」は結果として返されますが、「tiered」は返されません。
クエリに同じプロパティのキーワードを複数回含めると、1つのプロパティの値を複数検索できます。以下に例を示します。
tags:silver tags:bronze
この場合、検索ではORロジックが使用されます。前述の例で検索すると、検索結果には「silver」タグか「bronze」タグのいずれかが含まれます。
検索例
次の検索式は、タグが「vip」で、2019年5月1日より前に作成されたチケットを検索します。
tags:vip created<2019-05-01
- 「tags」は、特定のデータプロパティ(この場合、tag)を対象に検索することを示すプロパティキーワードです。
- 「:」は「等しい」演算子で、tagプロパティ値が後続の検索語と等しい必要があることを示します。「:」の前後にスペースがないことに注意してください。
- 「vip」は検索語です。
- createdは、特定の日付に作成された項目のcreatedデータプロパティを検索することを示すプロパティキーワードです。
- 「<」は、特定の日付より前に作成されたレコードを検索することを示す「より小さい」演算子です。
- 2015-05-01は、検索に使用する日付を示す検索語です。
データのないプロパティを検索する
none
を検索語として検索できます。assignee:none
この検索では、すべての未割り当てのチケットが返されます。
日時で検索する
日付のプロパティキーワード(created、updated、solved、due date)を検索演算子と組み合わせて、特定の日付、特定の日付より前、特定の日付の翌日以降のデータを返すことができます。ロケールにかかわらず日付を検索する場合は、YYYY-MM-DDの日付形式を使用します。MM/DD/YYYY(米国)など、ロケール固有の形式を使用することもできます。
created<2011-05-01
due_date>2010-01-10
solved:2010-01-10
また、<=(より小さいか等しい)と>=(より大きいか等しい)の演算子を使用して、それぞれ特定の日付以前(日付の日を含む)と特定の日付以降(日付の日を含む)のデータを検索することができます。
日付と時間を組み合わせて検索する
created>2015-09-01T12:00:00-08:00 updated<2015-09-01T12:00:00Z
上記の最初の例は、2015年の9月1日の午後12時(PST)より前に作成されたものを検索します。
2番目の例は、2015年の9月1日の午後12時(UTC)より前に更新されたものを検索します。
日付または時間の範囲を指定して検索する
created>2014-08-01 created<2014-08-05
また、検索範囲に時間を含めることもできます。次の例は、2014年8月1日の午後11時59分(UTC)から2014年8月4日の午前0時(UTC)までの間に作成されたものを検索します。
created>2014-08-01T23:59:00Z created<2014-08-04T23:59:59Z
相対時間で検索する
現在の時間を基準とする相対的な時間で検索する場合は、hours、minutes、minutes、weeks、months、yearsなどの時間単位を使用できます。以下の検索文は、最近の4時間内に作成されたものを返します。
created>4hours
検索結果を並べ替える
order_by:field
-
sort:asc
またはsort:desc
created
commented
priority
status
ticket_type
order_by
およびsort
のキーワードを使用するのは、sort_by
およびsort_order
のAPIパラーメータを使用するのと同じです。
typeキーワードを使用する
API検索では、検索結果を絞り込むために提供されているツールの1つにtype
キーワードがあります。このキーワードは、次のタイプを検索することを明示的に宣言するために使用します。
- ticket
- user
- organization
- group
type
キーワードの使用は、指定するタイプを明示的に検索していることを意味します。たとえば、次の検索文を使用すると、「カスタマー」組織に属するユーザー全員を検索できます。
type:user organization:customers
あるいは、organization:customers
と指定して検索すると、リクエスタがこの組織に属しているチケット全部が検索結果として返されます。これは、タイプを明示的に指定しないで検索した場合、チケットを含め(組織がチケットのプロパティになっている)、すべてのタイプの検索結果が返されるためです。
type:user
を使用すると、customers組織に属するすべてのユーザーが返されます。このため、検索をuserタイプに絞り込んで、チケットを除外します。
組織とグループはユーザーオブジェクトのプロパティですが、それぞれ独自のプロパティを持ち、それを検索することもできます。次のクエリでは、organizationタグのみを検索し、チケットやフォーラムトピックなどのZendesk Supportインスタンスの他の要素で使用できる同じ名前のタグを除外しています。
type:organization tags:premium
userキーワードを使用する
ユーザーのプロフィールデータを検索するには、次の2つのオプションがあります。
user
キーワードを使用するか、user:amy
type:user
キーワードを使用するtype:user amy
user
キーワードとtype:user
キーワードとの違いの詳細については、「ユーザー、グループ、組織の検索」の「userおよびtypeキーワード」に関するセクションを参照してください。
検索に関するFAQ
-
新しいデータが検索可能になるまでのどのくらい時間がかかりますか
Zendesk Supportに新しいデータを追加した場合、通常1分ほどでインデックスが作成されて検索できるようになります。
-
句読点は検索に影響しますか
句読点は、通常は検索に含まれません。
-
ワイルドカード検索に何か制限はありますか
ワイルドカード検索を実行できるのは、プロパティキーワードと組み合わせた場合のみです(例:
subject:photo*
)。 -
役割によって検索できるものに違いがありますか
管理者はZendesk Support内のすべてのデータを検索できます。エージェントは、アクセスが許可されたデータを検索できます。エンドユーザーはナレッジベースの全文テキスト検索を実行できます。
-
どの言語がサポートされますか
次の言語での検索では、言語固有のサポートがあります。- 英語
- フランス語
- ドイツ語
- 日本語
- ポルトガル語
- スペイン語
日本語の場合、単語間がスペースで区切られていないため、辞書ベースのトークン化がサポートに含まれます。他の言語では、言語固有のサポートは主に単語の派生形です。これにより、語形が異なっても同じ単語を検索できます。特に、単語の単数形と複数形は、通常同じものとして扱われます。
検索演算子
次の検索演算子を使用して、独自の検索文を作成できます。
演算子 | 説明 |
---|---|
: | フィールドの内容が、指定された値と等しいことを示します。status:open |
< | 指定された値より小さいことを示します。status<closed |
> | 指定された値より大きいことを示します。priority>normal |
<= | より小さいか等しいことを示します。status<=pending |
>= | より大きいか等しいことを示します。priority>=normal |
" " | 二重引用符。シンプルなキーワード検索では、これは、語句検索とも呼ばれ、引用符で囲まれた文字列に正確に一致する文字列が返されます。ただし、句読点は含まれません。"Please upgrade my account"
メモ:Supportの日本語版では、この機能は期待どおりに動作しません。シンプルなキーワードを二重引用符で囲んで検索した場合に返される文字列が、検索キーワードと正確に一致せず、語順も正確なものになりません。
データプロパティを含む検索では、二重引用符を使用して包含的AND検索を実行し、検索に含まれるすべてのプロパティを含む結果を返します。 tags:"superman is_awesome" |
- | マイナス記号。その単語(またはプロパティの値)を含む項目を検索結果から除外します。たとえば、次の文は、「pending」ステータスのチケットすべてを検索しますが、そのうち「invoice」タグが付いているチケットだけを検索結果から除外します。
status:pending -tags:invoice |
* | ワイルドカード演算子は、検索結果に単語の派生形を含めたい場合に便利です。たとえば、photo* を検索すると、photography、photographer、photographなど、「photo」で始まる単語を含む結果がすべて返されます。ただし、ワイルドカード検索を行うとパフォーマンスが低下するため、現時点では、ワイルドカード検索は制限付きでサポートされています。つまり、プロパティキーワードを使用して、検索対象のデータを絞り込む必要があります。
subject:photo* |
チケットプロパティのキーワード
次のチケットプロパティを検索できます。
チケットの検索の詳細については、「チケットの検索」を参照してください。
キーワード | 説明 |
---|---|
チケットID | チケットIDのプロパティキーワードはありません。チケットをIDで検索する場合は、以下の形式で単にID番号を指定します。233 |
created |
チケットが作成された日付または日時。日付を「yyyy-mm-dd format」形式で入力します。created:2011-05-01 日付または時間の範囲を指定して検索します。ISO 8601シンタックスを使用して時間を入力します。たとえば、2014年8月1日の午前10時30分~午後12時(UTC)の間に作成されたチケットを検索する場合、次のように指定します。 created>2014-08-01T10:30:00Z created<2014-08-01T12:00:00Z 日付と時刻を指定して検索する方法について詳しくは、「日時で検索する」を参照してください。 |
updated |
チケットが最後に更新された日付。updated>2011-05-15 日付と時刻を指定して検索する方法について詳しくは、「日時で検索する」を参照してください。 |
solved |
チケットが「解決済み」に設定された日付。solved<2011-06-01 日付と時刻を指定して検索する方法について詳しくは、「日時で検索する」を参照してください。 |
due_date |
チケットの期限。due_date:2011-06-01 日付と時刻を指定して検索する方法について詳しくは、「日時で検索する」を参照してください。 |
assignee |
割り当てられたエージェントまたはその他のエンティティ。「none」、「me」、ユーザー名(フルネームまたは一部)、メールアドレス、ユーザーID、または電話番号を指定できます(電話番号による検索については、phone ユーザープロパティを参照)。assignee:"Susan Warren" |
submitter |
チケットの送信者。リクエスタの代理でエージェントがチケットを送信していた場合は、リクエスタとは別のメンバーになります。「none」、「me」、ユーザー名(フルネームまたは一部)、メールアドレス、ユーザーID、または電話番号を指定できます(電話番号による検索については、phone ユーザープロパティを参照)。詳しくは「チケットユーザーロールを検索する」を参照してください。submitter:me |
requester |
チケットのリクエスタ。「none」、「me」、ユーザー名(フルネームまたは一部)、メールアドレス、ユーザーID、または電話番号を指定できます(電話番号による検索については、phone ユーザープロパティを参照)。requester:amy@mondocam.com |
subject |
チケットの件名のテキスト。subject:"upgrade account" |
description |
チケットの説明およびコメント内のテキスト。description:defective |
custom_status_id |
カスタムチケットのステータスがアクティブになっている場合、特定のシステムまたはカスタムチケットのステータスを検索します。数字のIDでステータスを指定します。このIDは、チケットステータスの編集時に「チケットのステータス」ページで確認できます。
|
status |
指定できる値:new、open、pending、hold、solved、closedstatus<closed |
ticket_type |
指定できる値:question、incident、problem、taskticket_type:problem |
priority |
指定できる値:low、normal、high、urgent
priority>low |
group |
グループの名前またはIDを指定します。そのグループに所属するエージェントに割り当てられたチケットが返されます。例:group:"Level 2" group:20663166 |
organization |
組織の名前またはIDを指定します。その組織に所属するリクエスタからのチケットが返されます。例:organization:customers organization:22989442 また、「none」を指定すると、どの組織にも属していないリクエスタからのチケットが返されます。 organization:none |
tags |
チケットに追加されたタグまたは「none」を指定します。tags:premium 2つのタグのいずれかを含むチケットを検索するには以下のように指定します。 tags:important tags:urgent 両方のタグを含むチケットを検索するには以下のように指定します。 tags:"important urgent" |
via |
チケットのソース。以下に例を示します。
via:phone 全ソースの一覧については、Zendesk開発者のドキュメントで「Via types reference」を参照してください。 |
commenter |
チケットにコメントを追加したメンバー。「none」、「me」、ユーザー名(フルネームまたは一部)、メールアドレス、ユーザーID、または電話番号を指定できます(電話番号による検索については、phone ユーザープロパティを参照)。commenter:"Mike" |
cc |
チケットのCCに含まれているメンバー。「none」、「me」、ユーザー名(フルネームまたは一部)、メールアドレス、ユーザーID、または電話番号を指定できます(電話番号による検索については、phone ユーザープロパティを参照)。cc:amanda@mondocam.com |
fieldvalue |
fieldvalueキーワードを使用すれば、任意のカスタムチケットフィールドに含まれる特定の値を検索できます。以下はその例です。fieldvalue:12345 検索結果として、「12345」という値を持つカスタムフィールドを含むすべてのチケットが返されます。 ドロップダウンカスタムフィールドについては、検索したいフィールド値に関連付けられているタグを検索します。 チェックボックスカスタムフィールドの場合、フィールドがチェックされている、またはチェックされていないチケットを検索することができます。以下はその例です。 custom_field_<Field ID>:checked |
custom_field_{id} |
特定のカスタムチケットフィールドの値を検索します。フィールド数値IDを指定します。このIDは、管理画面の「チケットフィールド」ページのURLから取得できるほか、Ticket Fields APIでも取得できます。シンタックスはcustom_field_ です。以下に例を示します。
-9,223,372,036,854,775,808 から 9,223,372,036,854,775,807までの範囲の値を検索することができます。 詳しくは「カスタムチケットフィールドを検索する」を参照してください。 |
brand |
ブランド名またはブランドIDを使用して、チケットで特定のブランドを検索します。2つ以上の単語を含むブランドは引用符が必要です。以下はその例です。brand:Nordstrom または
brand: "Banana Republic" または brand:<ID number> |
has_attachment |
true またはfalse を使用して、添付ファイルのあるチケットまたは添付ファイルのないチケットをすべて検索します。添付ファイルのあるすべてのチケットを検索する場合:
添付ファイルのないすべてのチケットを検索する場合:
|
form |
特定のチケットフォームで作成されたすべてのチケットを検索します。 チケットの名前に複数の単語が含まれている場合は、引用符を使用します。以下はその例です。
チケットフォームの名前が単一の単語の場合は、引用符を使用する必要はありません。以下はその例です。
|
recipient |
特定の受信者によって作成されたすべてのチケットを検索します。 これは、外部アドレスから転送されたメールのZendeskサポートアドレス(最終宛先)に対してのみ機能します。
|
comment |
チケットのコメント内のテキストを検索します。
チケットのコメント内で完全に一致するテキストを検索するには、検索するテキストを二重引用符で囲みます。
メモ:検索対象となるチケット内のコメントは、最初の500件のみです。
|
ユーザープロパティのキーワード
検索可能なユーザープロパティの一覧を以下に示します。
ユーザーを検索する方法については、「ユーザー、グループ、組織の検索」を参照してください。
キーワード | 説明 |
---|---|
name |
ユーザーの名前の一部またはフルネーム。
name:"alex anderson" |
role |
ユーザーに指定されたロール。role:admin |
email |
ユーザーのメールアドレスを指定するか、noneを指定してメールアドレスのないユーザーを検索します。
email:alex@mondocam.com email:"none" 二重引用符を使ったメールアドレス検索では、他のキーワード検索とは異なり、完全一致の検索結果は得られません。たとえば次のように検索すると、メールアドレスが「dwight」で始まるすべてのユーザーが検索結果として返されます。
ヒント:メールアドレスの検索では、ワイルドカードは使えません。たとえば、次のような検索では結果が返されません。
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:+555-111-2222 電話番号で検索する場合は、番号の前にプラス記号(+)を付ける必要があります。APIを使用して電話番号で検索する場合は、番号の前に%2B(URLエンコードで表記した「+」)を含める必要があります(例: |
tags |
ユーザーのプロフィールのタグを指定するか、none を指定してタグのないユーザーを検索します。
tags:premium tags:wholesaleユーザーと組織へのタグ付けの詳細については、「ユーザーおよび組織へのタグの追加」を参照してください。 |
customfield |
カスタムユーザーフィールドです。plan_type:platinum詳細については、「カスタムユーザーおよび組織フィールドを検索する」を参照してください。 |
is_verified |
ユーザーのIDのいずれかが確認されたかどうかを示します。
チケット共有で作成されたユーザーは自動的に確認されます。 |
is_suspended |
ユーザーが一時停止されているかどうかを示します。
|
WhatsAppの電話番号に基づいてユーザーを検索します。 詳しくは、「WhatsAppの番号を使用してチケットを検索する」を参照してください。 |
組織プロパティのキーワード
検索可能な組織プロパティの一覧を以下に示します。詳細については、「ユーザー、グループ、組織の検索」を参照してください。
キーワード | 説明 |
---|---|
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 |
グループプロパティのキーワード
検索可能なグループプロパティの一覧を以下に示します。詳細については、「ユーザー、グループ、組織の検索」を参照してください。
キーワード | 説明 |
---|---|
name |
グループの名前。name:"level 2" |
created |
グループが追加された日付。created<2011-05-01 日付と時刻を指定して検索する方法について詳しくは、「日時で検索する」を参照してください。 |
満足度評価の検索可能な値
satisfaction
キーワードと評価の値を指定して、カスタマー満足度評価を検索できます。カスタマー満足度の詳細については、「カスタマー満足度評価の使用」を参照してください。
値 | 説明 |
---|---|
bad |
「不満」と評価されたチケット。
|
badwithcomment |
「不満」と評価されたチケットで、チケットのリクエスタからのコメントを含むもの。
|
good |
「満足」と評価されたチケット。
|
goodwithcomment |
「満足」と評価されたチケットで、チケットのリクエスタからのコメントを含むもの。
|
offered |
カスタマー満足度評価をリクエストすると、チケット満足度評価ステータスは「提供済み」になります。以下の通知がチケットに追加されます。カスタマー満足度のフィードバックが提供されました。これは、評価をリクエストしたがまだ返答を受け取っていないことを示します。
|