詳細検索リファレンス

これらの検索パラメータと演算子を使用して、正確な検索クエリーを作成します。

完全一致

一般的な指針として、二重引用符は文字列フィールドにのみ使用してください。数値、日付、ブール演算のフィールドには二重引用符を使用しないでください。二重引用符には主に 2 つの用途があります。

1. スペースを含む語句を検索: 複数の単語や順序が重要なフレーズを検索する際には二重引用符を使用します。

   例:

   • owner="Doe John" は所有者が John Doe であるアイテムを検索します。カンマ、ピリオド、コロンといった文字は、「Doe, John」をアイテムの所有者として一致させる際には無視されます。
   • ITEM_DETAILS:DESC_CHANGE="Scratch on aluminum" は、フィールド値にその正確なフレーズを含むアイテムを検索します。

2. 完全一致する単語を検索: 完全な単語のみを検索する際には二重引用符を使用します。

   例:

   • red は「predator」に一致します(部分一致)。
   • "red" は「blue red wheel」には一致しますが、「predator」には一致しません。

部分一致にはアスタリスクは不要です。検索ツールは、二重引用符が存在しない場合にワイルドカードを自動的に使用します。

条件演算子

条件演算子(AND/OR)と括弧を組み合わせて、複雑なクエリーを作成します。たとえば、次の検索クエリーを使用すると、ピックリストの選択肢が「Medium」という文字列、またはアイテム、部品表、変更管理ワークスペース内の「test」という単語に一致するアイテムを検索できます: (ITEM_DETAILS:PRIORITY=Medium OR test) AND (workspaceId=9 OR workspaceId=8)

関係演算子

関係演算子(より大きい、より小さい、等しいなど)を数値フィールドや日付フィールドで使用します。たとえば、次の検索クエリーを使用すると、2019 年 1 月に作成され、「test」という単語を含むアイテムを検索できます: test AND createdOn>=2019-01-01 AND createdOn<=2019-01-31

ワークスペース間の検索

検索を特定のワークスペースに制限します。アイテムは複数のワークスペースに属することができないため、ワークスペース ID 間では AND の代わりに OR を使用します。たとえば、次の検索クエリーを使用すると、ワークスペース 9 または 26 内で John が所有するアイテムを検索できます: ownerName=John AND (workspaceId=9 OR workspaceId=26)

並べ替え

検索結果は既定で関連性(スコア)順にランク付けされます。UI は現在、カスタムの並べ替えをサポートしていませんが、API は次のフィールドによる並べ替えをサポートしています。

• スコア(関連性、レコード情報には非表示) – 既定
• 最終修正日時
• 作成日時
• アイテム記述子

結果は昇順(asc)または降順(desc)で表示できます。たとえば、次の検索クエリーを使用すると、ワークスペース 9 内で「testing」という単語を検索し、すべてのリビジョンを返します:

• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=score asc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=lastModifiedOn desc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=createdOn asc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=itemDescriptor desc

ヒント

• 既定では、検索はリビジョン管理されたワークスペースから最新バージョンのみを返します。API 呼び出しで &revision=2 を使用してすべてのアイテムを取得し、isLatestVersion および isWorkingVersion フィールドを使用して絞り込みます。

• すべての条件演算子(AND/OR)は大文字で入力する必要があります。

• 特定の年や月を検索するには日付範囲を使用します。

• ブール値は大文字または小文字で入力します。

• 検索はインデックス化されたすべてのタブに対して実行されます。2019 年 2 月以降、アイテムの詳細(分類データを除く)および添付ファイル(ファイルのタイトルとファイル名のみ)が検索用にインデックス化されています。

• 二重引用符で囲まれていない検索クエリー内のスペースは、OR 演算子として機能します。

• 以下の文字は検索クエリーで使用することはできません。

  • `
  • (
  • )
  • :
  • <
  • >
  • =
  • \
  • /
  • ]
  • [
  • {
  • }