共用方式為


IA-Connect 動態程式碼 (預覽版)

IA-Connect 是一個機器人流程自動化“RPA”平台,它將 RPA 功能從雲添加到本地虛擬機或通過 Citrix 或 Microsoft 遠程桌面“RDS”連接。 這是開發動態程式碼模組的模組。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 創世紀實驗室
URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
連接器中繼資料
Publisher 創世紀商業
網站 https://www.ultima.com/ultima-labs
隱私策略 https://www.ultima.com/privacy-policy
類別 IT運營;生產力

IA-Connect 是一個機器人流程自動化 (RPA) 平台,可將 RPA 功能從 Power Automate 雲端流程新增至內部部署虛擬機器,或透過 Citrix 或 Microsoft 遠端桌面 (RDS) 連線。 IA-Connect 連接器提供超過 800 個動作,可讓您直接從 Power Automate 雲端流程自動化每種類型的內部部署應用程式。 所有 IA-Connect 動作都可以直接從 Power Automate 雲端流程取得,從而在雲端型應用程式和內部部署應用程式之間輕鬆整合,並能夠在 RPA 流程中利用現有的 Power Automate 條件、迴圈、動態內容、運算式和例外狀況處理。 利用 IA-Connect Connectors 還可以從 Flow 執行歷史記錄中提供完整的執行歷史記錄和可審計性,同時也無需使用單獨的應用程式/控制台/工作室來開發 RPA 流程。

先決條件

若要使用任何 IA-Connect 連接器,您必須安裝 IA-Connect 軟體。 這是 30 天的免費測試,之後您將需要 IA-Connect 許可證。

IA-Connect 軟體由兩個主要組件組成:

  • IA-Connect Orchestrator,這是 Azure WebApp,您將在自己的 Azure 租用戶中裝載。 這會處理 RPA 流程到一或多個內部部署或雲端虛擬機器的路由和安全性。

  • IA-Connect 代理程式和導向器,安裝在可存取您要自動化軟體的虛擬機器上。 此外,IA-Connect 代理程式可以在 Citrix 或 Microsoft 遠端桌面服務 (RDS) 工作階段內執行,其中 RPA 命令會透過虛擬通道傳遞到遠端工作階段中以執行。 IA-Connect 代理程式可以從網路共用執行,而且不需要安裝。

可用的 IA-Connect 連接器

可用的 IA-Connect 連接器包括:

  • IA-Connect 動態程式碼
  • IA-Connect 爪哇
  • IA-Connect JML
  • IA-Connect 大型主機
  • IA-Connect Microsoft辦公室
  • IA-Connect SAP GUI
  • IA-Connect 場
  • IA-Connect 使用者介面
  • IA-Connect 網頁瀏覽器

如何取得認證

