デスクトップ用の Power Automate でカスタムアクションを構築する方法

[アーティクル]
12/13/2023

デスクトップ用 Power Automate のカスタムアクションを使用して、生産性、再利用性、拡張性を向上します。この記事では、デスクトップ用 Power Automate のカスタムアクションが、複数のフローで使用できる独自の再利用可能なアクションを作成者が作成するのにどのように役立つかについて説明します。作成者は、一連のステップまたは関数を新しいアクションに組み込むことによってカスタムアクションを作成します。カスタムアクションは、デスクトップアクション SDK 用 Power Automate を使用して作成されます。この SDK は、作成者が .NET 言語 C# を使用してカスタムアクションを作成できるようにする API セットを提供します。カスタムアクションは、Power Automate (make.powerautomate.com) のカスタムアクションセクションを通じて他のユーザーと共有することもできます。この記事では、カスタムアクションを作成、構築、デプロイ、使用、更新する方法について詳しく説明します。

重要

カスタムアクションの作成に使用される重要な機能はサポートされていますが、ここで説明されている提供されたソリューション、アセット、およびサンプルスクリプトは、これらの機能の実装例として機能し、サポートは含まれません。

概要

デスクトップ用 Power Automate のカスタムアクション機能を使用すると、複数のデスクトップフロー間で使用できる再利用可能な独自のアクションを作成できます。カスタムアクションを使用すると、新しいフローを構築するたびにアクションを再作成することなく、複雑なアクションや頻繁に使用するアクションを再利用できるため、時間と労力を節約できます。作成者は、既存のスキルと知識を応用して、他のシステムやサービスと統合するカスタムアクションを作成できます。さらに、プロ開発者は、既存の関数またはコードライブラリをラップして、組織資産の再利用性を高める新しいカスタムアクションを作成できます。

一連の方法または関数を新しいアクションに組み込むことによってカスタムアクションを作成します。カスタムアクションを作成したら、それを Power Automate デスクトップデザイナーキャンバスにドラッグアンドドロップして任意のデスクトップフローで使用します。

カスタムアクションは、Power Automate のカスタムアクションセクションを通じて他のユーザーと共有できます。これは、カスタムアクションを共有および検出するための中央リポジトリを提供します。これは、ユーザーが組織内の他のユーザーの専門知識や知識から恩恵を受けることができ、他の作成者が作成したカスタムアクションを簡単に見つけて使用できることを意味します。

全体的に、デスクトップ用 Power Automate のカスタムアクションは、製品の機能を拡張し、フロー構築プロセスを合理化し、組織内のコラボレーションとイノベーションを促進する強力な方法を提供します。

前提条件

デスクトップ用 Power Automate の最新版 - Power Automate をインストールする
.NET デスクトップ開発ワークロードのVisual Studio コミュニティ/プロフェッショナル/エンタープライズ 2022 などの # オーサリングツール
カスタムアクション SDK – NuGet ギャラリー | Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK
デジタル証明書:
- 自己署名証明書を生成する – 自己署名証明書の生成の概要 – .NET
- エンタープライズ展開 – 証明機関からの組織の信頼された証明書 – デジタル署名と証明書 – Office サポート
SignTool:
- SignTool を使用してファイルに署名する – Win32 アプリ
- SignTool
Windows PowerShell スクリプト (.ps1) – カスタムアクションの作成 – Power Automate

独自のカスタムアクションを作成する

Visual Studio を開いて、クラスライブラリ (.NET Framework) のテンプレートを使用した新しいプロジェクトを作成します。
プロジェクト名とファイルの場所を使用して新しいプロジェクトを構成し、Framework を .NET Framework 4.7.2 として設定します。。

注意

必ず名前付け規則に従ってください。詳細: カスタムモジュール名の規則
Visual Studio で、ツール>NuGet パッケージマネージャー>パッケージマネージャーコンソールの順に選択します。
PowerShell ウィンドウを開き、この PowerShell コマンドを使用して NuGet パッケージ PowerAutomate.Desktop.Actions.SDK をインストールします。
```
Find-Package Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK
NuGet\Install-Package Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK
```
「カスタムアクションの作成」の手順に従って、カスタムアクションのクラスファイルを作成します。

アクションの参考となる情報

リファレンスソリューションアーカイブ: .NET モジュールソリューション

アクション: メッセージをローカルファイルに書き込みます。

入力パラメータ: ファイル名、ファイルに書き込むメッセージ。

出力パラメータ: ステータスコード – 成功した場合は true、失敗した場合は false。

クラス定義:

using System;
using System.IO;
using Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK;
using Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK.Attributes;

namespace ModulesLogEvent
{
    [Action(Id = "LogEventToFile" , Order = 1, Category = "Logging")]
    [Throws("LogEventError")]
    public class LogEventToFile : ActionBase
    { 
        [InputArgument]
        public string LogFileName { get; set; }

        [InputArgument]
        public string LogMessage { get; set; }

        [OutputArgument]
        public bool StatusCode { get; set; }
    
