全文検索では、Zendesk Support全体からあらゆる種類のデータが検索結果として返されます。チケットデータのみ検索する場合は、チケットプロパティのキーワードを使用できます。
status:open
上の例では、status
がキーワードで、open
が値です。この検索では、ステータスが「オープン(open)」に設定されたすべてのチケットが返されます。これはもちろん、チケットフィールドとその値に直接反映されます。
status:open group:"Level 2"
これにより、レベル2サポートグループに割り当てられているすべての「オープン」ステータスのチケットが返されます。
この記事では、次のトピックについて説明します。
検索可能なすべてのデータのクイックリファレンスについては、「Zendesk Support検索リファレンス」を参照してください。
チケットプロパティのキーワード
検索に使用できるチケットプロパティのキーワードおよびその値については、以下の表で説明します。チケットデータのすべてが検索できるわけではありません。管理者とエージェントは、これらのキーワードを使用して、チケットを検索できます。
キーワード | 説明 |
---|---|
チケット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件のみです。
|
チケットプロパティのキーワードはすべて、検索文で単独で使用したり、他のチケットプロパティのキーワードやtype
キーワード(「typeキーワードを使用する」を参照)と組み合わせて使用することができます。
チケットユーザーロールを検索する
ユーザーはチケットにさまざまなロールを持っています(リクエスタ、担当者など)。これらのユーザーロールは、次の例のようにユーザーのID、名前(一部または全部)、メールアドレスで検索できます。
requester:52789480 submitter:amy assignee:"amy moore" requester:amy@mondocam.com
これらの検索では、ID、名前、メールアドレスを明示的に宣言する必要はありません。これらの各キーワードが、これらのユーザーアイデンティティをすべて受け入れます。
カスタムチケットフィールドを検索する
fieldvalue
キーワードを使用して、カスタムチケットフィールド内の特定の値を検索できます。以下はその例です。
fieldvalue:12345
検索結果として、「12345」という値を持つカスタムフィールドを含むすべてのチケットが返されます。
また、カスタムフィールドでチケットにタグを割り当てる場合、カスタムフィールドに割り当てたタグを使用してカスタムチケットフィールドを検索することができます。たとえば、ドロップダウンリストを作成した場合、各リストボックスの項目に割り当てられたタグを検索できます。
特定のドロップダウンリストのオプションを検索するには、tags
キーワードを使用します。
tags:product_question
このキーワードはタグを割り当てできるカスタムフィールドタイプ(ドロップダウンリストとチェックボックス)に適用されます。チェックボックスのカスタムフィールドには、ユーザーがチェックボックスをクリックしたことを示すタグを含めることができます。
ルックアップリレーションシップフィールドを除く他のすべてのカスタムフィールドタイプ(テキスト、複数行テキスト、小数、正規表現)は、チケットリクエスタが送信したテキストまたは数値で検索できます。たとえば、年齢などの人口統計情報を収集するために、サポートリクエストフォームに数値カスタムフィールドを追加した場合、リクエスタがフォームに入力した数字を検索できます(type:ticket "18"
)。
ルックアップリレーションシップによる検索はサポートされていません。
さらに、IDを使って、指定されたカスタムチケットフィールドのみを検索することができます(IDは、管理センター >「オブジェクトとルール」>「チケット」>「フィールド」の「チケットフィールド」ページにあります)。以下はその例です。
シンタックス | 例 |
---|---|
|
ID 1413のカスタムチケットフィールドに「new」という語句が含まれているチケットのリストを返します。 |
|
ID 1413のカスタムチケットフィールドが空白であるチケットのリストを返します。 |
|
ID 1413のカスタムチケットフィールドが使われており、空白ではないチケットのリストを返します。 |
チケットの添付ファイルを検索する
次のキーワードを使用して、チケットの添付ファイルを検索できます。
キーワード | 説明 |
---|---|
has_attachment |
このキーワードを使用して、添付ファイルが含まれていないチケットまたは添付ファイルを含むチケットを検索できます。このキーワードには、true およびfalse の2つの有効な値があります。
|
attachment_name |
添付ファイルはファイル名でも検索できます。
|
特定のチケットフォームのチケットを検索する
チケットフォームを検索し、そのチケットフォームが適用されているすべてのチケットを検索結果として返すことができます。たとえば、次の検索を実行すると、「変更リクエスト」というチケットフォームを使用しているすべてのチケットが返されます。
form:"Change Request"
電話番号でチケットを検索する
電話番号に基づいてユーザーのチケットを検索する場合は、次のような検索文を使用できます。
requester:+14154187506 status:new
この検索文は、submitter
、requester
、assignee
の各チケットユーザーロールについて指定できます。
自分自身を検索する
me
キーワード値を使用すれば、値がユーザー自身のユーザーアカウント(現在ログインしているユーザー)であるチケットのユーザープロパティを検索できます。
assignee:me
requester:me
submitter:me
assignee:me
ユーザープロフィールデータの検索の詳細については、「ユーザーを検索する」を参照してください。
チケット検索結果の整理および並べ替える
検索結果は、order_by
キーワードとsort
キーワードを使用して、整理および並べ替えることができます。
status:new order_by:updated_at sort:asc
並べ替えおよび整理の有効なキーワードと使用できる値のペアは以下のとおりです。
sort:asc
sort:desc
order_by:priority
order_by:status
order_by:ticket_type
order_by:updated_at
order_by:created_at
チケットデータの検索時に、order_by
とsort
のキーワード/値のペアをすべて使用できます。