為了獲得您的許可證並開始您的 30 天免費試用,請在我們的網站上提交請求 (https://www.ultima.com/IA-Connect/Power-Automate)。

收到試用請求後,我們將透過提供的電子郵件地址與您聯繫,以協助設定 IA-Connect 軟體並為您提供試用授權。 這是一個功能齊全的試用版,可讓您在試用期內測試自己環境中所有 9 個 IA-Connect Connector 的 800 個動作中的任何一個。

開始使用連接器

提交 IA-Connect 試用請求後,您將能夠下載包含 IA-Connect 軟件以及涵蓋安裝和設置的文件的 ZIP 文件。 我們還將根據需要與您聯繫,在安裝過程中提供支援和指導。

Support

在試用期間,您可以聯絡 Ultima Labs (IAConnect@ultima.com) 尋求支援和協助。

購買 IA-Connect 許可證後,您將收到支持代幣,這些代幣可以兌換 Ultima 位於英國的技術服務中心 (TSC) 的定制培訓或支持。

已知問題、常見錯誤和常見問題

我們的知識庫包含許多文章,涵蓋任何已知問題、使用 IA-Connect 連接器時可能發生的常見錯誤以及常見問題。 這可在 IA-Connect 試 https://support.ultima.com/ultimalabs 用期間和購買 IA-Connect 許可證時訪問,並提供訪問這些資源的帳戶。

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
API 金鑰 securestring 此 API 的 API 金鑰
IA-Connect Orchestrator 位址 字串 指定不含 HTTP(S) 元件的 IA-Connect Orchestrator 位址

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

IA-Connect 查閱資料表的查閱值

從 Orchestrator 查閱表格 (適用於使用 Orchestrator 的自動化) 或目前載入到 IA-Connect Agent 的查閱表格中,從符合輸入資料的第一列擷取值。 如果 Orchestrator 具有與載入 IA-Connect Agent 的查詢表格同名的查閱表格,則會使用 Orchestrator 查閱表格 (如果自動化正在通過 Orchestrator)。

使用正規表示式分割字串

使用正規表示式 (regex) 比對來分割輸入字串,並將字串的個別分割元件傳回為字串陣列。

取得 IA-Connect Orchestrator 查閱表格內容

從 Orchestrator 上保留的 IA-Connect Orchestrator 查閱表格擷取所有資料。 這不會擷取 IA-Connect Agent 處理的查閱表格 (磁碟上保存的 CSV 檔案)。

取得 IA-Connect 查詢表摘要

擷取目前載入到 IA-Connect Agent 中的查閱表格的摘要。

取得 IA-Connect 清單內容

從 IA-Connect Orchestrator 清單擷取所有資料。

取得 PowerShell 版本

取得執行 IA-Connect Agent 之會話中的 PowerShell 版本。 這會偵測 Microsoft PowerShell v3.x 到 v5.x,而不是 PowerShell 核心 (6.x 以上版本)。

取得 string

採用輸入字串,並傳回位於兩個指定字串之間或字串與行尾之間的字串的第一個實例。

取得正則運算式比對

對輸入字串執行正規表示式 (regex) 比對,並傳回字串是否符合比對的運算式和詳細資料。

取得正則運算式相符專案

對輸入字串執行正則運算式 (regex) 比對,並傳回字串陣列中的所有相符專案。 如果沒有相符項,陣列將是空的。

取得正規表示式群組相符專案

對輸入字串執行規則運算式 (regex) 比對,並傳回相符的群組名稱和值清單。

執行 PowerShell 腳本

在執行 IA-Connect Agent 的工作階段中執行 PowerShell 指令碼,其中指令碼內容會傳遞至 'PowerShell 指令碼內容' (PowerShellScriptContents) 輸入中的 IA-Connect Agent。 這是執行您自己的自訂 PowerShell 程式碼的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。 代理程式會使用 Microsoft PowerShell v3.x 到 v5.x (以安裝的版本為準) 執行 PowerShell,而不是 PowerShell 核心 (6.x 以上版本)。

將 CSV 上傳至 IA-Connect Orchestrator 查閱表格

將取代的 CSV 資料上傳至 IA-Connect Orchestrator 查閱表格,以取代任何現有的內容。 此動作不會與 IA-Connect Agent 處理的查閱表格 (磁碟上保存的 CSV 檔案) 互動。

將 CSV 上傳至 Orchestrator 清單 IA-Connect

將取代的 CSV 資料上傳至 IA-Connect Orchestrator 清單,取代任何現有的內容。

將資料列插入 JSON 資料表

取得 JSON 格式的輸入資料表,在指定位置插入資料列,並傳回 JSON 格式的新資料表。 如果您想要將資料列插入實際表格(即不是 JSON 格式),請使用「將資料列插入表格」動作。 如果要將字串插入字串陣列,請使用「將資料列插入字串陣列」動作。

將資料列插入字串陣列

取得字串項目的輸入陣列,在指定位置插入資料列,並傳回新的陣列。 如果您想要在表格中插入資料列,請使用「在資料表中插入資料列」動作。 如果您想要以 JSON 格式將資料列插入資料表,請使用「將資料列插入 JSON 資料表」動作。

將資料列插入表格

取得輸入表格,在指定位置插入資料列,並傳回新表格。 如果要將字串插入字串陣列,請使用「將資料列插入字串陣列」動作。 如果您想要以 JSON 格式將資料列插入資料表,請使用「將資料列插入 JSON 資料表」動作。

將輸入變數列插入 JSON 表格

取得 JSON 格式的輸入資料表,在指定位置插入從輸入變數建立的資料列,並傳回 JSON 格式的新資料表。 輸入資料列結構描述應符合輸入資料表的結構描述 (,即使用相同的屬性名稱和資料類型)。 如果您想要將資料列插入實際表格(即不是 JSON 格式),請使用「將資料列插入表格」動作。 如果要將字串插入字串陣列,請使用「將資料列插入字串陣列」動作。

將陣列轉換為JSON

採用輸入陣列並序列化為 JSON 字串。

從 JSON 取得資料表

採用 JSON 格式的輸入資料表,並傳回為資料表。 這稱為還原序列化。

從 JSON 表格儲存格取得字串

採用 JSON 格式的輸入表格,並將指定的儲存格傳回為字串。

從 JSON 資料表中刪除資料列

取得 JSON 格式的輸入資料表,刪除指定位置的一或多個資料列,並傳回 JSON 格式的新資料表。 如果您想要從實際表格中刪除一或多個列(即不是 JSON 格式),請使用「從表格中刪除一列」動作。 如果您想要從字串陣列中刪除一或多個列,請使用「從字串陣列中刪除一列」動作。

從 JSON 資料表中刪除資料行

取得 JSON 格式的輸入資料表,刪除一或多個資料行,並傳回 JSON 格式的新資料表。 如果您想要從實際資料表中刪除資料行 (即不是 JSON 格式),請使用「從資料表中刪除資料行」動作。

從 JSON 資料表資料行取得字串陣列

採用 JSON 格式的輸入表格,並將指定的資料行傳回為字串陣列。 如果您想從實際表中獲取字符串數組(即不是 JSON 格式),請使用“從表獲取數組”操作。

從字串中刪除字符

取得輸入字串,並傳回已移除指定字元的字串。 如果找不到指定的字元,則會傳回原始字串。

從字串陣列中刪除項目

取得字串項目的輸入陣列,刪除指定位置的一個或多個項目,並傳回新的陣列。 如果您想要從表格中刪除一或多個列,請使用「從表格中刪除一列」動作。 如果您想要從 JSON 格式的資料表中刪除一或多個資料列,請使用「從 JSON 資料表刪除資料列」動作。

從字串陣列取得 JSON 表格

取得字串項目的輸入陣列,並傳回為 JSON 資料表。

從字串陣列取得表格

取得字串項目的輸入陣列,並傳回為資料表。

從本機檔案匯入組合件

將 DotNet 元件從執行 IA-Connect Director 的電腦上傳至 IA-Connect Agent,將其載入記憶體中,並在動態 DotNet 程式碼參考時使用。

從查閱表格查閱資料儲存格 IA-Connect

從 Orchestrator 查閱表格 (適用於使用 Orchestrator 的自動化) 從符合輸入資料的第一列擷取所有資料儲存格,並傳回為表格。 此動作不支援載入 IA-Connect Agent 的查閱表格。

從查閱資料表查閱資料 IA-Connect 資料行

從符合輸入資料的第一列,從 Orchestrator 查閱表格 (適用於使用 Orchestrator 的自動化) 或目前載入 IA-Connect Agent 的查閱表格中擷取一或多個同名資料行,並以表格形式傳回。 例如,查閱表格可以包含多個名為「AD group」的輸出資料行,以代表多個 AD 群組,而且它們會在輸出資料表中傳回為個別資料列。 如果 Orchestrator 具有與載入 IA-Connect Agent 的查詢表格同名的查閱表格,則會使用 Orchestrator 查閱表格 (如果自動化正在通過 Orchestrator)。

從清單中取得資料 IA-Connect

從 IA-Connect Orchestrator 清單擷取資料行。

從表格中刪除資料列

取得輸入資料表,刪除指定位置的一或多個資料列,並傳回新資料表。 如果您想要從字串陣列中刪除一或多個列,請使用「從字串陣列中刪除一列」動作。 如果您想要從 JSON 格式的資料表中刪除一或多個資料列,請使用「從 JSON 資料表刪除資料列」動作。

從表格中刪除資料行

取得輸入資料表,刪除一或多個資料行,並傳回新資料表。 如果您想要從 JSON 格式的資料表中刪除資料行,請使用動作 [從 JSON 資料表刪除資料行]。

從表格欄取得字串陣列

取得輸入資料表,並將指定的資料行傳回為字串陣列。 如果您想要從 JSON 格式的資料表取得字串陣列,請使用動作「從 JSON 資料表取得陣列」。

從輸入變數建立JSON

採用輸入變數陣列,並以 JSON 格式傳回,並選擇性地以 JSON 表格形式傳回。

排序 JSON 表格

取得輸入 JSON 資料表,對資料表進行排序,並傳回新的 JSON 資料表。 如果您想要對實際表格進行排序(即不是 JSON 格式),請使用「排序表格」動作。 如果您想要對字串陣列進行排序,請使用「排序字串陣列」動作。

排序字串陣列

取得字串項目的輸入陣列,對陣列進行排序,並傳回新的陣列。 如果您想要對表格進行排序,請使用「排序表格」動作。 如果您想要以 JSON 格式排序表格,請使用「排序 JSON 表格」動作。

排序表格

取得輸入資料表,排序一或多列,並傳回新資料表。 如果您想要以 JSON 格式排序表格,請使用「排序 JSON 表格」動作。 如果您想要對字串陣列進行排序,請使用「排序字串陣列」動作。

新增組件搜尋資料夾

將資料夾路徑 (在執行 IA-Connect Agent 的電腦上) 新增至資料夾清單,以便 IA-Connect Agent 在嘗試載入外部參照時進行掃描。

是否已安裝 PowerShell 模組

在執行 IA-Connect Agent 的電腦上搜尋指定的 PowerShell 模組,並傳回是否已安裝。

是否已安裝 PowerShell 自動化

報告執行 IA-Connect 代理程式的電腦上是否提供 PowerShell 自動化。 如果無法使用 PowerShell 自動化,PowerShell 自動化動作將無法運作。

清除組合搜尋資料夾

重設 IA-Connect Agent 在嘗試載入外部參照時要掃描的其他資料夾清單。

移除 IA-Connect 查閱表格

移除目前載入到 IA-Connect Agent 中的查閱表格。

移除所有 IA-Connect 查詢表格

移除目前載入到 IA-Connect Agent 中的所有查閱表格。

篩選 JSON 資料表

取得輸入 JSON 資料表、篩選資料表 (使用 .NET DataView 資料列篩選語法) ,並傳回新的 JSON 資料表。 如果您想要篩選實際表格(即不是 JSON 格式),請使用「過濾表格」動作。 如果您想要過濾字串陣列,請使用「過濾字串陣列」動作。

篩選字串陣列

取得字串項目的輸入陣列、篩選陣列 (使用 .NET DataView 資料列篩選語法) ,並傳回新的陣列。 如果您想要篩選表格,請使用「篩選表格」動作。 如果您想要以 JSON 格式篩選表格,請使用動作「篩選 JSON 表格」。

篩選表

取得輸入資料表、篩選資料表 (使用 .NET DataView 資料列篩選語法) ,並傳回新資料表。 如果您想要以 JSON 格式篩選表格,請使用動作「篩選 JSON 表格」。 如果您想要過濾字串陣列,請使用「過濾字串陣列」動作。

載入 IA-Connect 查詢表

從執行 IA-Connect Agent 的電腦載入 IA-Connect 查閱表格。 進一步 IA-Connect 動作可以使用這些查閱表格來執行資料查閱。

重新命名 JSON 資料表中的資料行

採用 JSON 格式的輸入資料表、重新命名指定的資料行,並傳回 JSON 格式的新資料表。 如果您想要從實際表格重新命名資料行 (即不是 JSON 格式),請使用動作「重新命名資料表中的資料行」。

重新命名表格中的資料行

取得輸入資料表、重新命名指定的資料行並傳回新資料表。 如果您想要以 JSON 格式重新命名資料表中的資料行,請使用動作 '重新命名 JSON 資料表中的資料行'。

IA-Connect 查閱資料表的查閱值

從 Orchestrator 查閱表格 (適用於使用 Orchestrator 的自動化) 或目前載入到 IA-Connect Agent 的查閱表格中,從符合輸入資料的第一列擷取值。 如果 Orchestrator 具有與載入 IA-Connect Agent 的查詢表格同名的查閱表格,則會使用 Orchestrator 查閱表格 (如果自動化正在通過 Orchestrator)。

參數

名稱 機碼 必要 類型 Description
查閱表格名稱
LookupTableName True string

載入到 IA-Connect Agent 的 Orchestrator 查閱表格或查閱表格的名稱。

輸入資料JSON
InputDataJSON string

以 JSON 格式輸入要用於查閱的資料。 例如,如果查閱表格具有 'JobTitle' 和 'Country' 屬性欄,您可以提交下列 JSON:{ “JobTitle”: “Consultant”, “Country”: “England” }。

搜尋結果值欄名稱
SearchResultValueColumnName True string

查閱資料表中的資料行,其中包含要讀取的傳回值。

搜尋結果值資料行索引
SearchResultValueColumnIndex integer

如果設定為 1 (預設值),則會傳回符合所要求名稱的第一個結果欄中的值。 設定為較高的值 (N) 以傳回第 N 個相符欄。

如果沒有相符項,則引發例外狀況
RaiseExceptionIfNoMatch boolean

設定為 true (預設值),以在查閱不符合任何資料時引發例外狀況。 設定為 false ,如果查閱不符合任何資料,則傳回空白字串。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
輸出查閱值
OutputLookupValue string

指定查閱表格直欄的輸出值,透過根據 IA-Connect 查閱表格查閱輸入資料而取得。

使用正規表示式分割字串

使用正規表示式 (regex) 比對來分割輸入字串,並將字串的個別分割元件傳回為字串陣列。

參數

名稱 機碼 必要 類型 Description
輸入要分割的文字
TextToSplit True string

要根據規則運算式分割的輸入文字。

正規表示式
Regex True string

要分割輸入文字的正規表示式。

區分大小寫分割
CaseSensitive boolean

對於區分大小寫的拆分,請設定為 true (預設值) (例如,A 不是 a),對於不區分大小寫的拆分,請設定為 false (例如,A 和 a 被視為相同)。

修剪結果
TrimResults boolean

如果應該修剪每個個別的輸出陣列元素,請設定為 true (預設值)。

移除空白結果
RemoveEmptyResults boolean

如果應從輸出數組中刪除空的輸出數組元素(即您不想要空結果),則設定為 true。

正則運算式逾時(以秒為單位)
RegexTimeoutInSeconds integer

逾時之前可以處理正規表示式的秒數上限。這會停止由某些正則表達式引起的無限循環。

傳回

名稱 路徑 類型 Description
輸出陣列
OutputArray array of object

包含字串各個元件的輸出字串陣列,使用正則運算式進行分割。

items
OutputArray object
輸出中的元素數
NumberOfElementsInOutput integer

輸出陣列中的元素數目。

取得 IA-Connect Orchestrator 查閱表格內容

從 Orchestrator 上保留的 IA-Connect Orchestrator 查閱表格擷取所有資料。 這不會擷取 IA-Connect Agent 處理的查閱表格 (磁碟上保存的 CSV 檔案)。

參數

名稱 機碼 必要 類型 Description
查閱表格名稱
LookupTableName True string

Orchestrator 查閱表格的名稱。

傳回格式
ReturnFormat string

傳回結果時要使用的格式。

傳回

名稱 路徑 類型 Description
輸出查閱表格JSON
OutputLookupTableJSON string

查閱表格的輸出資料,採用 JSON 格式。

輸出查閱表格
OutputLookupTable array of object

查閱表格的輸出資料,採用資料表格式。

items
OutputLookupTable object
輸出查閱表格CSV
OutputLookupTableCSV string

查閱表格的輸出資料,以 CSV 格式。

輸出中的列數
NumberOfRowsInOutput integer

輸出中的列數。

輸出中的欄數
NumberOfColumnsInOutput integer

輸出中的欄數。

取得 IA-Connect 查詢表摘要

擷取目前載入到 IA-Connect Agent 中的查閱表格的摘要。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
查閱表格 JSON
LookupTablesJSON array of object

載入到 IA-Connect 代理程式中的查詢表格。

名稱
LookupTablesJSON.Name string
然後資料行索引
LookupTablesJSON.ThenColumnIndex integer
列數
LookupTablesJSON.NumberOfRows integer
資料行數
LookupTablesJSON.NumberOfColumns integer
NumberOfUniqueHeader屬性
LookupTablesJSON.NumberOfUniqueHeaderProperties integer
查詢表格數目
NumberOfLookupTables integer

目前載入到 IA-Connect Agent 中的查詢表格數目。

取得 IA-Connect 清單內容

從 IA-Connect Orchestrator 清單擷取所有資料。

參數

名稱 機碼 必要 類型 Description
清單名稱
ListName True string

Orchestrator 清單的名稱。

傳回格式
ReturnFormat string

傳回結果時要使用的格式。

傳回

名稱 路徑 類型 Description
輸出清單JSON
OutputListJSON string

清單中的輸出資料,採用 JSON 格式。

輸出清單
OutputList array of object

清單中的輸出資料,採用資料表格式。

items
OutputList object
輸出清單CSV
OutputListCSV string

清單中的輸出資料,以 CSV 格式。

輸出中的列數
NumberOfRowsInOutput integer

輸出中的列數。

輸出中的欄數
NumberOfColumnsInOutput integer

輸出中的欄數。

取得 PowerShell 版本

取得執行 IA-Connect Agent 之會話中的 PowerShell 版本。 這會偵測 Microsoft PowerShell v3.x 到 v5.x,而不是 PowerShell 核心 (6.x 以上版本)。

參數

名稱 機碼 必要 類型 Description
電腦名稱
ComputerName string

要檢查 PowerShell 版本的電腦名稱。 如果留空,則會使用執行 IA-Connect Agent 的電腦。

驗證機制
AuthenticationMechanism string

連線到遠端電腦或以替代使用者身分執行腳本時要使用的驗證機制。 支援的值為 'Basic'、'Credssp'、'Default'、'Digest'、'Kerberos' 和 'Negotiate'。

連線嘗試
ConnectionAttempts integer

連線到遠端電腦時要嘗試的連線數目。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 主要版本
PowerShellMajorVersion integer

PowerShell 的主要 (整數) 版本。 例如:PowerShell 5.1 會傳回 5。

PowerShell 次要版本
PowerShellMinorVersion integer

PowerShell 的次要 (小數位之後) 版本。 例如:PowerShell 5.1 會傳回 1。

取得 string

採用輸入字串,並傳回位於兩個指定字串之間或字串與行尾之間的字串的第一個實例。

參數

名稱 機碼 必要 類型 Description
輸入字串
InputString string

執行搜尋的輸入字串。

開始搜尋字串
StartSearchString string

開始搜尋字串。

結束搜尋字串
EndSearchString string

結束搜尋字串,如果搜尋到行尾,則保留空白。

逐行搜尋
SearchLineByLine boolean

如果您想要逐行搜尋輸入字串,且結果只包含目前行中的相符字串,請設定為 true。 設定為 false 可將輸入字串視為單一專案。

如果找不到,則擲回例外狀況
ThrowExceptionIfNotFound boolean

如果您想要在找不到搜尋字串時引發例外狀況,請設定為 true,如果動作在找不到搜尋字串時應該傳回 'String between found'=false,請設定為 false。

修剪結果
TrimResult boolean

如果您想要修剪結果之前或之後的空格或定位點,請設定為 true。

搜尋是正則表達式
SearchIsRegularExpression boolean

如果搜尋字串是正規表示式,則設為 true。 如果搜尋字串是一般文字,則設為 false。

區分大小寫的搜尋
CaseSensitiveSearch boolean

如果搜尋應該區分大小寫,請設定為 true。 針對不區分大小寫的搜尋設定為 false。

傳回

名稱 路徑 類型 Description
找到搜尋字串
SearchStringFound boolean

如果「找不到就擲回例外狀況」設定為 false,則如果找到搜尋字串,則此輸出會設定為 true,如果找不到,則會設定為 false。

之間的字串
StringBetween string

在指定字串之間找到的字串。

取得正則運算式比對

對輸入字串執行正規表示式 (regex) 比對,並傳回字串是否符合比對的運算式和詳細資料。

參數

名稱 機碼 必要 類型 Description
輸入要匹配的文字
TextToMatch True string

要與正規表示式相符的輸入文字。

正規表示式
Regex True string

要比對輸入文字的正規表示式。

搜尋索引
SearchIndex integer

要擷取的比對結果索引,從 1 開始。 如果您想要比對第一個結果 (預設行為),請輸入 1。 例如:如果輸入字串預期在 5 個位置符合正則運算式,而您對第 4 個相符專案感興趣,請輸入 4。

區分大小寫的比對
CaseSensitive boolean

對於區分大小寫的匹配項(例如,A 不是 a),設置為 true(默認值),對於不區分大小寫的匹配設置為 false(例如,A 和 a 被視為相同)。

正則運算式逾時(以秒為單位)
RegexTimeoutInSeconds integer

逾時之前可以處理正規表示式的秒數上限。這會停止由某些正則表達式引起的無限循環。

傳回

名稱 路徑 類型 Description
配對成功
SuccessfulMatch boolean

如果有成功的相符專案 (在指定的搜尋索引) ,則為 True,如果沒有,則為 false。

比對字串值
MatchStringValue string

如果有成功的比對,則此字串值會保存符合正則運算式的輸入文字中的文字。

匹配位置指數
MatchIndex integer

如果有成功的比對,此值會保留輸入文字中的位置,以符合比對所在的位置。 此值從 0 開始,代表輸入文字字串的開頭。

比對字串長度
MatchStringLength integer

如果匹配成功,則此值會保存與正則表達式匹配的輸入文本中的文本長度(即輸出值“匹配字符串值”的長度)。

取得正則運算式相符專案

對輸入字串執行正則運算式 (regex) 比對,並傳回字串陣列中的所有相符專案。 如果沒有相符項,陣列將是空的。

參數

名稱 機碼 必要 類型 Description
輸入要匹配的文字
TextToMatch True string

要與正規表示式相符的輸入文字。

正規表示式
Regex True string

要比對輸入文字的正規表示式。

要執行的最多匹配
MaximumMatches integer

要執行的正規表示式相符專案數量上限。 對於無限數量的相符項(即,繼續比對直到不再有相符項),請輸入不輸入值或值 0(預設值)。 此輸入旨在透過限制匹配數量來避免無限的正則表達式循環。

區分大小寫的比對
CaseSensitive boolean

對於區分大小寫的匹配項(例如,A 不是 a),設置為 true(默認值),對於不區分大小寫的匹配設置為 false(例如,A 和 a 被視為相同)。

修剪結果
TrimResults boolean

如果應該修剪每個個別的輸出陣列元素,請設定為 true (預設值)。

移除空白結果
RemoveEmptyResults boolean

如果應從輸出數組中刪除空的輸出數組元素(即您不想要空結果),則設定為 true。

正則運算式逾時(以秒為單位)
RegexTimeoutInSeconds integer

逾時之前可以處理正規表示式的秒數上限。這會停止由某些正則表達式引起的無限循環。

傳回

名稱 路徑 類型 Description
輸出陣列
OutputArray array of object

包含個別正則運算式相符的輸出字串陣列。

items
OutputArray object
輸出中的元素數
NumberOfElementsInOutput integer

輸出陣列中的元素數目。

取得正規表示式群組相符專案

對輸入字串執行規則運算式 (regex) 比對,並傳回相符的群組名稱和值清單。

參數

名稱 機碼 必要 類型 Description
輸入要匹配的文字
TextToMatch True string

要與正規表示式相符的輸入文字。

正規表示式
Regex True string

要比對輸入文字的正規表示式。

要擷取的群組
GroupsToRetrieve array of string

包含要擷取的正規表示式群組名稱的字串陣列。 如果提供空白陣列,則會擷取所有群組。 例如:如果正規表示式包含 (?<NeedsUpdating>(是|No)) 並指定應擷取 'NeedsUpdating' 群組,則會傳回該具名群組的相符值。

搜尋索引
SearchIndex integer

要擷取的比對結果索引,從 1 開始。 如果您想要比對第一個結果 (預設行為),請輸入 1。 例如:如果輸入字串預期在 5 個位置符合正則運算式,而您對第 4 個相符專案感興趣,請輸入 4。

區分大小寫的比對
CaseSensitive boolean

對於區分大小寫的匹配項(例如,A 不是 a),設置為 true(默認值),對於不區分大小寫的匹配設置為 false(例如,A 和 a 被視為相同)。

正則運算式逾時(以秒為單位)
RegexTimeoutInSeconds integer

逾時之前可以處理正規表示式的秒數上限。這會停止由某些正則表達式引起的無限循環。

傳回

名稱 路徑 類型 Description
規則運算式群組
RegexGroups array of object

包含與輸入字串相符的正規表示式群組名稱和值的陣列。

房產
RegexGroups.Property string
價值觀
RegexGroups.Value string
組數
NumberOfRegexGroups integer

正規表示式群組的數目。

執行 PowerShell 腳本

在執行 IA-Connect Agent 的工作階段中執行 PowerShell 指令碼,其中指令碼內容會傳遞至 'PowerShell 指令碼內容' (PowerShellScriptContents) 輸入中的 IA-Connect Agent。 這是執行您自己的自訂 PowerShell 程式碼的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。 代理程式會使用 Microsoft PowerShell v3.x 到 v5.x (以安裝的版本為準) 執行 PowerShell,而不是 PowerShell 核心 (6.x 以上版本)。

參數

名稱 機碼 必要 類型 Description
PowerShell 腳本內容
PowerShellScriptContents string

要執行的 PowerShell 腳本內容。 IA-Connect 將透過直接傳遞到 PowerShell 自動化引擎來執行此腳本 as-is。 實際上不會在磁碟上建立任何 PowerShell 腳本。 或者,您可以在磁碟上執行現有的 PowerShell 腳本,方法是輸入下列內容:return &; 'scriptpath'。 例如:return & 'c:\scripts\TestScript.ps1'。

電腦名稱
ComputerName string

要執行 PowerShell 腳本的電腦名稱。 如果留空,指令碼將在執行 IA-Connect Agent 的電腦上執行。

沒有結果是錯誤嗎
IsNoResultAnError boolean

如果 PowerShell 命令未傳回任何資料,這是否表示錯誤?

傳回複式類型
ReturnComplexTypes boolean

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 輸入 'Properties to return as collection'、'Properties names to serialize' 和 'Property types to serialize' 可讓您指定應該傳回哪些「複雜」屬性,以及用來格式化資料的方法 (根據屬性,挑選最有效的一個)。 此輸入可讓您指定應該對任何剩餘屬性執行的動作 (即「複雜」且未明確命名的屬性)。 如果設定為 true,IA-Connect 將嘗試使用 ToString() 傳回資料的字串表示法。 如果設定為 false (預設值),則 IA-Connect 不會傳回屬性。

將布林值傳回為布林值
ReturnBooleanAsBoolean boolean

布林屬性是否應該作為布林值返回? 如果為 false,則會以字串的形式傳回。

傳回數值為十進位
ReturnNumericAsDecimal boolean

Numeric 屬性應該以 Numerics 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

將返回日期作為日期
ReturnDateAsDate boolean

Date 屬性應該以 Dates 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

要傳回為集合的屬性
PropertiesToReturnAsCollectionJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應該嘗試以集合的形式傳回。 視屬性、其類型和值而定,您也應該考慮使用替代輸入「要序列化的屬性名稱」和「要序列化的屬性類型」(選擇一個)。 此輸入可以 JSON 或 CSV 格式輸入。 例如:若要傳回 EmailAddresses 和 MemberOf 陣列屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

驗證機制
AuthenticationMechanism string

連線到遠端電腦或以替代使用者身分執行腳本時要使用的驗證機制。 支援的值為 'Basic'、'Credssp'、'Default'、'Digest'、'Kerberos' 和 'Negotiate'。

連線嘗試
ConnectionAttempts integer

連線到遠端電腦時要嘗試的連線數目。

用戶名稱
Username string

如果以替代使用者身分執行指令碼,則要使用的使用者名稱。

密碼
Password password

如果以替代使用者身分執行指令碼,則要使用的密碼。

以執行緒身分執行指令碼
RunScriptAsThread boolean

如果設定為 false (預設值),IA-Connect 代理程式會立即執行 PowerShell 腳本,並在腳本完成時將結果傳回給 Director。 如果執行長或複雜的 PowerShell 腳本,此動作可能會逾時。如果設定為 true,IA-Connect 代理程式會以代理程式執行緒的 PowerShell 指令碼執行,而 IA-Connect 導向器 (或 Orchestrator、PowerShell 模組、Blue Prism) 可以監控此代理程式執行緒的狀態,並等待其完成。 這允許長或複雜的 PowerShell 腳本在沒有逾時的情況下運行。 IA-Connect 代理程式 9.3 和更早版本無法將 PowerShell 指令碼作為代理程式執行緒執行。

擷取執行緒識別碼的輸出資料
RetrieveOutputDataFromThreadId integer

如果您先前以代理程式執行緒身分執行 PowerShell 腳本,並將 [等候執行緒的秒數] 設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您只是執行 PowerShell 指令碼,請設定為 0 (預設值) (,因此不會擷取先前以代理程式執行緒執行的 PowerShell 指令碼的結果)。

等待執行緒的秒數
SecondsToWaitForThread integer

如果「以執行緒身分執行指令碼」設定為 true,則要等待代理程式執行緒完成的秒數。 如果執行 PowerShell 腳本的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 以略過等候:代理程式會繼續執行 PowerShell 腳本,但也可用於下一個動作。 然後,您可以使用動作 [等候代理程式執行程成功完成] 來等候代理程式執行緒完成,然後重新執行此 [執行 PowerShell 腳本] 動作,並將輸入 [擷取執行緒識別碼的輸出資料] 設定為代理程式執行緒識別碼。

指令碼包含儲存的密碼
ScriptContainsStoredPassword boolean

如果指令碼包含格式為 {IAConnectPassword:StoredPasswordIdentifier} 的 IA-Connect 儲存密碼識別碼,或格式為 {OrchestratorCredential:FriendlyName} 的 IA-Connect Orchestrator 一般認證,則設定為 true。 { } 片語將被指定的密碼替換,轉義並放在單引號中(除非它已經在腳本中放在引號中)。

記錄詳細輸出
LogVerboseOutput boolean

設定為 true,可將任何 PowerShell 詳細輸出記錄到 IA-Connect 記錄中。 這對於偵錯很有用。 若要在腳本中詳細記錄,請使用下列 PowerShell:Write-Verbose 'My message' -Verbose。

傳回安全字串
ReturnSecureStrings boolean

設定為 true 可傳回 PowerShell 腳本輸出中的任何安全字串屬性。 設定為 false (預設值) ,以不傳回任何保留為安全字串的屬性。 只有在您知道自己在做什麼時才設定為 true,因為這可能會導致傳輸密碼 (如果 PowerShell 腳本輸出中有密碼) 。

要序列化的屬性名稱
PropertyNamesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (您可以在收到後還原序列化)。 根據屬性、其類型和值,您還應該考慮使用替代輸入 '要傳回為集合的屬性' 和 '要序列化的屬性類型' (選擇一個)。 例如:若要序列化 EmailAddresses 和 MemberOf 屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

要序列化的內容類型
PropertyTypesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依類型) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (收到後可以還原序列化)。 根據屬性、其類型和值,您也應該考慮使用替代輸入「要傳回為集合的屬性」和「要序列化的屬性名稱」(選擇一個)。 此輸入是具有單一 'PropertyType' 欄位的集合。 例如:若要序列化 Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] 類型的任何屬性,請輸入 [{“PropertyType”: “Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”}] (JSON 資料表格式)、 [“Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”] (JSON 陣列格式) 或 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV 格式)。

