Power Automate v2 スキーマ

Note

この記事で説明する Power Automate および Dataverse 機能は、職場または学校アカウントあるいは組織のプレミアム アカウントで サインインするユーザーに適用されます。

Microsoft Dataverse の Power Automate ストア デスクトップ フローでは、ビジネス アプリケーションで使用されるデータを安全に格納し、管理できます。

この機能により、アプリケーション ライフサイクル管理 (ALM) のソリューションなどの機能を使用できます。 ただし、この方法で保存されたデータの処理は困難な場合があります。

したがって、Dataverse (v2) のデスクトップ フロー用の新しいストレージ スキーマが利用可能です。 これにより、Dataverse API との連携が容易になり、デスクトップ フローによる将来の製品強化が可能になります。 新しいストレージ スキーマは、デスクトップ用 Power Automate (v2.29) と共に公開されています。

Power Platform 管理センターで v2 スキーマ設定にアクセスする

v2 スキーマは、有料ライセンス ユーザーの Dataverse データベース消費を効果的に削減します。 また、デスクトップ フローのコンポーネントを、現在のサブスクリプションの一部である、アプリ向け Dataverse のファイル容量にオフロードします。

新しいスキーマを効果的に使用するには、ユーザーと無人ランタイム マシンがデスクトップ バージョンの適切なPower Automateに更新されていることを確認します。

Power Platform 管理者は、次の手順に従って、環境のデスクトップ フローの v2 ストレージ スキーマ設定 ( 拡張デスクトップ フロー スキーマと呼ばれます) にアクセスできます。

  1. Power Platform 管理センターにサインインする
  2. ナビゲーション ウィンドウで、[管理] を選択 します
  3. [ 管理 ] ウィンドウで、[ 環境] を選択します。
  4. [ 環境 ] ページで、構成する環境を選択します。
  5. コマンド バーで、設定 を選択します。
  6. 製品 を展開し、機能 を選択します。
  7. [ 機能 ] ページで、[ 拡張デスクトップ フロー スキーマ] に移動します。 この設定は、環境レベルで適用されます。

スキーマ V2 は既定で有効

2024 年 10 月 1 日の時点で、v1 スキーマは非推奨となり、Power Platform のすべてのパブリック リージョンで v2 スキーマが既定で有効になっています 。 v2 スキーマが有効な環境を使用してデスクトップ フローを作成および実行するには、デスクトップ用 Power Automate v2.29 以降が必要です。 この要件により、デスクトップ フロー作成者とアテンド型および非アテンド型ユーザーが新しい機能を利用できるようになります。

Power Platform 管理センターのスキーマ v2 をオプトアウトするオプションは、既定で有効になっています。

v2 スキーマが有効になっている環境でデスクトップ フローを管理する

現在 v1 スキーマに保存されている Power Automate デスクトップ フローは、v2 スキーマが有効になっている環境で意図したとおりに機能し続けます。 新規、変更済、および再保存されたデスクトップ フローは、v2 スキーマに保存されます。

デスクトップ フローが v2 対応環境のソリューションに属している場合は、これらの追加手順に従って、フローが正しく機能するために必要なすべてのバイナリがソリューション パッケージに含まれていることを確認してください。

変換されたデスクトップ フローをロールバックする

デスクトップ用 Power Automate バージョン 2.29 以降では、v1 スキーマが非推奨になるまで、v2 スキーマに移行した組織をロールバックすることができます。

v2 スキーマに変換されたデスクトップ フローは、Power Platform 管理者がその機能を無効にしている環境にデスクトップ フローを再保存することで、元に戻すことができます。

ほとんどのシナリオでは、デスクトップ用 Power Automate のバージョンをダウングレードする必要はありません。 ただし、v1 スキーマでサポートされていない v2 関連機能を使用するデスクトップ フローはロールバックできません。

v2 から v1 にロールバックすると、UI 要素に関連付けられた一部のスクリーンショットが保存されない可能性があります。 これらのスクリーンショットはデスクトップ フローの実行には必要ありませんが、保存できます。

  1. Power Automate デスクトップの右側のパネルにある UI 要素に移動します。
  2. リスト内の各 UI 要素を選択します。

これにより、v1 にロールバックしたときにスクリーンショットが保存されるようになります。

v2 スキーマ デスクトップ フローの制限

v2 スキーマに保存されたデスクトップ フローは、v2 スキーマ機能が有効になっている環境でのみ機能します。

管理ソリューション の V1 スキーマ デスクトップ フローは、v2 スキーマが有効になっている環境で動作する可能性がありますが、まず、v2 スキーマが有効になっている別の環境に再保存する必要があります。

次に、同じプロセスの更新された v2 スキーマ バージョンを、そのプロセスを実行する予定の管理されたマネージド環境にインポートできます。 アクティブ レイヤーは、自動化されたプロセスの v2 スキーマ バージョンに置き換えることができます。