        public override void Execute(ActionContext context)
        {
            try
            {           
                    // To append all of the text to the file
                    File.AppendAllText(LogFileName, LogMessage);
                    StatusCode = true;  
            }
            catch (Exception e)
            {
                if (e is ActionException) throw;

                throw new ActionException("LogEventError", e.Message, e.InnerException);
            }
        }
    }
}

リソース: この表には、Resources.resx のパラメータの説明とフレンドリ名がリストされています。

件名	価値	Comment
LogEventToFile_Description	提供されたファイルにメッセージを記録するカスタムアクション	アクションの説明
LogEventToFile_FriendlyName	LogEventToFile	Action name
LogEventToFile_LogFileName_Description	テキストターゲットの入力パラメータ	アクション入力の説明
LogEventToFile_LogFileName_FriendlyName	LogFileName	アクション入力名
LogEventToFile_LogFileName_Description	テキストターゲットの入力パラメータ	アクション入力の説明
LogEventToFile_LogMessage_FriendlyName	LogMessage	アクション入力名
LogEventToFile_StatusCode_Description	ブール型の出力パラメータ	アクション出力の説明
LogEventToFile_StatusCode_FriendlyName	LogMessage	Action outputName
ModulesLogEvent_Description	ログイベントを管理するモジュール	モジュールの説明
ModulesLogEvent_FriendlyName	LogEvent	モジュール名

パッケージをビルドしてカスタムアクションをデプロイする

パッケージを作成し、Power Automate にデプロイします。

カスタムアクション DLL ファイルに署名できるようにデジタル証明書を取得します。

重要

自己署名証明書はテスト目的のみに使用され、運用環境での使用はお勧めできません。環境内でカスタムアクションを組織的に展開するには、組織のガイドラインに従った信頼できるデジタル証明書を使用することをお勧めします。

チップ

組織全体でデスクトップ用 Power Automate のカスタムアクションを開発および使用するプロセスを合理化するには、SCCM/Appstore を通じて配布されるデスクトップ用 Power Automate インストーラーに信頼できるデジタル証明書をバンドルできます。 > これにより、デスクトップ用 Power Automate を必要とする作成者と無人ランタイムマシンの両方に、追加のアクションを必要とせずに証明書を自動的にインストールできるようになります。

この例では、自己署名証明書が使用されます。
1. このスクリプトを使用して自己署名証明書を作成します。
```
$certPFXFileName="C:\PADCustomAction\PADCustomActionCert.pfx";
$certCERFileName="C:\PADCustomAction\PADCustomActionCert.cer";
$certStoreLocation="Cert:\LocalMachine\AuthRoot";
$certname = "PADCustomActionSelfSignCert"
##Create certificate
$cert = New-SelfSignedCertificate -CertStoreLocation Cert:\CurrentUser\My -Type CodeSigningCert  -Subject "CN=$certname" -KeyExportPolicy Exportable -KeySpec Signature -KeyLength 2048 -KeyAlgorithm RSA -HashAlgorithm SHA256
$mypwd = ConvertTo-SecureString -String <YOUR CERT PASSWORD GOES HERE> -Force -AsPlainText
##Export certificate
$certPFXFile = Export-PfxCertificate -Cert $cert -FilePath $certPFXFileName -Password $mypwd
$certCERFile = Export-Certificate -Cert $cert -FilePath $certCERFileName -Type CERT -Verbose -Force
```
2. このコマンドを使用して、証明書を証明書ストアにインポートします。
```
##Import certificate
Import-Certificate -CertStoreLocation $certStoreLocation -FilePath $certCERFile
```
3. インポートされた証明書が、証明書 Microsoftマネージャーコンソール (MMC) スナップインの 信頼されたルート証明機関>証明書 に表示されることを確認します。
信頼された証明書を使用して DLL ファイルに署名し、作成されたカスタムモジュールを完成させます。このアクティビティに Signtool を使用するには、Visual Studio の開発者コマンドプロンプトを使用します。
```
Signtool sign /f "C:/PADActions/PADCustomActionCert.pfx" /p <YOURCERTPASSWORD> /fd SHA256 "C:/PADActions/PADCustomActionEventLog/Modules.LogEvent.dll"
```
カスタムアクションを展開するには、この PowerShell スクリプトを使用して、パッケージの内容をキャビネットファイル (.cab) に構築します。
```
.\BuildCAB.ps1 "C:/PADActions/PADCustomActionEventLog" "C:/PADActions/PADCustomActionEventLog" PADCustomActionEventLog.cab
```
サンプルスクリプトファイル BuildCAB.ps1 に移動します

Signtool を使用して、生成されたキャビネットファイルに署名します。

Signtool sign /f "C:/PADActions/PADCustomActionCert.pfx" /p <YOURCERTPASSWORD> /fd SHA256 "C:/PADActions/PADCustomActionEventLog/PADCustomActionEventLog.cab"

Power Automate カスタムアクションセクションに移動して、作成したカスタムアクションをアップロードします。名前、説明、およびキャビネットファイルを入力して、アップロードを選択します。

アクションが正常にアップロードされたら、通知を受信します。

