Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CodeCatalyst でコード、問題、プロジェクト、ユーザーを検索する
<a name="search"></a>

CodeCatalyst の検索バーまたは専用の検索結果ウィンドウを使用して、コード、問題、プロジェクト、およびユーザー CodeCatalyst を検索します。

検索バーに名前、説明、状態などのクエリを入力することで、スペースやプロジェクト全体でリソースを見つけることができます。検索クエリ言語を使用して検索クエリを絞り込むこともできます。

**Topics**
+ [検索クエリを絞り込む](#search-query-language-examples)
+ [検索を使用する際の考慮事項](#search-tips-troubleshooting)
+ [検索可能なフィールドリファレンス](#search-query-language-searchable-fields)

**検索する**

1. 上部にあるナビゲーションバーの検索バーに、検索クエリを入力します。

1. (オプション) CodeCatalyst の検索クエリ言語を使用して、検索クエリを絞り込みます。詳細については、「[検索クエリを絞り込む](#search-query-language-examples)」を参照してください。

1. 次のいずれかを行います:
   + 現在使用しているプロジェクト内のリソースを検索するには、**[このプロジェクト]** を選択します。
   + 現在いるスペース内のすべてのプロジェクト内のリソースを検索するには、**[このスペース]** を選択します。

1. 次のいずれかを実行して、専用の検索結果ウィンドウで検索結果を表示します。
   + [クイック検索結果] ウィンドウの下部で、**[project-name 内のすべての結果を表示する]** を選択して、すべての検索結果を表示します。
   + **Enter** を押してすべての検索結果を表示します。

**ヒント**  
@ 記号が先頭に付いた表示名またはユーザー名を使用すると、別のプロジェクトをプルリクエストのコメントまたは説明でメンションしたり、問題のコメントや説明でメンションできます。また、@ 記号が先頭に付いた問題名やコードファイル名を使用すると問題やコードファイルなどのリソースをリンクできます。

## 検索クエリを絞り込む
<a name="search-query-language-examples"></a>

検索後に探しているものが見つからない場合は、CodeCatalyst の特殊なクエリ言語を使用すると検索を絞り込むことができます。個々のフィールドには文字数制限はありませんが、クエリ全体の制限は 1,024 文字です。

**Topics**
+ [タイプで絞り込む](#search-query-language-type-search)
+ [フィールドで絞り込む](#search-query-language-field-search)
+ [ブール演算子で絞り込む](#search-query-language-boolean-search)
+ [プロジェクトで絞り込む](#search-query-language-project-search)

### タイプで絞り込む
<a name="search-query-language-type-search"></a>

検索範囲を特定のタイプの情報に絞り込むには、検索に `type:result-type` を含めます。ここでは、*result-type* は `code`、`issue`、`project` または `user` です。

例:
+ `type:code AND java` – 「java」を含むコード関連フィールドにコード結果を表示します。

  詳細については、「[コードフィールド](#search-query-language-type-code)」を参照してください。
+ `type:issue AND Bug` – 「Bug」を含む問題関連フィールドに問題の結果を表示します。

  詳細については、「[問題フィールド](#search-query-language-type-issue)」を参照してください。
+ `type:user AND MaryMajor` – 「MaryMajor」を含むユーザー関連フィールドにユーザーの結果を表示します。

  詳細については、「[ユーザーフィールド](#search-query-language-type-user)」を参照してください。
+ `type:project AND Datafeeder` – 「Datafeeder」を含むプロジェクト結果を表示します。

  詳細については、「[プロジェクトフィールド](#search-query-language-type-project)」を参照してください。

### フィールドで絞り込む
<a name="search-query-language-field-search"></a>

検索範囲を特定のフィールドに絞り込むには、検索に `field-name:query` を含めます。ここでは、*field-name* は `title`、`username`、`project`、`description` などになり、*query* は、検索するテキストになります。フィールドのリストについては、「[検索可能なフィールドリファレンス](#search-query-language-searchable-fields)」を参照してください。括弧を使用すると複数のクエリを検索できます。

例:
+ `title:bug` – タイトルに「bug」が含まれている結果を表示します。
+ `username:John` – ユーザー名に「John」が含まれている結果を表示します。
+ `project:DataFeeder` – プロジェクト「DataFeeder」の結果を表示します。クエリでは大文字と小文字は区別されません。
+ `description:overview` – 説明に「概要」が含まれている結果を表示します。

### ブール演算子で絞り込む
<a name="search-query-language-boolean-search"></a>

検索フレーズの制約を指定するには、ブール演算子 `AND`、`OR`、および `NOT` を使用できます。複数のフレーズを一覧すると、CodeCatalyst はデフォルトで、それらを `OR` に参加させます。括弧を使用すると検索フレーズをグループ化できます。
+ `exception AND type:code` – 「例外」のコード結果のみを表示します。
+ `path:README.md AND repo:ServerlessAPI` – リポジトリの名前が「ServerlessAPI」である「README.md」のパスの結果を表示します。
+ `buildspec.yml AND (repo:ServerlessAPI OR ServerlessWebApp)` – リポジトリが「ServerlessAPI」または「ServerlessWebApp」である「buildspec.yml」の結果を表示します。
+ `path:java NOT (path:py OR path:ts)` – パスに「java」が含まれているが、「py」や「ts」が含まれていない結果を表示します。

### プロジェクトで絞り込む
<a name="search-query-language-project-search"></a>

検索範囲を特定のプロジェクトに絞り込むには、検索に `project:name AND query` を含めます。ここでは、*name* は、検索しているプロジェクトで、*query* は、検索しているコンテンツです。
+ `project:name AND query` – パスにクエリとプロジェクト名が含まれている結果を表示します。

## 検索を使用する際の考慮事項
<a name="search-tips-troubleshooting"></a>

**コンテンツの更新の遅延** – 名前の変更や問題の再割り当てなどのコンテンツの更新が検索結果に反映されるまでに数分かかる場合があります。コードベースの移行などの大規模な更新は、検索結果に表示されるまでにより長い時間を要する場合があります。

**特殊文字のエスケープ** – 検索クエリでは、`+ - & & || ! ( ) { } [ ] ^ " ~ * ? : \` の特殊文字に気を付ける必要があります。特殊文字はクエリに影響を与えないため、削除するかエスケープする必要があります。文字をエスケープするには、文頭にバックスラッシュ (\$1) を追加します。例えば、検索クエリである [Feature] は、Feature または \$1[Feature\$1] のいずれかにする必要があります。

**検索の絞り込み** – 検索では大文字と小文字は区別されません。すべての小文字で検索すると、大文字と小文字の変更時にクエリが単語を分割できなくなります。例えば、`MyService` と `MyService` のみをクエリするには、`myservice` をクエリして、`my` または `service` のみを含む結果を回避することを検討します。

検索は、デフォルトで OR 単位の結合を使用して単語と単語の一部を結合します。例えば、`new function` は `new`と `function` の両方を含む結果と、`new` または `function` のみを含む結果を返す可能性があります。後者を回避するには、複数の単語を `AND` と組み合わせます。例えば、`new AND function` と検索できます。

**デフォルトブランチ** – 検索は、ソースリポジトリのデフォルトブランチに対する最新のコミットからのコード結果のみを返します。他のブランチまたはコミットでコードを検索するには、[リポジトリをローカルにクローンする](source-repositories-clone.md)、[開発環境でブランチを開く](devenvironment-create.md)、[CodeCatalyst UI でブランチと詳細を表示する](source-branches-view.md)ことを検討します。デフォルトブランチを変更すると、検索で検出できるファイルが更新されます。詳細については、「[リポジトリのデフォルトブランチを管理する](source-branches-default-branch.md)」を参照してください。

**重要**  
CodeCatalyst は、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず CodeCatalyst からリンクを解除し、デフォルトブランチを変更してから再度リンクする必要があります。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク](extensions-link.md)」を参照してください。  
ベストプラクティスとして、リポジトリをリンクする前に、必ず最新バージョンの拡張機能があることを確認してください。

## 検索可能なフィールドリファレンス
<a name="search-query-language-searchable-fields"></a>

CodeCatalyst は、検索クエリを入力するときに次のフィールドを検索します。エイリアスは、高度なクエリ言語でフィールドを参照するために使用できる別の名前です。

### コードフィールド
<a name="search-query-language-type-code"></a>


| フィールド | エイリアス | 説明 | 
| --- | --- | --- | 
|  BranchName  |  ブランチ  |  コードファイルが存在するブランチの名前。  | 
|  コード  |  該当なし  |  検索に一致したソースコードの一部を示すコードスニペット形式のコードの内容に関する情報。  | 
|  CommitId  |  該当なし  |  返されたコードファイルが最後に更新されたコミットのコミット ID。`branchName`で指定されたブランチ名の先頭にあるコミット ID か別の ID である場合があります。  | 
|  commitMessage  |  該当なし  |  コードファイルが最後に更新されたコミットのコミットメッセージ。`branchName` で指定されたブランチ名の先頭にあるコミットメッセージか別のメッセージである場合があります。コミットメッセージが指定されていない場合、この値は空の文字列になります。  | 
|  filePath  |  パス  |  このコードファイルのファイルパス。  | 
|  lastUpdatedBy  | 該当なし |  コードファイルを最後に更新した CodeCatalyst ユーザー。ユーザー名が使用できない場合、この値は Git 設定ファイルで設定されたユーザーの E メールアドレスになります。  | 
|  lastUpdatedById  |  該当なし  |  コードファイルを最後に更新したユーザーのシステム生成の一意の ID。ユーザー ID が使用できない場合、この値はユーザーの E メールアドレスである可能性があります。  | 
|  lastUpdatedTime  |  該当なし  |  検索データがコードファイルを含むコミットで最後に更新された時刻 (協定世界時 (UTC) タイムスタンプ)。  | 
|  projectId  |  該当なし  |  システム生成されたプロジェクト固有の ID 。  | 
|  projectName  |  projectNames、project  |  コードファイルがコミットされたソースリポジトリを含むプロジェクトの名前を表示します。  | 
|  repositoryId  |  repoId  |  システム生成されたソースリポジトリ固有の ID。  | 
|  repositoryName (リポジトリネーム)  |  repository、repo  |  コードファイルがコミットされたソースリポジトリの名前を表示します。  | 

### 問題フィールド
<a name="search-query-language-type-issue"></a>


| フィールド | エイリアス | 説明 | 
| --- | --- | --- | 
|  assigneeIds  |  assigneeId  |  問題に割り当てられたユーザーのシステム生成 ID。  | 
|  担当者  |  assignee  |  問題に割り当てられたユーザーのユーザー名。  | 
|  createdBy  |  該当なし  |  問題を作成したユーザーの名前を表示します。  | 
|  createdById  |  該当なし  |  問題を作成したユーザーのシステム生成の固有 ID。  | 
|  createdTime  |  該当なし  |  問題が作成された時刻 (協定世界時 (UTC) タイムスタンプ）。  | 
|  description  |  該当なし  |  問題の説明  | 
|  isArchived  |  archived  |  アーカイブされた状態で問題を作成するかどうかを示すブール値。  | 
|  isBlocked  |  ブロック済み  |  問題がブロック済みとしてマークされているかどうかを示すブール値。  | 
|  labelIds  |  labelId  |  問題に対するラベルのシステム生成 ID。  | 
|  lastUpdatedBy  |  該当なし  |  問題を最後に更新したユーザー名を表示します。  | 
|  lastUpdatedById  |  該当なし  |  問題を最後に更新したユーザーのシステム生成の固有 ID。  | 
|  lastUpdatedTime  |  該当なし  |  問題が最後に更新された時刻 (協定世界時 (UTC) タイムスタンプ）。  | 
|  優先度  |  該当なし  |  問題が割り当てられている場合は、問題の優先度。  | 
|  projectId  |  該当なし  |  システム生成されたプロジェクト固有の ID 。  | 
|  projectName  |  projectNames、project  |  この問題が見つかったプロジェクト。  | 
|  shortId  |  該当なし  |  問題の短縮された自動増分 ID。  | 
|  ステータス  |  該当なし  |  問題がバックログまたはオンボードの列にあるかどうかを示す問題の状態。  | 
|  statusId  |  該当なし  |  状態のシステム ID。  | 
|  title  |  該当なし  |  問題のタイトル。  | 

### プロジェクトフィールド
<a name="search-query-language-type-project"></a>


| フィールド | エイリアス | 説明 | 
| --- | --- | --- | 
|  description  |  該当なし  |  プロジェクトの説明。  | 
|  lastUpdatedTime  |  該当なし  |  プロジェクトメタデータが最後に更新された時刻 (協定世界時 (UTC) タイムスタンプ）。  | 
|  projectName  |  プロジェクト  |  スペース内のプロジェクトの名前。  | 
|  projectPath  |  該当なし  |  プロジェクトの作成時に定義されるプロジェクトの URL でルーティング可能な名前。プロジェクト名を必要とする URL で使用されます。  | 

### ユーザーフィールド
<a name="search-query-language-type-user"></a>


| フィールド | エイリアス | 説明 | 
| --- | --- | --- | 
|  displayName  |  該当なし  |  CodeCatalyst でユーザーが使用する名前。表示名は一意ではありません。  | 
|  email  |  該当なし  |  ユーザーの E メールアドレス。  | 
|  lastUpdatedTime  |  該当なし  |  ユーザーメタデータが最後に更新された時刻 (協定世界時 (UTC) タイムスタンプ）。  | 
|  userName  |  username  |  CodeCatalyst にサインアップしたときにユーザーが選択したユーザー名。表示名とは異なり、ユーザー名は変更できません。  |