Componentes
Un componente es un paso reutilizable de automatización, como "Iniciar sesión", "Crear pedido" o "Consultar código postal". Se registra una vez y se usa en todas las automatizaciones que lo necesiten.
En Automatizaciones > Componente, los componentes aparecen en árbol, por sistema.
El componente y el código
El nombre del componente es el mismo en Proton y en el código de la automatización: el código encuentra el componente por el nombre, sin registrarlo en ningún lugar. En los proyectos modelo:
- Python: el archivo
automacao/componentes/<nombre>.py.FazerLoginse convierte enfazer_login.py. - Java: la clase
<Nombre>.javaen el paquete de los componentes.Fazer loginse convierte enFazerLogin.
Lo mismo pasa con los parámetros: el código lee cada entrada (in_) y devuelve cada salida (out_) por el nombre
registrado. Ver Parámetros.
El árbol
- Cada sistema muestra sus componentes. Al hacer clic en el sistema se muestran el resumen y Nuevo componente en este sistema.
- Un punto naranja marca el componente sin documentación.
- La búsqueda encuentra por el nombre del componente, por el nombre de un parámetro o por el sistema.
- El chip de componentes sin documentación filtra el árbol: útil para encontrar lo que falta documentar.
Crear un componente
- Usa Nuevo componente (o Nuevo componente en este sistema).
- Completa el Componente (el nombre, sin espacios, hasta 100 caracteres, único en la organización) y el Sistema.
- Si quieres, completa ya Qué hace, la documentación y los parámetros.
- Guardar.
Documentación
La documentación del componente entra en el documento de todas las automatizaciones que lo usan:
| Campo | Qué escribir |
|---|---|
| Qué hace | La acción que el componente ejecuta en el sistema. |
| Objetivo | Por qué existe el paso: la regla de negocio que atiende. |
| Resultado esperado | Lo que tiene que pasar para que el paso esté correcto. Cada dataset puede complementarlo. |
| Precondiciones | Lo que tiene que estar listo antes. |
| Observaciones | Detalles para quien mantiene el componente. |
Un componente cuenta como documentado cuando tiene el objetivo o el resultado esperado.
Sugerir con IA
En la edición de un componente, Sugerir con IA propone la documentación a partir del nombre, del sistema, de los parámetros y de dónde se usa el componente (el paso anterior y el siguiente en cada dataset). Tú eliges qué usar, lo revisas en el formulario y guardas: no se guarda nada sin Guardar.
Cada sugerencia consume créditos de IA, y el botón muestra cuántos. Requiere el módulo de IA en el plan.
Parámetros del componente
La sección Parámetros lista las entradas y salidas del componente.
- Agregar parámetros vincula parámetros que ya existen en la organización.
- Crear parámetro crea un parámetro nuevo (de entrada o de salida) y lo vincula al componente. Si ya existe un parámetro con el mismo nombre o uno parecido, Proton ofrece usar el existente.
- El lápiz cambia el nombre del parámetro o la descripción.
- La x quita el parámetro del componente (en la edición).
El vínculo vale después de Guardar el componente.
Análisis de impacto e historial
- Análisis de impacto muestra lo que afecta un cambio en el componente: los datasets que lo usan, las automatizaciones, los procesos de negocio (con la criticidad) y los grupos de automatización. También avisa cuando datasets afectados fallaron en la última ejecución.
- Historial muestra cada cambio: quién lo hizo, cuándo, por dónde (por la pantalla, por la API o por la IA) y los campos modificados.
Eliminar
Un componente solo se puede eliminar cuando ningún dataset lo usa. Usa el Análisis de impacto para encontrar dónde está y quítalo de esos datasets antes.
Permisos
Ver, crear, modificar y eliminar componentes tienen permisos propios en el perfil (Componente). Crear y renombrar parámetros requiere los permisos de Parámetro.