Steppers (procesos guiados)
Un Stepper guía a una persona por un proceso de varios pasos: le muestra pantallas, le pide datos y, entre pantalla y pantalla, hace el trabajo (crea registros, los actualiza, genera un PDF, manda un email). Sirve para todo lo que hoy vive en una checklist: el alta de un cliente, la carga completa de un caso, la emisión de un documento.
Automation vs. Stepper: una automation se dispara sola; un Stepper lo lanza una persona desde un registro y conversa con ella. Administrarlos requiere manage_steppers; correrlos, ninguno especial (lo que escribe pasa con los permisos de quien lo corre).
Crear un Stepper
- Configuración → Automatización → Procesos → Nueva → tipo Stepper.
- Nombre y entidad de contexto: desde qué registro se lanza. Sus datos quedan disponibles como
{{record.campo}}. - Se abre el mismo builder de las automations, con el nodo Pantalla en la paleta. Entre pantallas ponés los nodos de siempre (crear / actualizar registro, enviar email, condiciones…).
Un Stepper nace apagado y se guarda cuantas veces quieras a medio armar. Al activarlo se revisa que cierre: sin pantallas, con una pantalla vacía, con un campo que no guarda en ninguna variable o con un PDF sin template, no se puede activar y la ventana te dice exactamente qué falta. Otras cosas —un campo sin etiqueta, un nodo suelto que nunca corre, una variable que no existe— solo avisan y te dejan seguir con Activar igual.
Ver el proceso como una lista
Arriba, al lado de la entidad, hay un switch Grafo / Pantallas. La segunda vista muestra el mismo proceso como la lista numerada de pantallas que va a ver la persona, con cuántos campos pide cada una y qué trae (PDF, email, componente). Entre pantalla y pantalla dice cuántos pasos corren (”↓ 2 pasos”): es el trabajo que se hace al tocar Siguiente.
Desde ahí, sin volver al grafo: click en una pantalla para diseñarla, arrastrar para reordenarla, Agregar pantalla al final, y el menú ⋮ para duplicarla o eliminarla.
Reordenar mueve la pantalla junto con el trabajo que corre justo después — si no, ese trabajo quedaría colgado de la pantalla anterior.
Dos cosas que la lista no ordena, y lo dice:
- Las pantallas que cuelgan de una condición (o del camino de error de un paso) se listan aparte, sin número: solo se ven si la condición da. Para reordenar un proceso con condiciones, el grafo.
- Las pantallas sin conectar aparecen al final, marcadas: existen pero nunca corren.
Diseñar una pantalla
Doble clic en un nodo Pantalla abre el diseñador: bloques a la izquierda, la pantalla en el medio, propiedades a la derecha, Vista previa arriba.
Los bloques se arrastran desde la lista de la izquierda al lugar exacto donde los querés, y una vez puestos se reordenan arrastrándolos (las flechas ↑↓ siguen estando). La lista tiene buscador, y se puede plegar a una tira de iconos cuando necesitás más lugar. Cualquier nodo del flujo —no solo una pantalla— se duplica con el botón de copiar del panel derecho: la copia nace desconectada, para que la conectes vos.
| Bloque | Qué hace |
|---|---|
| Input | Pide un dato: texto, texto largo, número, fecha, checkbox, picklist (lista fija o los elementos de una lista del flujo) o buscar registro (elige uno de una entidad) |
| Texto | Una instrucción; acepta {{…}} |
| Detalle del registro | Campos del registro desde el que se lanzó, solo lectura |
| Vista de PDF | Renderiza un template PDF con lo juntado hasta acá, para revisarlo antes de seguir |
| Enviar email | Un composer con destinatario, asunto y cuerpo precargados (editables) y, si hay una vista de PDF en la pantalla, el PDF adjunto. Mandar es avanzar: esta pantalla no tiene “Siguiente” |
| Mapeo de campos | Le muestra a la persona las variables de un template (PDF o email) para que elija de dónde sale cada una (un campo, una respuesta anterior, un valor fijo), con una propuesta automática por nombre |
| Componente propio | Un Visual Component dentro de la pantalla, que puede escribir solo las variables que declarás |
Propiedades de la pantalla (fila Pantalla, arriba): Agrupar respuestas en (la “carpeta” de las respuestas: con grupo empresa, un input Industria se lee como {{empresa.industry}}; sin grupo, dos pantallas con un campo del mismo nombre se pisan), texto del botón y Ofrecer “Atrás”.
Propiedades de un input: label, escribe en (la variable), tipo, opciones, valor por defecto (acepta {{record.campo}}), placeholder, ayuda, requerido.
Un bloque con visibilidad condicional lleva un ojo 👁 en la lista y un borde punteado en la vista previa, con la regla en el tooltip. La vista previa los muestra igual —no puede saber si se van a ver, porque eso depende de lo que la persona conteste en el momento—, pero te avisa cuáles son.
Usar las respuestas
Todo lo que se completa queda disponible para los nodos que vienen después, con autocompletado: {{empresa.industry}}, {{contacto.nombre}}, el registro elegido en un buscar registro como relación.
Lanzarlo desde un registro
El Stepper se corre desde un botón del encabezado del registro: en el Page Builder de la Record Page, seleccioná el encabezado → Custom buttons → tipo Stepper → elegí el proceso. Lo ven quienes ven esa página.
Mientras corre
- Arriba de todo se ve en qué paso está (“Paso 2 de 5”) con una barra que se va pintando. Si el proceso tiene condiciones que abren caminos distintos, no hay un total que prometer: ahí muestra solo el paso (“Paso 3”). Un Stepper de una sola pantalla no muestra nada.
- Cada Siguiente (o Enviar) ejecuta el tramo de nodos hasta la próxima pantalla; la persona ve “Procesando…” mientras tanto. Los registros de ese tramo se guardan con las mismas reglas que siempre (qué pasa al guardar); si algo falla, el tramo no guarda nada y la pantalla muestra el error (qué campo, qué entidad).
- Atrás aparece solo cuando volver es seguro: si el tramo anterior ya creó un registro o mandó un email, no se ofrece. Al volver, lo completado sigue ahí.
- Salir no es un accidente: un click al costado de la ventana no la cierra, y la X o Escape preguntan antes.
- Si la persona cierra la ventana a mitad de camino, no se pierde: al volver a lanzarlo retoma donde quedó y con lo que estaba escribiendo en esa pantalla (se va guardando solo). Empezar de nuevo descarta las respuestas (lo ya creado no se deshace).
- Las respuestas nunca salen del servidor: lo que se tipea en una pantalla no se interpola en otras ni viaja al navegador más que para mostrarse.
Probarlo antes de publicarlo
En el builder del Stepper hay un botón Probar: lo corre ahí mismo, sin tener que publicarlo como botón de un registro. Elegís el registro de contexto y, si querés, los valores iniciales de las variables; a la derecha vas viendo qué hizo el motor en cada tramo, nodo por nodo, con el valor de cada variable.
Probar es correr. No es una simulación: se crean los registros, salen los emails y se llaman las integraciones, igual que le pasaría a un usuario. Es a propósito —así lo que probás es lo que va a pasar—, pero conviene usar un registro de prueba.
Además, ahora toda ejecución de un Stepper queda registrada: el historial de ejecuciones del builder muestra una entrada por tramo con el detalle de cada nodo. Si alguien reporta que “no hizo nada”, ahí está lo que pasó, sin tener que reproducirlo.
Quién lo corrió
El mismo botón de historial abre dos pestañas: Ejecuciones y Log del motor. La primera lista, de cada corrida, quién la hizo, sobre qué registro, en qué estado quedó (en curso, completada, falló, abandonada) y —si sigue esperando— en qué pantalla está parada. Las corridas hechas con el botón Probar llevan el chip Prueba, para no confundirlas con uso real.
Sirve para lo que antes no se podía contestar: si alguien quedó trabado a mitad del proceso, y dónde. Las ejecuciones se conservan 30 días.
Límites de hoy
- Se lanza desde el encabezado de un registro; todavía no desde el Home ni como pestaña propia.
- Un Stepper que hace un Loop reinicia su presupuesto de pasos en cada pantalla (no hay límite total de ejecución entre pantallas).