Cómo referenciar campos de un pipeline en un formulario web

Referenciar campos personalizados de un pipeline en un formulario web permite recopilar información específica directamente en el flujo de solicitudes. A continuación, se explica cómo crear y asociar estos campos a tu formulario.

Paso 1: Accediendo al pipeline y abriendo la configuración de campos

1. En el menú lateral izquierdo, haz clic en “Pipelines” para abrir la lista de pipelines.
2. Selecciona el pipeline donde deseas agregar el campo personalizado.
3. Haz clic en “Configuraciones del Módulo” representado por el ícono “(...)” en la esquina superior derecha de la pantalla.
4. En la ventana modal, haz clic en la pestaña “Campos”.

Paso 2: Creando un campo personalizado

1. Haz clic en “Agregar campo personalizado”.
2. En el modal de creación, completa la información:

• Label: nombre/etiqueta del campo (ej.: Categoría).
• Tipo: selecciona el tipo de dato (Texto, Número, Fecha, Lista desplegable, etc.).
• Layout: “Único” o “Duplo” para definir el ancho.
• Placeholder (opcional): texto de ejemplo dentro del campo.
• Máscara (opcional): formato para autocompletar.
• ¿Es obligatorio este campo? (opcional): actívalo si es obligatorio.
• ¿El campo es de solo lectura? (opcional): actívalo si es solo lectura.

    1. (Opcional) En la pestaña “Visibilidad”, configura reglas para definir cuándo se mostrará el campo.     2. Haz clic en “Crear Campo” para finalizar.

Paso 3: Asociando el campo personalizado al formulario web

1. Accede a “Configuraciones > Formularios Web” en el menú lateral.
2. Localiza el formulario deseado y haz clic sobre él.
3. En la ventana modal, haz clic en la pestaña “Campos”.
4. Haz clic en “Agregar campo personalizado” y selecciona “Asociar con el Campo del Pipeline”.
5. Ajusta el orden de los campos arrastrándolos a la posición deseada. Los cambios se guardan automáticamente.

Paso 4: Publicando y probando el formulario

1. En la lista de Formularios Web, haz clic en el formulario y luego en “Abrir” para visualizarlo en una nueva pestaña.
2. Copia la URL y ábrela en modo incógnito para probar.
3. Verifica que el campo personalizado aparece y funciona según lo configurado (opciones correctas, placeholder, obligatoriedad).
4. Completa y envía el formulario.
5. En octapipe, confirma que el card creado en el pipeline contiene el valor informado en el campo personalizado.

Buenas prácticas:

• Estandariza nombres de campos para facilitar el mantenimiento.
• Prueba en modo incógnito para validar visibilidad.
• Revisa reglas de visibilidad para asegurar coherencia.
• Documenta cada campo personalizado con su propósito y reglas.
• Evita duplicidad verificando si el campo ya existe.
• Actualiza flujos relacionados al modificar o eliminar campos.

Conclusión:

Has aprendido cómo crear un campo personalizado en un pipeline y referenciarlo en un formulario web, asegurando que la información sea capturada e integrada al flujo de trabajo. Si tienes alguna duda, contacta a nuestro equipo de soporte.