名稱
Name string

輸入 PowerShell 參數的名稱。 這必須符合 PowerShell 變數命名格式 (,亦即建議避免使用空格或特殊符號)。 PowerShell 變數名稱不區分大小寫。 例如:MyVariable 會導致建立變數$MyVariable。

字串值
StringValue string

要指派給輸入 PowerShell 參數的字串值。 或者,如果您輸入布林值或數值,請使用其他值輸入。

整數值
IntValue integer

要指派給輸入 PowerShell 參數的整數 (整數) 值。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

布林值
BooleanValue boolean

要指派給輸入 PowerShell 參數的布林值 (true 或 false)。 或者,如果您要輸入字串或數值,請使用其他值輸入。

十進位值
DecimalValue double

要指派給輸入 PowerShell 參數的十進位值。 或者,如果您輸入字串、布林值或整數值,請使用其他值輸入。

物件值
ObjectValue object

要指派給輸入 PowerShell 參數的物件值。 這將成為 PowerShell 腳本中的 JSON 序列化字串變數,因此請使用 ConvertFrom-Json 還原序列化為物件。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 輸出 JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

執行緒識別碼
ThreadId integer

如果 PowerShell 指令碼以代理程式執行緒身分執行,則此輸出會保留代理程式執行緒識別碼,可用來監視 PowerShell 指令碼執行,並在指令碼完成時擷取 PowerShell 指令碼結果。

