自動化をブランチ化する

Automate は Global Branching と連携し、安全で分離された環境で自動化を開発できるようにします。このドキュメントでは、 リソースの追加と変更、アプリケーション間の互換性、 マージ要件、リベース、既知の制限事項など、ブランチ上で自動化を扱う方法を説明します。

Global Branching の概念とワークフローに関する一般的な情報については、Global Branching のドキュメントを参照してください。

リソースを追加、削除、変更する

自動化をブランチに追加する

自動化をブランチに追加するには、次の手順を実行します。

1. ブランチ上の自動化ファイルに移動するか、ページの右上にあるブランチセレクターで対象のブランチを選択します。そこから、ブランチに追加を選択します。
2. 自動化ファイルを編集して保存します。これで、自動化がブランチ上の保存済みリソースになります。

自動化をブランチから削除する

自動化をブランチから削除するには、右下のサイドバーでブランチから削除を選択します。自動化をブランチから削除すると、ブランチ上の変更がすべて破棄され、すべての効果の実行が停止します。

自動化を変更する

ブランチ上の自動化を変更するには、メインブランチと同じように、変更を加えて保存します。

対応している条件と効果

現在、ブランチ上では Automate のすべての条件に対応しているわけではありません。ブランチ上で自動化を作成すると、対応していない条件は条件セレクターで無効になります。

ブランチ上では、次の条件に対応しています。

• 時刻：指定した時刻になるとトリガーされます。たとえば、「毎週月曜日の午前9時」などです。
• セットに追加されるオブジェクト： 事前定義されたオブジェクトセットに新しいオブジェクトが現れるとトリガーされます。
• セットから外れるオブジェクト： 事前定義されたオブジェクトセットからオブジェクトが外れるとトリガーされます。
• セット内で変更されるオブジェクト： 事前定義されたオブジェクトセット内でオブジェクトが変更されるとトリガーされます。
• すべてのオブジェクトに対して実行： 指定されたセット内のすべてのオブジェクトに対して、効果を定期的に実行します。

ブランチ上では、次の条件に現在は対応していません。

• しきい値を超える： メトリクスのしきい値を超えるとトリガーされ、トリガー状態が維持されます。
• 自動化の依存関係： 別の自動化が完了した後にトリガーされます。既知の制限事項を参照してください。
• 時系列： 時系列のしきい値を超えるとトリガーされます。
• ストリーム [ベータ版]：ストリームに新しいレコードが追加されるたびにトリガーされます。
• メトリクスが変化する [サンセット]：オブジェクトセットの集計メトリクスが増加または減少するとトリガーされます。

ブランチ上では、Automate のすべての効果に対応しています。

• アクション： 条件が満たされるとアクションを実行します。
• ロジック： 条件が満たされると AIP Logic 関数を実行し、生成されたアクションをステージングするか、適用します。
• 関数 [ベータ版]： 条件が満たされると関数を実行します。これらの関数ではオントロジーを編集できません。
• 通知： 選択した受信者に通知を送信します。任意で Notepad の添付ファイルを付けることができます。

アプリケーション間の互換性

自動化は、オブジェクトタイプ、アクション、AIP Logic 関数、Foundry 関数など、プラットフォーム全体のリソースを参照します。ブランチ上では、自動化はこれらのリソースのブランチ上の状態を参照します。

• ブランチ化されたオブジェクトタイプとアクションタイプ： 自動化は、同じブランチ上で作成または変更されたオブジェクトタイプとアクションタイプを参照できます。
• ブランチ化された関数バージョン： 自動化は、AIP Logic 関数や Foundry 関数のブランチ化されたプレリリースバージョンなど、ブランチ化された関数バージョンを参照できます。
• ブランチに限定された実行： ブランチ化された自動化は、そのブランチ上で条件を評価し、効果を実行します。ブランチ上での効果の実行に伴う影響については、ブランチ上の副次的効果の管理を参照してください。

マージ要件

ブランチから main に自動化をデプロイするには、次のチェックに成功する必要があります。

• 承認要件が満たされている： ブランチをマージするには、自動化に必要なすべての承認要件が満たされている必要があります。下記のレビュアーの操作を参照してください。
• 自動化が main に合わせてリベースされている： マージする前に、自動化の main ブランチに変更が加えられている場合は、その変更をこのブランチにリベースします。
• 自動化が有効な状態である： 自動化は保存時に継続的に有効性が評価されるため、通常はこのチェックに合格します。ただし、自動化が依存するオブジェクトタイプ、アクションタイプ、関数などのリソースが削除されると、自動化が無効になる場合があります。

保護された自動化

自動化へのすべての編集がブランチとレビューのプロセスを経るようにするために、 その自動化の main ブランチを保護できます。

自動化の main ブランチを保護するには、ファイルシステム内のリソースに移動し、ブランチの保護 > プロジェクトポリシーで保護を選択します。自動化のメイン表示の右上にある詳細の表示オプションからも、この操作を行えます。

自動化の main ブランチが保護されている場合、main への編集を保存するには、グローバルブランチを経由する必要があります。

レビュアーの操作

提案を作成すると、Global Branching アプリケーション、または Automate の承認バナーから、自動化にレビュアーを追加できます。レビュアーとして追加されたユーザーには、 提案へのリンクを含むレビュー依頼のメールが届きます。

管理を選択してレビュアーを追加し、提案をマージする前に満たす必要がある承認ポリシーを表示します。

自動化にレビュー待ちの変更がある場合、ページ上部のバナーに、満たされている承認要件の数が表示されます。

そこからレビュアーは、レビューを開始を選択してレビューダイアログを開き、main とブランチの変更を左右配置で比較できます。その後、自分のレビューオプションを選択して、変更を承認または拒否できます。

必要なすべての承認要件が満たされると、変更が承認され、このリソースの提案をマージできるようになります。

リベースと競合の解決

このブランチを作成した後、または最後にリベースした後に main が変更された場合は、リベースが必要です。

自動化の上部にバナーが表示され、このブランチを最新の変更に合わせてリベースするよう求められます。

このブランチをリベースするには、バナーのリベースを開始を選択します。リベースの自動化ダイアログが開き、メインブランチと現在のブランチのバージョンが左右配置で比較表示されます。 メインブランチと現在のブランチのどちらのバージョンを保持するかを選択し、リベースを完了するを選択して選択内容を適用します。

リベースと承認の両方が必要な場合は、リベースダイアログが先に表示されます。レビュアーが変更をレビューするには、先にリベースを解決する必要があります。

既知の制限事項

• ブランチ上では、すべての条件がサポートされているわけではありません。完全な一覧については、サポートされている条件と効果を参照してください。
• リベースでは、main の変更とこのブランチの変更のどちらかを選択する必要があります。現在、より細かい粒度で差分を解決する方法はありません。