DocumentaciónAyuda

Diseñar el formulario de un ítem

Arma las preguntas que el solicitante responde al pedir un ítem, haz que algunas aparezcan solo cuando aplican y pruébalo antes de publicarlo.

En esta página

El formulario de un ítem son las preguntas que la mesa necesita para atender el pedido a la primera: qué equipo, para quién, desde cuándo. Lo armas campo a campo y lo pruebas en la Vista previa tal como lo verá el solicitante.

Antes de empezar

  • Necesitas el nivel Administrar en Catálogo de servicios para cambiar y guardar el formulario. Con el nivel Ver puedes abrirlo y probarlo, pero no guardarlo.

  • El ítem puede ser nuevo o existente. Ver Crear un ítem del catálogo.

Agregar un campo

  1. Entra a Catálogo, pestaña Ítems, y abre el ítem (o presiona Nuevo ítem).

  2. En la parte Formulario, elige el tipo en la lista junto al botón Campo.

  3. Presiona Campo. El campo se agrega al final, ya abierto, con el nombre del tipo como etiqueta.

  4. Completa su configuración (ver la tabla de abajo).

  5. Repite para cada pregunta. Un formulario admite hasta 50 campos.

  6. Presiona Guardar arriba a la derecha.

Cada campo aparece como una fila con su etiqueta, su tipo y, si corresponde, obligatorio. Presiona la etiqueta para abrir o cerrar su configuración. Con ↑ y ↓ cambias el orden en que se preguntan y con el ícono de papelera quitas el campo.

Tipos de campo

Tipo

Qué pide al solicitante

Configuración propia

Texto corto

Una línea de texto, como un número de serie o un nombre de carpeta

Ayuda, Largo máximo

Texto largo

Un texto de varias líneas, como una justificación

Ayuda, Largo máximo

Número

Una cantidad, como el número de licencias

Ayuda, Valor máximo

Fecha

Un día del calendario, como la fecha de ingreso

Ayuda

Correo

Una dirección de correo válida

Ayuda

Lista desplegable

Elegir una opción de una lista

Opciones

Opción única

Elegir una opción, mostrando todas a la vista

Opciones

Selección múltiple

Marcar una o varias opciones

Opciones

Casilla

Marcar sí o no, como «Acepto las condiciones de uso»

—

Persona

Indicar a alguien de la empresa, como quien recibirá el equipo

Personas

Adjuntos

Subir archivos, como una cotización o un formulario firmado

Máximo de archivos

Configuración de cada campo

Todos los campos tienen:

  • Etiqueta: la pregunta que lee el solicitante, hasta 120 caracteres. Obligatoria.

  • Id: el nombre interno del campo. Se usa en Mostrar si y en los flujos para leer la respuesta. Al agregar el campo se crea a partir del nombre del tipo (por ejemplo, texto_corto) y no cambia cuando editas la etiqueta: cámbialo por uno que se entienda, como tipo, si lo usarás en condiciones. Usa minúsculas, empieza con una letra y usa solo letras, números y _ (hasta 40 caracteres), sin repetir el de otro campo.

  • Tipo: puedes cambiarlo después. Se conservan la etiqueta, el id y si es obligatorio; entre Lista desplegable, Opción única y Selección múltiple también se conservan las opciones.

  • Obligatorio: el solicitante no puede enviar el pedido sin responderlo. En el portal se marca con un asterisco (*). En una Casilla obligatoria, el solicitante debe marcarla.

  • Mostrar si (opcional): una condición para que el campo aparezca solo en algunos casos. Ver Mostrar un campo solo cuando aplica.

Y según el tipo:

  • Ayuda: un texto breve bajo el campo, hasta 200 caracteres. Disponible en Texto corto, Texto largo, Número, Fecha y Correo.

  • Largo máximo: cuántos caracteres acepta. Si lo dejas vacío, el límite es 500 en Texto corto y 5.000 en Texto largo.

  • Valor máximo: el número más alto que acepta un Número.

  • Opciones (una por línea: valor | texto): cada línea es una opción. A la izquierda de la barra va el valor (lo que guarda Elion ITSM y lo que usas en las condiciones) y a la derecha el texto que ve el solicitante. Si escribes solo el texto, el valor se crea solo. Hasta 100 opciones.

  • Personas: Toda la empresa permite elegir a cualquier persona activa; Su departamento, solo a alguien del mismo departamento de quien pide.

  • Máximo de archivos: de 1 a 10 por campo. Viene en 3.

Un ejemplo de Opciones para un campo «Tipo de equipo»:

notebook | Notebook
pc | Computador de escritorio
monitor | Monitor adicional

Elige valores cortos y estables (notebook, pc) y cambia libremente el texto. Si cambias un valor, las condiciones y los flujos que lo usan dejan de calzar.

Mostrar un campo solo cuando aplica

Mostrar si (opcional) hace que un campo aparezca solo si se cumple una condición sobre las otras respuestas. Por ejemplo, preguntar «¿Necesitas docking?» solo cuando el tipo de equipo es notebook.

