Última actualización el 9 de noviembre de 2021 por Rakesh Gupta

Como programador declarativo, siempre desea crear flujos limpios donde los nombres deben ser apropiados para que a cualquier otro programador le resulte más fácil leer el flujo y comprenderlo.

Ahora, esto puede parecerle sin sentido, pero piense en una situación en la que está investigando un flujo para identificar por qué está fallando en tiempo de ejecución y no puede leerlo, ya que no tiene convenciones de nomenclatura ni documentación. .

La legibilidad del flujo es muy importante. Indica que se dedica menos tiempo a averiguar qué hace el flujo.

Hay dos elementos relacionados con Salesforce Flow que son muy importantes en lo que respecta a la legibilidad y son:

  1. Flujo bien comentado
  2. Buenas convenciones de nomenclatura

Un flujo bien comentado

Tomemos un escenario del mundo real. Mientras conduce, es posible que haya visto muchas señales en la carretera para ayudar a los conductores, como la señal, el límite de velocidad, los hitos o la dirección de la ruta. ¿Cuándo necesitamos / leemos las señales? ¡Cuando las cosas van mal! Mientras estemos avanzando felices, ¿quién tiene tiempo para leer las señales?

Se aplica una lógica similar en el desarrollo del flujo y en cualquier programación. Mientras los flujos o los códigos funcionen, ¿quién lee los comentarios? Los desafíos comienzan cuando: (1) el flujo deja de funcionar; (2) los clientes quieren modificaciones a los flujos existentes; (3), el flujo lo construye otra persona que no sea usted; o (3) ¡peor! – Podría ser tu antiguo yo en desarrollo (¡oouch!).

Fuente: Internet

Si crea flujos para que los consuman otros programadores en primer lugar y, en segundo lugar, el motor de tiempo de ejecución de flujo, es posible que se reduzca considerablemente la necesidad de comentarios adicionales. ¿Cómo comenta un administrador de Salesforce sobre su flujo?

  1. Administrador principiante: los comentarios explican cómo funciona el flujo
  2. Adminoloper experimentado: los comentarios explican por qué funciona el flujo
  3. Desarrollador incondicional: los comentarios explican por qué no se eligieron otras implementaciones

La siguiente captura de pantalla le dará una idea de qué escribir cuando se trata de agregar comentarios en sus flujos.

Buenas convenciones de nomenclatura

En el flujo, es una buena práctica nombrar variables, elementos de datos, lógicas y elementos de pantalla que describen lo que realmente se supone que deben hacer en lugar de nombrarlos al azar.

A continuación, se muestran algunas sugerencias de convenciones de nomenclatura para los elementos de Salesforce Flow:

Convenciones de nomenclatura de recursos

Tipo de recurso Tipo de datos Convenio de denominación

Ejemplos de

Variable Booleano varB_ <Descripción breve> varB_ReadyToInvest
Divisa varB_ <Descripción breve> varC_AnnualIncome
Fecha varD_ <Descripción breve> varD_DateOfBirth
Fecha y hora varDT_ <Descripción breve> varDT_MeetingTime
Lista de selección múltiple varMSP_ <Descripción breve> varMSP_Locations
Número varN_ <Descripción breve> varB_RecordCount
Lista de selección varP_ <Descripción breve> varP_Status
Variable de colección de registros varR_ <Etiqueta de plural de objeto> varR_Leads
Variable de registro varR_ <Nombre de objeto> varR_Lead
Texto varT_Name varT_TravelDestination
Constante Constante con_Name con_PiValue
Fórmula Booleano forB_Name forB_ReadyToInvest
Divisa forC_Name forC_AnnualIncome
Fecha forD_Name forD_NextFollowupDate
Fecha y hora forDT_Name forDT_MeetingTime
Número forN_Name forB_RecordCount
Texto forT_Name forT_OpportunityName
Plantilla de texto textT_Name textT_EmailBody
Elección choice_Status choice_Open
Conjunto de opciones de registro recChoice_Name recChoice_OpenLeads
Conjunto de opciones de lista de selección picChoice_Name recChoice_StageName
Escenario stage_Name stage_PersonalDetails

Convenciones de nomenclatura de elementos de datos

Tipo de elemento Convenio de denominación

Ejemplos de

Crear registros Cree <Nombre de objeto> o

Crear <etiqueta de plural de objeto>