將 CSV 上傳至 IA-Connect Orchestrator 查閱表格

將取代的 CSV 資料上傳至 IA-Connect Orchestrator 查閱表格,以取代任何現有的內容。 此動作不會與 IA-Connect Agent 處理的查閱表格 (磁碟上保存的 CSV 檔案) 互動。

參數

名稱 機碼 必要 類型 Description
查閱表格名稱
LookupTableName True string

Orchestrator 查閱表格的名稱。

CSV 資料
CSVData True string

要儲存在 Orchestrator 查閱表格中的取代 CSV 資料。 如果查閱表格已存在,則表格內容將取代為此 CSV 資料。 您無法提供空白的 CSV 輸入,但可以提供沒有資料列的 CSV 標頭列。

建立查閱表格(如果不存在)
CreateLookupTableIfNotExist boolean

如果設定為 false (預設值),且具名查閱表格尚不存在,則會引發例外狀況。 如果設定為 true,則會建立具名查閱表格 (如果不存在)。

傳回

名稱 路徑 類型 Description
指令結果
UploadCSVToIAConnectLookupTableResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將 CSV 上傳至 Orchestrator 清單 IA-Connect

將取代的 CSV 資料上傳至 IA-Connect Orchestrator 清單,取代任何現有的內容。

參數

