CodeCatalyst でコード、問題、プロジェクト、ユーザーを検索する - Amazon CodeCatalyst
検索クエリを絞り込む検索を使用する際の考慮事項検索可能なフィールドリファレンス

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

CodeCatalyst でコード、問題、プロジェクト、ユーザーを検索する

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

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

検索する

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

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

  3. 次のいずれかを行います。

    • 現在使用しているプロジェクト内のリソースを検索するには、[このプロジェクト] を選択します。

    • 現在いるスペース内のすべてのプロジェクト内のリソースを検索するには、[このスペース] を選択します。

  4. 次のいずれかを実行して、専用の検索結果ウィンドウで検索結果を表示します。

    • [クイック検索結果] ウィンドウの下部で、[project-name 内のすべての結果を表示する] を選択して、すべての検索結果を表示します。

    • Enter を押してすべての検索結果を表示します。

ヒント

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

検索クエリを絞り込む

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

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

例:

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

    詳細については、「コードフィールド」を参照してください。

  • type:issue AND Bug – 「Bug」を含む問題関連フィールドに問題の結果を表示します。

    詳細については、「問題フィールド」を参照してください。

  • type:user AND MaryMajor – 「MaryMajor」を含むユーザー関連フィールドにユーザーの結果を表示します。

    詳細については、「ユーザーフィールド」を参照してください。

  • type:project AND Datafeeder – 「Datafeeder」を含むプロジェクト結果を表示します。

    詳細については、「プロジェクトフィールド」を参照してください。

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

例:

  • title:bug – タイトルに「bug」が含まれている結果を表示します。

  • username:John – ユーザー名に「John」が含まれている結果を表示します。

  • project:DataFeeder – プロジェクト「DataFeeder」の結果を表示します。クエリでは大文字と小文字は区別されません。

  • description:overview – 説明に「概要」が含まれている結果を表示します。

検索フレーズの制約を指定するには、ブール演算子 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」が含まれていない結果を表示します。

検索範囲を特定のプロジェクトに絞り込むには、検索に project:name AND query を含めます。ここでは、name は、検索しているプロジェクトで、query は、検索しているコンテンツです。

  • project:name AND query – パスにクエリとプロジェクト名が含まれている結果を表示します。

検索を使用する際の考慮事項

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

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

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

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

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

重要

CodeCatalyst は、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず CodeCatalyst からリンクを解除し、デフォルトブランチを変更してから再度リンクする必要があります。詳細については、「CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク」を参照してください。

ベストプラクティスとして、リポジトリをリンクする前に、必ず最新バージョンの拡張機能があることを確認してください。

検索可能なフィールドリファレンス

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

フィールド エイリアス 説明

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

コードファイルがコミットされたソースリポジトリの名前を表示します。
フィールド エイリアス 説明

assigneeIds

assigneeId

問題に割り当てられたユーザーのシステム生成 ID。

担当者

assignee

問題に割り当てられたユーザーのユーザー名。

createdBy

該当なし

問題を作成したユーザーの名前を表示します。

createdById

該当なし

問題を作成したユーザーのシステム生成の固有 ID。

createdTime

該当なし

問題が作成された時刻 (協定世界時 (UTC) タイムスタンプ）。

説明

該当なし

問題の説明

isArchived

archived

アーカイブされた状態で問題を作成するかどうかを示すブール値。

isBlocked

ブロック済み

問題がブロック済みとしてマークされているかどうかを示すブール値。

labelIds

labelId

問題に対するラベルのシステム生成 ID。

lastUpdatedBy

該当なし

問題を最後に更新したユーザー名を表示します。

lastUpdatedById

該当なし

問題を最後に更新したユーザーのシステム生成の固有 ID。

lastUpdatedTime

該当なし

問題が最後に更新された時刻 (協定世界時 (UTC) タイムスタンプ）。

priority

該当なし

問題が割り当てられている場合は、問題の優先度。

projectId

該当なし

システム生成されたプロジェクト固有の ID 。

projectName

projectNames、project

この問題が見つかったプロジェクト。

shortId

該当なし

問題の短縮された自動増分 ID。

status

該当なし

問題がバックログまたはオンボードの列にあるかどうかを示す問題の状態。

statusId

該当なし

状態のシステム ID。

title

該当なし

問題のタイトル。
フィールド エイリアス 説明

説明

該当なし

プロジェクトの説明。

lastUpdatedTime

該当なし

プロジェクトメタデータが最後に更新された時刻 (協定世界時 (UTC) タイムスタンプ）。

projectName

プロジェクト

スペース内のプロジェクトの名前。

projectPath

該当なし

プロジェクトの作成時に定義されるプロジェクトの URL でルーティング可能な名前。プロジェクト名を必要とする URL で使用されます。
フィールド エイリアス 説明

displayName

該当なし

CodeCatalyst でユーザーが使用する名前。表示名は一意ではありません。

email

該当なし

ユーザーの E メールアドレス。

lastUpdatedTime

該当なし

ユーザーメタデータが最後に更新された時刻 (協定世界時 (UTC) タイムスタンプ）。

userName

username

CodeCatalyst にサインアップしたときにユーザーが選択したユーザー名。表示名とは異なり、ユーザー名は変更できません。