【UiPath】Studio 内の StudioX の機能の使い方【StudioX】

## はじめに
### この記事の執筆環境
この記事の執筆は以下の環境で行っています。
Studio 2025.0.161（Community License）
言語：日本語

### なにをするの？
Studio 内の StudioX の機能について解説してみます。

なんのこっちゃ？という響きの機能ですが、
最近のアップデートでCommunity版のUiPathではStudioXのUIを開くことができなくなっています。

その代替（？）として公式から提供されているテンプレートの紹介と、
個人的に感じているStudioXを使う時との違いを紹介していきます。

:::note
2025年6月7日現在はCommunity版であっても Citizen Developer ライセンスを割り当てることができれば、StudioXのUIを開くことができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/ed024a3c-a7e6-4bc9-837a-9efc34bfc86c.png)
:::

### StudioXのUIを開くことができないとは
今まで「プロファイルを変更」の画面からStudio⇔StudioXの切り替えを行っていました。
「プロファイルを変更」画面は 設定＞ライセンスとプロファイル＞プロファイルを変更 の順に辿ることで表示していましたが、記事執筆時点では「ライセンスとプロファイル」自体が表示されなくなっています。
そのため、変更操作を行うことができなくなっています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/4ee85b51-75e2-4208-8947-2958035d95af.png)

### 関連リリースノート
UiPath 2024 December Community Release

https://forum.uipath.com/t/uipath-2024-december-community-release/785415#p-1862154-studiox-capabilities-into-studio-6

製品版 latest 2024年12月（ビルド番号：2025.0.157）

https://docs.uipath.com/ja/studio/standalone/latest/release-notes/december-2024

## テンプレートの使い方
### UiPathのテンプレートとは
UiPathにはあらかじめ利用できる種々のテンプレートが存在しています。
有名なRE Frameworkもテンプレートの一種ですね。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/491cb3f4-295c-4b34-9b27-4e0d2faa0f5a.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/04d89360-621b-4b91-a16d-316e84babc61.png)
### StudioX用のテンプレート「タスク」を使用してプロジェクトを作成する
前述の画像にも載っている「タスク」という名前のテンプレートが該当します。
一覧にない場合は、テンプレートを検索して使用します。
「task」と検索することで表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/860c0249-bd9c-42a1-9769-2415f22e2f83.png)

いずれかの方法で「タスク」のテンプレートを選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/faf4cf82-0b17-41ef-a5da-30b34769a2b2.png)

「テンプレートを使用」をクリックすることで、タスクの生成画面が開きます。
名前と説明を入力したら「作成」をクリックしてプロジェクトを生成します。
詳細オプションはサッパリしており、StudioXにあったProjectNotebookに関する設定はありません。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/2db9e3db-2ad9-477c-9156-d907ac89f1b3.png)
作成が完了すると、GlobalHandlerX.xamlを含んだプロジェクトが作成されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/deac0235-9825-4927-bee4-10b9989ba75b.png)
プロジェクトフォルダの中を確認すると、Project_Notebookが**2種**作成された状態となっています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/4a855a3c-714c-4a37-9700-843206cf2324.png)

ここまでで、少し違和感はあるものの、StudoXのタスクっぽいプロジェクトが出来上がりました。

#### 「タスク」テンプレートが見つからない時は
テンプレート検索時「タスク」とカタカナで検索すると表示されないことが確認できました。
「task」と検索するようにしてみてください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/357398d3-5a37-41b8-a1d2-dd056cf0d177.png)

## 実際に使ってみる
### Main.xamlを開いて開発を始める
Main ワークフローを開いて、開発の準備をします。
開いたMain.xamlにはSingle Excel Process Scopeが予め設置されています。
この点は、従前からStudioXで作成したタスクをStudioで開いた時と同じになっています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/af31e9ae-96d1-443e-8d92-dfd4b8459e92.png)
### プロジェクトノートブックの値を呼び出してみる
メッセージボックスを使用して、プロジェクトノートブックから今日の日付を表示してみます。
※プロジェクトノートブック自体の解説は[前回の記事](
https://qiita.com/mh_ti_fu/items/63f8e9e03b1d12664fcb "【UiPath】プロジェクトノートブックの使い方【StudioX】")で行っています。

いつも通り＋ボタンから参照しようとするのですが、シートやセルの名前が英語で表示されてしまいます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/132857c1-2be4-4366-92a6-a14efc95c7a2.png)
これは、デフォルトで紐づいているプロジェクトノートブックが英語のファイルになっていることに起因します。
では、日本語にすることは可能なのか？可能です。
先程確認した通り、プロジェクトフォルダの中にはProject_Notebook.ja.xlsxも格納されていますので、紐づけを変えることで、日本語のプロジェクトノートブックを参照することが可能になります。

