Files
twenty/packages/twenty-docs/l/ca/user-guide/workflows/workflow-troubleshooting.mdx
T
9bc5486d0d i18n - translations (#15803)
Created by Github action

---------

Co-authored-by: github-actions <github-actions@twenty.com>
2025-11-13 17:12:39 +01:00

132 lines
6.3 KiB
Plaintext

---
title: Solució de problemes en el flux de treball
info: Depura i optimitza els teus fluxos de treball amb tècniques de resolució de problemes i consells d'optimització del rendiment.
image: /images/user-guide/what-is-twenty/20.png
sectionInfo: Automatitza processos i integra amb eines externes
---
<Frame>
<img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
</Frame>
## Depuració amb Execucions de Flux de Treball
Utilitza la interfície **Execucions de Flux de Treball** per depurar problemes:
- Accedeix mitjançant el panell **Execucions** en l'editor de fluxos de treball
- Fes clic en execucions individuals per veure les dades d'entrada/sortida de cada pas
- Comprova l'estat d'execució, missatges d'error i flux de dades entre passos
## Problemes Comuns i Solucions
### Flux de Treball No Es Desencadena
**Problema**: El flux de treball no s'executa quan s'esperava.
**Solucions**:
- Verifica que el flux de treball estigui **Actiu** (no en mode Esborrany)
- Comprova que la configuració del desencadenador coincideixi amb la teva estructura de dades
- Per a desencadenadors de Registre, assegura't que l'objecte i els camps correctes estan seleccionats
- Per a desencadenadors de Webhook, verifica la URL i el format de dades esperat
- Per a desencadenadors Programats, revisa la configuració de temps
### Formularis No Accessibles
**Problema**: Les accions dels formularis són difícils de trobar o accedir en fluxos de treball automatitzats.
<Warning>
Els formularis estan actualment dissenyats només per a desencadenadors manuals. Per a fluxos de treball amb altres desencadenadors (Registre Creat, Actualitzat, etc.), els formularis només són accessibles mitjançant la interfície d'execució de fluxos de treball, cosa que no és l'experiència d'usuari esperada. Un centre de notificacions es llançarà al 2026 per suportar adequadament els formularis en fluxos de treball automatitzats.
</Warning>
**Solució Temporal**: Utilitza desencadenadors manuals quan es requereixin formularis o reestructura els fluxos de treball per evitar formularis en fluxos automatitzats.
### Alt Consum de Crèdit
**Problema**: Fluxos de treball que consumeixen més crèdits del que s'esperava.
**Causes Comuns i Solucions**:
- **Trucades API Ineficiens**: Agrupa trucades API quan sigui possible en lloc de sol·licituds individuals
- **Configuració de Desencadenador Manual Incorrecta**: Utilitza disponibilitat `Massiva` en lloc de `Individual` per processar múltiples registres en una execució de flux de treball
- **Falten Filtres**: Afegir lògica condicional per aturar fluxos de treball quan no es compleixen els criteris
- **Passos Innecessaris**: Elimina accions redundants i optimitza la lògica del flux de treball
- **En temps real vs. Programat**: Utilitza fluxos de treball programats per a processos no urgents
### Límits Concurrents de Flux de Treball
**Problema**: Superant el límit de 100 fluxos de treball concurrents per espai de treball.
<Warning>
No pots executar més de 100 fluxos de treball en paral·lel en cap moment per espai de treball.
</Warning>
**Solucions**:
- Utilitza la disponibilitat `Massiva` per a desencadenadors manuals per processar múltiples registres en una execució
- Implementa retards entre execucions de fluxos de treball amb desencadenadors programats
- Optimitza fluxos de treball per executar-se més ràpidament i reduir el temps d'execució concurrent
- Considera el processament en lots durant hores fora de punta
### Limitació de Ràtio d'API
**Problema**: Trucades a API externs que fallen a causa de límits de ràtio.
**Solucions**:
- Utilitza fluxos de treball programats en lloc de desencadenadors en temps real quan sigui possible
- Implementa retards entre trucades API en accions de codi
- Agrupa sol·licituds API quan el servei extern ho suporta
- Supervisa les execucions de fluxos de treball per detectar errors de límit de ràtio i ajusta el temporitzador
### Problemes d'Iterador
**Problema**: Les accions d'Iterador no funcionen com s'esperava.
**Solucions**:
- **Nota**: L'Iterador està actualment en beta. Activa'l a Configuració → Llançaments → Laboratori
- Verifica que l'entrada sigui un conjunt de registres d'un pas previ
- Comprova que les accions dins l'Iterador estiguin correctament configurades
- Utilitza l'Iterador amb desencadenadors manuals `Massius` per un rendiment òptim
### Permisos Faltants
**Problema**: No es pot accedir a la secció de fluxos de treball.
<Warning>
Si no veus la secció de Fluxos de Treball, això es deu a un problema de permisos. Contacta amb l'administrador del teu espai de treball per concedir-te accés als fluxos de treball.
</Warning>
## Consells d'Optimització
### Pràctiques de Millor Rendiment
- **Comença simple** i afegeix complexitat de manera gradual
- **Usa la disponibilitat `Massiva`** per a desencadenadors manuals per processar registres múltiples de manera eficient
- **Afegeix filtres d'hora** per aturar fluxos de treball quan no es compleixen els criteris
- **Agrupa trucades API** i utilitza fluxos de treball programats per a processos no urgents
- **Oculta execucions de flux de treball** de pàgines que mostren tots els fluxos per millorar el rendiment de càrrega
- **Monitora l'ús de crèdit** regularment a Configuració → Facturació
### Prevenció d'Errors
- **Prova en mode esborrany** abans d'activar els fluxos de treball
- **Verifica respostes d'API** i implementa accions d'emergència
- **Utilitza noms descriptius per als passos** per a un manteniment més fàcil
- **Documenta la lògica complexa** per als membres de l'equip
## Obtenció d'Ajuda
### Ressources d'Autoservei
- Revisa les [Característiques del Flux de Treball](/l/ca/user-guide/workflows/workflow-features) per a detalls tècnics
- Consulta els [Crèdits del Flux de Treball](/l/ca/user-guide/workflows/workflow-credits) per consells d'optimització
- Exploreu [Automatitzacions Internes](/l/ca/user-guide/workflows/internal-automations) i la [Integració d'Eines Externes](/l/ca/user-guide/workflows/external-tool-integration) per obtenir exemples
### Suport Professional
- Contacta amb els nostres [Serveis Professionals](/l/ca/user-guide/workflows/professional-services) per a la resolució de problemes complexos
- Connecta't amb el suport a través de contact@twenty.com per obtenir assistència tècnica