閱讀及檢閱 Automation Anywhere 文件

Automation 360

關閉內容

內容

開啟內容

使用 SOAP 網頁服務動作的範例

  • 已更新:2022/03/10
    • Automation 360 v.x
    • 組建
    • RPA 工作區
    • 範例

使用 SOAP 網頁服務動作的範例

使用 [SOAP 網頁服務] action傳遞兩個數值,並從線上版本計算機應用程式傳回總和。

程序

若要進行 SOAP 網頁服務呼叫,請執行以下步驟:

  1. 按兩下或拖曳 [SOAP 網頁服務] 動作。
  2. 選取連線方式:
    • 若要使用 URI 進行連線,請輸入 URI,例如:http://www.dneonline.com/calculator.asmx?WSDL
    • 若要使用檔案進行連線,請從 Control Room 或桌面選取檔案,或插入變數。
  3. 選擇性的: [位址位置] 欄位中輸入 SOAP 端點。
    如果您指定位址位置,則bot會在執行期間使用該位置;否則,bot會使用來自 WSDL 檔案的位址位置。
    註: 如果您手動建立 SOAP URI,而且不使用 [建立 SOAP 要求] 選項,請移至步驟 6
  4. 按一下 [建立 SOAP 要求]
    出現 SOAP 要求視窗,顯示服務和連接埠,以及有關它們的作業和參數的詳細資料。
  5. SOAP 要求視窗中,展開您要檢視其連接埠清單的服務。按一下所需連接埠以顯示可用作業清單。選取所需作業,並按一下 [套用] 以從 SOAP 要求中擷取作業詳細資料。
    如果您使用 [建立 SOAP 要求] 選項,[服務][連接埠][作業][作業參數] 欄位將根據您選取的作業自動填入詳細資料。移至步驟 10
  6. [服務] 欄位中,輸入服務名稱。
    此欄位會識別網頁服務支援的連接埠集合。其保有 @SOAP 網頁服務呼叫的 服務名稱值,例如:Calculator
  7. 選擇性的: [連接埠] 欄位中,輸入要連接的端點。
    如果不指定連接埠,則bot會根據所選服務使用 WSDL 檔案中提到的第一個連接埠。但是,如果 SOAP 網頁服務不支援該連接埠,則bot執行將會失敗。
    該欄位保有 @SOAP 網頁服務呼叫的 繫結名稱值,例如:CalculatorSoap
  8. 選取您在 [連接埠] 欄位中指定之端點的 [SOAP 版本]
    選擇 [1.1][1.2]
  9. [作業] 欄位中,輸入您在 [連接埠] 中指定之端點的服務功能名稱。
    如果以下任一情況為 true,則此bot執行會失敗:
    • 連接埠欄位中提到的連接埠沒有任何作業。
    • 該連接埠的 SOAP 要求中提到的作業無法使用。
    該欄位保有 @SOAP 網頁服務呼叫的 作業名稱值,例如:Add
  10. 選取 [作業參數][原始資料參數] 以提供參數詳細資料。
    註: 如果您已選取 [建立 SOAP 要求][作業] 分頁的參數詳細資料表將會自動填入所選作業的參數。提供這些參數的值。您也可以新增、編輯或刪除特定作業的參數。
    • 如果選取 [作業參數],請輸入每個參數的名稱和值。例如,輸入以下值:
      1. 第一個 [名稱] 欄位中的 intA
      2. 第一個 [值] 欄位中的 10
      3. 第二個 [名稱] 欄位中的 intB
      4. 第二個 [值] 欄位中的 20
    • 如果選擇 [原始資料參數],請選取 [參數][認證參數]
  11. [參數]:您可以使用認證儲存櫃中的認證值,而無須在原始資料中以純文字形式 (使用者名稱或密碼) 公開認證。為此,您必須先在認證對應工具中對應認證,並使用大括號內原始資料中的參考名稱。

    例如,在原始資料中,您提供純文字形式的密碼驗證伺服器。

    <aut:AuthHeader>
    <aut:Password> abc@123</aut:Password>
    </aut:AuthHeader>
    
    若要使用認證儲存櫃的密碼,請執行以下步驟:
    1. 按一下 [新增替換項]
      [XML 名稱] 欄位中輸入參考名稱,例如 pwd。選取 [認證] 以使用 Credential Vault 中可用的值,選取 [變數] 以使用認證變數,或選取 [不安全的字串] 以手動指定要使用的值。
      如需有關 Credential Vault 及其使用方法的詳細資料,請參閱Credential Vault中的認證和lockers
    2. 按一下 [新增]
    3. 在大括號內指定原始資料中的參考資料,如下所示:
      <aut:AuthHeader>
      <aut:Password>{{pwd}}</aut:Password>
      </aut:AuthHeader>
      
      原始資料中指定的參考名稱 pwd 將替換儲存在 Credential Vault 中的對應值。
      請確實以和 [新增替換項] 中指定的相同格式輸入參考名稱。例如,若已在 [新增替換項] 中將密碼輸入為 pwd,並在原始資料中輸入 password 作為參考名稱,則在執行bot時,bot將發生錯誤。
  12. [認證參數]:如果您想要將原始資料參數輸入為認證。您可以選擇 [認證] 以使用 Credential Vault 中可用的值,或者選取 [變數] 以使用認證變數或不安全的字串,以手動指定要使用的值。
  13. [驗證模式] 清單中選取 [沒有驗證][基本]
    • 如果選取 [沒有驗證],請繼續下一步。
    • 如果選取 [基本],請輸入您的認證。
  14. 選擇性的: 透過從 Control Room 或您的桌面選取檔案或插入變數來提供用戶端憑證。
  15. 選擇性的: 提供自訂標頭。
  16. 選擇性的: 提供檔案以用來儲存 XML 輸出。
  17. 選取 [完整回應][選取的回應] 以縮小回應範圍。
    • 如果選取 [完整回應],請繼續下一步。
    • 如果您選取 [選取的回應],而且正以手動方式建立 Xpath 運算式,而不是使用 [建立 Xpath] 選項,則請執行以下步驟。
      1. 提供 XPath 運算式。例如:
        /*[local-name()='Envelope' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='Body' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='AddResponse' and namespace-uri()='http://tempuri.org/']/*[local-name()='AddResult' and namespace-uri()='http://tempuri.org/']
      2. 選取 XML 輸出的一個區段:[值][內部 XML][外部 XML]
      3. 如果選取 [值],請選擇分隔符號選項:[直立線符號][分號]
      4. 如果選取 [值],請選擇分隔符號選項:[直立線符號]、[分號] 或 [自訂]。
        如果您選取 [自訂],請在 [自訂分隔符號] (選擇性) 欄位中輸入變數或字元。
        註: 不支援以特殊字元美元符號 ($) 作為分隔符號。
  18. 按一下 [建立 Xpath]
    出現輸出預覽視窗。
  19. 從回應本文選取適當的節點。會自動建立 XML 路徑。按一下 [套用]
    如果您使用 [建立 Xpath] 選項,[XPath 運算式][值] 欄位會根據您選取的作業自動填入詳細資料。
  20. 選擇性的: 若要設定在傳送 SOAP 要求和接收回應時的逾時值,請在 [等候動作完成] 欄位中指定等候時間 (毫秒)。
    依預設,等候時間為 60000 毫秒。
  21. 選取變數以儲存 XML 輸出。
    例如:prompt-assignment
  22. 透過在內文中插入附帶變數 prompt-assignment[訊息方塊] action,驗證 [SOAP 網頁服務] action的輸出。
    當您執行bot時,訊息方塊應顯示 30
傳送意見反饋