通知を受け取る

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

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

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

  • 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.

項目の反復処理

Iterating refers to repeating one or more activities in your automation project for each individual item in a collection of items. To iterate through items, add one of the available For Each activities in which you define the collection, and then add the activities to repeat inside the For Each. When you configure the activities to repeat, indicate that an activity should use data from each item in the iteration by selecting the current item option from the Plus plus buttonplus button menu.
StudioX には、次の「繰り返し」系アクティビティが付属しています。

  • For Each Excel Row - Repeat one or more activities for each row in an Excel table, range, or sheet.
    The current item option is CurrentRow. For some activities, you must also select which column to use from the current row.
  • For Each Excel Sheet - Repeat one or more activities for each sheet in an Excel file.
    The current item option is 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.
  • 条件ビルダー - 条件を満たすかどうかに基づいて実行するアクティビティを判断する場合に使用される条件ステートメントを追加します。たとえば、[条件分岐 (if)] アクティビティには条件フィールドが含まれ、その条件を満たすと一連のアクティビティが実行され、必要に応じて、条件を満たさない場合は他の一連のアクティビティが実行されます。
    2 つの値を選択し、利用可能な演算子 ([次の値より大きい]、[次の値以上]、[次の値より小さい]、[次の値以下]、[次の値と等しい]、[次の値と等しくない]、[空である]、[空ではない]、[true である]、[false である]、[次の値で始まる]、[次の値で終わる]、[次の値を含む]、[数字である]、[数字でない]) を 1 つ使用してその 2 つの値を比較することによって、条件ステートメントを作成します。
    複数のステートメントを追加し、条件を満たすにはすべてのステートメントが true である必要があるか、任意のステートメントが true であればよいかを選択できます。
  • 保存された値を使用 - プロジェクトの後工程で使用できるように保存した別のアクティビティの出力を、現在のフィールドの入力として使用します。
  • [日付/時刻を選択] - カレンダーの日付または時刻 (時、分) を選択します。このオプションは、日付と時間のフィールドで使用できます。
  • 期間を選択 - 期間を選択します (時、分、秒)。このオプションは、期間のフィールドで使用できます。
  • 実行時に確認 - プロジェクトの実行時に値の入力を求めます。テキスト、数値、日付/時刻、または Boolean 値 (True/False) を入力できるフィールドに使用できます。
  • クリップボードから貼り付け - 別のアクティビティでクリップボードにコピーした出力値を、現在のフィールドの入力として使用します。このオプションは、テキスト値または Excel の範囲を受け入れるフィールドで使用できます。
  • 変数 - アプリ/Web 系のアクティビティのセレクターで使用するために作成された変数を選択します。
  • タスクの引数 - 作成した引数を選択して、StudioX アクティビティとアプリケーションの間でデータを渡します。
  • 詳細エディターを開く - 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 系のアクティビティのセレクターで使用するために作成された変数を選択します。
  • タスクの引数 - 作成した引数を選択して、StudioX アクティビティとアプリケーションの間でデータを渡します。
  • 詳細エディターを開く - VB の式を入力します。
  • 値をクリア - フィールドの現在の選択内容をクリアします。

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

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

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

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

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

引数の管理

Arguments are used to pass data between activities in a project and can be used to integrate an workflow with other products such as UiPath Apps.

設定後は、[後で使用するために保存] を使用するのと同様の方法で、引数をアクティビティで使用できます。

引数を作成する

  1. [データ マネージャー] パネルで [引数] argument buttonargument button ボタンをクリックします。
  2. [+ 追加] をクリックして新しい引数を作成します。
  3. 引数の横にあるプラス記号 plus buttonplus button メニューをクリックして、値を設定します。

既定では、新しい引数はすべて String 型で、[入力] 方向を持ちます。引数は、使用方法に基づいて設定できます。

  • - 引数に格納する値の型を選択します。次のオプションがあります。
    • Boolean - This type has only two possible values: true または false. These arguments enable you to make decisions, and therefore have a better control over your workflow.
    • Int32 - 数値情報を格納できます。数式や比較を実行したり、重要なデータを渡したりするために使用します。
    • String - テキスト情報を格納できます。この引数の型は、従業員名、ユーザー名、その他の文字列などのテキストベースの情報を格納するために使用できます。
    • Object - さまざまな型のデータを格納できます。この引数の型は、引数に格納するデータの型に柔軟性が必要な場合に使用できます。Object 型引数で使用するデータ型が、引数を使用するアクティビティに対応していることを確認してください。
    • System.Data.DataTable - この型は多くの情報を格納でき、データベースまたは行と列を持つ簡易なスプレッドシートとして機能します。データベース間で特定のデータを移行する場合や、Web サイトから情報を抽出してローカルのスプレッドシートに格納する場合などに役立ちます。
    • Array of [T] - 同じ型の値を複数格納することができます。
    • 型の参照 - タスクに関連がありそうな型をさらに検索できます。
  • 方向 - アプリケーションで使用する場合の、引数の方向を選択します。次のオプションが利用できます。
    • 入力 – この引数は、指定したプロジェクト内でのみ使用できます。
    • 出力 - この引数は、指定したプロジェクトの外にデータを渡すために使用できます。
    • 入力/出力 - この引数は、指定したプロジェクトの内外両方で使用できます。

引数の削除

  1. [データ マネージャー] パネルで [引数] argument buttonargument button ボタンをクリックします。
  2. 削除する引数の横にある X をクリックします。

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

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

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

965965

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

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

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

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

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

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

📘

注:

Microsoft Office のリソースを使用するオートメーションは、メイン セッションでそのリソースが既に開いている場合、ピクチャ イン ピクチャで正常に実行されません。ピクチャ イン ピクチャでオートメーションを実行する前に、オートメーションでアクセスされる PowerPoint、Excel、または Word のファイルをすべて閉じてください。

11 か月前に更新


オートメーションの基礎情報


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

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