Saltar al contenido principal
Version: 2.1.0

Campo Personalizado Teléfono

El campo personalizado Phone Number Field permite registrar un número de teléfono por work item, con validación de formato y renderizado como un enlace clicable tel: desde la vista del issue. Es útil para fichas de cliente, requesters de mesa de servicio, contactos comerciales y, en general, cualquier caso en el que se necesite capturar un número que luego pueda llamarse con un clic.

Crear el campo Teléfono​

  1. En Jira, haga clic en el icono de Configuración (rueda dentada) en la esquina superior derecha.

  2. Seleccione Issues (Incidencias).

  3. En la barra lateral izquierda, dentro de la sección Fields, haga clic en Custom fields.

  4. Haga clic en Create custom field en la esquina superior derecha.

  5. En la pantalla "Select a field type", busque y seleccione Phone Number Field. Haga clic en Next.

    💡 Lo reconocerá por su descripción: "Stores a single phone number." y por el icono de teléfono.

    Selección del tipo Phone Number Field en Jira Cloud

  6. Nombre y descripción:

    • Introduzca un Name (Nombre) para el campo (por ejemplo, "Teléfono del solicitante", "Contacto comercial").
    • Añada una Description opcional.

  7. Haga clic en Create.

  8. Asociar a pantallas: Marque las pantallas donde aparecerá el campo (creación, edición, transición, vista) y haga clic en Update.

A partir de este momento el campo está disponible para capturarse en los issues.

Formatos aceptados​

El complemento valida cada número en el cliente (mientras el usuario escribe) y en el servidor (al guardar) usando el mismo patrón, para que un número inválido no pueda colarse a través de la REST API.

Se aceptan estos formatos:

  • Internacional (E.164): +51999888777, +1 800 555 0100.
  • Local con separadores: 999-888-777, (01) 234-5678.
  • Mezcla razonable de espacios, puntos, guiones y paréntesis alrededor de los dígitos.

Restricciones:

  • Longitud total entre 7 y 20 caracteres (incluido el + opcional inicial).
  • Solo dígitos y los separadores visuales +, espacio, ., -, (, ).
  • El primer carácter útil debe ser un dígito o + (no se aceptan letras ni símbolos como & o #).

Si el valor no cumple las reglas, Jira muestra "The value is not a valid phone number." y no permite guardar.

Validación uniforme también en la REST API

Como la validación final se ejecuta en el servidor mediante una Jira expression, también se aplica cuando un issue es creado o editado mediante la REST API de Jira Cloud o por integraciones externas. Esto evita huecos donde se podrían introducir números inválidos saltándose la validación del navegador.

Captura desde la pantalla de creación​

En el diálogo de Create issue, el campo aparece como un input de texto simple. El usuario escribe el número y, al cabo de un segundo, el complemento valida el formato. Si el valor es inválido se muestra el mensaje de error debajo del campo y el botón Create del diálogo bloqueará el envío hasta corregirlo.

Campo Phone Number en el diálogo de creación de issue

Renderizado en la vista del issue​

Una vez guardado, el número aparece en la vista del issue acompañado por el icono mobile y se renderiza como un enlace tel: clicable. Al hacer clic, el dispositivo del usuario abre la aplicación de llamadas predeterminada (en macOS / Windows con una app de llamadas configurada, en móviles directamente el marcador).

Vista del campo Phone Number con enlace tel: en el issue

El enlace solo contiene dígitos (más un + opcional al inicio): los separadores visuales se eliminan al construir el href, para que el marcador no intente teclearlos. El número que el usuario ve mantiene los separadores que escribió.

Soporte de búsqueda y JQL​

El campo se registra con type: string, lo que habilita los operadores de cadena de igualdad exacta en JQL:

OperadorSoportadoEjemplo
=✅"Teléfono del solicitante" = "+51 999 888 777"
!=✅"Teléfono del solicitante" != "+51 000 000 000"
in / not in✅"Teléfono del solicitante" in ("+51 999 888 777", "+51 998 765 432")
is EMPTY / is not EMPTY✅"Teléfono del solicitante" is not EMPTY
~ / !~ (parcial)❌(no soportado por Forge para type: string)
Búsqueda parcial no disponible

Los operadores de coincidencia parcial (~, !~) no son soportados para campos personalizados Forge de tipo string. Esta es una limitación de la plataforma de Atlassian Forge, no del complemento. Para listas de teléfonos use el operador in (...).

Cuando el campo es opcional​

Si el campo no está marcado como obligatorio en su proyecto, puede dejarse en blanco sin que se produzca ningún error y el issue se guarda sin valor.