名稱 機碼 必要 類型 Description
清單名稱
ListName True string

Orchestrator 清單的名稱。

CSV 資料
CSVData True string

要儲存在 Orchestrator 清單中的取代 CSV 資料。 如果清單已存在,則清單內容將取代為此 CSV 資料。 您無法提供空白的 CSV 輸入,但可以提供沒有資料列的 CSV 標頭列。

如果不存在,請建立清單
CreateListIfNotExist boolean

如果設定為 false (預設值),且具名清單尚不存在,則會引發例外狀況。 如果設定為 true,則會建立具名清單 (如果不存在)。

傳回

名稱 路徑 類型 Description
指令結果
UploadCSVToIAConnectListResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將資料列插入 JSON 資料表

取得 JSON 格式的輸入資料表,在指定位置插入資料列,並傳回 JSON 格式的新資料表。 如果您想要將資料列插入實際表格(即不是 JSON 格式),請使用「將資料列插入表格」動作。 如果要將字串插入字串陣列,請使用「將資料列插入字串陣列」動作。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

列索引
RowIndex True integer

要插入的資料列索引。 使用 0 插入表格開頭,使用 1 插入第 1 列之後,使用 N 插入第 N 列之後。-1 或等於或大於表格中要插入表格結尾的項目數的任何數字 (如果您不知道表格有多長,則很有用)。

要插入的 JSON 列
RowToInsertJSON string

要以 JSON 格式插入的資料列內容。 如果要插入空白列,請保留空白。 例如:若要在「名稱」欄中插入「Simon」,請使用 {“Name”:“Simon”},若要在「國家」欄中額外插入「英格蘭」,請使用 {“Name”:“Simon”,“Country”:“England”}。

傳回

名稱 路徑 類型 Description
輸出 JSON 資料表
OutputJSONTable string

JSON 格式的輸出表格。

列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

將資料列插入字串陣列

取得字串項目的輸入陣列,在指定位置插入資料列,並傳回新的陣列。 如果您想要在表格中插入資料列,請使用「在資料表中插入資料列」動作。 如果您想要以 JSON 格式將資料列插入資料表,請使用「將資料列插入 JSON 資料表」動作。

參數

名稱 機碼 必要 類型 Description
輸入陣列
InputArray True array of string

字串的輸入陣列。

列索引
RowIndex True integer

要插入的資料列索引。 使用 0 插入數組的開頭,使用 1 插入在第 1 行之後,使用 N 插入行 N 之後。-1 或等於或大於數組中要插入數組末尾的項目數的任何數字(如果您不知道數組有多長,則很有用)。

要插入的值
ValueToInsert string

要插入新列中的字串值。 如果要插入空白列,請保留空白。

傳回

名稱 路徑 類型 Description
輸出陣列
OutputArray array of string

字串的輸出陣列。

項目數
NumberOfItems integer

輸出陣列中的項目數。

將資料列插入表格

取得輸入表格,在指定位置插入資料列,並傳回新表格。 如果要將字串插入字串陣列,請使用「將資料列插入字串陣列」動作。 如果您想要以 JSON 格式將資料列插入資料表,請使用「將資料列插入 JSON 資料表」動作。

參數

名稱 機碼 必要 類型 Description
輸入表格
Input table object
列索引
RowIndex True integer

要插入的資料列索引。 使用 0 插入表格開頭,使用 1 插入第 1 列之後,使用 N 插入第 N 列之後。-1 或等於或大於表格中要插入表格結尾的項目數的任何數字 (如果您不知道表格有多長,則很有用)。

要插入的 JSON 列
RowToInsertJSON string

要以 JSON 格式插入的資料列內容。 如果要插入空白列,請保留空白。 例如:若要在「名稱」欄中插入「Simon」,請使用 {“Name”:“Simon”},若要在「國家」欄中額外插入「英格蘭」,請使用 {“Name”:“Simon”,“Country”:“England”}。

傳回

名稱 路徑 類型 Description
輸出表
OutputTable array of object

輸出表格。

items
OutputTable object
列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

將輸入變數列插入 JSON 表格

取得 JSON 格式的輸入資料表,在指定位置插入從輸入變數建立的資料列,並傳回 JSON 格式的新資料表。 輸入資料列結構描述應符合輸入資料表的結構描述 (,即使用相同的屬性名稱和資料類型)。 如果您想要將資料列插入實際表格(即不是 JSON 格式),請使用「將資料列插入表格」動作。 如果要將字串插入字串陣列,請使用「將資料列插入字串陣列」動作。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

列索引
RowIndex True integer

要插入的資料列索引。 使用 0 插入表格開頭,使用 1 插入第 1 列之後,使用 N 插入第 N 列之後。-1 或等於或大於表格中要插入表格結尾的項目數的任何數字 (如果您不知道表格有多長,則很有用)。

屬性名稱
PropertyName string
屬性資料類型
DataType string
屬性值
Value string

傳回

名稱 路徑 類型 Description
輸出 JSON 資料表
OutputJSONTable string

JSON 格式的輸出表格。

列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

將陣列轉換為JSON

採用輸入陣列並序列化為 JSON 字串。

參數

名稱 機碼 必要 類型 Description
輸入物件
Input object object

傳回

名稱 路徑 類型 Description
輸出JSON
OutputJSON string

輸出 JSON 字串。

從 JSON 取得資料表

採用 JSON 格式的輸入資料表,並傳回為資料表。 這稱為還原序列化。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

起始列索引
StartRowIndex True integer

要擷取的第一列的索引。 使用 1 從第一行開始,使用 N 從第 N 行開始。

要擷取的資料列數
NumberOfRowsToRetrieve integer

要擷取的列數。 使用 0 (或留空) 來擷取所有資料列。

開始直欄索引
StartColumnIndex integer

要擷取的第一欄的索引。 使用 1 從第一欄開始,使用 N 從第 N 欄開始。 如果您想要指定要依名稱擷取的第一欄,請將此輸入保留空白,並改用輸入「開始欄名稱」。

開始欄名稱
StartColumnName string

要擷取的第一欄的選擇性名稱。 如果您希望按索引檢索欄,請將此輸入保留空白並改用輸入「開始欄索引」。

要擷取的資料行數目
NumberOfColumnsToRetrieve integer

要擷取的資料行數目。 使用 0 (或保留空白) 來擷取所有資料行。

傳回

名稱 路徑 類型 Description
輸出表
OutputTable array of object

輸出表格。

items
OutputTable object
列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數 (應一律為 1)。

從 JSON 表格儲存格取得字串

採用 JSON 格式的輸入表格,並將指定的儲存格傳回為字串。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

列索引
RowIndex integer

包含要擷取之儲存格的資料列索引。 第一行使用 1,第 N 行使用N。

資料行索引
ColumnIndex integer

包含要擷取之儲存格的資料行索引。 第一列使用1,第N列使用N。 如果您想要依名稱擷取資料行,請將此輸入留空,並改用輸入 '資料行名稱'。

欄位名稱
ColumnName string

包含要擷取之儲存格之資料行的選用名稱。 如果您想要按索引檢索直欄,請將此輸入留空並改用輸入「直欄索引」。

如果儲存格不存在,則後援
FallBackIfCellDoesNotExist boolean

如果指定的列索引、直欄索引或名稱不存在,則此輸入會控制結果。 如果此輸入設定為false(預設值),則會出現例外狀況。 如果此輸入設定為 true,則「輸出字串」將設定為後援值,該值可以是空白或您選擇的值。

後援值
FallbackValue string

如果指定的列索引、直欄索引或名稱不存在,且輸入 'Fallback if cell does not exist' 設為 true,則此後援值將用於輸出字串。

傳回

名稱 路徑 類型 Description
輸出字串
OutputString string

輸出儲存格內容會以字串形式呈現。

從 JSON 資料表中刪除資料列

取得 JSON 格式的輸入資料表,刪除指定位置的一或多個資料列,並傳回 JSON 格式的新資料表。 如果您想要從實際表格中刪除一或多個列(即不是 JSON 格式),請使用「從表格中刪除一列」動作。 如果您想要從字串陣列中刪除一或多個列,請使用「從字串陣列中刪除一列」動作。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

起始列索引
StartRowIndex True integer

要開始刪除的資料列索引。 使用 1 刪除第一行,使用 N 刪除第 N 行。

要刪除的列數
NumberOfRowsToDelete True integer