これらの手順に従って、カスタムアクションモジュールがキャビネットファイルにパッケージ化され、信頼できる証明書で署名されます。さらに、カスタムアクションキャビネットファイルは、Power Automate のカスタムアクションライブラリにアップロードされます。

詳細: カスタムアクションをアップロードする

デスクトップ用 Power Automate を使用してデスクトップフローでカスタムアクションアクティビティを使用する

新しいデスクトップフローを作成し、デザイナーで アセットライブラリ を選択します。
アセットライブラリで利用可能なカスタムアクションを調べます。以前に作成され、Power Automate のカスタムアクションセクションにアップロードされたアクションに注目してください。

追加を選択して、このカスタムアクションをデザイナーの アクション セクションに追加します。
カスタムアクションが正常に追加されたことを検証します。デスクトップ用 Power Automate の アクション 検索バーで検索します。
カスタムアクションをドラッグするか、ダブルクリックしてデスクトップフローに追加します。
入力パラメータと追加の手順を指定して、カスタムアクションをテストします。

カスタムアクションを使用したサンプルデスクトップフロー。
フローをテストして、カスタムアクションがリアルタイムで動作していることを確認します。

注意

キャビネットファイルの署名に使用される証明書を、カスタムアクションを含むデスクトップフローの構築に使用されるマシンと、デスクトップフローを実行する各ランタイムマシンにインポートします。

これらの手順に従って、カスタムアクションが作成され、モジュールがキャビネットファイルにパッケージ化され、信頼できる証明書で署名され、Power Automate のカスタムアクションライブラリにアップロードされ、正常に実行されるかどうかテストされたカスタムアクションを使用するためのデスクトップフロー。

カスタムアクションを更新して再デプロイする

次の手順に従って、カスタムアクションの機能を更新して、更新された機能を反映します。

新しいアクション機能で、クラスファイル Visual Studio ソリューションをを更新します。詳細: 更新された .NET モジュールソリューション

図に示すように、3 番目の入力パラメータを受け入れるようにクラスファイルの署名を変更しました。

using System;
using System.IO;
using Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK;
using Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK.Attributes;

namespace ModulesLogEvent
{
 [Action(Id = "LogEventToFile" , Order = 1, Category = "Logging")]
 [Throws("LogEventError")]
 public class LogEventToFile : ActionBase
 { 
     [InputArgument]
     public string LogFileName { get; set; }

     [InputArgument]
     public string LogMessage { get; set; }

     [InputArgument]
     public string LogLevel { get; set; }

     [OutputArgument]
     public bool StatusCode { get; set; }

     public override void Execute(ActionContext context)
     {
         try
         {
                 // To append all of the text to the file
                 File.AppendAllText(LogFileName, LogLevel + ": " + LogMessage);
                 StatusCode = true;
         }
         catch (Exception e)
         {
             if (e is ActionException) throw;

             throw new ActionException("LogEventError", e.Message, e.InnerException);
         }
     }
  }
}

DLL ファイルに署名し、キャビネットファイルを作成し、キャビネットファイルに署名し、キャビネットファイルを Power Automate のカスタムアクションセクションにアップロードする場合は、前に説明したのと同様の手順を使用します。詳細: パッケージをビルドしてカスタムアクションをデプロイする

注意

このアクションを含むデスクトップフローは新しい機能で更新されるため、更新されたカスタムアクションキャビネットファイルをアップロードする前に、必ずこの変更の影響を分析してください。
必要に応じてデスクトップフローを更新します。

更新機能を検証するために、カスタムアクションに 3 番目の入力パラメータを追加しました。カスタムアクションアクティビティはデザイナーでエラーとしてマークされており、新しい入力パラメータで更新する必要があることに注意してください。
フローをテストして、リアルタイムで動作しているカスタムアクションがを更新されたことを確認します。

このセクションでは、デスクトップ用 Power Automate カスタムアクションの更新済み機能を更新し、パッケージを構築して、Power Automate にデプロイし、デスクトップフローをリファクタリングし、カスタムアクションの更新された機能を使用してデスクトップフローを実行することで機能を検証しました。

Share via

デスクトップ用の Power Automate でカスタムアクションを構築する方法

概要

前提条件

独自のカスタムアクションを作成する

アクションの参考となる情報

パッケージをビルドしてカスタムアクションをデプロイする

デスクトップ用 Power Automate を使用してデスクトップフローでカスタムアクションアクティビティを使用する

カスタムアクションを更新して再デプロイする

その他のリソース

Share via

デスクトップ用の Power Automate でカスタム アクションを構築する方法

概要

前提条件

独自のカスタム アクションを作成する

アクションの参考となる情報

パッケージをビルドしてカスタム アクションをデプロイする

デスクトップ用 Power Automate を使用してデスクトップ フローでカスタム アクション アクティビティを使用する

カスタムアクションを更新して再デプロイする

その他のリソース

デスクトップ用の Power Automate でカスタムアクションを構築する方法

独自のカスタムアクションを作成する

パッケージをビルドしてカスタムアクションをデプロイする

デスクトップ用 Power Automate を使用してデスクトップフローでカスタムアクションアクティビティを使用する