La condición no es código: usa un conjunto cerrado de operadores y Elion ITSM la revisa mientras la escribes:

Para

Escribe

Leer una respuesta

form. seguido del Id del campo: form.tipo

Comparar

== (igual), != (distinto), <, <=, >, >=

Ver si está en una lista

in: form.tipo in ['notebook', 'pc']

Ver si una selección múltiple incluye una opción

contains: form.software contains 'office'

Combinar

&& (y), `

Valores

textos entre comillas simples ('notebook'), números (500000), true, false y null (vacío)

Ejemplos:

form.tipo == 'notebook'
form.tipo in ['notebook', 'pc'] && form.reemplazo == true
form.cantidad > 5
form.fecha_ingreso >= '2026-11-01'

Reglas para que funcione:

  • En las listas y opciones se compara con el valor, no con el texto: form.tipo == 'notebook', no 'Notebook'.

  • Un Número se compara con números sin comillas (form.cantidad > 5); un texto, con comillas. Un número entre comillas no es igual a un número.

  • Una Casilla marcada vale true: form.acepta == true.

  • Las fechas se comparan como texto con el formato AAAA-MM-DD.

  • Solo puede usar otros campos de este formulario (no el mismo campo), en hasta 500 caracteres.

  • Si la condición no se cumple, el campo no aparece y su respuesta no se pide, aunque sea Obligatorio.

  • Un campo oculto cuenta como vacío para las condiciones de los demás. Si se oculta «Tipo de equipo», lo que dependía de él también se oculta.

Si la condición tiene un error, lo ves en rojo bajo el campo, por ejemplo Texto sin cerrar. o usa form.modelo, que no es un campo de este formulario.

Si cambias el Id de un campo, las condiciones de otros campos que lo usaban quedan con error y no puedes guardar hasta corregirlas. Los flujos que leen esa respuesta también dejan de encontrarla.

Probar el formulario

La parte Vista previa muestra el formulario tal como lo verá el solicitante, con la Descripción corta arriba. Se actualiza mientras editas y aplica las condiciones de Mostrar si: responde las preguntas y verás cómo aparecen y desaparecen los campos.

  1. Responde en la Vista previa como lo haría un solicitante.

  2. Presiona Validar. Elion ITSM revisa tus respuestas y marca en rojo los errores de cada campo, como Obligatorio., Correo no válido. o Máximo 5. Si todo está bien, verás Las respuestas de prueba son válidas.

  3. Si el ítem ya está guardado, presiona Probar en el servidor. Es la misma revisión que se hace cuando alguien envía el pedido de verdad. Si está todo bien, verás El servidor aceptó las respuestas de prueba.

Probar en el servidor revisa las respuestas contra el formulario guardado. Si cambiaste campos, presiona Guardar antes de probar. En un ítem nuevo el botón no aparece hasta que lo guardas.

En la vista previa, Persona y Adjuntos son simulados: escribes un texto en vez de buscar a la persona o subir un archivo. Por eso, al probar en el servidor, déjalos vacíos (si son obligatorios, el servidor los marcará con Requerido; es lo esperable). Para probarlos de verdad, pide el ítem desde el portal con un usuario de prueba. Ver Pedir algo del catálogo.

Un campo Persona con Su departamento se prueba con tu propio departamento, como si tú fueras quien pide.

Qué pasa después

  • Cada vez que guardas un cambio en el formulario, sube la Versión del formulario que ves bajo el nombre del ítem. Los cambios en los otros datos del ítem no cambian la versión.

  • Los pedidos nuevos usan la versión vigente. Cada solicitud ya creada guarda la versión con que se respondió: en la ficha del ticket, el bloque Pedido del catálogo muestra las preguntas y respuestas de esa versión, aunque después hayas cambiado el formulario.

  • En el ticket, la descripción lleva cada pregunta con su respuesta (las opciones con su texto, las casillas como Sí o No).

Si algo no funciona

Bajo el formulario aparece un recuadro amarillo con lo que impide guardar. Mientras esté, al presionar Guardar verás Corrige el formulario antes de guardar. Los avisos más comunes:

  • falta la etiqueta.: escribe la Etiqueta del campo.

  • el id va en minúsculas, empieza con letra y usa solo letras, números y _. o el id «…» está repetido.: corrige el Id.

  • agrega al menos una opción., hay opciones con el mismo valor. o cada opción necesita valor y texto.: revisa las Opciones.

  • entre 1 y 10 archivos. o el máximo debe ser positivo.: corrige Máximo de archivos, Largo máximo o Valor máximo.

  • «Mostrar si» de «…»: seguido del problema: corrige la condición de ese campo.

Al probar en el servidor, el mensaje Campo desconocido bajo un campo significa que ese campo todavía no está guardado: presiona Guardar y vuelve a probar.

Relacionado

Buscar en Elion ITSM

Escribe al menos 2 letras para buscar en Elion ITSM.

↑↓ moverse · Enter abrir · Esc cerrar