要刪除的列數。

傳回

名稱 路徑 類型 Description
輸出 JSON 資料表
OutputJSONTable string

JSON 格式的輸出表格。

列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

從 JSON 資料表中刪除資料行

取得 JSON 格式的輸入資料表,刪除一或多個資料行,並傳回 JSON 格式的新資料表。 如果您想要從實際資料表中刪除資料行 (即不是 JSON 格式),請使用「從資料表中刪除資料行」動作。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

開始直欄索引
StartColumnIndex integer

要開始刪除的資料行索引。 使用 1 刪除第一欄,使用 N 刪除第 N 欄。 如果您想要按名稱刪除欄,請將此輸入保留空白,並改用輸入「要刪除的欄名稱」。

要刪除的資料行名稱
ColumnNameToDelete string

要刪除之欄的選擇性名稱。 如果您想要按索引刪除欄,請將此輸入留空並改用輸入「開始欄索引」。

要刪除的資料行數目
NumberOfColumnsToDelete True integer

要刪除的資料行數目,從指定的索引或名稱開始。

傳回

名稱 路徑 類型 Description
輸出 JSON 資料表
OutputJSONTable string

JSON 格式的輸出表格。

列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

從 JSON 資料表資料行取得字串陣列

採用 JSON 格式的輸入表格,並將指定的資料行傳回為字串陣列。 如果您想從實際表中獲取字符串數組(即不是 JSON 格式),請使用“從表獲取數組”操作。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

資料行索引
ColumnIndex integer

要傳回為陣列的資料行索引。 第一列使用1,第N列使用N。 如果您想要依名稱擷取資料行,請將此輸入留空,並改用輸入 '資料行名稱'。

欄位名稱
ColumnName string

要傳回為陣列的資料行的選擇性名稱。 如果您想要按索引檢索直欄,請將此輸入留空並改用輸入「直欄索引」。

傳回

名稱 路徑 類型 Description
輸出陣列
OutputArray array of string

字串的輸出陣列。

項目數
NumberOfItems integer

輸出陣列中的項目數。

從字串中刪除字符

取得輸入字串,並傳回已移除指定字元的字串。 如果找不到指定的字元,則會傳回原始字串。

參數

名稱 機碼 必要 類型 Description
輸入字串
InputString string

執行字元移除的輸入字串。

要從輸入字串中移除的字元
CharactersToRemoveFromInputString string

包含您要從輸入中移除的所有字元的字串。 例如:!@&?^*。

從輸入字串中移除變音符號
RemoveDiacriticsFromInputString boolean

如果設定為 true,IA-Connect 會嘗試從輸入字串中移除所有變音符號,並將字元取代為具有相同字元減去變音符號的變音符號。 例如:將「重音 a」替換為「a」。 在沒有直接對應至簡單字元的案例中,會移除字元。 例如:去掉德語升號 S。

從輸入字串中移除非英數字元
RemoveNonAlphaNumericFromInputString boolean

如果設定為 true,IA-Connect 會從輸入字串中移除所有非英數字元。

從輸入字串中移除數值字元
RemoveNumericFromInputString boolean

如果設定為 true,IA-Connect 會從輸入字串中移除所有數值字元。

從輸入字串中刪除小寫字符
RemoveLowercaseCharactersFromInputString boolean

如果設定為 true,IA-Connect 將從輸入字串中刪除所有小寫字母字元。

從輸入字串中刪除大寫字元
RemoveUppercaseCharactersFromInputString boolean

如果設定為 true,IA-Connect 會從輸入字串中移除所有大寫字母字元。

傳回

名稱 路徑 類型 Description
輸出字串
OutputString string

具有已移除字元的字串。 如果找不到指定的字元,這將是原始字串。

從字串陣列中刪除項目

取得字串項目的輸入陣列,刪除指定位置的一個或多個項目,並傳回新的陣列。 如果您想要從表格中刪除一或多個列,請使用「從表格中刪除一列」動作。 如果您想要從 JSON 格式的資料表中刪除一或多個資料列,請使用「從 JSON 資料表刪除資料列」動作。

參數

名稱 機碼 必要 類型 Description
輸入陣列
InputArray True array of string

字串的輸入陣列。

起始項目索引
StartItemIndex True integer

要開始刪除的項目索引。 使用 1 刪除第一個項目,使用 N 刪除第 N 個項目。

要刪除的項目數
NumberOfItemsToDelete True integer

要刪除的項目數目。

傳回

名稱 路徑 類型 Description
輸出陣列
OutputArray array of string

字串的輸出陣列。

項目數
NumberOfItems integer

輸出陣列中的項目數。

從字串陣列取得 JSON 表格

取得字串項目的輸入陣列,並傳回為 JSON 資料表。

參數

名稱 機碼 必要 類型 Description
輸入陣列
InputArray True array of string

字串的輸入陣列。

欄位名稱
ColumnName True string

要用於表格欄的名稱。

丟棄空物品
DropEmptyItems boolean

設定為true可忽略(刪除)陣列中的空項目。 設定為 false 以包含所有項目。

傳回

名稱 路徑 類型 Description
輸出 JSON 資料表
OutputJSONTable string

JSON 格式的輸出表格。

列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數 (應一律為 1)。

從字串陣列取得表格

取得字串項目的輸入陣列,並傳回為資料表。

參數

名稱 機碼 必要 類型 Description
輸入陣列
InputArray True array of string

字串的輸入陣列。

欄位名稱
ColumnName True string

要用於表格欄的名稱。

丟棄空物品
DropEmptyItems boolean

設定為true可忽略(刪除)陣列中的空項目。 設定為 false 以包含所有項目。

傳回

名稱 路徑 類型 Description
輸出表
OutputTable array of object

輸出表格。

items
OutputTable object
列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數 (應一律為 1)。

從本機檔案匯入組合件

將 DotNet 元件從執行 IA-Connect Director 的電腦上傳至 IA-Connect Agent,將其載入記憶體中,並在動態 DotNet 程式碼參考時使用。

參數

名稱 機碼 必要 類型 Description
本端組合檔案路徑
LocalAssemblyFilePath True string

本機會話中本機元件檔案的檔案路徑 (執行 IA-Connect 導向器的位置) 。

組件名稱
AssemblyName True string

要匯入的組件名稱。

壓縮
Compress boolean

上傳前是否應該壓縮組件?

Workflow
Workflow True string

在此處新增下列運算式:workflow()

從查閱表格查閱資料儲存格 IA-Connect

從 Orchestrator 查閱表格 (適用於使用 Orchestrator 的自動化) 從符合輸入資料的第一列擷取所有資料儲存格,並傳回為表格。 此動作不支援載入 IA-Connect Agent 的查閱表格。

參數

名稱 機碼 必要 類型 Description
查閱表格名稱
LookupTableName True string

Orchestrator 查閱表格的名稱。

輸入資料JSON
InputDataJSON string

以 JSON 格式輸入要用於查閱的資料。 例如,如果查閱表格具有 'JobTitle' 和 'Country' 屬性欄,您可以提交下列 JSON:{ “JobTitle”: “Consultant”, “Country”: “England” }。

如果沒有相符項,則引發例外狀況
RaiseExceptionIfNoMatch boolean

設定為 true (預設值),以在查閱不符合任何資料時引發例外狀況。 設定為 false ,如果查閱不符合任何資料,則傳回空白字串。

傳回空白儲存格
ReturnBlankCells boolean

如果您想要在傳回表中包含空白儲存格,請設定為 true。 設定為 false (預設值) ,以僅包含具有值的資料儲存格。

傳回格式
ReturnFormat string

傳回結果時要使用的格式。

傳回

名稱 路徑 類型 Description
輸出查閱表格JSON
OutputLookupTableJSON string

輸出表格,其中包含符合輸入資料列的資料儲存格,透過根據 IA-Connect 查閱表格查閱輸入資料而取得。 輸出資料表將具有一列和一或多個資料欄,採用 JSON 格式。

輸出查閱表格
OutputLookupTable array of object

輸出表格,其中包含符合輸入資料列的資料儲存格,透過根據 IA-Connect 查閱表格查閱輸入資料而取得。 輸出表格將具有一列和一或多個資料欄。

items
OutputLookupTable object
輸出中的儲存格數
NumberOfCellsInOutput integer

輸出中的儲存格數目。

從查閱資料表查閱資料 IA-Connect 資料行

從符合輸入資料的第一列,從 Orchestrator 查閱表格 (適用於使用 Orchestrator 的自動化) 或目前載入 IA-Connect Agent 的查閱表格中擷取一或多個同名資料行,並以表格形式傳回。 例如,查閱表格可以包含多個名為「AD group」的輸出資料行,以代表多個 AD 群組,而且它們會在輸出資料表中傳回為個別資料列。 如果 Orchestrator 具有與載入 IA-Connect Agent 的查詢表格同名的查閱表格,則會使用 Orchestrator 查閱表格 (如果自動化正在通過 Orchestrator)。

參數

名稱 機碼 必要 類型 Description
查閱表格名稱
LookupTableName True string

載入到 IA-Connect Agent 的 Orchestrator 查閱表格或查閱表格的名稱。

輸入資料JSON
InputDataJSON string

以 JSON 格式輸入要用於查閱的資料。 例如,如果查閱表格具有 'JobTitle' 和 'Country' 屬性欄,您可以提交下列 JSON:{ “JobTitle”: “Consultant”, “Country”: “England” }。

搜尋結果表格欄名稱
SearchResultTableColumnName True string

