RPA之PAD(Power Automate Desktop)組件開發

本文由網友藍創精英團隊投稿，歡迎轉載、分享
原文作者：藍創精英團隊
原文鏈接：https://blog.csdn.net/i2blue/article/details/125040323

其實，PAD，現在官方文檔還沒有對外組件式或者插件式開發接口。

但是，有一些志同道合的朋友，比如(潘淳)，潘總大佬，在RPA領域，還是很牛逼的。

只要有一扇門，就會有一個世界，現在已經有了一扇門(畢竟是.Net Framework，那么，研究借鑒就容易多了)。

組件開發環境

默認組件的位置是在當前應用下的這個目錄

C:\Program?Files?(x86)\Power?Automate?Desktop\custom-modules

應用地址，按照你自己的來。

另外，插件的DLL，是需要DLL 代碼簽名了。

默認采用個人簽名，放到系統受信任的根證書頒發機構即可。

如果有錢，可以買個代碼簽名。

目前，我這邊還沒別的好的方式，其中，簽名大致分為兩種，一種是域名證書SSL，和代碼簽名，它們之間是不一樣的，不能混用。

大致目錄如下:

最簡單的Demo

準備直接按照開發流程走一遍，最后，再總結。

新建空白解決方案

默認新增一個解決方案（空的解決方案）

新增組件庫

組件DLL名要滿足以下規則

"?*.Modules.?*.dll",
"Modules.?*.dll"

而，官方的組件包是這樣子的

Microsoft.Flow.RPA.Desktop.Modules.System.Actions.dll

所以，我這邊也按照官方的標準走。

就叫 YZG.Modules.HelloWorld.Actions（注：需要注意的是，像 demo,test等名字，可能會導致識別不出來的問題，所以，建議起一些特殊的名字。）

打招呼組件項目

默認方案從打招呼開始

引用開發DLL包

然后，引用安裝目錄 C:\Program Files (x86)\Power Automate Desktop

下的這幾個DLL包

Microsoft.Flow.RPA.Desktop.Modules.SDK.dllMicrosoft.Flow.RPA.Desktop.Modules.SDK.Extended.dll

當然，如果你用的過程中，提示，需要哪個包，你也可以引入進來。

引入完，效果如下：

增加打招呼邏輯

以下就是全部邏輯代碼

[Action(Id?=?"SayHello")]
[Icon(Code?=?"EFF7")]
[Throws("MyError")]
public?class?SayHello?:?ActionBase
{[InputArgument]public?string?UserName?{?get;?set;?}????[OutputArgument]public?string?Result?{?get;?set;?}public?override?void?Execute(ActionContext?context){try{this.Result?=?$"{UserName}?你好，中國歡迎你！?-{DateTime.Now}";}catch?(ActionException?ex){throw?new?ActionException("MyError",?ex.Message,?ex.InnerException);}}
}

增加國際化支持

也不用增加外語，直接增加中文支持就可以了

首先，我們增加一個中文的資源文件(另外可以參考官網路徑下的語言包來看內部結構分析)

下圖幀數大于300（重新錄制部分，有興趣查看原文看完整gif)

組件顯示大致規則

組件的名字從哪里來

是從程序集信息里的AssemblyTitle來的，這個名字默認是英文，但是，也可以漢化的。

另外這個名字最好和組件Action的名字不一致。這樣，顯示會方便點

組件內容的顯示大致規則

通過對 組件名 或者 類型 以及 類屬性 分割。

增加

_FriendlyName
_Description
_Summary

其中 FriendlyName 就是各種組件的主名稱，Description就是提示語相當于，Summary就是關鍵信息，作用還是很明顯的，內部使用了模板引擎變量 < 屬性名大寫 >來動態顯示一些信息。

大體示例如下:

Close_Connection_Description?=?"新?SQL?連接的句柄"
Close_Connection_FriendlyName?=?"SQL?連接"
Close_Description?=?"關閉與數據庫的開放連接"
Close_FriendlyName?=?"關閉?SQL?連接"
Close_Summary?=?"關閉?SQL?連接?<CONNECTION>"
ConnectAndExecute_Description?=?"連接到數據庫并執行?SQL?語句"
ConnectAndExecute_Summary?=?"<if(RESULT)>\r\n執行?SQL?語句?<STATEMENT>?并將查詢結果存儲到?<RESULT>?中<else>\r\n執行?SQL?語句?<STATEMENT><endif>"
Connect_ConnectionString_Description?=?"用于連接到數據庫的連接字符串"
Connect_ConnectionString_FriendlyName?=?"連接字符串"
Connect_Connection_Description?=?"新?SQL?連接的句柄"
Connect_Connection_FriendlyName?=?"SQL?連接"
Connect_Description?=?"打開與數據庫的新連接"
Connect_FriendlyName?=?"打開?SQL?連接"
Connect_Summary?=?"<if(CONNECTION)>\r\n打開?SQL?連接?<CONNECTIONSTRING>?并將其存儲到?<CONNECTION>?中<else>\r\n打開?SQL?連接?<CONNECTIONSTRING><endif>"
Database_Description?=?"連接到數據庫并執行?SQL?語句"
Database_FriendlyName?=?"數據庫"
ErrorMessage_CannotConnect?=?"無法連接到數據源"
ErrorMessage_CannotConnectError?=?"無法連接到數據源?{0}"
ErrorMessage_InvalidConnectionString?=?"連接字符串無效"
ErrorMessage_StatementError?=?"SQL?語句中的錯誤?{0}"
ErrorMessage_UniniatializedConnection?=?"SQL 連接未初始化。請仔細檢查是否已指定正確的 SQL 連接，且該連接在“打開 SQL 連接”之后(而不是在已關閉該連接之后)使用"
Error_ConnectToDataSourceError_Description?=?"指示連接到數據源時出現問題"
Error_ConnectToDataSourceError_FriendlyName?=?"無法連接到數據源"
Error_InvalidConnectionStringError_Description?=?"指示指定的連接字符串無效"
Error_InvalidConnectionStringError_FriendlyName?=?"連接字符串無效"
Error_SqlStatementError_Description?=?"指示給定的?SQL?語句中存在錯誤"
Error_SqlStatementError_FriendlyName?=?"SQL?語句中的錯誤"
ExecuteSqlStatement_ConnectionString_Description?=?"用于連接到數據庫的連接字符串"
ExecuteSqlStatement_ConnectionString_FriendlyName?=?"連接字符串"
ExecuteSqlStatement_Connection_Description?=?"新?SQL?連接的句柄"
ExecuteSqlStatement_Connection_FriendlyName?=?"SQL?連接"
ExecuteSqlStatement_Description?=?"連接到數據庫并執行?SQL?語句"
ExecuteSqlStatement_FriendlyName?=?"執行?SQL?語句"
ExecuteSqlStatement_GetConnection_Description?=?"指定是從給定連接字符串創建新連接，還是選擇已打開的連接"
ExecuteSqlStatement_GetConnection_FriendlyName?=?"獲取連接的方式"
ExecuteSqlStatement_Result_Description?=?"來自數據庫的結果，采用數據表的形式，包含行和列"
ExecuteSqlStatement_Result_FriendlyName?=?"查詢結果"
ExecuteSqlStatement_Statement_Description?=?"要對數據庫執行的?SQL?語句"
ExecuteSqlStatement_Statement_FriendlyName?=?"SQL?語句"
ExecuteSqlStatement_Timeout_Description?=?"等待來自數據庫的結果的最長時間"
ExecuteSqlStatement_Timeout_FriendlyName?=?"超時"
Execute_Description?=?"連接到數據庫并執行?SQL?語句"
Execute_Summary?=?"<if(RESULT)>\r\n對?<CONNECTION>?執行?SQL?語句?<STATEMENT>?并將查詢結果存儲到?<RESULT>?中<else>\r\n對?<CONNECTION>?執行?SQL?語句?<STATEMENT><endif>"
GetSQLConnectionBy_ConnectionString_FriendlyName?=?"連接字符串"
GetSQLConnectionBy_SQLConnectionVariable_FriendlyName?=?"SQL?連接變量"
Message_SqlConnection?=?"SQL?連接"
SqlConnectionHandle_FriendlyName?=?"SQL?連接"
SqlConnectionHandle_FriendlyNamePlural?=?"SQL?連接"

參考如上信息，接下來，我們對打招呼程序進行中文內容填充。