通知を受け取る

UiPath StudioX

UiPath StudioX ガイド

自動化の基礎情報

アクティビティについて

アクティビティはオートメーション プロジェクトの基本的な構成ブロックであり、それぞれが、StudioX で自動化できる 1 つ以上の手動タスクを表しています。関連するアクティビティを相互接続したシーケンスが、1 つのオートメーション プロジェクトを形成します。繰り返しプロセスの自動化を検討する場合は、まずそのプロセスを個別の手動ステップに分解したうえで、それぞれのステップを自動化するアクティビティを StudioX で特定する必要があります。

例として、次のワークフローを自動化することを検討します。

  1. スプレッドシートを開きます。
  2. ビジネス アプリケーションを開きます。
  3. スプレッドシートのセルからデータをコピーします。
  4. コピーしたデータをビジネス アプリケーションのフィールドに貼り付けます。
  5. アプリケーションのボタンをクリックしてデータを送信します。

このプロセスを自動化するプロジェクトを StudioX で作成する場合は以下のアクティビティを使用します。

  1. [Excel ファイルを使用] で、使用するスプレッドシートを指定します。
  2. [アプリケーション/ブラウザーを使用] で、使用するアプリケーションを指定します。
  3. [文字を入力] で、ビジネス アプリケーションでデータのコピー先とするフィールドと、データのコピー元のセルを選択します。
  4. [クリック] で、ビジネス アプリケーションでデータ送信のためにクリックするボタンを指定します。

手動ステップと StudioX のアクティビティに、必ず 1 対 1 の対応関係が存在するわけではありません。この例でもわかるように、[文字を入力] アクティビティは、コピー対象とするテキストのコピー元とコピー先の両方を示すために使用しているので、2 つの手動ステップに対応しています。

コンテナー アクティビティ

「コンテナー」系のアクティビティは、それらのアクティビティ内に追加されたアクティビティを実行する場合の範囲または満たすべき条件を定義します。「コンテナー」系のアクティビティは、1 つまたは複数の子アクティビティを含む親アクティビティと言えます。「コンテナー」系のアクティビティの例として、以下のものがあります。

  • リソース系アクティビティ - アプリケーション リソースをオートメーションに追加して、これらのアクティビティ内に追加された別のアクティビティが使用できるようにします。
  • 繰り返し (コレクションの各要素) 系アクティビティ - 項目のコレクションを定義し、これらのアクティビティ内に追加された別のアクティビティを、それらの各項目に対して 1 回ずつ繰り返します。
  • 繰り返し (指定回数) - 繰り返し (コレクションの各要素) 系アクティビティに似ていますが、このアクティビティ内に追加された別のアクティビティを指定された回数だけ繰り返します。
  • [条件分岐][スイッチ][アプリのステートを確認] - 条件を評価し、その評価結果に基づいて、これらのアクティビティ内に追加された特定のアクティビティを実行することにより、オートメーションのフローを決定します。
  • ダウンロードを待機 - このアクティビティ内に追加された別のアクティビティにより開始されたファイルのダウンロードを検出し、そのファイルをオートメーションで使用できるようにします。

リソース系アクティビティ

アクティビティは、適用先のアプリケーションに基づいて、各カテゴリに分類されます。アプリケーションで実行するタスクを自動化するには、まず必要なアプリケーション リソースをオートメーションに追加する必要があります。以下のアクティビティによって、オートメーションにリソースを追加します。

  • Excel ファイルを使用 - 指定した Excel ファイルを使用します。このアクティビティ内に追加されるすべてのアクティビティで、Excel ファイルのデータを使用できます。子アクティビティを設定するとき、StudioX からファイルの個々のセル、範囲、またはシートを直接選択できます。
  • Use Desktop Outlook App, Use Outlook 365, and Use Gmail add a desktop Outlook, Outlook 365, and Gmail account to the automation. The emails in the account are available to all the activities added inside this activity. When you configure child activities, you can select individual folders, messages, or message fields directly from StudioX.
  • Word ファイルを使用 - 指定した Word 文書を使用します。このアクティビティ内のファイルに対して実行するアクティビティを追加します。
  • アプリケーション/ブラウザーを使用 - 指定したデスクトップ アプリケーションまたは Web ブラウザーのページを使用します。このアクティビティ内のアプリケーションまたは Web ブラウザーで実行するアクティビティを追加します。
  • PowerPoint プレゼンテーションを使用 - 指定した PowerPoint ファイルを使用します。このアクティビティ内のファイルに対して実行するアクティビティを追加します。

