通知を受け取る

UiPath StudioX

UiPath StudioX ガイド

Excel の自動化

Excel の自動化について

StudioX は Microsoft Excel との緊密な連携を提供し、Excel で実行するタスクを自動化する多数のアクティビティを用意しています。

You start by adding the Excel file you want to automate as a resource to the automation project, and then add the activities to perform in the file. When configuring the activities that use the file, you can select sheets, tables, named ranges, and named cells directly from the Plus plus buttonplus button menu in StudioX. You can also seamlessly switch from StudioX to Excel to indicate the data to use directly from the file.

アクティビティの設定中にプラス記号 plus buttonplus button メニューの [Excel 内で示す] をクリックすれば、スプレッドシートが Excel で開き、リボンに [UiPath] タブが表示されます。セルまたはセル範囲など、使用するデータを選択してから [UiPath] タブの [Confirm (確定)] をクリックすることで、選択内容を確定します。

📘

注:

Microsoft Excel 2010 を使用している場合、Excel ファイルの列全体 (例: B:G) を指定しないでください。必ず、特定の範囲 (例: B1:G100) を指定します。Excel の旧バージョンでは、機能上の制約から、列全体を指定するとプロジェクトの実行時にエラーが発生する恐れがあります。

You can also manually indicate the Excel data to use by selecting the Custom Input option in the Plus plus buttonplus button menu. This option enables you to enter cell and range references, table names, or sheet names, which can be useful when you are working with Excel files with dynamic names, or with files that don't exist at design time and no template file is available.

範囲内の各行に同じアクティビティを繰り返す場合は、[繰り返し (Excel の各行)] アクティビティを追加してから、その内部で繰り返すアクティビティを追加します。

Excel タスクの自動化の方法については、このセクションのチュートリアルを参照してください。

Excel 系アクティビティの詳細については、このセクションの各アクティビティの詳しい説明をご覧ください。

📘

注:

実行時と設計時の両方で、Excel ファイルを起動およびプレビューするための方法がいくつかあります。詳細については、「プロジェクト設定」をご覧ください。

オートメーションへの Excel ファイルの追加

Excel ファイルをリソースとしてオートメーションに追加する方法は 2 つあります。2 つの方法の主な違いは、プロジェクト内のどのアクティビティが、Excel ファイルのデータにアクセスし、変更を加えることができるかという点です。

  • Add a Use Excel File resource activity. Using this option, the data in the file can only be extracted or modified by the activities added inside the resource activity. After all the activities inside Use Excel File are executed, the file is closed. This is useful when the file will be created at runtime (e.g. downloaded or saved from an email attachment) or if the file needs to sent to another location (e.g. uploaded or sent as an email attachment).
  • プロジェクトを Excel ファイルに接続します。このオプションを使用すると、ファイルがグローバル リソースとして追加されます。つまり、プロジェクト内のすべてのアクティビティがファイルにアクセスおよび変更できるようになります。オートメーションの実行が完了して初めて、ファイルへの接続が解除されます。これは、ファイル名と場所が変更されず、メールの添付ファイルとしてのアップロードまたは送信など、他の目的でファイルを使用する必要がない場合を意図しています。

Excel ファイルへのプロジェクトの接続

Excel ファイルに接続し、グローバル リソースとして追加するには、次の操作を実行します。

  1. [データ マネージャー] パネルの上部にある [リソースに接続] add resourceadd resource をクリックし、[新しい Excel ファイルに接続] を選択します。
  2. [リソースを管理] ウィンドウで、次の情報を入力して [OK] をクリックします。
    • Excel ファイルを選択 - フィールドの横にある [参照] アイコン browse filesbrowse files をクリックし、オートメーションに追加する Excel ファイルを参照して選択します。
    • 後で使用するために名前を付ける - オートメーション プロジェクトでファイルを参照するときに使用する名前を入力します。
    • 変更を保存 - オートメーションの実行後にファイルが保存されるようにする場合は、このオプションを選択します。選択しないと、変更内容はプロジェクトの実行後に初期ステートに戻ります。このオプションは既定で選択されています。
      変更を保存するオプションが無効な場合、プラス plus buttonplus button メニューおよび [データ マネージャー] パネルの Excel リソースのエントリの横に「(自動保存: オフ)」というメッセージが表示されます。
    • 読み取り専用 - ファイルを読み取り専用モードで開くようにするには、このオプションを選択します。これにより、ファイルの編集がロックされている場合や、編集パスワードが設定されている場合でも、データの抽出操作を実行できます。このオプションは既定で選択されていません。

