StudioX

2020.10

偽

サポート対象外

StudioX ユーザーガイド

最終更新日 2023年12月20日

Excel の自動化

Excel の自動化について

StudioX は Microsoft Excel との緊密な連携を提供し、Excel で実行するタスクを自動化する多数のアクティビティを用意しています。Excel アドインのインストールについて詳しくは『UiPath Studio ガイド』をご覧ください。

まず、自動化する Excel ファイルをリソースとしてオートメーションプロジェクトに追加し、次にそのファイルで実行するアクティビティを追加します。ファイルを使用するアクティビティを設定するときは、シート、表、名前付き範囲、名前付きセルを StudioX のプラス記号 のメニューから直接選択できます。また、StudioX から Excel にシームレスに切り替え、使用するデータをファイルから直接指定することもできます。

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

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

プラス記号 のメニューから [カスタム入力] オプションを選択して、使用する Excel データを手動で指定することもできます。このオプションを使用して、セルおよび範囲の参照、表の名前、シート名を入力できます。動的な名前の Excel ファイルや、設計時に存在せず利用可能なテンプレートファイルがないファイルを扱うときに役立ちます。

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

Excel タスクを自動化する方法については、以下のチュートリアルをご覧ください。

StudioX では以下のアクティビティが利用可能です。

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

Excel ファイルをオートメーションに追加する

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

[Excel ファイルを使用] リソースアクティビティを追加します。このオプションを使用すると、リソースアクティビティ内に追加されたアクティビティだけがファイル内のデータを抽出または変更できます。[Excel ファイルを使用] 内のすべてのアクティビティが実行された後に、ファイルが閉じます。これは、ファイルが実行時に作成される場合 (メールの添付ファイルからダウンロードまたは保存する場合など) や、ファイルを別の場所に送信する必要がある場合 (メールの添付ファイルとしてアップロードまたは送信する場合など) に役立ちます。
プロジェクトを Excel ファイルに接続します。このオプションを使用すると、ファイルがグローバルリソースとして追加されます。つまり、プロジェクト内のすべてのアクティビティがファイルにアクセスおよび変更できるようになります。オートメーションの実行が完了して初めて、ファイルへの接続が解除されます。これは、ファイル名と場所が変更されず、メールの添付ファイルとしてのアップロードまたは送信など、他の目的でファイルを使用する必要がない場合を意図しています。

プロジェクトを Excel ファイルに接続する

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

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

Excel リソースを管理する

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

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

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

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

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

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

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

ノートブックファイル - プロジェクトノートブックとして使用する、別の Excel ファイルを選択します。
後で使用するための名前 - アクティビティで Excel ファイルを操作するときに、プロジェクトでそのファイルを参照するための名前を入力します。既定の名前は Notes です。
アクセスパスワード - ファイルを開くときにパスワードが要求されるようにする場合、そのパスワードを入力します。
編集用パスワード - ファイルを編集するときにパスワードが要求されるようにする場合、そのパスワードを入力します。
ファイルを自動保存 - オートメーションの実行後にファイルが保存されるようにする場合は、このオプションを選択します。選択しないと、変更内容はプロジェクトの実行後に初期ステートに戻ります。このオプションは既定で選択されていません。

変更を保存するオプションが無効化されている場合、プラス記号 のメニューおよび [データマネージャー] パネルのプロジェクトノートブックのエントリの横に「(自動保存: オフ)」というメッセージが表示されます。
読み取り専用 - ファイルを読み取り専用モードで開くようにするには、このオプションを選択します。これにより、ファイルの編集がロックされている場合や、編集パスワードが設定されている場合でも、データの抽出操作を実行できます。このオプションは既定で選択されていません。

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

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

日付

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

日数が追加された後の日付 - セル B4 に入力した日付に、セル B6 の日数を加算して得られる日付を返します。
稼働日数が追加された後の日付 - セル B4 に入力した日付に、セル B6 の日数 (週末は除く) を加算して得られる日付を返します。
日付形式 (YYYYMMDD) - セル B4 に入力した日付を、YYYYMMDD 形式のテキストに変換して返します。
今日の日付 - 今日の日付を返します。
先週の日付 (月曜日、金曜日、日曜日) - 先週の月曜 (LastWeekMonday)、金曜 (LastWeekFriday)、日曜の日付 (LastWeekSunday) を返します。
先月の日付 (1 日目と最終日) - 先月の最初の日付 (LastMonthStartDate) と最後の日付 (LastMonthEndDate) を返します。
今月の最初の営業日/最終稼働日 - 今月の最初の営業日の日付 (ThisMonthFirstWorkingDay) と最終営業日の日付 (ThisMonthLastWorkingDay) を返します。

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

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

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

テキスト

セル 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 (再設定された数字) に返されます。