查閱表格中輸出資料行的名稱,其中包含要在輸出資料表中傳回的值。 如果查閱表格中只有一個輸出直欄具有此名稱,則輸出表格將具有單一列。 如果查閱資料表中的多個輸出資料行共用通用名稱,則輸出資料表將有多個資料列。

如果沒有相符項,則引發例外狀況
RaiseExceptionIfNoMatch boolean

設定為 true (預設值),以在查閱不符合任何資料時引發例外狀況。 設定為 false ,如果查閱不符合任何資料,則傳回空白字串。

傳回空白儲存格
ReturnBlankCells boolean

如果您想要在傳回表中包含空白儲存格,請設定為 true。 設定為 false (預設值) ,以僅包含具有值的儲存格。

傳回格式
ReturnFormat string

傳回結果時要使用的格式。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
輸出查閱表格JSON
OutputLookupTableJSON string

從具有指定名稱的一或多個查閱表格直欄讀取的輸出表格,透過根據 IA-Connect 查閱表格查閱輸入資料而取得。 輸出資料表將有一個資料行 (符合要求的結果資料表資料行名稱) 和一或多列,採用 JSON 格式。

輸出查閱表格
OutputLookupTable array of object

從具有指定名稱的一或多個查閱表格直欄讀取的輸出表格,透過根據 IA-Connect 查閱表格查閱輸入資料而取得。 輸出資料表將有一個資料行 (符合要求的結果資料表資料行名稱) 和一或多列。

items
OutputLookupTable object
輸出查閱陣列
OutputLookupArray array of object

輸出陣列是從一或多個具有指定名稱的查閱表格直欄讀取的,這是透過根據 IA-Connect 查閱表格查閱輸入資料而取得的。 輸出陣列是具有一或多個列的單個直欄。

items
OutputLookupArray object
輸出中的列數
NumberOfRowsInOutput integer

輸出中的列數。

從清單中取得資料 IA-Connect

從 IA-Connect Orchestrator 清單擷取資料行。

參數

名稱 機碼 必要 類型 Description
清單名稱
ListName True string

Orchestrator 清單的名稱。

搜尋欄索引
SearchColumnIndex integer

清單中要傳回的資料行索引。 預設為 1,傳回第一欄。 如果您想要依名稱擷取直欄,請將此設定為 0,並改為指定直欄名稱。

搜尋欄名稱
SearchColumnName string

清單中要傳回的直欄名稱,如果您想要依名稱從清單擷取直欄。 如果您想使用此輸入,請將「搜尋欄索引」設定為 0。

傳回空白儲存格
ReturnBlankCells boolean

如果您想要在傳回資料中包含空白儲存格,請設定為 true。 設定為 false (預設值) ,以僅包含具有值的儲存格。

如果清單不存在,則遞補
FallBackIfListDoesNotExist boolean

如果指定的清單不存在,則此輸入會控制結果。 如果此輸入設定為false(預設值),則會出現例外狀況。 如果此輸入設定為 true,則「輸出清單」(以請求的傳回格式格式化)將設定為後援值,該值可以是空白或您選擇的值。

後援值
FallbackValue string

如果指定的清單不存在,且輸入 'Fallback if list does not exist' 設為 true,則此後援值將用於輸出,並以要求的傳回格式格式化。 如果您要從查閱表格讀取資料,且某些資料項目代表清單,而某些項目是實際資料,這很有用。

傳回格式
ReturnFormat string

傳回結果時要使用的格式。

傳回

名稱 路徑 類型 Description
輸出清單JSON
OutputListJSON string

清單中的輸出欄,採用 JSON 格式。

輸出清單
OutputList array of object

清單中的輸出直欄,採用資料表格式。

items
OutputList object
輸出清單陣列
OutputListArray array of object

清單中的輸出欄,採用陣列格式。

items
OutputListArray object
輸出中的列數
NumberOfRowsInOutput integer

輸出中的列數。

從表格中刪除資料列

取得輸入資料表,刪除指定位置的一或多個資料列,並傳回新資料表。 如果您想要從字串陣列中刪除一或多個列,請使用「從字串陣列中刪除一列」動作。 如果您想要從 JSON 格式的資料表中刪除一或多個資料列,請使用「從 JSON 資料表刪除資料列」動作。

參數

名稱 機碼 必要 類型 Description
輸入表格
Input table object
起始列索引
StartRowIndex True integer

要開始刪除的資料列索引。 使用 1 刪除第一行,使用 N 刪除第 N 行。

要刪除的列數
NumberOfRowsToDelete True integer

要刪除的列數。

傳回

名稱 路徑 類型 Description
輸出表
OutputTable array of object

輸出表格。

items
OutputTable object
列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

從表格中刪除資料行

取得輸入資料表,刪除一或多個資料行,並傳回新資料表。 如果您想要從 JSON 格式的資料表中刪除資料行,請使用動作 [從 JSON 資料表刪除資料行]。

參數

名稱 機碼 必要 類型 Description
輸入表格
Input table object
開始直欄索引
StartColumnIndex integer

要開始刪除的資料行索引。 使用 1 刪除第一欄,使用 N 刪除第 N 欄。 如果您想要按名稱刪除欄,請將此輸入保留空白,並改用輸入「要刪除的欄名稱」。

要刪除的資料行名稱
ColumnNameToDelete string

要刪除之欄的選擇性名稱。 如果您想要按索引刪除欄,請將此輸入留空並改用輸入「開始欄索引」。

要刪除的資料行數目
NumberOfColumnsToDelete True integer

要刪除的資料行數目,從指定的索引或名稱開始。

傳回

名稱 路徑 類型 Description
輸出表
OutputTable array of object

輸出表格。

items
OutputTable object
列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

從表格欄取得字串陣列

取得輸入資料表,並將指定的資料行傳回為字串陣列。 如果您想要從 JSON 格式的資料表取得字串陣列,請使用動作「從 JSON 資料表取得陣列」。

參數

名稱 機碼 必要 類型 Description
輸入表格
Input table object
資料行索引
ColumnIndex integer

要傳回為陣列的資料行索引。 第一列使用1,第N列使用N。 如果您想要依名稱擷取資料行,請將此輸入留空,並改用輸入 '資料行名稱'。

欄位名稱
ColumnName string

要傳回為陣列的資料行的選擇性名稱。 如果您想要按索引檢索直欄,請將此輸入留空並改用輸入「直欄索引」。

傳回

名稱 路徑 類型 Description
輸出陣列
OutputArray array of string

字串的輸出陣列。

項目數
NumberOfItems integer

輸出陣列中的項目數。

從輸入變數建立JSON

採用輸入變數陣列,並以 JSON 格式傳回,並選擇性地以 JSON 表格形式傳回。

參數

名稱 機碼 必要 類型 Description
屬性名稱
PropertyName string
屬性資料類型
DataType string
屬性值
Value string
以 JSON 表格形式傳回
ReturnAsJSONTable True boolean

如果設定為 true,JSON 將以表格/資料表格式(即格式 [{}])傳回。 如果設定為false,JSON將以單一實體(即格式) {}傳回。 使用哪種格式取決於您對 JSON 的操作。 大部分 IA-Connect 動作都需要資料表格式。

傳回

名稱 路徑 類型 Description
輸出JSON
OutputJSON string

變數及其值以 JSON 格式編碼。

排序 JSON 表格

取得輸入 JSON 資料表,對資料表進行排序,並傳回新的 JSON 資料表。 如果您想要對實際表格進行排序(即不是 JSON 格式),請使用「排序表格」動作。 如果您想要對字串陣列進行排序,請使用「排序字串陣列」動作。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

排序欄名稱
SortColumnName True string

要排序的欄名稱。

遞增排序
Ascending boolean

設定為 true 以遞增順序排序。 設定為 false 以遞減順序排序。

排序欄名稱 2
SortColumnName2 string

要排序的選用第二個資料行名稱 (依第一資料行排序之後)。

遞增排序 2
Ascending2 boolean

設定為 true 以遞增順序排序第二個資料行名稱。 設定為 false 以遞減順序排序。

排序欄名稱 3
SortColumnName3 string

要排序的選用第三欄名稱 (依第一欄和第二欄排序之後)。

遞增排序 3
Ascending3 boolean

設定為 true 以遞增順序排序第三欄名稱。 設定為 false 以遞減順序排序。

傳回

名稱 路徑 類型 Description
輸出 JSON 資料表
OutputJSONTable string

JSON 格式的輸出表格。

列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

排序字串陣列

取得字串項目的輸入陣列,對陣列進行排序,並傳回新的陣列。 如果您想要對表格進行排序,請使用「排序表格」動作。 如果您想要以 JSON 格式排序表格,請使用「排序 JSON 表格」動作。

參數

名稱 機碼 必要 類型 Description
輸入陣列
InputArray True array of string

字串的輸入陣列。

遞增排序
Ascending boolean

設定為 true 以遞增順序排序。 設定為 false 以遞減順序排序。

區分大小寫
CaseSensitive boolean

針對區分大小寫的排序設定為 true(即分別排序的大寫和小寫)。 針對不區分大小寫的排序設定為 false。

傳回

名稱 路徑 類型 Description
排序輸出陣列
OutputArray array of string

字串的排序輸出陣列。

項目數
NumberOfItems integer

輸出陣列中的項目數。

排序表格

取得輸入資料表,排序一或多列,並傳回新資料表。 如果您想要以 JSON 格式排序表格,請使用「排序 JSON 表格」動作。 如果您想要對字串陣列進行排序,請使用「排序字串陣列」動作。

