UiPath Excel ワークブックのシートを取得 アクティビティ
(プロジェクト設定:モダンExcelの設定でクラシックを使う場合のアクティビティです)
「ワークブックのシートを取得」はUiPathでExcelのブックから番号指定で
シート名を取得するアクティビティです。
この記事ではその使い方と機能を紹介します。
アクティビティの使い方
まず「Excel アプリケーション スコープ」を設置しブックのパスに読み込むファイルを指定します。
そして「Excel アプリケーション スコープ」の中に「ワークブックのシートを取得」をドラッグします。
![「Excel アプリケーション スコープ」の中に「ワークブックのシートを取得」をドラッグする図解](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-60.png)
読み込むシートのサンプルは下のようになっています。このシート名を取得します。
![読み込むシートのサンプル](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-61.png)
まず「ワークブックのシートを取得」の「入力-インデックス」プロパティに
0から始まるシートの番号を設定します。0で最初のシート、1で2番目のシートになります。
![「ワークブックのシートを取得」アクティビティの「入力-インデックス」プロパティに0から始まるシート番号指定する図解](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-64.png)
シート名の取得をするには内容を受け取る変数も必要です。
変数はString型で設定し、その変数を「ワークブックのシートを取得」の
「出力」プロパティの結果に指定します。
![String型の変数を宣言し、出力プロパティに指定する図解](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-62-1024x541.png)
今回は受け取った変数をメッセージボックスに表示します。
![メッセージボックスにシート名変数を指定するキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-63.png)
この状態でUiathを起動すると指定ブックの2番目のシート名が表示されます。
![「ワークブックのシートを取得」の「入力-インデックスに」1(2番目)を指定するキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-65.png)
![読み込みブックのキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-66.png)
![指定したシート名が表示されるキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-67.png)
インデックスを0にすると最初のシート名が表示されます。
![「ワークブックのシートを取得」の「入力-インデックスに」0(1番目)を指定するキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-68.png)
![読み込みブックのキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-69.png)
![指定したシート名が表示されるキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-70.png)
用途
単純にシート名が欲しい場合や
シートの位置は分かるが名前が不確定のシートを
他のExcelアクティビティの対象とする場合に使用します。
多くのアクティビティはシート名を処理対象とするため
「ワークブックのシートを取得」でシート名を取得し、そのシート名を
他のアクティビティのシート指定に使用します。
プロパティ
共通
表示名を設定します。
![表示名のキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-71.png)
表示名はデザイナーパネルに反映されます。
![デザイナーパネルの表示例](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-72.png)
「ワークブックのシートを取得」アクティビティが一つであればそのままで良いですが
複数ある場合はどのファイル・ブックからどのシートを取得するかを考慮した
名前として付けるようにしましょう。
入力
シート名を取得するシートの番号を指定します。
0から始まる連番で、0では最初のシート(一番、左)
1では左から2番目のシートを取得します。
![入力のキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-73.png)
出力
値を受け取るString型の変数を指定します。
![出力のキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/11/image-74.png)
その他
UiPathのログに引数や変数の値が表示されるかを指定します。
機密性の高い情報を取り扱う場合にのみチェックする必要があります。
![プライベートのキャプチャ](https://blog-tips.sekenkodqx.jp/wp-content/uploads/2019/10/image-246.png)