自動化に必要なリソースはいくつでも追加できます。複数のアプリケーションを使用する複数のアクティビティについては、リソースを別のリソースの内部に追加します。以下に例を示します。

  • Excel ファイルのデータと Outlook アカウントのメールの両方を使用するアクティビティを追加するには、[デスクトップ版 Outlook アプリを使用] アクティビティに [Excel ファイルを使用] アクティビティを追加し、[Excel ファイルを使用] 内に共通のアクティビティを追加します。
  • Web ページと Word 文書の両方を使用するアクティビティを追加するには、[Word ファイルを使用] アクティビティに [アプリケーション/ブラウザーを使用] アクティビティを追加し、[アプリケーション/ブラウザーを使用] 内に共通のアクティビティを追加します。

オートメーションへのグローバル リソースの追加

リソース系のアクティビティを使用してリソースをオートメーションに追加すると、そのリソースを使用できるのはその「リソース」系アクティビティ内に追加したアクティビティのみとなります。プロジェクト内のすべてのアクティビティでリソースを使用できるよう、プロジェクトをリソースに接続することでリソースをグローバルに追加できます。グローバル リソースは [データ マネージャー] パネルで管理され、アクティビティとしてプロジェクトに追加されません。つまり、プロジェクトをリソースに接続することで、デザイナー パネルのスペースも節約できます。

For information on how to connect a project to an Excel workbook, see Connecting a Project to an Excel File.

項目の反復処理

反復処理とは、項目のコレクション内の各項目に 1 つ以上のアクティビティを繰り返すことを指します。項目を反復処理するには、使用可能な [繰り返し (コレクションの各要素)] 系アクティビティの 1 つを追加してコレクションを定義し、次に、反復処理するアクティビティを [繰り返し (コレクションの各要素)] 系アクティビティ内に追加します。アクティビティの繰り返しを設定するときは、アクティビティで反復処理内の各項目のデータが使用されるように指定します。これは、プラス記号 plus buttonplus button メニューから現在の項目を選択することで行います。
StudioX には、次の [繰り返し] 系アクティビティが付属しています。

  • 繰り返し (Excel の各行) - Excel の表、範囲、またはシートの行ごとに、1 つ以上のアクティビティを繰り返します。
    現在の項目を表すのは CurrentRow です。アクティビティによっては、使用する列を現在の行から選択することも必要です。
  • 繰り返し (Excel の各シート) - Excel ファイルのシートごとに、1 つ以上のアクティビティを繰り返します。
    現在の項目を表すのは CurrentSheet です。
  • For Each Email - Repeat one or more activities for each message in an Outlook folder, Gmail label, or in a selection of messages.
    The current item option is CurrentMail. For some activities, you must also select which field to use from the current mail: Subject, Body, Body as HTML, Bcc, Cc, To, From, or Priority.
  • For Each File in Folder - Repeat one or more activities for each file in a folder on your computer.
    The current item option is CurrentFile. You must also select which file property to use from the current file: Size, Name, Full Name (includes full path), Folder, Last modified date, Last accessed date, Created date, IsReadOnly, or Size in KB.

[繰り返し (コレクションの各要素)] 内に追加されたアクティビティを設定するときに識別しやすくするため、現在の項目のオプションの名前を、反復処理を実行している項目を表す名前に変更できます。

アクティビティで使用されるデータを構成する

アクティビティはデータを入力として受け取って、実行時に出力データを生成することができます。各アクティビティのデータは、データ フィールドの右側に表示されるプラス plus buttonplus button メニューで設定できます。

アクティビティは、その目的に応じて、データ フィールドがないものや、1 つまたは複数のデータ フィールドを持つものがあります。ここでは、プラス plus buttonplus button メニューに表示されるオプションについて説明します。このメニューには、フィールド、アクティビティ、親アクティビティのそれぞれに関連性の高いオプション、すなわち各フィールドで使用可能なオプションのうち一部のみが表示されます。

入力フィールドのオプション

