Search Tickets（チケットの検索）
1つ以上のチケットを検索し、チケットIDを返します。チケットIDを別のカードで使用して、チケットの参照、チケット情報の更新などを行うことができます。
オプション
| フィールド | 定義 | Type（タイプ） | Required (必須) |
|---|---|---|---|
|
Return (結果) |
［Single ticket（単一のチケット）］か［All matching tickets（一致するすべてのチケット）］を選択します。 Single ticket（単一のチケット）: こちらを選択した場合、このカードは検索条件に最初に一致したチケットを返します。特定のチケットを探している場合にこのオプションを使用します。 All matching tickets（一致するすべてのチケット）: こちらを選択した場合、このカードは検索条件に一致するチケットの集合を返します。フィルタリングされたチケットのセットを探している場合にこのオプションを使用します。 |
ドロップダウン |
TRUE |
入力
1つ以上の入力フィールドを使用してチケットを検索します。検索しない結果はカードで非表示にする必要があります。
複数の検索条件を指定すると、それを組み合わせてクエリが作成されます。結果出力は、すべての条件に一致するグループとなります。
ただし、検索条件を指定しない場合、カードは利用可能なレコードのすべてのフィールドを返します。
| フィールド | 定義 | Type（タイプ） | Required (必須) |
|---|---|---|---|
|
Ticket（チケット） |
|||
|
Subject（件名） |
チケットの件名。 |
テキスト |
FALSE |
|
Description（説明） |
チケット上の説明（または最初のコメント）。 |
テキスト |
FALSE |
|
Type（タイプ） |
チケットのタイプで、オプションはproblem、incident、question、taskです。 |
ドロップダウン |
FALSE |
|
Priority（優先度） |
チケットの優先度で、オプションはurgent、high、normal、lowです。 |
ドロップダウン |
FALSE |
|
Status（ステータス） |
チケットの状態で、new、open、pending、hold、solved、closedのいずれかです。 |
ドロップダウン |
FALSE |
|
Requester（依頼者） |
チケットを依頼したユーザーのID。 |
数値 |
FALSE |
|
Assignees（割り当て先） |
チケットが割り当てられたエージェントのID。 |
テキスト |
FALSE |
|
Organization（組織） |
依頼者が属しているOrganizationのID。 |
テキスト |
FALSE |
|
Group（グループ） |
チケットが割り当てられたグループのID。 |
テキスト |
FALSE |
|
Due Date（期日） |
チケットのタイプが「タスク」の場合、期日を表します。日付はISO 8601形式である必要があります。 |
テキスト |
FALSE |
|
Tags (タグ) |
チケットに関連付けられているタグのリスト。検索結果に含まれるようにするには、チケットのこのリストに各タグがある必要があります。 |
リスト |
FALSE |
|
Via Channel（チャンネル経由） |
チケットが作成された方法の説明。使用できる値はapi、web、mobileです。 |
ドロップダウン |
FALSE |
|
Ticket Form（チケットフォーム） |
このチケットを表示するために使用されたチケットフォームのID（ある場合）。 |
テキスト |
FALSE |
|
Brand（ブランド） |
このチケットに関連付けられているブランドのID。 |
テキスト |
FALSE |
|
添付ファイル？ |
［True］が選択された場合、添付ファイルがあるチケットだけが結果に含まれます。［False］が選択された場合、添付ファイルがないチケットだけが結果に含まれます。 |
True/False |
FALSE |
|
Attachment Name（添付ファイルの名前） |
添付ファイルの名前。 |
テキスト |
FALSE |
|
CC（カーボンコピー） |
チケットのCCに現在含まれているユーザーのID。 |
テキスト |
FALSE |
|
Custom Field Value (カスタムフィールド値) |
値が一致するチケットの各カスタムフィールドを検索します。 |
テキスト |
FALSE |
|
External ID (外部ID) |
チケットの外部ID。 |
テキスト |
FALSE |
出力
| フィールド | 定義 | Type（タイプ） |
|---|---|---|
|
Ticket ID（チケットID） |
検索により返される最初のチケットのIDで、［Single ticket（単一のチケット）］オプションが選択されている場合に返されます。 |
テキスト |
|
チケットID |
検索により返されるすべてのチケットのIDで、［All matching tickets（一致するすべてのチケット）］オプションが選択されている場合に返されます。 |
リスト |