Scenario 2023 年 2 月リリース以前のデスクトップ用 Power Automate 2023 年 2 月リリース以降のデスクトップ用 Power Automate
v2 スキーマが有効になっている環境で v1 スキーマ デスクトップ フローを実行できますか? はい はい
v2 スキーマが有効になっている環境で v2 スキーマ デスクトップ フローを実行できますか? いいえ (ユーザーへのエラー通知) はい
v2 スキーマが無効になっている環境で v2 スキーマ デスクトップ フローを実行できますか? いいえ (ユーザーへのエラー通知) はい
v2 スキーマが無効になっている環境で v1 デスクトップ フローを v1 スキーマに編集/保存できますか? はい はい
v2 スキーマが有効になっている環境で v1 デスクトップ フローを v1 スキーマに編集/保存できますか? はい いいえ (フローは v2 スキーマでアップコンバートして保存されます)
v2 スキーマが無効になっている環境で v2 デスクトップ フローを z1 スキーマに編集/保存できますか? いいえ (ユーザーへのエラー通知) はい (フローは v1 スキーマにダウングレードされ、保存されます)
v2 スキーマが有効になっている環境で v2 デスクトップ フローを v2 スキーマに編集/保存できますか? いいえ (ユーザーへのエラー通知) はい

サイズ制限を超過しました

デスクトップ フローを v2 スキーマで保存すると、次のエラーが表示される場合があります。

「フローは許容サイズ制限を超えたため保存できません。」

フロー保存中にフロー サイズの制限を示すエラー メッセージが表示されました。

この制限は、Dataverse に保存されるデスクトップ フローの定義に適用され、その文字数は 1600 万文字を超えることはできません。 この問題は、アクションのプロパティ値が大きい場合や変数のデフォルト値が大きい場合など、大規模なデスクトップ フローで発生する可能性があります。 例としては、画像を base64 として保存し、デフォルトの変数値として設定することが挙げられます。

アクション プロパティまたは変数のデフォルト値に大きなペイロードを保存しないことをお勧めします。 代わりに、他のアクションから値を取得するか、値を入力変数として渡します。 デスクトップ フローを複数の子デスクトップ フローに分割することもできます。

Dataverse スキーマ

v2 スキーマで、Dataverse に格納されているデータ モデルを変更します。 ワークフロー エンティティに加えて、デスクトップ フロー バイナリ エンティティを使用して、画像やメタデータなどのデスクトップ フローに関連するデータを保存します。

デスクトップ フロー バイナリを使用した v2 スキーマのデスクトップ フロー。

Important

デスクトップ フロー バイナリ オブジェクトは、デスクトップ フローを開いたり実行したりできるようにするために必要なデータを保存するための、デスクトップ フローの必須コンポーネントです。 これらのバイナリ オブジェクトは削除しないでください。 これらを削除すると、デスクトップ フローのデータが永久に失われ、それぞれのフローが編集できなくなります。

デスクトップ フロー バイナリの数は、デスクトップ フローのサイズによって異なる場合があります。

役割と権限

v2 スキーマでは、デスクトップ フロー バイナリ テーブルが使用されます。 デスクトップ フローが期待どおりに動作するには、追加の権限が必要です。 既定のセキュリティ ロール Environment MakerBasic Userを使用している場合、デスクトップ フローが想定どおりに動作するために追加の構成は必要ありません。 これらの組み込みロールには、v2 スキーマでのフローの作成、実行、管理に必要なすべてのアクセス許可が既に含まれています。

カスタム セキュリティ ロールを使用してデスクトップ フローへのアクセスを管理する場合、これらのロールには、以下に示すデスクトップ フロー固有の特権に加えて、組み込みの Basic User ロールと Environment Maker ロールのすべての特権を含める必要があります。 カスタム ロールは、これらの組み込みロールのアクセス許可を効果的に継承またはミラー化し、組み込みロールが時間の経過と同時に変更される可能性があるため、定期的に確認および更新する必要があります。 これにより、互換性が維持され、プラットフォームのアクセス許可の進化時に予期しないエラーが発生するのを防ぐことができます。

Basic UserロールとEnvironment Makerロールによって提供されるアクセス許可に加えて、カスタム セキュリティ ロールを使用する場合、デスクトップ フローには次の特権が必要です。

  • prvCreatedesktopflowbinary
  • prvReaddesktopflowbinary
  • prvWritedesktopflowbinary
  • prvDeletedesktopflowbinary
  • prvSharedesktopflowbinary
  • prvAssigndesktopflowbinary
  • prvAppenddesktopflowbinary
  • prvAppendTodesktopflowbinary
  • prvReadSolution
  • prvReadtag (バージョン 2.57 以降はオプション)
  • prvReadtaggedprocess (バージョン 2.57 以降はオプション)

各権限の最小アクセス レベルは基本 (ユーザー) です。 詳細情報: セキュリティ ロールおよび特権

v2 スキーマを使用したデスクトップ フロー バイナリに必要な特権とアクセス レベル

Important

Basic User または Environment Maker によって通常付与される他の必要な Dataverse または Power Platform のアクセス許可がない場合、ロールと特権に記載されている権限のみを割り当てるだけでは不十分な場合があります。