ワークフローに関するアクティビティ

最終更新日時 2024年12月20日

カスタム入力

UiPath.System.Activities.CustomInput

ブラウザウィンドウにカスタム HTML フォームを読み込んで表示します。人間ユーザーから特定のデータを収集できます。フォームで収集したデータは、後続のアクティビティを使用してさらに処理することができます。ファイル内部では、HTML に限らず、サポートされる言語はいずれも使用できます。Studio 内部のデータを取得できるようにするには、HTML ファイルに特定の JavaScript 関数を含める必要があります。詳細については、こちらをご覧ください。

プロパティ

共通

表示名 - アクティビティの表示名です。

入力

URI - 読み込む HTML ファイルの URI です。このフィールドは、文字列と String 型変数のみをサポートします。このフィールドに、ファイルパスまたは URL を入力します。

注: URL を使用する場合には、完全形式で入力する必要があります。たとえば、https://activities.uipath.com/docs/custom-input/ です。

その他

プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

結果 - カスタム入力フォームから取得したデータです。String 型変数に格納されます。このフィールドは String 型変数のみをサポートします。

カスタム HTML ファイルの作成

注: アクティビティがフォームに入力されたデータを取得できるようにするには、HTML スクリプトに、Result が取得するデータとなる window.external.setResult([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>