Convenciones de nomenclatura en Power Automate

Un Flow que se llama „Untitled“ o „Instant cloud flow-3“ parece al principio un pequeño detalle. Sin embargo, en cuanto en un inquilino existen más de un puñado de Flows y varias personas los construyen y mantienen, es precisamente ese nombre el que decide si alguien entiende en cinco minutos qué hace el Flow o se pasa media hora haciendo clic Trigger por Trigger. En NordFlux aplicamos convenciones de nomenclatura fijas en cada empleado digital que construimos para usted, porque son la medida de gobernanza más económica que existe: ninguna herramienta adicional, ninguna licencia, solo disciplina al crearlos.

Por eso Microsoft no trata las convenciones de nomenclatura como algo opcional, sino como parte fija de las Coding Guidelines oficiales de Power Automate y de las recomendaciones de gobernanza de Power Platform. Este artículo reúne las reglas más importantes para Flows, acciones, conexiones y entornos, derivadas directamente de la documentación de Microsoft, para que pueda fijarlas como guía de estilo en su equipo. Así mantiene en todo momento el control sobre cómo crecen sus automatizaciones, en lugar de tener que ordenarlas más tarde con esfuerzo.

¿Por qué una convención de nomenclatura es la base de la gobernanza?

Según Microsoft, un Center of Excellence para Power Platform se apoya en varios pilares, entre ellos la seguridad de los datos, los derechos de acceso y la supervisión. Uno de ellos es el desarrollo de soluciones, y ahí Microsoft menciona explícitamente los „estándares de codificación y las convenciones de nomenclatura para garantizar la legibilidad y el mantenimiento“ como tarea de la gobernanza. La razón es evidente: sin nombres uniformes no es posible generar informes de forma automatizada ni, en caso necesario, entender con rapidez qué Flow usa qué conexión o qué entorno está en producción. Las convenciones de nomenclatura no son, por tanto, una cuestión cosmética, sino la base sobre la que el control de acceso, la supervisión y los informes empiezan a funcionar.

¿Cómo debería nombrar Flows, Trigger y acciones?

Para los componentes dentro de un Flow, la documentación de Microsoft Usar una nomenclatura coherente para los componentes de un Flow ofrece cinco recomendaciones concretas:

• Nombres descriptivos en lugar de denominaciones genéricas. Un Trigger no debería llamarse „Trigger1“, sino por ejemplo „Recibir correo nuevo“, para que su finalidad quede clara de inmediato.
• CamelCase o guiones bajos para separar palabras. Acciones como „sendEmailNotification“ o „send_email_notification“ se leen de un vistazo, mientras que „sendemailnotification“ no.
• Prefijos para categorizar. Microsoft propone marcar los Trigger con „Trg_“, las acciones con „Act_“ y las variables con „Var_“, para que el rol de un componente se reconozca de inmediato.
• Coherencia en todos los Flows. Un equipo que aplica la misma convención en cada Flow no tiene que descifrar un estilo ajeno en cada nuevo Flow de un compañero.
• Documentación de la convención. Una guía de estilo, por ejemplo en una página compartida de SharePoint, hace que los nuevos miembros del equipo conozcan las reglas en lugar de deducirlas a partir de los Flows existentes.

De forma complementaria, Microsoft recomienda añadir comentarios a las acciones, sobre todo en Flows complejos o cuando varias personas trabajan en ellos. Un nombre dice qué hace una acción; un comentario dice por qué se construyó así.

¿Qué diferencia a las conexiones de las referencias de conexión en la nomenclatura?

En el caso de las conexiones, la cuestión de los nombres se vuelve rápidamente confusa, porque Power Automate distingue dos conceptos diferentes. Según Ventajas del uso de Cloud Flows compatibles con soluciones, las conexiones son configuraciones específicas de cada usuario con detalles de autenticación que, fuera de las soluciones, se insertan directamente en las acciones. Si cambia una conexión, cada acción que la utiliza debe actualizarse por separado. Las referencias de conexión, en cambio, son un puntero a una conexión y se utilizan en los Cloud Flows compatibles con soluciones. Separan el diseño del Flow del inicio de sesión concreto y pueden intercambiarse entre los entornos de desarrollo, prueba y producción sin que tenga que tocar cada acción.

