워크플로우 문제 해결

​

워크플로우 실행으로 디버깅하기

문제를 디버그하기 위해 워크플로우 실행 인터페이스를 사용하세요:

• 워크플로우 편집기의 실행 패널을 통해 접근
• 각 단계의 입력/출력 데이터를 보려면 개별 실행을 클릭하세요
• 단계 간의 실행 상태, 오류 메시지 및 데이터 흐름을 확인하세요

​

일반적인 문제와 해결책

​

워크플로우가 작동하지 않음

문제: 워크플로우가 예상대로 실행되지 않음. 해결책:

• 워크플로우가 활성화되었는지 확인 (초안 모드 아님)
• 트리거 설정이 데이터 구조와 일치하는지 확인하세요
• 레코드 트리거의 경우, 올바른 객체와 필드가 선택되었는지 확인
• 웹훅 트리거의 경우 URL과 예상 데이터 형식을 검증
• 예약된 트리거의 경우, 타이밍 구성을 점검

​

양식에 접근할 수 없음

문제: 자동 워크플로우에서 양식 작업 찾기 또는 접근이 어려움. 임시 해결책: 양식이 필요한 경우 수동 트리거 사용 또는 자동 흐름에서 양식 사용을 피하기 위해 워크플로우 구조를 변경.

​

높은 크레딧 소비

문제: 예상보다 더 많은 크레딧을 소모하는 워크플로우. 일반 원인 및 해결책:

• 비효율적인 API 호출: 개별 요청 대신 배치 API 호출 사용
• 잘못된 수동 트리거 구성: 단일 대신 벌크 가용성을 사용하여 하나의 워크플로우 실행에서 여러 레코드를 처리
• 필터 누락: 조건이 충족되지 않을 때 워크플로우를 중지할 조건부 로직 추가
• 불필요한 단계: 불필요한 작업 제거하고 워크플로우 논리 최적화
• 실시간 대 예약: 긴급하지 않은 프로세스에는 예약된 워크플로우 사용

​

동시 워크플로우 제한

문제: 워크스페이스당 100개의 동시 워크플로우 제한을 초과합니다. 해결책:

• 수동 트리거의 벌크 가용성을 사용하여 하나의 실행에서 여러 레코드를 처리
• 예약된 트리거를 사용하여 워크플로우 실행 간 지연을 구현
• 워크플로우를 최적화하여 더 빠르게 실행되고 동시 실행 시간을 줄임
• 비활성화 시간에 일괄 처리 실행 고려

​

API 속도 제한

문제: 외부 API 호출이 속도 제한으로 인해 실패합니다. 해결책:

• 가능한 경우 실시간 트리거 대신 예약된 워크플로우 사용
• 코드 작업에서 API 호출 간 지연을 구현
• 외부 서비스가 지원할 경우, 배치 API 요청 사용
• 속도 제한 오류를 모니터링하고 타이밍 조정

​

이터레이터 문제

문제: 이터레이터 작업이 예상대로 작동하지 않음. 해결책:

• 참고: 이터레이터는 현재 베타 버전입니다. 설정 -> 릴리즈 -> 랩에서 활성화
• 입력이 이전 단계의 레코드 배열인지 확인
• 이터레이터 내부의 작업이 올바르게 구성되어 있는지 확인
• 최적의 성능을 위해 벌크 수동 트리거와 함께 이터레이터 사용

​

권한 누락

문제: 워크플로우 섹션에 접근 불가.

​

최적화 팁

​

성능 최적화 모범 사례

• 단순하게 시작하고 점진적으로 복잡성 추가
• 수동 트리거에 대해 벌크 가용성 사용하여 여러 레코드를 효율적으로 처리
• 기준이 충족되지 않을 때 워크플로우를 중지하기 위해 초기에 필터 추가
• API 호출 배치하고 긴급하지 않은 프로세스에는 예약된 워크플로우 사용
• 로딩 성능을 개선하기 위해 모든 워크플로우를 표시하는 페이지에서 워크플로우 실행 숨기기
• 설정 -> 청구에서 크레딧 사용량을 정기적으로 모니터링

​

오류 예방

• 워크플로우를 활성화하기 전에 초안 모드로 테스트
• API 응답을 검증하고 대체 작업 구현
• 유지관리를 쉽게 하려면 설명적인 단계 이름 사용
• 팀원을 위해 복잡한 로직을 문서화

​

도움 받기

​

셀프 서비스 자료

• 기술 세부 사항은 워크플로우 기능 검토
• 최적화 팁을 위해 워크플로우 크레딧 확인
• 예시는 내부 자동화 및 외부 도구 통합 탐색

​

전문 지원

• 복잡한 문제 해결을 위해 전문 서비스에 문의
• 기술 지원을 위해 contact@twenty.com으로 연락