Excel リソースを管理する

Excel リソースは、オートメーションに追加された方法に関係なく、[データ マネージャー] パネルから管理できます。Excel リソースを右クリックし、コンテキスト メニューのオプションを 1 つ選択します。

  • Excel ファイルを開く - ファイルを Excel で開きます。
  • Excel ファイルの場所を開く - Excel ファイルを含むフォルダーを開きます。
  • 編集 - リソースのプロパティを編集できる [リソースを管理] ウィンドウを開きます。
  • 削除 - プロジェクトからリソースを削除します。

プロジェクト ノートブックについて

プロジェクト ノートブックは、式を保存したりデータを操作したりするメモ帳として使用できる Excel のブックです。その目的は、プロジェクトの実行時に計算や一時データの保存に使用することです。既定では、オートメーションの実行が完了しても、プロジェクト ノートブックに加えた変更は保存されません。

既定のプロジェクト ノートブックは、Project_Notebook.xlsx という名前のファイルで、プロジェクト フォルダーに StudioX によって作成されます。ファイルには、あらゆるオートメーション プロジェクトで使用できる、一連の定義済みの式が組み込まれています。式は、適用対象の分野に応じて、複数のシートに分かれています。各シートに、入力データやそのデータを操作する式を追加できるセルがあります。式は、簡単に識別できる名前付きセルに設定されており、オートメーションで使用するときには、プラス plus buttonplus button メニューから直接選択できます。

プロジェクト ノートブックを構成する

StudioX のリボンから [ノートブック] > [ノートブックを構成] を選択します。以下を設定できます。以下を設定できます。

  • ノートブック ファイル - プロジェクト ノートブックとして使用する、別の Excel ファイルを選択します。
  • 後で使用するために名前を付ける - アクティビティで Excel ファイルを操作するときに、プロジェクトでそのファイルを参照するための名前を入力します。既定の名前は Notes です。
  • アクセス パスワード - ファイルを開くときにパスワードが要求されるようにする場合、そのパスワードを入力します。
  • 編集用パスワード - ファイルを編集するときにパスワードが要求されるようにする場合、そのパスワードを入力します。
  • ファイルを自動保存 - オートメーションの実行後にファイルが保存されるようにする場合は、このオプションを選択します。選択しないと、変更内容はプロジェクトの実行後に初期ステートに戻ります。このオプションは既定で選択されていません。
    変更を保存するオプションが無効な場合、プラス plus buttonplus button メニューおよび [データ マネージャー] パネルのプロジェクト ノートブックのエントリの横に「(自動保存: オフ)」というメッセージが表示されます。
  • 読み取り専用 - ファイルを読み取り専用モードで開くようにするには、このオプションを選択します。これにより、ファイルの編集がロックされている場合や、編集パスワードが設定されている場合でも、データの抽出操作を実行できます。このオプションは既定で選択されていません。

プロジェクト ノートブックの式

以下で、プロジェクト ノートブックで使用できる式について詳しく説明します。プロジェクト ノートブックに式を追加する方法については、「チュートリアル: 独自の式のプロジェクト ノートブックへの追加」を参照してください。

Date

セル B4 (日付) に基準日 (既定は今日の日付)、セル B6 (日数) に日数 (既定は 7) を入力します。この値が、後でシート内のセル B4 の日付に加算されます。次の式を使用できます。

  • 日数が追加された後の日付 - セル B4 に入力した日付に、セル B6 の日数を加算して得られる日付を返します。

  • 稼働日数が追加された後の日付 - セル B4 に入力した日付に、セル B6 の日数 (週末は除く) を加算して得られる日付を返します。

  • 日付形式 (YYYYMMDD) - セル B4 に入力した日付を、YYYYMMDD 形式のテキストに変換して返します。

  • 今日の日付 - 今日の日付を返します。

  • 先週の日付 (月曜日、金曜日、日曜日) - 先週の月曜 (LastWeekMonday)、金曜 (LastWeekFriday)、日曜の日付 (LastWeekSunday) を返します。

  • 先月の日付 (1 日目と最終日) - 先月の最初の日付 (LastMonthStartDate) と最後の日付 (LastMonthEndDate) を返します。

  • 今月の最初の営業日/最終稼働日 - 今月の最初の営業日の日付 (ThisMonthFirstWorkingDay) と最終営業日の日付 (ThisMonthLastWorkingDay) を返します。