參數

名稱 機碼 必要 類型 Description
輸入表格
Input table object
排序欄名稱
SortColumnName True string

要排序的欄名稱。 如果您想按多列排序,請列出逗號分隔的列。

遞增排序
Ascending True boolean

設定為 true 以遞增順序排序。 設定為 false 以遞減順序排序。

排序欄名稱 2
SortColumnName2 string

要排序的選用第二個資料行名稱 (依第一資料行排序之後)。

遞增排序 2
Ascending2 boolean

設定為 true 以遞增順序排序第二個資料行名稱。 設定為 false 以遞減順序排序。

排序欄名稱 3
SortColumnName3 string

要排序的選用第三欄名稱 (依第一欄和第二欄排序之後)。

遞增排序 3
Ascending3 boolean

設定為 true 以遞增順序排序第三欄名稱。 設定為 false 以遞減順序排序。

傳回

名稱 路徑 類型 Description
輸出表
OutputTable array of object

輸出表格。

items
OutputTable object
列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

新增組件搜尋資料夾

將資料夾路徑 (在執行 IA-Connect Agent 的電腦上) 新增至資料夾清單,以便 IA-Connect Agent 在嘗試載入外部參照時進行掃描。

參數

名稱 機碼 必要 類型 Description
資料夾路徑
FolderPath True string

要新增至資料夾清單的資料夾路徑,供 IA-Connect Agent 在嘗試載入外部參照時掃描。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

是否已安裝 PowerShell 模組

在執行 IA-Connect Agent 的電腦上搜尋指定的 PowerShell 模組,並傳回是否已安裝。

參數

名稱 機碼 必要 類型 Description
PowerShell 模組
PowerShellModuleName True string

要搜尋的 PowerShell 模組名稱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
是否已安裝 PowerShell 模組
PowerShellModuleIsInstalled boolean

如果已安裝指定的 PowerShell 模組,則傳回 true,如果未安裝,則傳回 false。

是否已安裝 PowerShell 自動化

報告執行 IA-Connect 代理程式的電腦上是否提供 PowerShell 自動化。 如果無法使用 PowerShell 自動化,PowerShell 自動化動作將無法運作。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
是否已安裝 PowerShell 自動化
PowerShellAutomationIsInstalled boolean

如果 PowerShell 自動化可用,則傳回 true,如果沒有,則傳回 false。

清除組合搜尋資料夾

重設 IA-Connect Agent 在嘗試載入外部參照時要掃描的其他資料夾清單。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

移除 IA-Connect 查閱表格

移除目前載入到 IA-Connect Agent 中的查閱表格。

參數

名稱 機碼 必要 類型 Description
查閱表格名稱
LookupTableName True string

載入到 IA-Connect 代理程式中的查詢表格名稱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
RemoveIAConnectLookupTableResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

移除所有 IA-Connect 查詢表格

移除目前載入到 IA-Connect Agent 中的所有查閱表格。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
RemoveAllIAConnectLookupTablesResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

篩選 JSON 資料表

取得輸入 JSON 資料表、篩選資料表 (使用 .NET DataView 資料列篩選語法) ,並傳回新的 JSON 資料表。 如果您想要篩選實際表格(即不是 JSON 格式),請使用「過濾表格」動作。 如果您想要過濾字串陣列,請使用「過濾字串陣列」動作。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

Filter
Filter True string

.NET DataView 資料列篩選語法中的篩選條件。 例如:[Name] 像 '*Element'。

排序欄名稱
SortColumnName string

套用篩選器後要排序的選擇性欄名稱。 如果您想按多列排序,請列出逗號分隔的列。

遞增排序
Ascending boolean

設定為 true 以遞增順序排序。 設定為 false 以遞減順序排序。

排序欄名稱 2
SortColumnName2 string

要排序的選用第二個資料行名稱 (依第一資料行排序之後)。

遞增排序 2
Ascending2 boolean

設定為 true 以遞增順序排序第二個資料行名稱。 設定為 false 以遞減順序排序。

排序欄名稱 3
SortColumnName3 string

要排序的選用第三欄名稱 (依第一欄和第二欄排序之後)。

遞增排序 3
Ascending3 boolean

設定為 true 以遞增順序排序第三欄名稱。 設定為 false 以遞減順序排序。

傳回

名稱 路徑 類型 Description
輸出 JSON 資料表
OutputJSONTable string

JSON 格式的輸出表格。

列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

篩選字串陣列

取得字串項目的輸入陣列、篩選陣列 (使用 .NET DataView 資料列篩選語法) ,並傳回新的陣列。 如果您想要篩選表格,請使用「篩選表格」動作。 如果您想要以 JSON 格式篩選表格,請使用動作「篩選 JSON 表格」。

參數

名稱 機碼 必要 類型 Description
輸入陣列
InputArray True array of string

字串的輸入陣列。

欄位名稱
ColumnName True string

在篩選作業期間,要用於保存陣列的資料表資料行的名稱。 然後,此名稱可以作為 .NET DataView 資料列篩選語法中的資料行名稱。 例如,MyColumn,然後可以稱為 [MyColumn]。

Filter
Filter True string

.NET DataView 資料列篩選語法中的篩選條件。 例如:[Name] 像 '*Element'。

傳回

名稱 路徑 類型 Description
過濾輸出陣列
OutputArray array of string

過濾的字串輸出陣列。

項目數
NumberOfItems integer

輸出陣列中的項目數。

篩選表

取得輸入資料表、篩選資料表 (使用 .NET DataView 資料列篩選語法) ,並傳回新資料表。 如果您想要以 JSON 格式篩選表格,請使用動作「篩選 JSON 表格」。 如果您想要過濾字串陣列,請使用「過濾字串陣列」動作。

參數

名稱 機碼 必要 類型 Description
輸入表格
Input table object
Filter
Filter True string

.NET DataView 資料列篩選語法中的篩選條件。 例如:[Name] 像 '*Element'。

排序欄名稱
SortColumnName string

套用篩選器後要排序的選擇性欄名稱。 如果您想按多列排序,請列出逗號分隔的列。

遞增排序
Ascending boolean

設定為 true 以遞增順序排序。 設定為 false 以遞減順序排序。

排序欄名稱 2
SortColumnName2 string

要排序的選用第二個資料行名稱 (依第一資料行排序之後)。

遞增排序 2
Ascending2 boolean

設定為 true 以遞增順序排序第二個資料行名稱。 設定為 false 以遞減順序排序。

排序欄名稱 3
SortColumnName3 string

要排序的選用第三欄名稱 (依第一欄和第二欄排序之後)。

遞增排序 3
Ascending3 boolean

設定為 true 以遞增順序排序第三欄名稱。 設定為 false 以遞減順序排序。

傳回

名稱 路徑 類型 Description
輸出表
OutputTable array of object

輸出表格。

items
OutputTable object
列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

載入 IA-Connect 查詢表

從執行 IA-Connect Agent 的電腦載入 IA-Connect 查閱表格。 進一步 IA-Connect 動作可以使用這些查閱表格來執行資料查閱。

參數

名稱 機碼 必要 類型 Description
查閱資料表路徑
Path True string

查詢資料表的完整路徑。 這必須可從執行 IA-Connect Agent 的階段作業存取。 如果指定資料夾,則會處理該資料夾下的所有檔案。

如果任何資料表無法載入,則引發例外狀況
RaiseExceptionIfAnyTableFailsToLoad True boolean

如果設為 true,且任何 IA-Connect 查閱表格無法載入 (例如,如果表格中有問題) ,則會引發例外狀況。 這是預設值,因為如果任何資料表無法載入,這通常會導致稍後在程序中發生例外狀況。 如果設定為 false,則會忽略問題查閱表格,只會載入可用的查閱表格e3d。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
載入的查閱表格數目
NumberOfLookupTablesLoaded integer

成功載入的查閱表格數目。

無法載入的查閱表格數目
NumberOfLookupTablesFailedToLoad integer

載入失敗的查閱表格數目。 只有當「如果任何表無法載入」設定為 false 時,才會設定此值,否則會出現例外狀況。

重新命名 JSON 資料表中的資料行

採用 JSON 格式的輸入資料表、重新命名指定的資料行,並傳回 JSON 格式的新資料表。 如果您想要從實際表格重新命名資料行 (即不是 JSON 格式),請使用動作「重新命名資料表中的資料行」。

參數

名稱 機碼 必要 類型 Description
輸入 JSON 資料表
JSONTable True string

JSON 格式的輸入表格。

來源資料行名稱
SourceColumnName True string

要重新命名的資料行名稱。

新資料行名稱
NewColumnName True string

資料行的新名稱。

傳回

名稱 路徑 類型 Description
輸出 JSON 資料表
OutputJSONTable string

JSON 格式的輸出表格。

列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。

重新命名表格中的資料行

取得輸入資料表、重新命名指定的資料行並傳回新資料表。 如果您想要以 JSON 格式重新命名資料表中的資料行,請使用動作 '重新命名 JSON 資料表中的資料行'。

參數

名稱 機碼 必要 類型 Description
輸入表格
Input table object
來源資料行名稱
SourceColumnName True string

要重新命名的資料行名稱。

新資料行名稱
NewColumnName True string

資料行的新名稱。

傳回

名稱 路徑 類型 Description
輸出表
OutputTable array of object

輸出表格。

items
OutputTable object
列數
NumberOfRows integer

輸出表格中的列數。

欄數
NumberOfColumns integer

輸出表格中的欄數。