Utilice la barra de búsqueda o una ventana específica de resultados de búsqueda en CodeCatalyst para buscar código, incidencias, proyectos y usuarios en CodeCatalyst.
Puede buscar recursos en su espacio y en sus proyectos introduciendo consultas como el nombre, la descripción y el estado en la barra de búsqueda. También puede delimitar las consultas de búsqueda mediante el lenguaje de consultas de búsqueda.
Temas
Búsqueda
-
En la barra de búsqueda de la barra de navegación superior, introduzca una consulta de búsqueda.
-
(Opcional) Puede delimitar la consulta de búsqueda utilizando el lenguaje de consultas de búsqueda de CodeCatalyst. Para obtener más información, consulte Delimitación de la consulta de búsqueda.
-
Realice una de las siguientes acciones:
-
Para buscar recursos dentro del proyecto en el que se encuentra actualmente, seleccione Este proyecto.
-
Para buscar recursos en todos los proyectos del espacio en el que se encuentra actualmente, seleccione Este espacio.
-
-
Para ver los resultados de la búsqueda en una ventana de resultados de búsqueda específica, realice una de las siguientes acciones:
-
En la parte inferior de la ventana de los resultados de búsqueda rápida, seleccione Ver todos los resultados en nombre-del-proyecto | nombre–del-espacio para ver todos los resultados de la búsqueda.
-
Presione Intro para ver todos los resultados de la búsqueda.
-
sugerencia
Puede mencionar a otros usuarios del proyecto en un comentario o descripción de una solicitud de extracción, o en un comentario o descripción de un tema, utilizando el signo @ seguido de su nombre de visualización o nombre de usuario. También puede incluir enlaces a recursos como incidencias o archivos de código utilizando el signo @ seguido del nombre dela incidencia o del archivo de código.
Delimitación de la consulta de búsqueda
Si no puede encontrar lo que busca tras realizar la búsqueda, puede delimitarla con el lenguaje de consultas especializado de CodeCatalyst. Los campos individuales no tienen límite de caracteres, pero la consulta general tiene un límite de 1024 caracteres.
Temas
Delimitación por tipo
Para delimitar el alcance de la búsqueda a un tipo de información específico, incluya
en la búsqueda, donde type:result-type
result-type
debe ser code
, issue
, project
o user
.
Ejemplos:
-
type:code AND java
: muestra los resultados del código en campos relacionados con el código que contengan la expresión “java”.Para obtener más información, consulte Campos de código.
-
type:issue AND Bug
: muestra los resultados de incidencias en campos relacionados con incidencias que contengan la expresión “Bug”.Para obtener más información, consulte Campos de incidencias.
-
type:user AND MaryMajor
: muestra los resultados de los usuarios en campos relacionados con los usuarios que contengan la expresión “MaryMajor”.Para obtener más información, consulte Campos de usuario.
-
type:project AND Datafeeder
: muestra los resultados del proyecto que contengan la expresión “Datafeeder”.Para obtener más información, consulte Campos de proyecto.
Delimitación por campo
Para delimitar el alcance de la búsqueda a un campo específico, incluya
en la búsqueda, donde field-name:query
field-name
es title
, username
, project
, description
, etc. y query
es el texto que está buscando. Para obtener una lista de los campos, consulte Referencia de campos que se pueden buscar. Puede buscar varias consultas si utiliza paréntesis.
Ejemplos:
-
title:bug
: muestra los resultados en los que el título contenga la expresión “bug”. -
username:John
: muestra los resultados en los que el nombre de usuario contenga la expresión “John”. -
project:DataFeeder
: muestra los resultados en el proyecto “DataFeeder”. La consulta no distingue entre mayúsculas y minúsculas. -
description:overview
: muestra los resultados en los que la descripción contenga la expresión “overview”.
Delimitación con operadores booleanos
Para especificar las restricciones en las expresiones de búsqueda, puede utilizar los operadores booleanos AND
, OR
y NOT
. Si incluye varias expresiones, CodeCatalyst las une con OR
de forma predeterminada. Puede agrupar las expresiones de búsqueda mediante paréntesis.
-
exception AND type:code
: muestra solo los resultados del código para “exception”. -
path:README.md AND repo:ServerlessAPI
: muestra los resultados de las rutas con “README.md” en las que el repositorio se llame “ServerlessAPI”. -
buildspec.yml AND (repo:ServerlessAPI OR ServerlessWebApp)
: muestra los resultados de “buildspec.yml”, en las que el repositorio sea “ServerlessAPI” o “ServerlessWebApp”. -
path:java NOT (path:py OR path:ts)
: muestra los resultados en los que la ruta contenga “java”, pero no “py” o “ts”.
Delimitación por proyecto
Para delimitar el alcance de la búsqueda a un proyecto específico, incluya
en la búsqueda, donde project:name AND query
name
es el proyecto en el que esté buscando y query
es el contenido que esté buscando.
-
project:name AND query
: muestra los resultados en los que la ruta contenga la consulta y el nombre del proyecto.
Consideraciones sobre el uso de búsquedas
Actualizaciones de contenido retrasadas: las actualizaciones de contenido, como los cambios de nombre o las reasignaciones de incidencias, pueden tardar varios minutos en reflejarse en los resultados de la búsqueda. Las actualizaciones importantes, como la migración de una base de código, pueden tardar más en aparecer en los resultados de búsqueda.
Caracteres de escape especiales: los siguientes caracteres especiales requieren una consideración especial en las consultas de búsqueda: + - & & || ! ( ) { } [ ]
^ " ~ * ? : \
. Los caracteres especiales no influirán en la consulta, y debe eliminarlos u omitirlos mediante marcas de código. Para omitir un carácter mediante marcas de código, escriba una barra invertida (\) delante de él. Por ejemplo, la consulta de búsqueda [Feature] debe ser Feature o \[Feature\].
Búsqueda restrictiva: la búsqueda no distingue entre mayúsculas y minúsculas. La búsqueda en minúsculas evita que las consultas dividan las palabras al cambiar entre mayúsculas y minúsculas. Por ejemplo, para realizar consultas de MyService
y estrictamente de MyService
, considere la posibilidad de utilizar en la consulta la expresión myservice
para evitar resultados que contengan únicamente my
o service
.
De forma predeterminada, la búsqueda une palabras y partes de palabras con una conjunción de tipo OR. Por ejemplo, new function
podría devolver resultados que contengan tanto new
como function
, y también resultados que contengan únicamente new
o function
. Para evitar esto último, combine varias palabras con AND
. Por ejemplo, puede buscar new AND function
.
Ramificaciones predeterminadas: la búsqueda solo devolverá los resultados de código de la última confirmación en la ramificación predeterminada del repositorio de código fuente. Para encontrar código en otras ramificaciones o confirmaciones, puede clonar el repositorio de forma local, abrir la ramificación en un entorno de desarrollo o ver las ramificaciones y los detalles en la interfaz de usuario de CodeCatalyst. Si se cambia la ramificación predeterminada, las actualizaciones de los archivos se pueden detectar mediante la búsqueda. Para obtener más información, consulte Administración de la ramificación predeterminada de un repositorio.
importante
CodeCatalyst no admite la detección de cambios en la ramificación predeterminada de los repositorios vinculados. Para cambiar la ramificación predeterminada de un repositorio vinculado, primero debe desvincularlo de CodeCatalyst, cambiar la ramificación predeterminada y volver a vincularla. Para obtener más información, consulte Vinculación de repositorios de GitHub, repositorios de Bitbucket, repositorios de proyectos de GitLab y proyectos de Jira en CodeCatalyst.
Como práctica recomendada, asegúrese siempre de tener la última versión de la extensión antes de vincular un repositorio.
Referencia de campos que se pueden buscar
CodeCatalyst busca en los siguientes campos al introducir consultas de búsqueda. Los alias son otro nombre que puede utilizar para hacer referencia al campo en el lenguaje de consultas avanzado.
Campo | Alias | Descripción |
---|---|---|
branchName |
branch |
Nombre de la ramificación en la que se encuentra el archivo de código. |
code |
N/A |
Información sobre el contenido del código en forma de fragmentos de código que indican las partes del código fuente que coinciden con la búsqueda. |
commitId |
N/A |
ID de la confirmación en la que se actualizó por última vez el archivo de código devuelto. Puede ser o no el ID de confirmación que aparece en el extremo del nombre de la ramificación especificada en |
commitMessage |
N/A |
Mensaje de la confirmación en la que se actualizó por última vez el archivo de código. Puede ser o no el mensaje de confirmación que aparece en el extremo del nombre de la ramificación especificada en |
filePath |
path |
Ruta de este archivo de código. |
lastUpdatedBy |
N/A |
Usuario de CodeCatalyst que actualizó el archivo de código por última vez. Si el nombre de usuario no está disponible, este valor será la dirección de correo electrónico del usuario tal y como está configurada en el archivo de configuración de Git. |
lastUpdatedById |
N/A |
ID único generado por el sistema del usuario que actualizó por última vez el archivo de código. Si el ID de usuario no está disponible, este valor puede ser la dirección de correo electrónico del usuario. |
lastUpdatedTime |
N/A |
Hora en que los datos de búsqueda se actualizaron por última vez con la confirmación que contenía el archivo de código (en formato de marca de tiempo universal coordinado (UTC)). |
projectId |
N/A |
El ID exclusivo del proyecto generado por el sistema. |
projectName |
projectNames, project |
Muestra el nombre del proyecto que contiene el repositorio de código fuente en el que se ha confirmado el archivo de código. |
repositoryId |
repoId |
El ID exclusivo generado por el sistema del repositorio de código fuente. |
repositoryName |
repository, repo |
Muestra el nombre del repositorio de código fuente en el que se ha confirmado el archivo de código. |
Campo | Alias | Descripción |
---|---|---|
assigneeIds |
assigneeId |
ID únicos generados por el sistema de los usuarios asignados a la incidencia. |
assignees |
assignee |
Nombres de usuario de los usuarios asignados a la incidencia. |
createdBy |
N/A |
Nombre de visualización del usuario que creó la incidencia. |
createdById |
N/A |
ID único generado por el sistema del usuario que creó la incidencia. |
createdTime |
N/A |
Hora en que se creó la incidencia (en formato de marca de tiempo universal coordinado (UTC)). |
description |
N/A |
Descripción de la incidencia. |
isArchived |
archived |
Valor booleano que indica si se va a crear la incidencia en un estado archivado. |
isBlocked |
blocked |
Valor booleano que indica si la incidencia está marcada como bloqueada. |
labelIds |
labelId |
ID únicos generados por el sistema de las etiquetas de una incidencia. |
lastUpdatedBy |
N/A |
Nombre de visualización del usuario que actualizó la incidencia por última vez. |
lastUpdatedById |
N/A |
ID único generado por el sistema del usuario que actualizó por última vez la incidencia. |
lastUpdatedTime |
N/A |
Hora en que se actualizó la incidencia por última vez (en formato de marca de tiempo universal coordinado (UTC)). |
priority |
N/A |
Prioridad de la incidencia, si se ha asignado alguna. |
projectId |
N/A |
El ID exclusivo del proyecto generado por el sistema. |
projectName |
projectNames, project |
Proyecto en el que se encuentra esta incidencia. |
shortId |
N/A |
Identificador abreviado y que se incrementa automáticamente para la incidencia. |
status |
N/A |
Estado de la incidencia que indica si está pendiente o en una columna incluida. |
statusId |
N/A |
Identificador de sistema del estado. |
title |
N/A |
Título de la incidencia. |
Campo | Alias | Descripción |
---|---|---|
description |
N/A |
Descripción del proyecto. |
lastUpdatedTime |
N/A |
Hora en que se actualizaron los metadatos del proyecto por última vez (en formato de marca de tiempo universal coordinado (UTC)). |
projectName |
project |
Nombre del proyecto en el espacio. |
projectPath |
N/A |
Nombre del proyecto que se puede enrutar mediante URL, definido durante la creación del proyecto. Se utiliza en las direcciones URL que requieren el nombre del proyecto. |
Campo | Alias | Descripción |
---|---|---|
displayName |
N/A |
Nombre utilizado para el usuario en CodeCatalyst. Los nombres de visualización no son únicos. |
|
N/A |
Dirección de correo electrónico del usuario. |
lastUpdatedTime |
N/A |
Hora en que se actualizaron los metadatos del usuario por última vez (en formato de marca de tiempo universal coordinado (UTC)). |
userName |
username |
Nombre de usuario elegido por el usuario cuando se registró en CodeCatalyst. A diferencia de los nombres de visualización, los nombres de usuario no se pueden cambiar. |