A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Pesquisa do código, problemas, projetos e usuários no CodeCatalyst
<a name="search"></a>

Use a barra de pesquisa ou uma janela de resultados de pesquisa dedicada no CodeCatalyst para pesquisar códigos, problemas, projetos e usuários do CodeCatalyst.

Você pode encontrar recursos em seu espaço e projetos inserindo consultas, como nome, descrição e status na barra de pesquisa. Você também pode refinar suas consultas de pesquisa usando a linguagem da consulta de pesquisa.

**Topics**
+ [Refinamento da sua consulta de pesquisa](#search-query-language-examples)
+ [Considerações ao trabalhar com a pesquisa](#search-tips-troubleshooting)
+ [Referência de campos pesquisáveis](#search-query-language-searchable-fields)

**Para pesquisar**

1. Na barra de pesquisa na barra de navegação superior, insira uma consulta de pesquisa.

1. (Opcional) Refine sua consulta de pesquisa usando a linguagem de consulta de pesquisa do CodeCatalyst. Para obter mais informações, consulte [Refinamento da sua consulta de pesquisa](#search-query-language-examples).

1. Execute um destes procedimentos:
   + Para pesquisar recursos no projeto em que você está atualmente, selecione **Este projeto**.
   + Para pesquisar recursos em todos os projetos no espaço em que você está atualmente, selecione **Este espaço**.

1. Visualize os resultados da pesquisa em uma janela de resultados da pesquisa dedicada fazendo o seguinte:
   + Na parte inferior da janela de resultados da pesquisa rápida, selecione **Visualizar todos os resultados em nome do projeto \$1 nome do espaço** para visualizar todos os resultados da pesquisa.
   + Pressione **Enter** para visualizar todos os resultados da pesquisa.

**dica**  
Mencione outros usuários do projeto em um comentário ou descrição de solicitação pull ou em um comentário ou descrição do problema, usando o sinal @ seguido pelo nome de exibição ou nome de usuário. Você também pode vincular recursos, como problemas ou arquivos de código, usando o sinal @ seguido pelo nome do problema ou do arquivo de código. 

## Refinamento da sua consulta de pesquisa
<a name="search-query-language-examples"></a>

Se você não conseguir encontrar o que está procurando depois de pesquisar, pode refinar sua pesquisa com a linguagem de consulta especializada do CodeCatalyst. Os campos individuais não têm limite de caracteres, mas a consulta geral tem um limite de 1.024 caracteres.

**Topics**
+ [Refinamento por tipo](#search-query-language-type-search)
+ [Refinamento por campo](#search-query-language-field-search)
+ [Refinamento com operadores boolianos](#search-query-language-boolean-search)
+ [Refinamento por projeto](#search-query-language-project-search)

### Refinamento por tipo
<a name="search-query-language-type-search"></a>

Para refinar o escopo da sua pesquisa para um tipo específico de informação, inclua `type:result-type` em sua pesquisa, onde o *tipo de resultado* é `code`, `issue`, `project` ou `user`.

Exemplos:
+ `type:code AND java` – Mostre os resultados do código em campos relacionados ao código que contêm “java”.

  Para obter mais informações, consulte [Campos de código](#search-query-language-type-code).
+ `type:issue AND Bug` – Mostre os resultados do problema em campos relacionados ao problema que contêm “Bug”.

  Para obter mais informações, consulte [Campos de problema](#search-query-language-type-issue).
+ `type:user AND MaryMajor` – Mostre os resultados do usuário em campos relacionados ao usuário que contêm “MaryMajor”.

  Para obter mais informações, consulte [Campos de usuário](#search-query-language-type-user).
+ `type:project AND Datafeeder` – Mostre os resultados do projeto que contêm “Datafeeder”.

  Para obter mais informações, consulte [Campos do projeto](#search-query-language-type-project).

### Refinamento por campo
<a name="search-query-language-field-search"></a>

Para refinar o escopo da sua pesquisa para um campo específico, inclua `field-name:query` na pesquisa, onde o *nome do campo* é `title`, `username`, `project`, `description` e assim por diante, e a *consulta* é o texto que você está pesquisando. Para ver uma lista de campos, consulte [Referência de campos pesquisáveis](#search-query-language-searchable-fields). Você pode pesquisar várias consultas usando parênteses.

Exemplos:
+ `title:bug`: mostre os resultados em que o título contém “bug”.
+ `username:John`: mostre os resultados em que o nome do usuário contém “John”.
+ `project:DataFeeder`: mostre os resultados no projeto “DataFeeder”. A consulta não faz distinção entre maiúsculas e minúsculas.
+ `description:overview`: mostre os resultados onde a descrição contém “visão geral”.

### Refinamento com operadores boolianos
<a name="search-query-language-boolean-search"></a>

Para especificar restrições nas frases de pesquisa, você pode usar os operadores boolianos `AND`, `OR` e `NOT`. Se você listar várias frases, o CodeCatalyst as unirá com `OR` por padrão. Você pode agrupar frases de pesquisa usando parênteses.
+ `exception AND type:code` – Mostre apenas os resultados do código para “exceção”.
+ `path:README.md AND repo:ServerlessAPI` – Mostre os resultados para caminhos com “README.md” em que o repositório é denominado “ServerlessAPI”.
+ `buildspec.yml AND (repo:ServerlessAPI OR ServerlessWebApp)` – Mostre os resultados para “buildspec.yml” em que o repositório é “ServerlessAPI” ou “ServerlessWebApp”.
+ `path:java NOT (path:py OR path:ts)` – Mostre os resultados em que o caminho contém “java”, mas não “py” ou “ts”.

### Refinamento por projeto
<a name="search-query-language-project-search"></a>

Para refinar o escopo da sua pesquisa para um projeto específico, inclua `project:name AND query` em sua pesquisa, onde *nome* é o projeto no qual você está pesquisando e *consulta* é o conteúdo que você está pesquisando.
+ `project:name AND query` – Mostre os resultados em que o caminho contém a consulta e o nome do projeto.

## Considerações ao trabalhar com a pesquisa
<a name="search-tips-troubleshooting"></a>

**Atualizações de conteúdo atrasadas** – Pode levar vários minutos para que atualizações de conteúdo, como alterações de nome ou reatribuições de problemas, sejam refletidas nos resultados da pesquisa. Grandes atualizações, como uma migração de base de código, podem levar mais tempo para aparecer nos resultados da pesquisa.

**Caracteres especiais de escape**: os seguintes caracteres especiais requerem consideração especial em suas consultas de pesquisa: `+ - & & || ! ( ) { } [ ] ^ " ~ * ? : \`. Caracteres especiais não influenciarão a consulta e você deverá removê-los ou evitá-los. Para evitar um caractere, adicione uma barra invertida (\$1) na frente dele. Por exemplo, a consulta de pesquisa [Recurso] deve ser Recurso ou \$1[Recurso\$1].

**Limitar a pesquisa**: a pesquisa não faz distinção entre maiúsculas e minúsculas. Pesquisar em letras minúsculas evita que suas consultas dividam palavras na mudança de maiúsculas e minúsculas. Por exemplo, para consultar por `MyService` e somente `MyService`, considere consultar `myservice` para evitar resultados que contenham somente `my` ou `service`.

A pesquisa une palavras e partes de palavras com a conjunção OR-wise por padrão. Por exemplo, `new function` poderia retornar resultados contendo `new` e `function` e também resultados com apenas `new` ou `function`. Para evitar o último, combine várias palavras com `AND`. Por exemplo, você pode pesquisar por `new AND function`.

**Ramificações padrão** – A pesquisa retornará somente os resultados do código da confirmação mais recente na ramificação padrão do repositório de origem. Para encontrar código em outras ramificações ou confirmações, considere [clonar o repositório localmente](source-repositories-clone.md), [abrir a ramificação em um Ambiente de Desenvolvimento](devenvironment-create.md) ou [visualizar as ramificações e os detalhes na interface do usuário do CodeCatalyst](source-branches-view.md). A alteração da ramificação padrão resulta em atualizações nos arquivos que podem ser descobertos pela pesquisa. Para obter mais informações, consulte [Gerenciar a ramificação padrão de um repositório](source-branches-default-branch.md).

**Importante**  
O CodeCatalyst não comporta a detecção de alterações na ramificação padrão para repositórios vinculados. Para alterar a ramificação padrão de um repositório vinculado, primeiro você deve desvinculá-la do CodeCatalyst, alterar a ramificação padrão e vinculá-la novamente. Para obter mais informações, consulte [Vinculando GitHub repositórios, repositórios do Bitbucket, repositórios de GitLab projetos e projetos do Jira no CodeCatalyst](extensions-link.md).  
Como prática recomendada, sempre verifique se você tem a versão mais recente da extensão antes de vincular um repositório.

## Referência de campos pesquisáveis
<a name="search-query-language-searchable-fields"></a>

O CodeCatalyst pesquisa os campos a seguir quando você insere consultas de pesquisa. Aliases são outro nome que você pode usar para referenciar o campo na linguagem de consulta avançada.

### Campos de código
<a name="search-query-language-type-code"></a>


| Campo | Alias | Descrição | 
| --- | --- | --- | 
|  branchName  |  ramo  |  Nome da ramificação em que o arquivo de código está.  | 
|  código  |  N/D  |  Informações sobre o conteúdo do código na forma de trechos de código indicando partes do código-fonte que corresponderam à pesquisa.  | 
|  commitId  |  N/D  |  ID de confirmação da confirmação na qual o arquivo de código retornado foi atualizado pela última vez. Pode ou não ser o ID de confirmação na ponta do nome da ramificação especificado em `branchName`.  | 
|  commitMessage  |  N/D  |  Mensagem de confirmação da confirmação na qual o arquivo de código foi atualizado pela última vez. Pode ou não ser a mensagem de confirmação na ponta do nome da ramificação especificado em `branchName`. Se nenhuma mensagem de confirmação for fornecida, esse valor será uma string vazia.  | 
|  filePath  |  caminho  |  Caminho do arquivo desse arquivo de código.  | 
|  lastUpdatedBy  | N/D |  Usuário do CodeCatalyst que atualizou o arquivo de código pela última vez. Se o nome de usuário não estiver disponível, esse valor será o endereço de e-mail do usuário conforme configurado no arquivo de configuração do Git.  | 
|  lastUpdatedById  |  N/D  |  ID exclusiva gerada pelo sistema do usuário que atualizou o arquivo de código pela última vez. Se o ID de usuário não estiver disponível, esse valor poderá ser o endereço de e-mail do usuário.  | 
|  lastUpdatedTime  |  N/D  |  Hora em que os dados da pesquisa foram atualizados pela última vez com a confirmação que continha o arquivo de código (em Tempo Universal Coordenado (UTC)).  | 
|  projectId  |  N/D  |  ID exclusivo do projeto gerado pelo sistema.  | 
|  projectName  |  projectNames, project  |  O nome de exibição do projeto que contém o repositório de origem no qual o arquivo de código foi confirmado.  | 
|  repositoryId  |  repoId  |  O ID exclusivo gerado pelo sistema do repositório de origem.  | 
|  repositoryName  |  repositório, repo  |  O nome de exibição do repositório de origem no qual o arquivo de código foi confirmado.  | 

### Campos de problema
<a name="search-query-language-type-issue"></a>


| Campo | Alias | Descrição | 
| --- | --- | --- | 
|  assigneeIds  |  assigneeId  |  Os IDs exclusivos gerados pelo sistema dos usuários atribuídos ao problema.  | 
|  destinatários  |  destinatário  |  Nomes de usuário dos usuários atribuídos ao problema.  | 
|  createdBy  |  N/D  |  O nome de exibição do usuário que criou o problema.  | 
|  createdById  |  N/D  |  O ID exclusivo do usuário que criou o problema gerado pelo sistema.  | 
|  createdTime  |  N/D  |  A hora em que a edição foi criada (em Tempo Universal Coordenado (UTC)).  | 
|  description  |  N/D  |  Descrição do problema.  | 
|  isArchived  |  archived  |  Um valor booleano que indica se o problema deve ser criado em um estado arquivado.  | 
|  isBlocked  |  blocked  |  Um valor booleano que indica se o problema foi marcado como bloqueado.  | 
|  labelIds  |  labelId  |  IDs exclusivos dos rótulos gerados pelo sistema para um problema.  | 
|  lastUpdatedBy  |  N/D  |  Nome de exibição do usuário que atualizou o problema pela última vez.  | 
|  lastUpdatedById  |  N/D  |  O ID exclusivo do usuário que atualizou o problema pela última vez gerado pelo sistema.  | 
|  lastUpdatedTime  |  N/D  |  A hora em que o problema foi atualizado pela última vez (em Tempo Universal Coordenado (UTC)).  | 
|  priority  |  N/D  |  Prioridade do problema, se houver um atribuído.  | 
|  projectId  |  N/D  |  ID exclusivo do projeto gerado pelo sistema.  | 
|  projectName  |  projectNames, project  |  Projeto no qual esse problema pode ser encontrado.  | 
|  shortId  |  N/D  |  Identificador abreviado e de incremento automático para o problema.  | 
|  status  |  N/D  |  Status do problema que indica se o problema está em pendência ou na coluna do quadro.  | 
|  statusId  |  N/D  |  Identificador do status do sistema.  | 
|  título  |  N/D  |  Título do problema.  | 

### Campos do projeto
<a name="search-query-language-type-project"></a>


| Campo | Alias | Descrição | 
| --- | --- | --- | 
|  description  |  N/D  |  Uma descrição do projeto.  | 
|  lastUpdatedTime  |  N/D  |  A hora em que os metadados do projeto foram atualizados pela última vez (em Tempo Universal Coordenado (UTC)).  | 
|  projectName  |  project  |  Nome do projeto no espaço.  | 
|  projectPath  |  N/D  |  Nome roteável por URL do projeto, definido durante a criação do projeto. Usado em URLs que exigem o nome do projeto.  | 

### Campos de usuário
<a name="search-query-language-type-user"></a>


| Campo | Alias | Descrição | 
| --- | --- | --- | 
|  Nome de exibição  |  N/D  |  Nome usado para o usuário no CodeCatalyst. Os nomes de exibição não são exclusivos.  | 
|  email  |  N/D  |  O endereço de e-mail do usuário.  | 
|  lastUpdatedTime  |  N/D  |  A hora em que os metadados do usuário foram atualizados pela última vez (em formato de Tempo Universal Coordenado (UTC)).  | 
|  userName  |  username  |  Nome de usuário escolhido pelo usuário quando ele se inscreveu no CodeCatalyst. Ao contrário dos nomes de exibição, os nomes de usuário não podem ser alterados.  |