ライフサイクル ワークフローのバージョン管理

ライフサイクル ワークフローを使って作成されたワークフローは、組織内のユーザーのライフサイクルの監査に関する組織の要件を満たすよう、必要に応じて更新できます。 ワークフローの更新を管理するため、ライフサイクル ワークフローではワークフローのバージョン管理の概念が導入されています。 ワークフローのバージョンは、実行条件またはそのタスクを更新することによってトリガーされる、既存のワークフローの新しいバージョンです。 ワークフローのバージョンでは、既存のワークフローのアクションやスコープさえ変更できます。 ワークフロー更新プロセスでのワークフローのバージョン管理の処理方法を理解すると、ワークフローのタスクと条件がワークフローによって処理されるユーザーと常に関連するように、ワークフローを戦略的に設定できます。

バージョン管理の利点

ライフサイクル ワークフローでバージョンを管理すると、ユース ケースごとに新しいワークフローを作成する方法より、多くの利点があります。 これらの利点により、トラブルシューティングと記録保持の両方の機能について、レポート作成プロセスを次のように改善できます。

  • 長期保有 - バージョン管理を使うと、監査ログのみを使う場合より、ワークフローの情報を長く保持できます。 監査ログでは過去 30 日間の情報のみが保存されるのに対し、バージョン管理ではワークフローの詳細を作成の時点から追跡できます。
  • 追跡可能性 - ユーザーを処理したワークフローの特定のバージョンを追跡できます。

ワークフローのプロパティとバージョン

ワークフローの更新によって新しいバージョンの作成がトリガーされる場合がありますが、常にそうなるとは限りません。 基本プロパティと呼ばれるワークフローのパラメーターは、ワークフローの新しいバージョンを作成せずに更新できます。 このようなパラメーターの一覧は次のとおりです。

  • displayName
  • description
  • isEnabled
  • IsSchedulingEnabled
  • タスク名
  • タスクの説明

Microsoft Entra 管理センターでは、これらに対応するパラメーターは、更新対象のワークフローの [プロパティ] セクションにあります。 Screenshot of updated basic properties LCW

Microsoft Entra 管理センターと Microsoft Graph の API の両方を使ってこれらのプロパティを更新する手順について詳しくは、「ワークフローのプロパティを管理する」をご覧ください。

新しいバージョンの作成をトリガーするプロパティは次のとおりです。

  • tasks
  • executionConditions

これらのワークフローの新しいバージョンは、Microsoft Entra 管理センターで更新を行うとすぐに作成されますが、Microsoft Graph で API を使ってワークフローの新しいバージョンを作成する場合は、createNewVersion メソッドを実行する必要があります。 タスクまたは実行条件を更新する手順について詳しくは、「ワークフローのバージョンを管理する」をご覧ください。

Note

ワークフローがオンデマンドの場合、実行条件に関連付けられた構成情報は存在しません。

ワークフローのバージョン履歴に含まれる詳細

ワークフローの基本プロパティの変更とは異なり、ワークフローの新しく作成されるバージョンは前のバージョンと大きく異なる場合があります。 タスクを追加または削除でき、ワークフローの実行対象ユーザーが異なっていてもかまいません。 バージョン間でワークフローが大きく変更される可能性があるため、バージョンの詳細では、ワークフローの現在のバージョンだけでなく、前の繰り返しに関する詳細情報も提供されます。

Microsoft Entra 管理センターに表示されるバージョン情報に含まれる詳細:

Screenshot of workflow versioning information.

詳細なバージョン情報は次のとおりです。

parameter description
バージョン番号 情報の対象であるワークフローのバージョンを示す整数。 新しいワークフロー バージョンごとに順番に増えていきます。
最終更新日 ワークフローが最後に更新された日時。 ワークフローの以前のバージョンの場合、最終変更日は常に次のバージョンが作成された日時になります。
最終更新元 このワークフロー バージョンを最後に変更したユーザー。
作成日 ワークフローのバージョンが作成された日時。
作成者 ワークフローのこの特定のバージョンを作成したユーザー。
名前 このバージョンでのワークフローの名前。
説明 このバージョンでのワークフローの説明。
カテゴリ ワークフローのカテゴリ。
実行条件 このバージョンのワークフローが実行されるユーザーとタイミングを定義します。
タスク このワークフロー バージョンに存在するタスク。 API で表示する場合は、タスクの引数も表示できます。 特定のタスクの定義については、ライフサイクル ワークフローのタスクと定義に関する記事をご覧ください

次のステップ