入力フィールドでは、以下のオプションを使用して、アクティビティが受け取るデータを定義します。

  • プロジェクトに追加されたリソースからのデータ
    • Excel - Data from the Project Notebook or from an Excel file added to the automation. Select named cells, named ranges, tables, or sheets directly from the Plus plus buttonplus button menu, or select Indicate in Excel to open the workbook in Excel and indicate in it. Selecting Custom Input lets you manually enter sheet names, table names, cell addresses, or range addresses. If the activity is inside an For Each Excel Row activity, you can select the current row in the iteration.
    • Outlook/Gmail/Outlook 365 - 親メールのリソース アクティビティに対して定義されたメール アカウントからのデータ。Outlook デスクトップ アプリで選択されたメッセージをプロジェクトの実行時に使用できます。アクティビティが [繰り返し (各メール)] アクティビティの内部にある場合は、反復処理中の現在のメールを使用できます。
    • PowerPoint - 親の [PowerPoint プレゼンテーションを使用] アクティビティに対して定義された PowerPoint プレゼンテーションのデータ。スライド、プレースホルダー、スライド マスター、またはレイアウトを選択できます。
    • ファイル - アクティビティが [繰り返し (フォルダー内の各ファイル)] アクティビティの内部にある場合、反復処理内の現在のファイルのプロパティを使用できます。
  • Text - Enter text using the built-in text builder. You can click Plus plus buttonplus button inside the Text Builder to add Excel data, mail data, or values you saved for later use to the text.
  • Number - Enter a numeric value or a formula. Formulas support the following operators and symbols: + (addition), - (subtraction), * (multiplication), / (division), ^ (exponent, for example 2^3 for 2 raised to the power of 3), ( ) (to enforce the order of operations).
    You can click Plus plus buttonplus button inside the Numeric Calculation window to add numeric values from the project. For example, select a cell in an Excel file, or a numeric value that you saved for later use.
  • 条件ビルダー - 条件が成立しているかどうかに基づいてどのアクティビティを実行するかを判断する条件ステートメントを追加します。たとえば、[条件分岐] アクティビティには条件フィールドがあり、その条件が成立すれば一連のアクティビティが実行され、条件が成立しない場合は、必要に応じて別のアクティビティのセットが実行されます。
    条件ステートメントを作成するには、2 つの値を選択し、使用可能な演算子のいずれかを使用してそれらを比較します。この演算子には、より大きい、以上、未満、以下、等値、非等値、空白値、非空白値、true、false、先頭値、終了値、含む、数値、非数値などがあります。
    複数のステートメントを追加して、すべてのステートメントが true である場合に条件が成立したとするか、いずれかのステートメントが true である場合に条件が成立したとするかを選択できます。
  • 保存された値を使用 - プロジェクトの後工程で使用できるように保存した別のアクティビティの出力を、現在のフィールドの入力として使用します。
  • [日付/時刻を選択] - カレンダーの日付または時刻 (時、分) を選択します。このオプションは、日付と時間のフィールドで使用できます。
  • 期間を選択 - 期間を選択します (時、分、秒)。このオプションは、期間のフィールドで使用できます。
  • 実行時に確認 - プロジェクトの実行時に値の入力を求めます。テキスト、数値、日付/時刻、または Boolean 値 (True/False) を入力できるフィールドに使用できます。
  • クリップボードから貼り付け - 別のアクティビティでクリップボードにコピーした出力値を、現在のフィールドの入力として使用します。このオプションは、テキスト値または Excel の範囲を受け入れるフィールドで使用できます。
  • 変数 - アプリ/Web 系のアクティビティのセレクターで使用するために作成された変数を選択します。
  • 詳細エディターを開く - VB の式を入力します。
  • 値をクリア - フィールドの現在の選択内容をクリアします。

出力フィールドのオプション