ロケールに依存しない方法でテキストを日付に変換

日本語の年、月、日を表す文字を数値の後ろに挿入した日付をセル B18 (テキスト) に入力します。この日付が、MM/DD/YYYY 形式に変換され、セル B29 (再設定された日付) に返されます。

日付シートで式を使う方法の例については、「チュートリアル: ファイルとフォルダーの操作」をご覧ください。

テキスト (Text)

セル B4 (テキスト) にテキストを入力します。セル B4 内で特定のテキストを検索するには、セル B10 (検索する文字列) に検索するテキストを入力します。検索したテキストを別のテキストに置換するには、置換するテキストをセル B11 (置換後の文字列) に入力します。次の式を使用できます。

  • トリム - セル B4 のテキストから余分な空白文字を削除して返します。
  • 長さ - セル B4 のテキストの文字数を返します。
  • 大文字 - セル B4 のテキストを、すべて大文字に変換して返します。
  • 小文字 - セル B4 のテキストを、すべて小文字に変換して返します。
  • 置換結果 - セル B4 のテキストに対して、セル B10 に追加されたテキストを、セル B11 に追加されたテキストで置換した結果を返します。
  • 検索結果 - セル B10 に追加されたテキストが、セル B4 のテキストに含まれるかどうかをチェックします。テキストが見つかった場合は TRUE、見つからなかった場合は FALSE を返します。
  • - セル B4 のテキストの最後の空白文字の前のテキストを返します。
  • - セル B4 のテキストの最後の空白文字の後のテキストを返します。

テキストから値を抽出する

セル B4 に追加されたテキストから特定の値をセル F5 に抽出するには、値の左側のテキストをセル D5 に入力するか、値の右側のテキストをセル E5 に入力します (または、両方に入力)。複数の値を抽出するには、行 6 ~ 9 で同じ列のセルを使用します。これをオートメーションで使用すれば、同じテンプレートに従うテキスト ブロックの中から可変の部分を抽出できます。たとえば、同じラベルが先頭に付けられた、自動化されたメール通知から請求書の番号や金額などの値を抽出できます。

テキスト シートで式を使う方法の例については、「チュートリアル: 自動化されたメールからのデータ抽出と、デスクトップ アプリケーションへのデータ移動」をご覧ください。

Number

セル B4 (数字) に数値を入力します。この数値を操作する、次の式を使用できます。

  • クリーンアップ済み - B4 に追加された数値から、改行とノーブレーク スペース (改行しない空白文字) をすべて削除して返します。
  • 整数 - セル B4 の整数部分を返します。
  • 小数第 2 位 - セル B4 に追加された値を小数点以下 2 桁にして返します。

ロケールに依存しない方法でテキストを数字に変換

桁区切り文字がないか、桁区切り文字としてピリオド (.) を使用していて、かつ小数桁の区切り文字としてコンマ (,) を使用している数値をセル B11 (テキスト) に入力します。この数値が、桁区切り文字としてコンマ (,)、小数桁の区切り文字としてピリオド (.) を使用した値に変換されて、セル B15 (再設定された数字) に返されます。

ファイル (File)

ファイルへのフル パスを拡張子まで含めてセル B6 (ファイル パス) に入力します。次の式を使用できます。

  • ファイル名 - セル B6 に追加されたファイル パスから、拡張子を含むファイル名を返します。
  • ファイル拡張子 - セル B6 に追加されたファイル パスからファイルの拡張子を返します。
  • 拡張子なしのファイル名 - セル B6 に追加されたファイル パスから拡張子を除いたファイル名を返します。
  • フォルダー - セル B6 にパスを追加されたファイルを含むフォルダーへのパスを返します。
  • 再設定されたファイル名 - セル B9 と B10 の値を '.' (ピリオド) で区切って返します。結果は、拡張子付きのファイル名になります。

ファイル シートで式を使う方法の例については、「チュートリアル: 保存、名前の変更、添付ファイルの移動」をご覧ください。

7 か月前に更新



Excel の自動化


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

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