Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Seguimiento de los trabajos con problemas En un proyecto, puede utilizar problemas para planificar su trabajo y hacer un seguimiento de este. Un problema es una determinada cantidad de trabajo que se guarda en un registro determinado. Los problemas se pueden dividir en tareas para añadir algo más de organización y para hacer un seguimiento del trabajo en ese problema. También puede crear enlaces entre los problemas para llevar un registro del trabajo relacionado, añadir etiquetas para organizar y clasificar el trabajo, agrupar los problemas, asignar prioridades al trabajo e indicar si el trabajo está bloqueado. Cuando esté listo para trabajar en un problema o en un conjunto de problemas, puede hacer una estimación del trabajo, asignárselo a los usuarios y añadir comentarios para ayudar a otros a entender el trabajo y su progreso. También puede exportar los problemas para darle un formato distinto a la información que contienen. # Crear un problema en CodeCatalyst Los equipos de desarrollo crean problemas para facilitar el seguimiento y la administración de su trabajo. Puede crear problemas en un proyecto en función de sus necesidades. Por ejemplo, podría crear un problema para hacer un seguimiento de la actualización de una variable en el código. Puede asignar problemas a otros usuarios del proyecto, usar etiquetas para hacer un seguimiento del trabajo y muchas otras cosas. Sigue estas instrucciones para crear una incidencia en CodeCatalyst. **Creación de un problema** 1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Vaya al proyecto en el que desea crear un problema. 1. En la página de inicio del proyecto, seleccione **Crear proyecto**. Si lo prefiere, en el panel de navegación, seleccione **Problemas**. 1. Seleccione **Crear el problema**. **nota** También puede añadir problemas en línea al usar una vista de cuadrícula. 1. Introduzca un título para el problema. 1. (Opcional) Introduzca una **Descripción**. Puede usar Markdown para añadir formato. 1. (Opcional) Seleccione el **estado**, la **prioridad** y la **estimación** para el problema. **nota** Si la configuración de estimación del proyecto está configurada en **Ocultar estimaciones**, no habrá un campo **Estimación**. 1. (Opcional) Añada tareas al problema. Las tareas se pueden usar para dividir el trabajo de un problema en objetivos más pequeños. Para añadir una tarea, seleccione **\$1 Añadir tareas**. Luego, introduzca el nombre de la tarea en el campo de texto y pulse Intro. Después de añadir las tareas, puede marcarlas como completadas seleccionando la casilla de verificación o, si lo prefiere, reordenándolas; para ello, seleccione y arrastre la tarea desde el lado izquierdo de la casilla de verificación. 1. (Opcional) Añada una etiqueta existente o cree una nueva y añádala seleccionando **\$1 Agregar etiqueta**. 1. Para añadir una etiqueta existente, selecciónela de la lista. Puede introducir un término de búsqueda en el campo para buscar en el proyecto todas las etiquetas que contengan ese término. 1. Para crear una etiqueta nueva y añadirla, introduzca el nombre de la etiqueta que desee crear en el campo de búsqueda y pulse Intro. 1. (Opcional) Añada un cesionario seleccionando **\$1 Añadir un cesionario**. Puede añadirse rápidamente como cesionario seleccionando **\$1 Añadirme**. **sugerencia** Puede asignarle el problema a **Amazon Q** para que Amazon Q intente resolverlo. Para obtener más información, consulte [Tutorial: Uso de funciones de IA CodeCatalyst generativa para acelerar el trabajo de desarrollo](getting-started-project-assistance.md). Esta característica solo está disponible en la región Oeste de EE. UU. (Oregón). Esta funcionalidad requiere que las características de IA generativa estén habilitadas en el espacio. Para obtener más información, consulte [Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. (Opcional) Añada un **campo personalizado** existente o cree uno nuevo. Los problemas pueden tener varios campos personalizados. 1. Para añadir un campo personalizado existente, elija el campo personalizado en la lista. Puede introducir un término de búsqueda en el campo para buscar en el proyecto todos los campos personalizados que contengan ese término. 1. Para crear un nuevo campo personalizado y añadirlo, introduzca el nombre del campo personalizado que desee crear en el campo de búsqueda y pulse Intro. A continuación, elija el tipo de campo personalizado que desee crear y establezca un valor. 1. Seleccione **Crear el problema**. Aparecerá una notificación en la esquina inferior derecha: si el problema se ha creado correctamente, aparecerá un mensaje de confirmación indicándolo; si el problema no se ha creado correctamente, aparecerá un mensaje de error con el motivo. A continuación, puede seleccionar **Reintentar** para editar y volver a intentar crear el problema, o bien seleccionar **Descartar** para descartarlo. Ambas opciones descartarán la notificación. **nota** No puede vincular una solicitud de extracción a un problema cuando lo crea. Sin embargo, puede [editarlo](issues-edit-issue.md) después de crearlo para añadir enlaces a las solicitudes de extracción. ## Prácticas recomendadas al crear problemas asignados a Amazon Q y al trabajar en ellos Tras crear problemas, algunos de ellos permanecen. Hay diversos motivos para ello y algunos pueden ser complejos. A veces, no está claro quién debe trabajar en el problema. Otras veces, el problema requiere investigación o experiencia en una parte determinada del código base y los mejores candidatos para el trabajo están ocupados con otros problemas. A menudo, hay otro trabajo urgente que se debe atender primero. Cualquiera de estas causas o todas ellas pueden provocar problemas que no se resuelvan. CodeCatalyst incluye la integración con un asistente de IA generativa llamado Amazon Q que puede analizar un problema en función de su título y su descripción. Si le asigna el problema a Amazon Q, este intentará crear un borrador de solución para que lo repase. Con esta ayuda, su equipo y usted pueden centrar su trabajo en los problemas que requieran su atención, mientras Amazon Q trabaja en una solución para aquellos problemas que usted no puede abordar inmediatamente por falta de recursos. **nota** **Desarrollado por Amazon Bedrock**: AWS implementa la [detección automática de abusos](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). Como las características **Escribir descripción automáticamente**, **Crear un resumen del contenido**, **Recomendar tareas**, **Utilizar Amazon Q para crear o agregar características a un proyecto** y **Asignar problemas a Amazon Q** del agente de Amazon Q Developer para el desarrollo de software están basadas en Amazon Bedrock, los usuarios pueden aprovechar al máximo los controles implementados en Amazon Bedrock para garantizar la protección, la seguridad y el uso responsable de la inteligencia artificial (IA). Amazon Q funciona mejor en cuestiones o problemas sencillos y directos. Para obtener los mejores resultados, utilice un lenguaje sencillo para explicar claramente lo que quiere que se haga. A continuación, encontrará algunas prácticas recomendadas para crear problemas de modo que Amazon Q pueda trabajar en ellos. **importante** Las características de IA generativa solo están disponibles en la región de Oeste de EE. UU. (Oregón). + **Explique las cosas con sencillez**. Amazon Q funciona mejor con cambios y correcciones de código simples que se pueden explicar en el título y la descripción del problema. Al elegir un título o una descripción, evite usar ambigüedades, contradicciones o palabras innecesarias. + **Hable de un modo específico**. Cuanta más información pueda proporcionar sobre los cambios exactos necesarios para resolver el problema, más fácil será que Amazon Q logre crear una solución eficaz. Si es posible, incluye detalles específicos, como el nombre APIs que deseas cambiar, los métodos que deseas actualizar, las pruebas que necesitan cambios y cualquier otro detalle que se te ocurra. + **Incluya todos los detalles en el título y la descripción del problema antes de asignárselo a Amazon Q**. No puede cambiar el título ni la descripción de un problema después de dicha asignación, así que asegúrese de tener toda la información necesaria sobre un problema antes de asignárselo a Amazon Q. + **Asigne únicamente los problemas que requieran cambios de código en un solo repositorio de código fuente**. Amazon Q solo puede funcionar con el código de un único repositorio fuente en CodeCatalyst. Los repositorios vinculados no son compatibles. Asegúrese de que el problema solo requiera cambios en un solo repositorio de código fuente antes de asignarle el problema a Amazon Q. + **Use la opción de aprobación de pasos (la opción que sugiere Amazon Q de forma predeterminada)**. De forma predeterminada, Amazon Q le pedirá su aprobación para cada paso. Esto le permite usar comentarios para interactuar con Amazon Q sobre el problema y sobre cualquier solicitud de cambios que cree. De este modo, disfrutará de una experiencia más interactiva con Amazon Q y podrá ajustar el procedimiento y el código para resolver el problema. **nota** Amazon Q no responde a comentarios individuales en problemas o solicitudes de extracción, pero los revisará cuando se le pida que vuelva a valorar el método seleccionado o que cree una revisión. + **Revise siempre con cuidado el método sugerido por Amazon Q**. Cuando usted apruebe el método, Amazon Q empezará a trabajar en la generación de código con base en dicho método. Por lo tanto, antes de decirle a Amazon Q que continúe, revise bien el método y compruebe que incluya todos los detalles necesarios. + **Compruebe que solo Amazon Q pueda trabajar en flujos de trabajo si no tiene otros flujos de trabajo que puedan implementarse antes de la revisión**. Es posible que el proyecto tenga flujos de trabajo configurados para iniciar ejecuciones ante eventos de solicitudes de extracción. Si es así, cualquier solicitud de extracción que Amazon Q cree, y que incluya la creación o actualización del YAML del flujo de trabajo, podría iniciar una ejecución de los flujos de trabajo incluidos en la solicitud de extracción. Como práctica recomendada, no permita que Amazon Q trabaje en archivos de flujo de trabajo a menos que esté seguro de que no hay flujos de trabajo en el proyecto que vayan a ejecutar automáticamente estos flujos antes de revisar y aprobar la solicitud de extracción que se cree. Para obtener más información, consulte [Tutorial: Uso de funciones de IA CodeCatalyst generativa para acelerar el trabajo de desarrollo](getting-started-project-assistance.md) y [Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). ## Estimación de un problema En el desarrollo ágil, la *estimación* se conoce como los puntos de una historia. Puede utilizar la estimación de un problema para representar la cantidad de trabajo necesario, además de la ambigüedad y la complejidad del problema. Valore la posibilidad de utilizar estimaciones más altas para los problemas con mayor riesgo o dificultad o con un mayor número de incógnitas. Antes de estimar los problemas, primero debe elegir qué tipo de estimaciones desea utilizar para el proyecto. De forma predeterminada puede elegir entre dos: Para utilizar los métodos **talla de camisetas** o **secuencia de Fibonacci** de forma eficaz, el equipo debe concordar en lo que cada talla representa. Deben decidir en conjunto lo que representa cada estimación y, luego, empezar a aplicar esas estimaciones en cada problema. Es recomendable hacer revisiones periódicas. Siga estos pasos para configurar la configuración de las estimaciones del esfuerzo en caso de problemas en CodeCatalyst. **Configuración de la estimación del esfuerzo en problemas** 1. En el panel de navegación, elija **Problemas**. 1. Seleccione **Problemas activos** para abrir el menú desplegable del **selector de vistas de problemas** y elija **Configuración**. 1. En **Estimación**, en la sección **Configuración básica**, elija cómo aparecerán los valores de estimación. Los tipos de estimaciones disponibles son **Talla de camisetas**, **Secuencia de Fibonacci** u **Ocultar estimaciones**. Si la configuración de estimación del proyecto está configurada en **Ocultar estimaciones**, no habrá campo **Estimación** en los problemas del proyecto. Cuando se actualice el tipo de estimación, no se perderá ningún dato y el valor de estimación de todos los problemas se convertirá automáticamente. La asignación de conversiones aparece en la siguiente tabla. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/issues-tracking-work.html) Para añadir o cambiar la estimación de un problema, puede [editar el problema](issues-edit-issue.md). # Edición y colaboración en temas de CodeCatalyst **Contents** + [Edición de problemas](issues-edit-issue.md) + [Uso de archivos adjuntos](issues-attachments.md) + [Visualización y administración de archivos adjuntos](issues-settings-attachments.md) + [Administración de las tareas en los problemas](issues-tasks.md) + [Vinculación entre problemas](issues-link-issue.md) + [Señalización de un problema como bloqueado o desbloqueado](issues-mark-as-blocked.md) + [Adición, edición o eliminación de comentarios](issues-comment.md) + [Uso de menciones en un comentario](issues-mentions-comment.md) # Edición de problemas Siga estos pasos para editar el título, la descripción, el estado, el cesionario, la prioridad, la estimación o las etiquetas de un problema. **Edición de un problema** 1. Elija el problema que desee editar para ver los detalles del problema. Si necesita ayuda para encontrar un problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Para editar el título del problema, seleccione el título, introduzca uno nuevo y pulse Intro. 1. Para editar la descripción, selecciónela, introduzca una nueva y pulse Intro. Puede usar Markdown para añadir formato. 1. En **Tareas**, puede ver y administrar las tareas relacionadas con el problema. Si no hay tareas, puede dejar que Amazon Q analice el problema y recomiende tareas para dividir el trabajo en elementos independientes que se puedan asignar a usuarios. Para obtener más información, consulte [Administración de las tareas en los problemas](issues-tasks.md). 1. Para editar el **estado**, la **estimación** o la **prioridad**, elija una opción de los menús desplegables correspondientes. 1. En **Etiquetas**, puede añadir una etiqueta existente, eliminarla o crear una nueva. 1. Para añadir una etiqueta existente, seleccione **\$1 Agregar etiqueta** y elija la etiqueta de la lista. Puede introducir un término de búsqueda en el campo para buscar en el proyecto todas las etiquetas que contengan ese término. 1. Para crear una etiqueta nueva y añadirla, seleccione **\$1 Agregar etiqueta**, introduzca el nombre de la etiqueta que desee crear en el campo de búsqueda y pulse Intro. 1. Para eliminar una etiqueta, seleccione el icono **X** junto a la etiqueta que desee eliminar. Si elimina una etiqueta de todos los problemas, la etiqueta aparecerá en **Etiquetas no utilizadas**, en la sección **Etiquetas** de la **configuración** del problema. Las etiquetas no utilizadas aparecen al final de la lista de etiquetas cuando se utilizan filtros o se añaden etiquetas a un problema. Puede encontrar un resumen de todas las etiquetas (usadas y no usadas) y de los problemas que las contienen en la **configuración** del problema. 1. Para asignar un problema, seleccione **\$1 Añadir un cesionario** en la sección **Cesionario** y busque y seleccione al cesionario en la lista. Puede añadirse rápidamente como cesionario seleccionando **\$1 Añadirme**. 1. En **Archivos adjuntos**, puede añadir, descargar o eliminar archivos adjuntos. Para obtener más información, consulte [Uso de archivos adjuntos](issues-attachments.md). 1. Para vincular una solicitud de extracción, seleccione **Vincular solicitud de extracción** y elija una solicitud de extracción de la lista o introduzca su URL o ID. Para desvincular una solicitud de extracción, seleccione el icono de desvinculación. **sugerencia** Después de añadir un enlace a una solicitud de extracción en un problema, puede acceder rápidamente a ella seleccionando el ID correspondiente en la lista de solicitudes de extracción vinculadas. Puede usar la URL de una solicitud de extracción para vincular las solicitudes que estén en proyectos distintos del panel de problemas, pero solo los usuarios que sean miembros de ese proyecto podrán ver esa solicitud de extracción o ir a ella. 1. (Opcional) Añada y configure un campo personalizado existente, elimínelo o cree uno nuevo. Los problemas pueden tener varios campos personalizados. 1. Para añadir un campo personalizado existente, elija el campo personalizado en la lista. Puede introducir un término de búsqueda en el campo para buscar en el proyecto todos los campos personalizados que contengan ese término. 1. Para crear un nuevo campo personalizado y añadirlo, introduzca el nombre del campo personalizado que desee crear en el campo de búsqueda y pulse Intro. A continuación, elija el tipo de campo personalizado que desee crear y establezca un valor. 1. Para eliminar un campo personalizado, seleccione el icono **X** junto al campo personalizado que desee eliminar. Si elimina un campo personalizado de todos los problemas, este se eliminará y ya no podrá verlo al aplicar filtros. # Uso de archivos adjuntos Puede añadir archivos adjuntos a los números CodeCatalyst para facilitar el acceso a los archivos relacionados. Utilice el siguiente procedimiento para administrar los archivos adjuntos de un problema. El tamaño de los archivos adjuntos que se añaden a problemas se contabiliza en las cuotas de almacenamiento del espacio. Para obtener más información sobre cómo ver y administrar los archivos adjuntos de un proyecto, consulte [Visualización y administración de archivos adjuntos](issues-settings-attachments.md). **importante** Amazon no escanea ni analiza los archivos adjuntos a los números CodeCatalyst. Cualquier usuario puede añadir un archivo adjunto a un problema, y ese archivo podría contener código o contenido malicioso. Asegúrese de que los usuarios conozcan las prácticas recomendadas sobre la administración de los archivos adjuntos y la protección frente a virus y código o contenido malicioso. **Adición, descarga o eliminación de archivos adjuntos** 1. Seleccione el problema en el que desee administrar tareas. Si necesita ayuda para encontrar un problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Para añadir un archivo adjunto, seleccione **Cargar archivo**. Vaya al archivo en el explorador de archivos del sistema operativo y selecciónelo. Seleccione **Abrir** para añadirlo como archivo adjunto. Para obtener información sobre las cuotas, como el tamaño máximo de los archivos adjuntos, consulte [Cuotas para emisiones en CodeCatalyst](issues-quotas.md). Tenga en cuenta las siguientes limitaciones sobre el nombre y el tipo de contenido de los archivos adjuntos. + Los siguientes caracteres no están permitidos en el nombre del archivo: + Caracteres de control (`0x00–0x1f` y `0x80–0x9f`). + Caracteres reservados (`/`, `?`, `<`, `>`, `\`, `:`, `*`, `|` y `"`). + Nombres de archivos reservados de Unix (`.` y `..`). + Puntos y espacios al final. + Nombres de archivos reservados de Windows (`CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9`). + El tipo de contenido del archivo adjunto debe seguir el siguiente patrón de tipos de soporte: ``` media-type = type "/" [tree "."] subtype ["+" suffix]* [";" parameter]; ``` Por ejemplo, `text/html; charset=UTF-8`. 1. Para descargar un archivo adjunto, seleccione el menú de puntos suspensivos situado junto al archivo adjunto que desee descargar y seleccione **Descargar**. 1. Para copiar la URL de un archivo adjunto, seleccione el menú de puntos suspensivos situado junto al archivo adjunto del que quiera copiar la URL y seleccione **Copiar URL**. 1. Para eliminar un archivo adjunto, seleccione el menú de puntos suspensivos situado junto al archivo adjunto que desee eliminar y seleccione **Eliminar**. # Visualización y administración de archivos adjuntos Puede ver una tabla con todos los archivos adjuntos añadidos a los problemas de un proyecto en la configuración de problemas. Esta tabla incluye detalles de todos los archivos adjuntos, con información como el tipo de contenido, cuándo se ha añadido, el problema en el que se ha añadido, el estado y el tamaño del archivo. Esta tabla se puede utilizar para identificar fácilmente los archivos adjuntos de gran tamaño en problemas completados o archivados, a fin de eliminarlos y liberar espacio de almacenamiento. **importante** Amazon no escanea ni analiza los archivos adjuntos a los números CodeCatalyst. Cualquier usuario puede añadir un archivo adjunto a un problema, y ese archivo podría contener código o contenido malicioso. Asegúrese de que los usuarios conozcan las prácticas recomendadas sobre la administración de los archivos adjuntos y la protección frente a virus y código o contenido malicioso. **Visualización y administración de todos los archivos adjuntos de problemas en un proyecto** 1. En el panel de navegación, elija **Problemas**. 1. Seleccione el icono de puntos suspensivos y **Configuración**. 1. Seleccione la pestaña **Archivos adjuntos**. # Administración de las tareas en los problemas Se pueden añadir *tareas* a los problemas a fin de añadir algo más de desglose, organización y seguimiento en el trabajo de ese problema. Puede crear tareas usted mismo o utilizar Amazon Q para recomendar tareas en función de su análisis del problema y de su complejidad. Amazon Q Developer es un asistente conversacional generativo basado en inteligencia artificial que puede ayudarlo a comprender, crear, ampliar y operar aplicaciones. AWS Para acelerar su desarrollo AWS, el modelo que impulsa Amazon Q se complementa con AWS contenido de alta calidad para producir respuestas más completas, procesables y referenciadas. Para obtener más información, consulte [What is Amazon Q Developer?](https://docs.aws.amazon.com/amazonq/latest/aws-builder-use-ug/what-is.html) en la *Guía del usuario de Amazon Q Developer*. **Administración de tareas relacionadas con problemas** 1. Elija el problema para el que desea administrar tareas. Si necesita ayuda para encontrar un problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. En **Tareas**, puede ver y administrar las tareas relacionadas con el problema. 1. Para añadir una tarea, introduzca el nombre de la tarea en el campo de texto y pulse Intro. 1. Si el problema no tiene ninguna tarea, puede dejar que Amazon Q lo analice y cree tareas en función del título y la descripción del problema o del análisis de la complejidad de este y del código del repositorio; elija **Recomendar tareas**. Deberá especificar el repositorio de código fuente que contiene el código del problema. Seleccione **Comenzar a recomendar tareas** para iniciar el análisis de recomendación de tareas. El cuadro de diálogo se cerrará. Tras finalizar la recomendación, seleccione **Ver tareas recomendadas** para revisarlas y tomar las medidas que sean necesarias, como eliminar o añadir tareas a la lista o reordenar las tareas recomendadas, antes de seleccionar **Crear tareas**. Después de que las tareas se hayan creado automáticamente, podrá asignárselas a los usuarios y trabajar con ellas tal y como lo haría con las creadas manualmente. 1. Para marcar una tarea como completada, seleccione la casilla de verificación de la tarea. 1. Para ver o actualizar los detalles de una tarea, selecciónela en la lista. 1. Para reordenar las tareas, elija y arrastre la tarea desde el lado izquierdo de la casilla de verificación. 1. Para eliminar una tarea, seleccione el menú de puntos suspensivos de la tarea y, luego, **Eliminar**. # Vinculación entre problemas Si un problema está relacionado con el trabajo en otro problema, puede vincularlos. Esta es una forma rápida de comprender las dependencias entre los elementos de trabajo y de hacer un seguimiento de estas. Al vincular un problema, puede elegir entre cuatro estados: + Relacionado con: utilice este estado para especificar el trabajo relacionado con el problema vinculado. + Bloqueado por: utilice este estado para indicar que el problema está bloqueado por el problema vinculado. + Bloquear para: utilice este estado para indicar que el problema está bloqueando el progreso en el problema vinculado. + Duplicado: utilice este estado para indicar que el problema duplica el trabajo capturado en otro problema. No puede cambiar el estado de una vinculación después de crearla. Los enlaces y su estado aparecen en **Problemas vinculados**, tanto en el problema donde se creó el enlace como en el problema vinculado. También puede eliminar los enlaces después de crearlos. **Vinculación entre problemas o entre un problema y una tarea** 1. Abra el problema que desee vincular a otro problema. Si necesita ayuda para encontrar el problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione **Vincular problemas**. 1. En **Marcar como**, elija el estado del enlace. En **Número de problema**, introduzca el número del problema o selecciónelo en la lista desplegable. 1. Para añadir otro enlace, seleccione **Añadir problema vinculado**. 1. Cuando haya terminado, seleccione **Actualizar** para actualizar el problema y todos los problemas vinculados en la relación. # Señalización de un problema como bloqueado o desbloqueado Si hay algo que le impide trabajar en un problema, quizá sea una buena idea señalarlo como *bloqueado*. Por ejemplo, el problema podría estar bloqueado si depende de un cambio en otra parte de la base de código que aún no se ha combinado. Cuando marcas una publicación como bloqueada, CodeCatalyst añades una etiqueta roja de **Bloqueado** a la publicación, lo que la hace muy visible en tu registro o archivo, o en tu tablero. Podrá desbloquear el problema cuando se resuelvan las circunstancias externas. **Señalización de un problema como bloqueado** 1. Abra el problema que desee señalizar como bloqueado. Si necesita ayuda para encontrar el problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione **Acciones** y, a continuación, **Señalizar como bloqueado**. **Desbloqueo de un problema** 1. Abra el problema que desee desbloquear. Si necesita ayuda para encontrar el problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione **Acciones** y, a continuación, **Señalizar como desbloqueado**. # Adición, edición o eliminación de comentarios Puede dejar comentarios en problemas. En los comentarios, puede incluir una etiqueta a otros miembros del espacio, otros proyectos del espacio, problemas relacionados y código. **Adición de comentarios en un problema** 1. Vaya a su proyecto. 1. En la barra de navegación, elija **Problemas**. 1. Elija el problema en el que desee añadir el comentario. Si necesita ayuda para encontrar un problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Introduzca el comentario en el campo **Comentarios**. Puede usar Markdown para añadir formato. 1. Seleccione **Enviar**. **Para editar un comentario** Puede editar los comentarios que haga sobre los problemas. Solo puede editar los comentarios que usted haya creado. 1. Vaya a su proyecto. 1. En la barra de navegación, elija **Problemas**. 1. Elija el problema en el que desee añadir un comentario. Si necesita ayuda para encontrar un problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Para editar un comentario, busque el comentario que desee editar. **sugerencia** Puede ordenar los comentarios por los más antiguos o los más recientes. Los comentarios se cargan de diez en diez. 1. Seleccione el icono de puntos suspensivos y **Editar**. 1. Edite el comentario. Puede usar Markdown para añadir formato. 1. Seleccione **Save**. El comentario ya se ha actualizado. **Para eliminar un comentario** Puede eliminar los comentarios que haga sobre problemas. Solo puede eliminar los comentarios que usted haya creado. Al eliminar un comentario, aparecerá su nombre de usuario, pero con la frase *This comment has been deleted* en lugar del texto original del comentario. 1. Vaya a su proyecto. 1. En la barra de navegación, elija **Problemas**. 1. Seleccione el problema en el que desee eliminar un comentario. Si necesita ayuda para encontrar un problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione el icono de puntos suspensivos, **Eliminar** y, a continuación, **Confirmar**. # Uso de menciones en un comentario En los comentarios, puede incluir menciones a miembros del espacio, otros proyectos, problemas relacionados y código. Al hacerlo, se crea un enlace rápido al usuario o al recurso mencionado. **Menciones (con @) en comentarios** 1. Vaya a su proyecto. 1. En la barra de navegación, elija **Problemas**. 1. Elija el problema que desee editar para ver los detalles del problema. Si necesita ayuda para encontrar un problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione el cuadro de texto **Agregar un comentario**. 1. Escriba `@user_name` para mencionar a otro usuario. 1. Escriba `@project_name` para mencionar un proyecto. 1. Escriba `@issue_name` o `@issue_number` para mencione otro problema. 1. Escriba `@file_name` para mencionar código o archivos específicos en un repositorio de código fuente. **nota** A medida que escriba, aparecerá una lista de los cinco elementos principales (usuarios, repositorios de código fuente, proyectos, etc.) que contengan los términos que coincidan con sus `@mention`. 1. Elija el elemento que desee mencionar. La ruta con la ubicación del elemento aparecerá en el cuadro de texto del comentario. 1. Termine el comentario y seleccione **Enviar**. # Búsqueda y visualización de problemas En las siguientes secciones se describe cómo buscar y ver de forma eficaz los problemas de un CodeCatalyst proyecto. ## Búsqueda de un problema Puede hacer la búsqueda de un problema por parámetros específicos. Para obtener más información sobre cómo afinar la búsqueda, consulte [Búsqueda de código, incidencias, proyectos y usuarios en CodeCatalystBúsqueda de código, incidencias, proyectos y usuarios](search.md). **Búsqueda de un problema** 1. Vaya a su proyecto. 1. Utilice la barra de búsqueda para encontrar problemas o información relacionada con problemas. Puede utilizar parámetros de consulta para afinar la búsqueda. Para obtener más información, consulte [Búsqueda de código, incidencias, proyectos y usuarios en CodeCatalystBúsqueda de código, incidencias, proyectos y usuarios](search.md). # Ordenación de problemas De forma predeterminada, los problemas CodeCatalyst se ordenan por **orden manual**. El orden manual muestra los problemas tal y como los usuarios los muevan. Cuando los problemas están ordenados de forma manual, puede arrastrarlos y soltarlos para cambiar su orden. Esta opción de ordenación es útil para preparar el registro de tareas pendientes de los problemas y para priorizarlos. La siguiente tabla muestra cómo se pueden ordenar los problemas tanto en la vista de cuadrícula como en la de panel. | Opciones de ordenación en la vista de cuadrícula | Opciones de ordenación en la vista de panel | | --- | --- | | Orden manual | Orden manual | | Última actualización | Última actualización | | Priority (Prioridad) | Priority (Prioridad) | | Estimación | Estimación | | Title | Title | | ID | | | Status | | | Blocked | | | Campos personalizados | | Utilice el procedimiento que se indica a continuación para cambiar el orden de los problemas. **Ordenación de problemas** 1. Vaya a su proyecto. 1. En el panel de navegación, elija **Problemas**. La vista predeterminada es **Panel**. 1. (Opcional) Seleccione **Problemas activos** para abrir el menú desplegable del **selector de vistas de problemas** e ir a una vista de problemas distinta. 1. Para ordenar una vista de cuadrícula, hay dos opciones: 1. Elija el **encabezado** del campo por el que desea ordenar. Cuando selecciona el **encabezado**, se alterna entre orden ascendente y descendente. 1. Seleccione el menú desplegable **Ordenar por** y elija un parámetro de ordenación. Los problemas se clasificarán en orden ascendente. 1. Para ordenar una vista de panel, seleccione el menú desplegable **Ordenar por** y elija un parámetro de ordenación. Los problemas se clasificarán en orden ascendente. # Agrupación de problemas La agrupación se utiliza para organizar los problemas en el panel según varios parámetros, como el cesionario, las etiquetas y la prioridad. **Agrupación de problemas** 1. Vaya a su proyecto. 1. En el panel de navegación, elija **Problemas**. La vista predeterminada es **Panel**. 1. (Opcional) Seleccione **Problemas activos** para abrir el menú desplegable del **selector de vistas de problemas** e ir a una vista de problemas distinta. 1. Seleccione **Agrupar**. 1. En **Agrupar por**, elija un parámetro por el que agrupar: + Si elige **Cesionario** o **Prioridad**, elija el **Orden de agrupación**. + Si elige **Etiqueta**, seleccione las etiquetas y, a continuación, **Orden de agrupación**. 1. (Opcional) Seleccione el conmutador **Mostrar grupos vacíos** para mostrar u ocultar los grupos que actualmente no tienen ningún problema asignado. 1. La vista se actualiza a medida que selecciona elementos. Un problema solo aparecerá en el grupo que coincida con los parámetros configurados. # Filtrado de problemas Utilice el filtrado para buscar problemas que contengan un valor especificado de nombre, prioridad, etiqueta, campo personalizado o cesionario. **Filtrado de problemas** 1. Vaya a su proyecto. 1. En el panel de navegación, elija **Problemas**. 1. (Opcional) Seleccione **Problemas activos** para abrir el menú desplegable del **selector de vistas de problemas** e ir a una vista de problemas distinta. **nota** Para filtrar según una cadena en el nombre o la descripción del problema, introduzca la cadena en la barra de búsqueda de problemas. 1. Seleccione **Filtro** y, a continuación, **\$1 Agregar filtro**. 1. Elija los parámetros por los que desee filtrar. Puede elegir varios filtros y parámetros. Puede configurar los filtros para mostrar los problemas que coincidan con todos los filtros o con cualquier filtro individual seleccionando **y** o bien **o**. La vista se actualizará para mostrar los problemas que coincidan con el filtro. # Progresión en problemas Todos los problemas tienen un ciclo de vida. En CodeCatalyst, los problemas suelen empezar como un borrador en el backlog. Cuando va a empezar el trabajo en ese problema, este pasa a otra categoría de estado y pasa por varios estados hasta que se completa; luego, se archiva. Puede mover el problema, o hacer que avance en su ciclo de vida, de las siguientes maneras: + Puede mover un problema entre el registro de tareas pendientes y el panel. + Puede mover un problema en curso por varias etapas de finalización. + Puede archivar un problema que se haya completado. # Transferencia de un problema entre el registro de tareas pendientes y el panel Cuando empiece a trabajar en el problema, podrá moverlo entre el registro de tareas pendientes y el panel. Si el trabajo se pospone, también puede volver a incluirlo en el registro de tareas pendientes. **Transferencia de un problema entre el registro de tareas pendientes y el panel** 1. Vaya a su proyecto. 1. En el panel de navegación, elija **Problemas**. La vista predeterminada es **Panel**. 1. Para transferir un problema del panel al registro de tareas pendientes, haga lo siguiente: 1. Seleccione el problema que desee transferir. Si necesita ayuda para encontrar el problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione **Tareas pendientes** en el menú desplegable **Estado**. 1. Para transferir un problema del registro de tareas pendientes al panel, haga lo siguiente: 1. Para acceder al registro de tareas pendientes, seleccione **Panel** y **Tareas pendientes**. 1. Seleccione el problema que desee transferir. Si necesita ayuda para encontrar el problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione **Añadir al panel** o elija un **estado** que no sea **Tareas pendientes**. # Progreso de un problema por las etapas del ciclo de vida en el panel Puede transferir un problema dentro de un panel a través de diferentes estados hasta que se complete. **Transferencia de un problema dentro del panel** 1. En el panel de navegación, elija **Problemas**. La vista predeterminada es **Panel**. 1. Realice una de las siguientes acciones: + Arrastre y suelte el problema a otro estado. + Seleccione un problema y elija un estado en el menú desplegable **Estado**. + Elige un problema y, a continuación, selecciona **Mover a: *next-status***. Para obtener información sobre cómo archivar un problema, consulte [Archivo de problemas](issues-archive-issues.md). # Transferencia de problemas entre grupos Puede [agrupar los problemas](issues-grouping.md) en las vistas **Todos los problemas** y **Panel** según distintos parámetros. Si los problemas están agrupados, puede moverlos de un grupo a otro. Al mover un problema de un grupo a otro, se editará automáticamente el campo en el que están agrupados los problemas para que coincida con el grupo de destino. Como ejemplo, supongamos que hay una empresa CodeCatalyst que utiliza y que tiene problemas asignados a dos personas, Wang Xiulan y Saanvi Sarkar. El panel está agrupado por `Assignee` y hay dos grupos, uno para cada cesionario. Si se transfiere un problema del grupo de Wang Xiulan al grupo de Saanvi Sarkar, el cesionario del problema pasará a ser Saanvi Sarkar. # Archivo de problemas **nota** Los problemas de un proyecto no se eliminan, se archivan. Para eliminar los problemas, debe eliminar el proyecto. Puede archivar un problema cuando ya no lo necesite en el proyecto. Al archivar un problema, lo CodeCatalyst elimina de todas las vistas que filtran los problemas archivados. Los problemas archivados se pueden ver en la vista predeterminada **Problemas archivados**; si es necesario, se pueden desarchivar. Puede archivar un problema en los siguientes casos: + Ya ha completado el problema y no lo necesita en la columna **Listo**. + No tiene la intención de trabajar en el problema. + Ha creado el problema por error. + Ha alcanzado el número máximo de problemas activos. **Archivo de problemas** 1. Abra el problema que desee archivar. Si necesita ayuda para encontrar el problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione **Acciones** y **Pasar al archivo**. 1. (Opcional) Para archivar rápidamente varios problemas con el estado **Completado**, seleccione los puntos suspensivos verticales situados en la parte superior del estado **Completado** del panel y seleccione **Archivar problemas**. **Desarchivo de problemas** 1. Abra el problema que desee desarchivar. Para ver una lista de problemas archivados, abra la vista **Problemas archivados** en el menú desplegable del **selector de vistas de problemas**. Si necesita ayuda para encontrar el problema, consulte [Búsqueda y visualización de problemas](issues-view.md). 1. Seleccione **Desarchivar**. # Exportación de problemas Puede exportar los problemas de la vista actual a un archivo .xlsx. Para exportar los problemas, siga los pasos a continuación. **Exportación de problemas** 1. Vaya a su proyecto. 1. En la barra de navegación, elija **Problemas**. 1. Seleccione **Problemas activos** para abrir el menú desplegable del **selector de vistas de problemas** y vaya a la vista que contiene los problemas que desee exportar. Solo se exportarán los problemas que aparecen en la vista. 1. Seleccione el menú de puntos suspensivos y elija **Exportar a Excel**. 1. Se descargará el archivo .xlsx. De forma predeterminada, tiene como nombre el nombre del proyecto y la fecha de la exportación.