주요 콘텐츠로 건너뛰기
모듈

공통 기능을 모듈로워크플로 간 재사용

모듈은 또 다른 템플릿 모음이 아니라 여러 워크플로가 참조하는 하위 흐름입니다. 버전과 명시적인 입출력 계약으로 업그레이드, 재사용, 문제 해결의 경계를 분명히 합니다.

492사용 가능한 모듈
SEMVER버전 기반 업그레이드
I/O타입 지정 계약
제품 화면

모든 모듈을 관리하는 위치

모듈 라이브러리에는 마켓에서 다운로드한 모든 모듈이 표시됩니다. 모듈은 명시적인 inputs/outputs 계약을 가지며 상위 워크플로의 sub_workflow 단계에서 이름으로 참조할 수 있습니다.

Braidrun 모듈 라이브러리 스크린샷
모듈 라이브러리: 설치된 모듈마다 입출력 계약과 이를 참조하는 워크플로가 표시되며, 한 번 고치면 참조하는 흐름 전체에 반영됩니다
모듈 계약

모듈 계약

상위와 하위 간에 데이터를 전달하는 유일한 방법은 입력/출력(명시적 계약)입니다.

INPUTS / OUTPUTS

모듈 계약

호출자가 전달해야 하는 매개변수(이름, 유형, 필수, 기본값, 설명 포함)

SEMVER

모듈 업그레이드 및 버전 호환성

편집 및 검증 시 필수 입력, 출력 매핑 및 참조를 확인하세요.

SUB_WORKFLOW

상위 워크플로에서 모듈을 호출하는 방법

모듈 워크플로 이름을 입력하거나 편집기에서 특정 워크플로를 선택하세요.

내장 모듈 라이브러리

492개 모듈: 데이터 수집, 보고서 생성, 메시지 전달 등 자주 쓰는 단계가 모두 준비되어 있습니다

utility-*

범용 유틸리티(utility-* 접두사, 약 140개)

모듈 라이브러리에는 492개 내장 모듈(플랫폼 로그인, 시간창 계산, ASA 리포트 가져오기, Excel 리포트, Slack 전달 등)이 딸려 있으며, 자세한 내용은

ads-*

광고 및 어트리뷰션

이 모듈들은 실제 광고 운영 현장에서 나온 것으로, 주요 광고 플랫폼의 리포트 수집과 어트리뷰션 데이터를 다룹니다. 용도별 주요 분류는 다음과 같습니다:

business-*

업무 시나리오(business-* 접두사, 약 150개)

가장 수가 많은 묶음입니다. 특정 외부 시스템을 대상으로 바로 운영에 올릴 수 있는 업무 동작(이상 점검, 운영 브리핑, 데이터 동기화 등)을 제공합니다. 이름 규칙이 business-module-<서비스>-<용도>이므로 서비스 이름으로 검색하는 게 가장 빠릅니다.

integration-*

연결 상태 점검(integration-* 접두사, 약 70개)

커넥터와 일대일로 대응하는 헬스 체크 모듈로, 특정 서드파티 인증이 지금 쓸 수 있는 상태인지 확인합니다. 긴 흐름의 맨 앞에 사전 점검으로 두거나, 별도의 정기 작업으로 모든 인증을 순회 점검하기에 좋습니다.

재사용 효과

모듈 하나를 바꾸면 여러 워크플로가 함께 개선됩니다

상위 워크플로는 모듈의 공개 입출력 계약에만 의존합니다. 모듈 내부는 계속 개선할 수 있고 호출자는 버전 차이와 호환성을 검증한 뒤 적용 시점을 선택합니다.

  • 하나의 기능, 여러 호출자보고서, 알림, 분석 워크플로가 같은 모듈을 공유할 수 있습니다.
  • 업그레이드의 버전 경계호출자는 차이를 확인하고 업그레이드 시점을 선택할 수 있습니다.
  • 추적 가능한 참조 관계어떤 워크플로가 사용하는지 확인하고 변경 전에 영향을 평가합니다.
재사용 방식

상위 워크플로에서 모듈을 호출하는 방법

  1. 상위 워크플로에서 모듈을 호출하는 방법 모듈 워크플로 이름을 입력하거나 편집기에서 특정 워크플로를 선택하세요.
  2. 모듈 계약 호출자가 전달해야 하는 매개변수(이름, 유형, 필수, 기본값, 설명 포함)
  3. 모듈 업그레이드 및 버전 호환성 편집 및 검증 시 필수 입력, 출력 매핑 및 참조를 확인하세요.
  4. 맞춤 모듈 먼저 재사용할 로직을 경계가 명확한 워크플로우로 정리하고 저장하세요.
템플릿 라이브러리에서 시작하고 모듈 라이브러리에서 역량을 더하세요
템플릿 라이브러리와 모듈 라이브러리는 별도 앱 진입점입니다. 하나는 다운로드한 전체 워크플로를, 다른 하나는 재사용 모듈을 관리합니다.