Campo Personalizado Moneda (Currency)

El campo personalizado Currency Field permite almacenar un importe monetario por work item y renderizarlo con el símbolo de moneda, la posición del símbolo (prefijo o sufijo) y la cantidad de decimales que el administrador defina por contexto.

Está pensado para cotizaciones, presupuestos, ingresos esperados, costos asociados a una incidencia, montos de oportunidad comercial y, en general, cualquier KPI económico que conviene ver con su símbolo correcto sin sacrificar la capacidad de filtrar por JQL como un número.

Crear el campo Currency

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

2. Seleccione Issues.

3. En la barra lateral izquierda, en 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 Currency Field. Haga clic en Next.

   💡 Lo reconocerá por su descripción: "Stores a monetary amount and renders it with a configurable symbol, position and decimals per context."

   

6. Nombre y descripción:

   • Introduzca un Name (Nombre) para el campo (por ejemplo, "Monto cotizado", "Costo estimado").
   • Añada una Description opcional.

7. Haga clic en Create.

8. Asociar a pantallas: Marque las pantallas correspondientes y haga clic en Update.

A partir de este momento el campo está disponible. No obstante, los valores aún se mostrarán como un número plano: hay que configurar el símbolo, la posición y los decimales en cada contexto del campo (siguiente apartado).

Valor sin configuración de contexto

Mientras un contexto del campo no tenga configuración guardada, los valores se muestran sin símbolo, con el formato numérico del locale del usuario (ej. 1,500.00). Esto evita mostrar un símbolo que no corresponda al contexto del negocio hasta que el administrador lo defina.

Configurar la visualización por contexto

La configuración del campo Currency está siempre asociada al contexto del campo. Esto significa que puede definir monedas distintas por proyecto o por tipo de issue, según los contextos que haya creado.

Modelo de configuración

Cada contexto requiere tres valores:

• Currency symbol — Texto libre para el símbolo. Ejemplos: S/, $, €, USD, BRL.
• Symbol position — Dónde se imprime el símbolo respecto al número:
  • Prefix → S/ 1,500.00
  • Suffix → 1,500.00 S/
• Decimal places — Cantidad de decimales: 0, 2 o 4.

Pasos para configurar la moneda

1. Vaya a Configuración → Issues → Custom fields.

2. Localice el campo Currency que creó y haga clic en el menú de acciones (⋯) → Contexts and default value.

3. En la página de contextos del campo, abra el contexto que quiere configurar.

4. Dentro del contexto verá una sección aportada por Admin Essentials llamada Currency display.

5. Complete el formulario:

   • Currency symbol: ej. S/, $, €.
   • Symbol position: Prefix o Suffix.
   • Decimal places: 0, 2 o 4.

6. Haga clic en Save.

   

Tras guardar, los issues asociados a ese contexto comenzarán a mostrar el valor formateado con el símbolo, posición y decimales elegidos.

Ejemplos de configuración

Contexto	Symbol	Position	Decimales	Resultado para 1500
Proyecto PER	S/	Prefix	2	S/ 1,500.00
Proyecto USA	$	Prefix	2	$ 1,500.00
Proyecto EUR	€	Suffix	2	1,500.00 €
Proyecto CRYPTO	BTC	Suffix	4	1,500.0000 BTC

Un mismo campo, varios contextos

Si reutiliza el mismo campo Currency en varios proyectos con monedas distintas, basta con crear un contexto por proyecto y guardar la configuración correspondiente. JQL sigue operando sobre el valor numérico almacenado, no sobre la cadena formateada.

Validación del valor en captura

Cuando un usuario introduce un valor en el campo, Jira valida en el servidor (mediante Jira expression) que sea un número finito. Las posibilidades son:

• Vacío → válido (el campo es opcional cuando no se marca como obligatorio).
• Número entero o decimal → válido.
• Texto que no es número → bloquea el guardado con el mensaje "Please enter a valid number."

Captura desde la pantalla de creación

En el diálogo Create issue, el campo aparece como un input numérico. El usuario escribe el valor sin necesidad de teclear el símbolo: el formateo se aplica al renderizar la vista del issue, no en el momento de la captura.

Renderizado en la vista del issue

En la vista del issue, el valor se muestra formateado según la configuración del contexto activo (símbolo, posición, decimales). Internamente el valor sigue siendo un número, por lo que los reportes y las consultas JQL siguen funcionando como con cualquier campo numérico de Jira.

Soporte de búsqueda y JQL

El campo se registra con type: number, lo que habilita los operadores numéricos estándar de JQL:

Operador	Soportado	Ejemplo
= / !=	✅	"Monto cotizado" = 1500
< / <= / > / >=	✅	"Monto cotizado" >= 10000
is EMPTY / is not EMPTY	✅	"Monto cotizado" is not EMPTY
in / not in	✅	"Monto cotizado" in (1000, 5000, 10000)

JQL trabaja sobre el valor, no sobre el símbolo

Las consultas JQL operan sobre el valor numérico almacenado, sin importar cómo se vea en pantalla. Por ejemplo, "Monto cotizado" >= 1000 devuelve los issues cuyo valor sea ≥ 1000 aunque uno se muestre como S/ 1,000.00 y otro como € 1,000.00 por estar en contextos distintos.