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 |
| 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 清單擷取所有資料。 |
|
取得 Power |
取得執行 IA-Connect Agent 之會話中的 PowerShell 版本。 這會偵測 Microsoft PowerShell v3.x 到 v5.x,而不是 PowerShell 核心 (6.x 以上版本)。 |
| 取得 string |
採用輸入字串,並傳回位於兩個指定字串之間或字串與行尾之間的字串的第一個實例。 |
| 取得正則運算式比對 |
對輸入字串執行正規表示式 (regex) 比對,並傳回字串是否符合比對的運算式和詳細資料。 |
| 取得正則運算式相符專案 |
對輸入字串執行正則運算式 (regex) 比對,並傳回字串陣列中的所有相符專案。 如果沒有相符項,陣列將是空的。 |
| 取得正規表示式群組相符專案 |
對輸入字串執行規則運算式 (regex) 比對,並傳回相符的群組名稱和值清單。 |
|
執行 Power |
在執行 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 在嘗試載入外部參照時進行掃描。 |
|
是否已安裝 Power |
在執行 IA-Connect Agent 的電腦上搜尋指定的 PowerShell 模組,並傳回是否已安裝。 |
|
是否已安裝 Power |
報告執行 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 |
輸出表格中的欄數。 |