Workatoのプロパティ変数を活用する方法：Environment PropertiesとProject Propertiesの違い

# はじめに
一般的にアプリケーションでは、接続先や固定値をパラメーターとして設定しておくことで、開発から本番環境への移行が容易になります。Workatoではどのように設定すればよいのでしょうか？

この記事では、Workatoでパラメーターの設定方法、利用方法をご説明します。

# プロパティ変数を用いて設定することが可能
Workatoでは以下の2種類のプロパティ変数を設定することが可能です。
それぞれ紹介します。
* Environment properties：ワークスペース全体でパラメーターを管理
* Project properties：プロジェクト単位でパラメーターを管理

# Environment propertiesについて
Environment propertiesはワークスペース全体でレシピの設定パラメーターを管理することができます。つまり、どのレシピからも参照できるので、ワークスペース全体の共通メッセージ等を管理することに適しています。

### Environment propertiesの権限設定
Environment propertiesを利用するためには、以下の権限を設定する必要があります。
この権限の設定内容はWorkatoドキュメントの[Data storage](https://docs.workato.com/privileges.html#data-storage)の参照をお願いします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3455960/05f57cbc-f174-9954-299d-e8c94164ab19.png)


### Environment propertiesの設定方法
サイドバーの"Tools" > "Environment properties"に遷移することで設定できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3455960/26bf09f7-e737-fb99-1d9d-d9f6a1d116a3.png)

Environment propertiesはプロパティ名と値のセットで登録をします。
※最大100個まで登録することが可能です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3455960/288ecf57-4cb3-f165-e639-ad8cd51f959b.png)

### Environment propertiesの利用方法
レシピでは、データピルのPropertiesに表示されているEnvironment propertiesのオブジェクトからプロパティ名を選択することで、利用が可能です。
![20240829_1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3455960/dcd01604-e4f8-9b09-c7a7-8a38cd889f9e.png)




# Project propertiesについて
Project propertiesはワークスペース内のプロジェクト単位に設定をすることが可能です。つまり、Environment propertiesよりスコープを狭くし、各プロジェクトで固有の設定値を管理することに適しています。

### Project propertiesの権限設定
Project propertiesを利用するためには、以下の権限を設定する必要があります。
権限の設定内容はWorkatoドキュメントの[Data storage](https://docs.workato.com/privileges.html#data-tables)の参照をお願いします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3455960/f1027847-e926-6389-31fb-29251fcb57b7.png)

### Project propertiesの設定方法
プロジェクトのタブの"Setting" > "Project properties"に遷移することで設定できます。
Environment propertiesと同様にプロパティ名と値のセットで登録をします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3455960/45c64e9e-09b7-0ab7-98ee-8b8463c8cf3b.png)


### Project propertiesの利用方法
レシピでは、データピルのPropertiesに表示されているProject propertiesオブジェクトからプロパティ名を選択することで、利用が可能です。
![20240829_2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3455960/c73de5a6-9256-787b-82cb-442d9de4b2f0.png)




# まとめ
まとめると、以下のようになります。

* ワークスペース全体でレシピの設定パラメーターを管理する場合は、Environment propertiesを利用することで全てのレシピで利用が可能です
* プロジェクトの内部だけでレシピの設定パラメーターを管理する場合は、Project propertiesを利用することでプロジェクトの内部だけで利用が可能です

# おわりに
いかがでしょうか？ WorkatoではEnvironment propertiesやProject propertiesを活用することで、用途にあったパラメーターを柔軟に設定することができます。

Workatoの導入・導入後の活用などでお困りの場合、Workatoリセラーにご相談する方法もございます。お困りごとがございましたら、認定リセラーの[日立ソリューションズ](https://www.hitachi-solutions.co.jp/rpa/sp/products/workato/?utm_source=sns&utm_medium=qiita&utm_campaign=c4097b5ab802e16756cb)へ是非ご相談ください。

# 参考リンク

* 株式会社 日立ソリューションズ
    * [Workato ご紹介サイト](https://www.hitachi-solutions.co.jp/rpa/sp/products/workato/?utm_source=sns&utm_medium=qiita&utm_campaign=c4097b5ab802e16756cb)
* Workato 公式サイト
    * [Environment propertiesの権限設定](https://docs.workato.com/privileges.html#data-storage)
    * [Project propertiesの権限設定](https://docs.workato.com/privileges.html#data-tables)