メインコンテンツへ移動
モジュール

再利用可能な機能をモジュール化ワークフローをまたいで再利用

モジュールは別のテンプレート集ではなく、複数のワークフローから参照できるサブフローです。バージョンと明示的な入出力契約により、更新・再利用・調査の境界が明確になります。

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 対 1 で対応する死活確認モジュールで、ある第三者認可が現時点で利用可能かを確かめます。長いフローの先頭に事前チェックとして置いても、単独の定期タスクとして全認可を巡回させても使えます。

再利用の効果

1つのモジュール更新で、複数のワークフローを強化

親ワークフローはモジュールの公開入出力契約だけに依存します。モジュール内部は継続的に更新でき、呼び出し側はバージョン差分と互換性を確認して採用時期を選べます。

  • 1つの機能を複数箇所で利用レポート、アラート、分析ワークフローで同じモジュールを共有できます。
  • 更新にはバージョン境界呼び出し側は差分を確認し、更新時期を選べます。
  • 参照関係を追跡可能利用中のワークフローを把握し、変更前に影響を評価できます。
再利用の方法

親ワークフローがモジュールを呼び出す方法

  1. 親ワークフローがモジュールを呼び出す方法 モジュールのワークフロー名を入力するか、エディターで特定のワークフローを選択します。
  2. モジュール契約 呼び出し元が渡す必要があるパラメータ (名前、タイプ、必須、デフォルト値、説明付き)
  3. モジュールのアップグレードとバージョンの互換性 編集および検証時に必要な入力、出力マッピング、および参照を確認してください。
  4. カスタムモジュール まず、再利用するロジックを明確な境界を持つワークフローに整理し、保存します。
テンプレートライブラリで始め、モジュールライブラリで機能を追加
テンプレートライブラリとモジュールライブラリは別々の入口です。前者はダウンロードした完全なフロー、後者は再利用可能なモジュールを管理します。