### 日本語のプロジェクトノートブックを使用する
さっそく、紐づけられたファイルの切り替えを行っていきます。
まずはStudioの画面右側から「データ マネージャー」タブを開きます。
StudioXでは変数の管理に使用したタブになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/be55514e-7e47-4769-a595-a4b3d5943c86.png)
リソース＞Notesを右クリックして、設定をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/17d87368-92a5-49ac-9b6c-af5db70f6bf1.png)
表示された「リソースを管理」でExcelファイルを変更します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/c6d617c8-d077-4583-9354-616b05876ddd.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/2228e0cc-0cb0-4020-bec2-57e480bd8a90.png)
「後で使用するための名前」が自動的に変更されるので「Notes」に戻しておきましょう。
ここで設定した名前が、後ほど「参照名」として表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/5490d450-081a-42e9-9a5a-f9ebac90fd4f.png)

ファイルを変更した後、OKをクリックすることでファイルの紐づけが変更となります。
これにより、＋ボタンから日本語のプロジェクトノートブックを参照することが可能となります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/66ccb482-437d-40a6-bcca-6b62ff42907e.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/c891142e-3144-4741-87a0-b8f40fa29690.png)

### 表示の違い
上記の実行結果を得たメッセージ ボックスのアクティビティは以下となります。
StudioXしか使ったことの無い方は違和感を感じるのではないでしょうか？
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/0517af95-1dba-4b07-b269-fddba141bb6b.png)


StudioXではプロジェクトノートブックの値を参照した場合、以下の形で表示されていました。
[ノートブックの参照名] シート名!セルアドレス
下図であれば 参照名「Notes」のプロジェクトノートブックの「Scratchpad」シートの「B1」セルを示していることが読み取れます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/43c974fa-08e3-4361-911e-e935a06d41d3.png)
シート名!セルアドレス という表記はExcel内で別シートを参照する時の表記と同じです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/04297bf1-918b-47a3-b20e-9a026fb13298.png)
これにより、プログラミングに不慣れであっても、参照元が直感的にわかるようになっていました。
（画像参照元：[チュートリアル: プロジェクト ノートブックに独自の式を追加する](https://docs.uipath.com/ja/studiox/standalone/latest/user-guide/tutorial-adding-your-own-formulas-to-the-project-notebook)

Studioでアクティビティ上で表示されている内容は、
式エディターの内容がそのまま表示されている形となっています。
これが、違和感の正体となります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/044187c2-57b0-498a-9969-d33ab905b715.png)

### エディターの違い
#### 使えるエディターは「式エディター」だけ
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/2eca6763-ef89-4dd2-b824-fa419f9edc08.png)
改めて、＋ボタンをクリックしたところです。
StudioXでは利用場面によって「テキスト」や「数」といった項目が表示され、選択することで対応したエディタが開いていました。
対応したエディタの中で設定を行うことで、設定した内容がある程度自動的にString型、Int型に変換されるようになっていることで、型への意識を抑えることができる仕様となっていました。

Studioで操作する場合、上記の専用エディターが表示されなくなるため、式エディターで編集を行うことが必須となります。

式エディターには、StudioXのエディターと大きな違いがあります。
それは、エディタ内に＋ボタンが無いことです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/c5cc9d7c-c4f4-4075-9541-3e8616019773.png)
エディタ内で「変数」や「プロジェクトノートブックの値」を呼び出すために、StudioXでは＋ボタンを押して参照していましたが、式エディターでは「変数を使用」から選択する形に変更になっています。
そして「変数を使用」の一覧からは「プロジェクトノートブックの値」が**呼び出せなくなって**います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/c7a8330e-291f-42bf-8b45-9e086b34165b.png)

#### プロジェクトノートブックの値を組み合わせて使う時
ここまでで紹介したエディターの変更で大きな影響を受けるのは、エディターの中で文字列とプロジェクトノートブックの値を組み合わせて使用するケースが考えられます。

具体的には、ファイル名にタイムスタンプを付ける処理を考えてみましょう。

テンプレートのExcelファイルをコピーして、
タイムスタンプ付きのExcelファイルを作成する。
と、言った処理で`実行結果_YYYYMMDD.xlsx`を作成するような処理、見たことが無い方はいないかと…

StudioXであれば、テキストエディター内で簡単に表現することができた内容ですが、Studioで式エディターで行うには**事前知識が必要**となります。