出力フィールドでは、アクティビティにより生成されるデータを使用して実行される処理を定義します。以下のオプションを使用できます。

  • Excel - Save output to the Project Notebook or an Excel file defined for a parent Use Excel File activity. Select named cells, named ranges, tables, or sheets directly from the Plus plus buttonplus button menu, or select Indicate in Excel to open the workbook in Excel and indicate in it. Selecting Custom Input lets you manually enter sheet names, table names, cell addresses, or range addresses. If the activity is inside an For Each Excel Row activity, you can select the current row in the iteration.
  • 後で使用するために保存 - オートメーションの後工程で使用できるように出力を保存し、プロジェクトでそれを参照するための名前を入力します。保存した値は、別のアクティビティで入力として選択できます。
  • Copy to clipboard - Save the output to the clipboard. You can then paste the value in an input field in another activity. This option is available for fields that output text, Boolean values (True/False), numbers, or Excel ranges (for example, the Destination field in the Copy Range activity). Boolean and number values are converted to text when copied to the clipboard.
  • 保存された値の名前を変更 - 後で使用するために保存した値の名前を変更します。
  • 変数 - アプリ/Web 系のアクティビティのセレクターで使用するために作成された変数を選択します。
  • 詳細エディターを開く - VB の式を入力します。
  • 値をクリア - フィールドの現在の選択内容をクリアします。

アクティビティの出力を別のアクティビティの入力として使用する

アクティビティ間でデータの受け渡しができると非常に便利であり、場合によっては、特定のワークフローでは完了のために不可欠となることさえあります。StudioX では、あるアクティビティによって生成された出力を保存しておいて、それをそのプロジェクトで後から実行される別のアクティビティの入力として使用できます。

  1. 他のアクティビティで使用するためにデータを保存するには、アクティビティの出力データを設定するフィールドのプラス plus buttonplus button メニューで [後で使用するために保存] オプションを選択し、保存する値の名前を入力します。この名前は、後で別のアクティビティの入力として値を識別および選択するときに使用します。したがって、どのような値が保存されているかがわかるような一意の名前を付けるようにしてください。
  2. 保存されたデータを、そのプロジェクトで後から実行される別のアクティビティの入力として使用するには、アクティビティの入力データを設定するフィールドのプラス plus buttonplus button メニューに表示される [保存された値を使用] オプションで値を選択します。

この機能が役立つさまざまなシナリオがあります。次に、いくつかの例を示します。

  • [テキスト ファイルを読み込み] アクティビティでテキスト ファイルの内容を読み込んで出力し、それを [テキストを追加] アクティビティの入力として使用して Word ファイルにテキストを追加します。
  • [ファイルの存在を確認] アクティビティで、ファイルが存在するかどうかをチェックし、出力される結果 (True または False) を [条件分岐] アクティビティの条件として使用して、ファイルが既に存在している場合に実行する特定のアクションを判断します。

オートメーションを実行する

設計段階から、オートメーションを頻繁に実行することをお勧めします。それにより、プロジェクトが期待どおりに動作することを確認して、潜在的なエラーを早期に特定することができます。

オートメーションを実行するには、StudioX のリボンの [実行] をクリックするか、キーボードの F5 を押します。

プロジェクトの実行を停止するには、リボンの [停止] をクリックするか、キーボードの F5 を押します。プロジェクトの実行後、デザイナー パネルの上部に、実行が正常に完了したかどうかを知らせるメッセージが表示されます。

プロジェクトの一部だけを実行するには、任意のアクティビティを右クリックして、以下のオプションを選択します。

  • このアクティビティまで実行 - プロジェクト内のこのアクティビティより前のアクティビティをすべて実行します。
  • [このアクティビティから実行] - プロジェクト内のこのアクティビティ以降のアクティビティをすべて実行します。

ピクチャ イン ピクチャでの実行

プロジェクトの実行中にロボットの干渉を受けずにコンピューターを使用するには、オートメーションをピクチャ イン ピクチャ モードで実行します。このモードでは、プロジェクトが別ウィンドウで開かれた別のセッションで実行されるため、ユーザーがキーボード、マウス、画面を完全に制御できます。

ピクチャ イン ピクチャでオートメーションを実行するには、StudioX のリボンの [実行] の下にある矢印をクリックし、[PiP で実行] を選択します。または、F6 キーを押します。ロボットにより、プロジェクト内のアクティビティが新しいウィンドウで実行されます。

📘

注:

Microsoft Office のリソースを使用するオートメーションは、メイン セッションでリソースが既に開いている場合、ピクチャ イン ピクチャで正常に実行されません。ピクチャ イン ピクチャでオートメーションを実行する前に、オートメーションでアクセスされる PowerPoint、Excel、または Word のファイルをすべて閉じます。オートメーションで Outlook アカウントが使用される場合は、タスク バー/通知領域に最小化するのではなく必ず Outlook デスクトップ アプリケーションを閉じてください。

5 か月前に更新


自動化の基礎情報


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。