Para la convención de nomenclatura, esto significa: una referencia de conexión debería llevar en el nombre el servicio y su finalidad de uso, por ejemplo „conref_sharepoint_freigabeliste“, en lugar de confiar en la propuesta genérica que el diseñador de Flows asigna automáticamente. Así, al mover una solución entre entornos, reconoce de inmediato qué referencia se dirige a qué servicio externo, sin tener que abrir cada acción por separado.

¿Cómo se establece una convención de nomenclatura para los entornos?

También por encima de los Flows individuales hacen falta reglas fijas. Las recomendaciones de estrategia de entornos de Microsoft proponen un patrón de cuatro elementos: fase del ciclo de vida, región, unidad de negocio y finalidad, por ejemplo „Prod-US-Finance-Payroll“. Como alternativa, en organizaciones más pequeñas suele bastar con un esquema más sencillo como „Contoso Dev“, „Contoso Test“ y „Contoso Prod“, siempre que separe de forma coherente qué entorno sirve a qué finalidad. Según Microsoft, también es importante no incluir información confidencial en los nombres de los entornos, ya que son visibles para cualquiera con acceso al Admin Center, y mantener los nombres lo bastante cortos para que sigan siendo manejables incluso tras años de crecimiento.

¿Cómo aplica una convención de nomenclatura de forma coherente en el equipo?

Una convención que solo existe sobre el papel se diluye en la práctica. Por eso Microsoft recomienda documentar las reglas en una guía de estilo y compartirlas con la comunidad de creadores a través de un punto de acceso común, como una página de SharePoint, en lugar de dejarlas en la cabeza de cada persona. Para organizaciones más grandes existe además el Power CAT Toolkit, que da soporte a las revisiones de código y detecta automáticamente cuándo los Flows se desvían de las mejores prácticas documentadas, incluidas las convenciones de nomenclatura. Así se mantiene el control sobre unos paisajes de Flows en crecimiento incluso cuando cada vez más áreas especializadas construyen sus propias automatizaciones.

Si quiere establecer una convención de nomenclatura para su empresa, pero no desea empezar desde cero, NordFlux con Power Automate le ayuda a definir reglas de gobernanza e incorporarlas a los Flows existentes, sin que se interrumpan los procesos en marcha.

Preguntas frecuentes

¿Tengo que usar realmente prefijos como „Trg_“ o „Act_“ para cada componente?

No. Microsoft menciona los prefijos como una posible opción para categorizar, no como una obligación. Lo decisivo es que dentro de su equipo se pongan de acuerdo en un esquema y lo apliquen de forma coherente, ya sea con prefijos, CamelCase o guiones bajos.

¿Dónde conviene documentar nuestra convención de nomenclatura?

Microsoft recomienda un lugar central, accesible para todos los creadores, por ejemplo una página de SharePoint como hub de Power Platform para su comunidad de creadores. Importa menos la herramienta concreta que el hecho de que cada persona nueva encuentre las reglas antes de crear su primer Flow propio.

¿Se aplica la misma convención de nomenclatura también a las referencias de conexión en las soluciones?

Sí. Aunque las referencias de conexión funcionan técnicamente de forma distinta a las conexiones simples, deberían seguir las mismas reglas de nombres descriptivos. Un nombre que indique el servicio vinculado y la finalidad de uso ayuda especialmente al mover soluciones entre los entornos de desarrollo, prueba y producción.

¿Cómo se relacionan las convenciones de nomenclatura y la estrategia de entornos?

Ambos temas se entrelazan: una convención de nomenclatura clara para los entornos, como „Prod-US-Finance-Payroll“, muestra de inmediato qué Flows y conexiones pueden ir a parar a qué entorno. Sin esa claridad, ni siquiera la mejor nomenclatura de Flows puede integrarse de forma útil en una estructura de gobernanza más amplia.

¿Merece la pena una convención de nomenclatura incluso con pocos Flows?

Sí. Precisamente porque el número de Flows se multiplica en la mayoría de las organizaciones más rápido de lo previsto, una convención introducida pronto resulta rentable. Renombrar después cientos de Flows existentes supone mucho más trabajo que aplicar de forma coherente una regla sencilla desde el principio.