Excel アクティビティ パッケージについて

The UiPath.Excel.Activities package helps automate all aspects of Microsoft Excel, which is one of the most commonly used tools across industries. It contains activities that allow you to read information from a cell, columns, rows, or ranges, write to other spreadsheets or workbooks, execute macros, and even extract formulas. Moreover, you can sort data, color-code it, or append additional information.

重要: バージョン 3.0.0 より、レガシ プロジェクトでクラシック アクティビティはサポートされなくなりました。引き続き 3.0.0 より前のバージョンのクラシック アクティビティを使用できます。詳しくは、「今後削除される機能」をご覧ください。

適合性 (正常に動作する割合)

注: UiPath.Excel.Activities パッケージは、次の Microsoft Excel バージョンに対応しています。

• 2013
• 2016
• 2019
• 2021 年
• 2024 年
• Office 365
• Office 2024

構成

You can enable the modern experience as explained in Project Settings.

モダン アクティビティ

「モダン」に分類されているアクティビティは、もともと StudioX プロファイル向けに設計された最新のアクティビティです。

The Excel Modern design experience and activities provide the same functionality of the StudioX business activities by default in Studio. Follow the tutorial section to find out more about working with Excel activities in Studio. For a full guide, check the Excel Automation in the StudioX guide.

Studio Modern design experience

A modern design experience is available in the Studio profile starting with Studio v2021.10 and UiPath.Excel.Activities v2.11.0. In the modern experience, the modern activities replace the classic activities in the Studio profile, and the StudioX design experience is brought to Studio.

The modern design experience is enabled by default. You can select the design experience for each project from the Excel activities project settings. When the classic experience is enabled for a project, the classic app integration activities that do not support interacting with Excel from the plus menu are available in the Activities panel in Studio instead of the modern activities.

チュートリアル

Add the Use Excel File scope activity to indicate the file to automate and configure its child activities by selecting Excel data from the plus menu of each property without having to manually enter expressions:

1. Use the folder icon to browse the contents of the file and select data that matches the type of each property. For example, you can select cells, ranges, tables, sheets, or charts from the worksheet. You can also indicate the current row or current sheet in an iteration.
   
   
   
   
2. If you find it easier to work in Excel, in the In range field, select the plus menu for more options, then select Excel, and then Indicate in Excel to select data directly from the file.
   Note: This functionality requires that you install the Excel Add-in.
   
   
   
   
   
3. [カスタム入力] オプションでは、表、グラフ、またはシート名に基づいて入力値を手動で指定するか、セルまたは範囲の参照を入力できます。
   
   

   

   
   

If the file you want to automate does not exist yet, you can still use the options in the plus menu by defining a file with the same structure as a template in the Use Excel File activity.

Choosing the most suitable activity type

To decide which type of activity you should use, check the following table.

Note: Modern activities include a wider range of options than classic ones.

Activity type	プロジェクトの対応 OS	Excel installation required	パフォーマンス	ユーザー エクスペリエンス	Best used when
Use Excel File (Modern)	Windows, Cross-platform	はい	High (memory optimized)	Visual and guided (Plus menu, Indicate in Excel)	Building modern workflows, working across profiles.
Excel Application Scope (Classic)	Windows, Windows-legacy	はい	Best for large or complex user interface tasks.	Manual setup required	Automating legacy Excel user interface workflows. Classic Excel activities are not suitable for new automations. It is recommended to use modern activities instead.
ワークブック アクティビティ	Windows, Cross-platform, Windows-legacy	いいえ	Good for lightweight headless operations.	Simple expression-based	Excel is not installed, or the user interface is not required.

ワークブック アクティビティ

Workbook activities can be executed even if Microsoft Excel is not installed on the machine and can only read or write data to and from the file.

アクティビティで処理するファイルは、次の 2 つの方法のいずれかで指定できます。

• 各「ブック」系アクティビティでファイル パスを指定します。このオプションを使用すると、ファイルは、そのファイルを処理する各アクティビティの実行時にメモリに読み込まれます。このオプションは、小さいファイルに最適です。
• Connect your Studio project to the Excel file from the Data Manager to add it as a resource, then reference the resource in each Workbook activity by selecting it from the plus menu. Using this option, once the file is loaded, it remains in the memory until all the activities in the defined scope are executed, providing the best runtime performance when working with larger files and a larger number activities. To optimize performance, set the scope to the container closest to where the activities that use the resource are placed in the workflow. For more information, check Using the Data Manager.

[アプリの連携] カテゴリのアクティビティ

[アプリの連携] に分類されているアクティビティについては、アクティビティを実行するマシンに Excel アプリケーションがインストールされている必要があります。多数の行と列を含む大規模で複雑なスプレッドシートの場合は、[アプリの連携] カテゴリのアクティビティを使用することをお勧めします。これらのアクティビティによって、最適なパフォーマンスと整合性を確保できるからです。

これらのアクティビティを動作させるには、CSV アクティビティを除くすべての [アプリの連携] カテゴリのアクティビティを [Excel アプリケーション スコープ] に含める必要があります。Excel アクティビティ パッケージのバージョン 2.10.4 からは、これらのアクティビティも [Excel ファイルを使用] アクティビティに含めることができます。

専用のアクティビティでは .csv ファイルを操作できますが、他のすべてのアクティビティでは、.xlsx および .xls を操作できます。[Excel アプリケーション スコープ] でのみ動作するアクティビティは、.xlsm ファイルも操作できます。

トラブルシューティングと制限事項

Note: The Excel Activities Pack does not support the old Excel Binary File Format (.XLS) specific to Microsoft Excel 95.

• When you use activities that read, copy, or append ranges, if a cell contains formatting information, Excel considers that cell as containing data, even though it appears empty.

• The Microsoft Office 2016 version 1708 (Build 8431.2079) changes the window title of files that are being edited and saved from "FileName.xlsx - Excel" to "FileName.xlsx - Saved". After closing the file, the filename reverts to normal.

  これにより、オートメーション プロジェクトで、ウィンドウのタイトルが含まれているセレクターを使用する場合に、問題が発生する場合があります。たとえば、Excel のバージョンが前述のセレクター (<wnd app='excel.exe' cls='XLMAIN' title='FileName.xlsx - Excel' /> <wnd cls='EXCEL7' title='FileName.xlsx' />) である場合は、続くセレクターが機能しなくなります。この問題を回避するには、動的変数セレクターを使用することをお勧めします。
• Some Excel versions, for example, Excel 2019, always open SharePoint documents in read-only mode. You can check if a remote document supports editing by opening it manually in Excel on your local machine.