Ú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:
- Flujo bien comentado
- 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!).
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?
- Administrador principiante: los comentarios explican cómo funciona el flujo
- Adminoloper experimentado: los comentarios explican por qué funciona el flujo
- 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> |
|
| 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> |
|
| Componentes de la pantalla (por ejemplo, nombre, correo electrónico, teléfono, casilla de verificación, etc.) | <Descripción breve pero significativa> |
|
| 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 activado por registro |
|
|
| Flujo activado por programación | Programado: <Descripción breve pero significativa> |
|
| Flujo activado por eventos de plataforma | Activador de evento de plataforma: <Descripción breve pero significativa> |
|
| Flujo iniciado automáticamente |
|
|
| Flujo móvil de servicio de campo | Servicio de campo: <Descripción breve pero significativa> |
|
| Flujo del programador de Salesforce | Programador de Salesforce: <Descripción breve pero significativa> |
|
| Flujo omnicanal | Omnicanal: <Descripción breve pero significativa> |
|
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/
