nxar.Aprender
Steppers: procesos guiados paso a paso0 de 7 capítulos
  1. 1Qué es un Stepper
  2. 2Tu primer Stepper
  3. 3Campos, validaciones y valores por default
  4. 4Guardar lo que se completa
  5. 5Ramas y bloques condicionales
  6. 6Activarlo y lanzarlo desde la cuenta
  7. 7Probar y ver quién lo corrió

Casos de uso

  1. ·Registrar un reclamo desde la cuenta
  2. ·Calificar una oportunidad
  3. ·Checklist de onboarding que deja tareas
Volver al recorrido
Capítulo 4 de 7 · 14 min

Guardar lo que se completa

Entre pantalla y pantalla, nodos que actualizan la cuenta y crean el contacto con las respuestas. Qué es un tramo, por qué se guarda entero y cómo leer el proceso como una lista.

Una pantalla junta respuestas; los que guardan son los nodos de siempre, los mismos de las automations. En este capítulo el Stepper pasa a tener tres pantallas y dos nodos que escriben:

  1. Datos de la empresa → Actualizar la cuenta
  2. Contacto principal → Crear el contacto
  3. Listo

Actualizá la cuenta con las respuestas

En la paleta, grupo Datos, arrastrá Actualizar registro debajo de Datos de la empresa. Si no quedó conectado solo, conectalo: pasá el mouse por Datos de la empresa y arrastrá desde el punto de abajo hasta el punto de arriba del nodo nuevo.

En el inspector:

  • Nombre del nodo: Actualizar la cuenta.
  • Registro a actualizar: Registro del trigger. Es la cuenta desde la que se lanzó el Stepper.
  • Campos a actualizar: con el botón + agregá dos filas.
CampoValor
phone{{empresa.telefono}}
industry{{empresa.industria}}

En Campo van los API names de los campos de Account; en Valor, las respuestas de la pantalla. Al tipear {{ se abre la lista de lo disponible, con las respuestas ya agrupadas (empresa.telefono, empresa.industria).

El nodo que escribe en la cuenta lo que se contestó en la primera pantalla.
Builder con el nodo Actualizar la cuenta seleccionado: Registro a actualizar en Registro del trigger y Campos a actualizar phone y industry con valores empresa.telefono y empresa.industria

El nodo que escribe en la cuenta lo que se contestó en la primera pantalla.

Armá la pantalla del contacto

Arrastrá otra Pantalla debajo de Actualizar la cuenta y conectala. Nombre del nodo: Contacto principal. Abrí el diseñador:

  • En la fila Pantalla: Agrupar respuestas en contacto.
  • Título: ¿Con quién hablamos?.
  • Tres Input de tipo Texto: Nombre (Requerido), Email (Requerido) y Cargo, con Placeholder Gerente de compras. Escribe en queda en contacto.nombre, contacto.email y contacto.cargo.

Guardar pantalla.

Creá el contacto

Arrastrá Crear registro debajo de Contacto principal y conectalo. En el inspector:

  • Nombre del nodo: Crear el contacto.
  • Entidad: Contact.
  • Campos:
CampoValor
name{{contacto.nombre}}
email{{contacto.email}}
title{{contacto.cargo}}
account{{record.id}}
  • Guardar como variable: nuevo_contacto. Así los pasos de abajo pueden usar el contacto recién creado.

{{record.id}} es la cuenta desde la que se lanzó el Stepper: el contacto queda colgado de ella.

Crear el contacto con las respuestas de la segunda pantalla, colgado de la cuenta.
Builder con el nodo Crear el contacto seleccionado: Entidad Contact, campos name, email, title y account con sus valores, y Guardar como variable nuevo_contacto; en el canvas, la cadena completa hasta la pantalla Listo

Crear el contacto con las respuestas de la segunda pantalla, colgado de la cuenta.

Cerrá con una pantalla de resumen

Arrastrá una tercera Pantalla debajo de Crear el contacto y conectala. Nombre del nodo: Listo. En el diseñador:

  • En la fila Pantalla: Texto del botón Terminar y destildá Ofrecer “Atrás”.
  • Un bloque Aviso: Tono Éxito, Título (opcional) {{record.name}} quedó dado de alta, y en Contenido: Se actualizaron los datos de la cuenta y se creó el contacto {{contacto.nombre}}.

Guardar pantalla.

Escribí qué está pasando

Mientras corre un tramo, la persona ve un spinner. Abrí otra vez Datos de la empresa, seleccioná la fila Pantalla y en Mientras procesa escribí Actualizando la cuenta…. En Contacto principal, Creando el contacto…. Es el texto que acompaña al spinner cuando el tramo tarda.

Hacé clic en Guardar en la barra del builder.

Al volver a abrir una pantalla, el campo Mientras procesa puede aparecer vacío aunque el texto esté guardado. Si no lo tocás, se conserva: no hace falta volver a escribirlo.

Un tramo se guarda entero

Todo lo que corre entre dos pantallas es un tramo, y se guarda junto: si Crear el contacto fallara (por ejemplo, porque falta un campo obligatorio de Contact), no queda nada a medias. La persona vuelve a Contacto principal, con lo que había escrito y el error a la vista, corrige y sigue.

Lo que sí quedó guardado es lo de los tramos anteriores: si falla el contacto, la cuenta ya está actualizada desde el tramo uno. Por eso, después de un tramo que escribió algo, el Stepper no ofrece Atrás: volver implicaría deshacer lo guardado, y eso no se hace. La opción Ofrecer “Atrás” de cada pantalla solo vale cuando el tramo anterior no escribió nada.

Lo que se crea queda a nombre de quien corre el Stepper, y pasa por las mismas reglas que si lo cargara a mano: valores por default, validaciones y las automations de la entidad. Si tenés una automation que crea una tarea al crear un contacto, también se dispara acá.

El proceso como una lista

El grafo sirve para armar; para leer el recorrido, arriba del builder está el switch Grafo / Pantallas. En Pantallas ves las pantallas en orden, con lo que tiene cada una y cuántos pasos corren en el medio (“1 paso en el medio”).

El mismo Stepper leído como lista: tres pantallas y un paso entre cada una.
Vista Pantallas del builder: Las pantallas, en orden; 1 Datos de la empresa 2 campos, 1 paso en el medio, 2 Contacto principal 3 campos, 1 paso en el medio, 3 Listo 1 bloque, y el botón Agregar pantalla

El mismo Stepper leído como lista: tres pantallas y un paso entre cada una.

Desde acá también se reordena: arrastrá una pantalla a otro lugar y se lleva con ella el trabajo que corre justo después (mover Contacto principal mueve también Crear el contacto). Agregar pantalla suma una al final.

Cómo saber que te salió

  • En Pantallas ves Datos de la empresa, Contacto principal y Listo, numeradas, con “1 paso en el medio” entre cada una.
  • Hacé clic en Actualizar la cuenta en el grafo: tiene phone e industry. En Crear el contacto: Entidad Contact y cuatro campos.
  • Lo vas a probar de verdad en el capítulo de activarlo y lanzarlo.

¿Llegaste al resultado de arriba?