Configuración del Campo

Aquí es donde defines el comportamiento y la apariencia específicos de tu campo Issue Picker. Puedes acceder a esta página haciendo clic en Configurar para cualquier campo en el Panel Principal.

Configuración por Contexto

Para permitir una mayor flexibilidad y reutilización de los campos de Issue Picker, hemos introducido la capacidad de configurar campos por "contexto". Esto le permite aplicar diferentes configuraciones para el mismo campo según el proyecto o el tipo de incidencia, evitando la necesidad de crear múltiples campos personalizados.

¿Cómo funciona?

1. Crear Contextos en Jira: Primero, navegue a la configuración de campos personalizados de Jira y añada los contextos que necesite para su campo de Issue Picker.

2. Configurar en el Panel del Complemento: Una vez en nuestro panel de administración, si un campo tiene más de un contexto, verá un nuevo menú desplegable llamado Contexto de Configuración en la parte superior del formulario de configuración.

3. Seleccionar un Contexto:
   • Seleccione un contexto para configurar ajustes específicos para diferentes proyectos o tipos de incidencia.
   • Los cambios que realice se aplicarán únicamente al contexto seleccionado.
   • Una estrella (★) junto al nombre del contexto indica que tiene una configuración personalizada guardada.
   • Los contextos sin un asterisco están utilizando la configuración global heredada (Usando configuración heredada).

Editar un Contexto Específico

Al seleccionar un contexto del menú, el formulario se actualizará con su configuración guardada (o la configuración global si es la primera vez), permitiéndole modificarla. Este modo se indica con el texto Editando contexto específico.

Restablecer a la Configuración Global

Si desea que un contexto vuelva a utilizar la configuración global, puede usar el botón "Restablecer a Global". Esto eliminará la configuración específica del contexto y volverá a heredar la configuración por defecto.

---

Una vez que haya seleccionado el contexto deseado (o si está utilizando la configuración global por defecto), puede proceder a configurar las siguientes pestañas. La página de configuración se divide en dos pestañas principales: General y Vista.

Pestaña General

Esta pestaña controla la funcionalidad principal del campo.

• Nombre del Campo y Descripción: Estos campos son de solo lectura aquí y muestran el nombre y la descripción que estableciste al crear el campo personalizado.
• Nota: Un área de texto opcional donde puedes añadir una nota o instrucción adicional para los usuarios. Esta nota se almacena por separado de la descripción estándar del campo.
• Filtro JQL (Opcional): Esta es una característica poderosa que restringe qué issues se pueden seleccionar en el campo. El JQL que ingreses aquí se combina con la búsqueda del usuario.
  • Ejemplo: Si estableces el filtro en project = "PROJ" AND status = "To Do", los usuarios solo podrán buscar y seleccionar issues que estén en el proyecto "PROJ" y que actualmente tengan el estado "To Do".
  • Validación en Vivo: El editor proporciona retroalimentación mientras escribes. Una marca de verificación verde indica un JQL válido, mientras que un icono de error rojo aparecerá si hay un error de sintaxis.

Variables Dinámicas en JQL

Para hacer los filtros aún más poderosos, puedes inyectar valores de otros campos del issue actual en el JQL. Esto permite que el filtro JQL se adapte dinámicamente al contexto del issue donde se está utilizando el campo.

La sintaxis para usar una variable es {{issue.customfield_XXXXX}}, donde XXXXX es el ID numérico del campo personalizado.

• Ejemplo de caso de uso: Imagina que tienes un campo "Componente Principal" (customfield_10200) y quieres que tu campo Issue Picker solo muestre issues que compartan el mismo componente.
  • Tu JQL se vería así: component = {{issue.customfield_10200}}
  • Cuando un usuario utilice el campo Issue Picker en un issue, el valor del campo "Componente Principal" de ese issue se insertará automáticamente en la consulta.

• Ignorar Contexto: Permite la selección de issues de cualquier proyecto para el que el usuario tenga acceso, ignorando el contexto nativo del campo (su configuración de proyectos y tipos de issue). Los permisos de visualización del usuario siempre son respetados.
• Tipo de Selección: Esta configuración determina si los usuarios pueden seleccionar uno o varios issues.
  • Selección Simple: (Predeterminado) Los usuarios solo pueden seleccionar un issue.
  • Selección Múltiple: Los usuarios pueden seleccionar múltiples issues.

Pestaña Vista

Esta pestaña controla cómo se muestran los issues seleccionados y otros elementos de la interfaz de usuario.

• Título del Panel de Enlaces Entrantes: Permite definir un nombre personalizado para el panel de enlaces entrantes que se muestra en la vista de issues. Si no se especifica un valor, el panel mostrará el nombre del campo. Esto te da control total sobre la visibilidad del panel campo por campo.

• Campos Visibles: Puedes elegir qué información adicional mostrar junto al icono, la clave y el resumen del issue seleccionado.

  • Campos Requeridos: El Icono de Tipo de Incidencia, la Clave de Incidencia y el Resumen siempre se muestran.
  • Campos Opcionales: Puedes activar la visibilidad de:
    • Prioridad: Muestra el icono de prioridad del issue.
    • Asignado: Muestra el avatar del usuario asignado.
    • Estado: Muestra el estado actual del issue como una etiqueta de color (ej. "To Do", "In Progress").

• Vista Previa en Vivo: Esta sección proporciona una vista previa dinámica que se actualiza a medida que marcas o desmarcas las opciones de visibilidad de arriba. Te da una idea inmediata de cómo se verá el campo para tus usuarios. Por ejemplo, la vista previa mostrará iconos de marcador de posición para la prioridad y el asignado, y una etiqueta de estado de muestra.

Después de realizar tus cambios en cualquiera de las pestañas, haz clic en el botón Guardar cambios para aplicar tu nueva configuración.