工作流活动

上次更新日期 2024年12月20日

自定义输入

UiPath.System.Activities.CustomInput

加载自定义 HTML 表单并将其显示到浏览器窗口中，使您能够从人类用户那里收集某些数据。然后，可以使用后续活动进一步处理表单中收集的数据。可以在文件中使用的语言不限于 HTML，还支持任何其他语言。为了能够在 Studio 中检索数据，HTML 文件必须包含特定的 JavaScript 函数，详情请参阅此处。

属性

常见

“显示名称”- 活动的显示名称。

输入

URI - 要加载的 HTML 文件的 URI。此字段仅支持字符串和字符串变量。您可以在该字段中输入文件路径或 URL。

注意：使用 URL 时，必须插入其完整格式，例如：https://activities.uipath.com/docs/custom-input/。

其他

“私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

结果 - 此为自定义输入表单中的数据，存储在字符串变量中。此字段仅支持字符串变量。

创建自定义 HTML 文件

注意：要使活动能够检索键入表单的数据，HTML 脚本必须包含 window.external.setResult([Result]) 标签，其中 Result 为要检索的数据。

让我们来举例说明一下，假设有一个 HTML 文件可以检索人类用户的“名字”、“姓氏”和“年龄”。输入表单如下所示：

此页面所采用的 HTML 代码如下所示：

<!DOCTYPE html>
<html lang="en">
 <head>
    <meta charset="utf-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>UiPath KYC Solution</title>
  </head>
  <body>
      
          First Name:<br>
          <input type="text" id="First_Name"><br>
          Last Name:<br>
          <input type="text" id="Last_Name"><br>
          Age:<br>
          <input type="text" id="Age"><br>
          <button onclick="SubmitValues()">Submit</button>
    
  </body>
  </html><!DOCTYPE html>
<html lang="en">
 <head>
    <meta charset="utf-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>UiPath KYC Solution</title>
  </head>
  <body>
      
          First Name:<br>
          <input type="text" id="First_Name"><br>
          Last Name:<br>
          <input type="text" id="Last_Name"><br>
          Age:<br>
          <input type="text" id="Age"><br>
          <button onclick="SubmitValues()">Submit</button>
    
  </body>
  </html>

此页面不包含用于将收集的数据发送回用户处的必要代码。添加后，文件应如下所示：

<!DOCTYPE html>
<html lang="en">
 <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>UiPath KYC Solution</title>
  </head>
  <body>
      
          First Name:<br>
          <input type="text" id="First_Name"><br>
          Last Name:<br>
          <input type="text" id="Last_Name"><br>
          Age:<br>
          <input type="text" id="Age"><br>
          <button onclick="SubmitValues()">Submit</button>
          <script type="text/javascript">
          function SubmitValues(){
            var First_Name = document.getElementById("First_Name").value;
            var Last_Name = document.getElementById("Last_Name").value;
            var Age = document.getElementById("Age").value;
            window.external.setResult(First_Name + "," + Last_Name + "," + Age);
            return true;
          }
            
          </script>
  </body>
  </html><!DOCTYPE html>
<html lang="en">
 <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>UiPath KYC Solution</title>
  </head>
  <body>
      
          First Name:<br>
          <input type="text" id="First_Name"><br>
          Last Name:<br>
          <input type="text" id="Last_Name"><br>
          Age:<br>
          <input type="text" id="Age"><br>
          <button onclick="SubmitValues()">Submit</button>
          <script type="text/javascript">
          function SubmitValues(){
            var First_Name = document.getElementById("First_Name").value;
            var Last_Name = document.getElementById("Last_Name").value;
            var Age = document.getElementById("Age").value;
            window.external.setResult(First_Name + "," + Last_Name + "," + Age);
            return true;
          }
            
          </script>
  </body>
  </html>