Crear contacto o

Crear contactos

Eliminar registros Eliminar <Nombre de objeto> o

Eliminar <etiqueta de plural de objeto>

Eliminar cliente potencial o

Eliminar clientes potenciales

Obtener registros Obtenga <Nombre de objeto> o

Eliminar <etiqueta de plural de objeto>

Obtener plomo o

Obtener prospectos

Actualizar registros Actualice <Nombre de objeto> o

Eliminar <etiqueta de plural de objeto>

Actualizar cotización o

Actualizar cotizaciones

Actualizar campo Actualizar <nombre de campo> al valor Actualizar clasificación a Caliente
Revertir registros Revertir registros Revertir registros

Convenciones de nomenclatura de elementos lógicos

Tipo de elemento

Convenio de denominación

Ejemplos de

Asignación: variable de registro Establecer campos de <Nombre de objeto> Establecer campos de cuenta
Asignación: una variable o campo Establecer <Nombre de campo> en valor Establecer etapa en cerrada ganada
Decisión <Pregunta> ¿Listo para cerrar el trato?
Resultado de la decisión <Respuesta>
  • Cerrar el trato
  • Mantener el trato abierto
Círculo Recorrer <Etiqueta de plural de objeto> Oportunidades en bucle
Ordenar colección Ordenar <Etiqueta de plural de objeto> Ordenar contactos

Convenciones de nomenclatura de elementos de interacción

Tipo de elemento

Convenio de denominación

Ejemplos de

Pantalla <Breve descripción>
  • Recopilar detalles de clientes potenciales
  • Recopilar detalles de la política
Componentes de la pantalla (por ejemplo, nombre, correo electrónico, teléfono, casilla de verificación, etc.) <Descripción breve pero significativa>
  • Componentes de la pantalla Recopilar detalles de clientes potenciales
    • CLD_Name
    • CLD_Email
    • CLD_Phone
    • CLD_Checkbox
  • Componentes de la pantalla Recopilar detalles de la política
    • CPD_Name
    • CPD_Email
    • CPD_Phone
    • CPD_Checkbox
Acción <Breve descripción> Enviar cuenta para aprobación
Subflujo <Breve descripción> Crear tarea
Analizar lista de selección de selección múltiple

Convenciones de nomenclatura de flujo

Tipo de flujo

Convenio de denominación

Ejemplo

Flujo de pantalla Flujo de pantalla: <Descripción breve pero significativa>
  • Flujo de pantalla: cumplimiento de pedidos
Flujo activado por registro
  • Activador de registro: <nombre de objeto> antes de guardar
  • Activador de registro: <nombre de objeto> después de guardar
  • Activador de registro: <nombre de objeto> antes de eliminar
  • Activador de registro: liderar antes de guardar
  • Activador de registro: plomo después de guardar
  • Activador de registro: plomo antes de eliminar
Flujo activado por programación Programado: <Descripción breve pero significativa>
  • Programado: enviar facturas mensuales
Flujo activado por eventos de plataforma Activador de evento de plataforma: <Descripción breve pero significativa>
  • Activador de evento de plataforma: actualización de la orden de compra en la cotización
Flujo iniciado automáticamente
  • Subflujo: <Descripción breve pero significativa>
  • Subflujo: controlador <nombre de objeto>
  • Subflujo: Agregar al espacio de trabajo de Slack
  • Subflujo: Responsable de gestión
Flujo móvil de servicio de campo Servicio de campo: <Descripción breve pero significativa>
  • Servicio de campo: Orden de trabajo completa
Flujo del programador de Salesforce Programador de Salesforce: <Descripción breve pero significativa>
  • Programador de Salesforce: Nueva cita saliente
Flujo omnicanal Omnicanal: <Descripción breve pero significativa>
  • Omnicanal: enrutar llamadas a agentes

Evaluación formativa:

¡Quiero saber de ti!

¿Qué aprendiste de esta publicación? ¿Cómo imagina aplicar este nuevo conocimiento en el mundo real?

Avísame twitteando en @automationchamp, o búscame en LinkedIn.

 Corrector de pruebas : - Frances Barrera

Esta es una traducción realizada por EGA Futura, y este es el link a la publicación original: https://automationchampion.com/2021/11/09/naming-conventions-for-salesforce-flow/

Entradas recomendadas