コピー先 の式エディターには以下の通りに入力する必要があります。
まず、式エディターの中からプロジェクトノートブックの値を参照する事が出来ないので、先に＋ボタンから参照しておきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/a65c013f-4679-41a8-857b-0c5c82964c64.png)
呼び出した状態で、改めて＋ボタンから式エディターを開きます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/ee2e0ffb-246c-49da-9222-11292b430c52.png)
必要な文字列を追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/e958bc86-bae1-46c8-984a-4b736df99384.png)
ポイントは以下の通りです。
* 固定文字列の部分`実行結果_`と`.xlsx`の部分は`""`で括る
* ノートブックの値を呼び出した部分に `.ToString` を付与して文字列に変換する
* それぞれの文字列を結合して、ひとつの文字列となるように間に`&`を入力する
※文字列をひとつにするための記法は色々と種類があります

どれもStudioで開発を行ってきた方であれば当たり前の事ではありますが、
StudioXでのみ開発を行っていた方には、初見の設定ばかりとなっています。
それだけ StudioXのテキストエディターが**親切に設計されていた**ということですね。

また、**事前知識が必要**と書いていますが、上記の例であればExcel内でセルの値と文字列を結合するのと同じ要領になるので、実は**覚えるのは簡単**だったりします。

上記のように設定することで、実行結果としてタイムスタンプ付きのファイルを生成することができました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/0ff36664-6cdb-40ca-9763-23859f95c313.png)


#### プロジェクトノートブックの値を複数組み合わせて使いたい時
では、プロジェクトノートブック内の複数の値を組み合わせて使いたい時はどのようにすれば良いのか、試してみたいと思います。
プロジェクトノートブック内に時間を取得する式を追加して、`実行結果_YYYYMMDD_hhmmss.xlsx`を作成してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/a5fe6a65-df1b-4bb9-8c5b-bc9fe8dd46d8.png)

先程と同じように、＋ボタンで`hhmmss`を参照してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/dcb86c18-2282-45c6-a8f1-89a7bb8e1fc7.png)
すると、中身は`hhmmss`だけを参照する形に書き換わってしまいます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/66ec995e-52db-442b-b32a-9c3da91e1e35.png)
※マウスを重ねると、式エディターの入力内容が表示されます

やり方はいくつか考えられます。
##### プロジェクトノートブックの中で完結させる
**やり方その①**です
一番、わかりやすいやり方はプロジェクトノートブックの中で`YYYYMMDD_hhmmss`の形を作ってしまう事になります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/b0347581-805c-44b2-8241-b624f3924560.png)
このようにすると、ひとつの値を呼び出すのと同じやり方で、実装することができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/a41ce724-0961-47bf-8dfb-2a6b32fe6ede.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/70ab440b-fb90-463d-9e9a-ddc2f72153ae.png)

しかし、このやり方ではプロジェクトノートブックの中に参照するための値を全部定義しなければならなくなってしまいます。

##### プロジェクトノートブックの中の値を変数として予め取り込む
**やり方その②**です
プロジェクトノートブックの中の値を、予め変数として取り込んでおけば、「変数」として式エディターから呼び出すことが可能になります。
代入アクティビティを使って「保存先」で＋ボタンを押し「変数を作成」します
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/f1f3a705-4cb3-4b38-b4d5-64f84824d99b.png)
`変数を設定`と表示されるので、任意の名前を入力します。
以下では`YYYYMMDD`と変数に名前を付けています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/c82a0571-cd99-4d1f-8519-1dc9b78b1eb3.png)
「保存する値」で＋ボタンを押してプロジェクトノートブックからYYYYMMDDセルの値を設定します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/f143e13a-2128-45ab-8b63-8b7b407951a7.png)

同様の設定をhhmmssにも行います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/079af7ca-6817-46f3-8ef4-9763bb8665c2.png)
この時、変数への格納処理は変数を使いたい処理よりも手前に配置するようにします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/b8ea2d24-791a-44e5-84ee-20bc5504b9ae.png)
設定がうまくいっていると、式エディターの中で「変数を使用」から参照できるようになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/c6fb1455-3bc0-45ca-8bde-41658ad09ddb.png)
変数名の部分をクリックすることで、式エディターの中に呼び出すことができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/d22ef8d7-d870-43a1-86f8-a25e136c4bcb.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/2fc4ad65-0ef2-467f-a464-0898bca0acd9.png)
同様に`hhmmss`を呼び出し、最終的に欲しい文字列の形になるように成型すると、以下のような形となります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/684532ed-2453-43b7-a403-bdf5a9b87f42.png)
実行結果として、日時までのタイムスタンプの入ったファイルを得ることができました！
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/ce366b42-6381-4fcc-8ee0-b507bd12d4ac.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/1d936d25-8b38-4cd4-8656-b9bca538c7ef.png)
※式エディタで変数を使用の表示一覧に、目的の変数が表示されない時は`>`をクリックして表示の展開、折り畳みを行って調整をしてみてください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/07f9ef28-6314-4266-aa2f-2ebafb717f2e.png)

このやり方では無駄な変数が増えて嫌ですか？
そこまで考えが至るのであれば、脱StudioXはすぐそこです。

##### 式エディター内で複数のノートブックの値を参照する
**やり方その③**です
＋ボタンからプロジェクトノートブックの中の値を参照した後、式エディターの中に記載されている`Notes.Sheet("日付").Cell("YYYYMMDD")`という内容に注目します。

この記述は、要するにStudioの**式エディターからプロジェクトノートブックの中の値を参照するためのルール**になっています。
ルールさえ覚えてしまえば、式エディターの中で複数の値を参照することが可能になります。
そしてこのルールは`.`を区切りに分解をしてみると、案外簡単だったりします。

`Notes`の部分はプロジェクトノートブックの参照名です。
プロジェクトノートブックのファイルを設定する際に「後で使用するための名前」に入力した値に相当します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/6130722e-1d37-404a-86fd-fd12d69ca2ea.png)

`Sheet("日付")`の部分は参照したいセルが存在するシート名の指定になります。
`""`で囲まれた部分がシートの名前です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/46e060eb-cf64-46ff-981a-66fe40c21d92.png)

`Cell("YYYYMMDD")`の部分は参照したいセルの名前の指定になります。
`""`で囲まれた部分がセルに付けた名前です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/242f6eac-cfb8-4526-940f-8be6c1fe1c9a.png)

実際に式エディターの中で呼び出してみます。
式エディターの中で`N`と入力すると、候補で`Notes`が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/bb77f4a1-6a2e-4e05-b767-abaec6422d65.png)
`Notes`に続けて`.`を入力することで、シート名の候補が出てきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/8cee57a5-74c7-473c-8db0-7102d2e151f5.png)
目的のシート名をダブルクリックすることで、`Sheet`部分が自動入力されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/01df80a9-c778-40f5-86df-473198da56c9.png)
さらに続けて`.`を入力することで、セル名の候補が出てきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/66e0c9c7-a4f9-4641-894e-9adb71d270b2.png)
目的のセル名をダブルクリックすることで、`CELL`の部分も自動入力されました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/1cae9e94-d729-45b9-92fa-f968a0ce5b9c.png)

ルールまで分解して解説を行いましたが、実は式エディターの中で候補を呼び出していくだけで必要なセル情報を呼び出せるようになっています。
式エディターも**実はかなり親切な設計**になっています。

あとは**プロジェクトノートブックの値を組み合わせて使う時**の項で紹介したポイントに従って組み合わせると、以下のような式が組みあがります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/c2a55817-9012-4e27-8ecd-c87af1d01852.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/354187ae-f75c-4b05-8867-9dece9de5536.png)

実行することで、新たなタイムスタンプの付与されたファイルを生成することができました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/545766/13ff8a69-1f4f-4a74-ba54-dabe2c00ff8d.png)

※セル名の選択の際、項目が多すぎて目的のセル名に辿り着けないことも発生するかと思います。そんな時は、適当なセル名を選んだあと`Cell("")`の`""`内を任意のセル名に書き換えることで同じ結果を得られます。

## さいごに
**Studio内にStudioXの機能が内包された**という趣旨のアップデートを受けて、実際にどのようにすればStudioXライクな開発を行うことができるのか考え、プロジェクトノートブックの参照方法と式エディターの使用方法について紹介してみました。

実は紹介した内容は、Studioユーザーであっても、モダンプロジェクト化した後のExcel内のセルの値の参照方法と同じだったりします。

改めて、モダン化したStudioのプロジェクトと言うのは、様々なところでStudioXから輸入された要素が多いのだと学びになりました。

ちなみに、このアップデートは前回「プロジェクトノートブックの使い方について」の記事を書いた時点で、実は適用されていました。記事を読んだ時点でアクティビティパネル上の**違和感**に気付いた方がいらっしゃったとしたら、その方はStudioXマスターを名乗って良いと思います(笑)

長文となりましたが、最後までお読みいただき、ありがとうございました。