mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-23 06:27:57 +00:00
40 lines
2.7 KiB
Markdown
40 lines
2.7 KiB
Markdown
|
---
|
||
|
|
id: variables
|
||
|
|
title: Workspace Variables Migration
|
||
|
|
---
|
||
|
|
|
||
|
|
<div className='badge badge--warning heading-badge'>Deprecated</div>
|
||
|
|
<br/><br/>
|
||
|
|
|
||
|
|
Workspace variables were used in ToolJet to store values such as tokens, secret keys, API keys, etc. But currently **Workspace variables are marked as deprecated, indicating that it will be removed in future releases**. In the current version, you are still able to delete existing variables and use it through out any ToolJet apps, but creating and updating variables are no longer supported.
|
||
|
|
|
||
|
|
Please use **[Workspace Constants](/docs/security/constants/)** instead. This guide will help you migrate from **Workspace Variables** to **Workspace Constants**.
|
||
|
|
|
||
|
|
## Workspace Constants
|
||
|
|
|
||
|
|
Workspace Constants are predefined values that enhance consistency, simplify updates, and securely store sensitive information across applications within a workspace. Unlike other variables, they are resolved exclusively on the server side, ensuring a high level of security by preventing client-side exposure. Refer to **[Workspace Constants](/docs/security/constants/)** guide for more information.
|
||
|
|
|
||
|
|
## Migrating from Workspace Variables to Workspace Constants
|
||
|
|
|
||
|
|
To migrate from Workspace Variables to Workspace Constants, you need to create new constants and store each value, follow the steps in **[Creating Workspace Constants](/docs/security/constants/#creating-workspace-constants)** guide.
|
||
|
|
|
||
|
|
Once you have migrated all the Workspace Variables to Workspace Constants, you can replace the Workspace Variables in your apps with their corresponding Workspace Constants.
|
||
|
|
|
||
|
|
### Replacing Workspace Variables with Workspace Constants
|
||
|
|
|
||
|
|
- Navigate to the app or data source where you want to replace the Workspace Variables.
|
||
|
|
- Replace the Workspace Variables with their corresponding Workspace Constants. <br/>
|
||
|
|
For example, if you have a Client Workspace Variable like `%%client.pi%%`, replace it with `{{constants.pi}}`. <br/>
|
||
|
|
<img className="screenshot-full" src="/img/workspace-const/client-side-variable.gif" alt="Workspace constants"/>
|
||
|
|
|
||
|
|
<img className="screenshot-full" src="/img/workspace-const/server-side-variable.gif" alt="Workspace constants"/>
|
||
|
|
|
||
|
|
### Deleting Workspace Variables
|
||
|
|
|
||
|
|
After migrating all Workspace Variables to Workspace Constants and thoroughly testing your applications, you can delete the Workspace Variables. To remove a Workspace Variable, follow these steps:
|
||
|
|
|
||
|
|
1. Navigate to the Workspace Variables tab in the Workspace Settings. <br/>
|
||
|
|
(Example URL - `https://app.corp.com/nexus/workspace-settings/workspace-variables`)
|
||
|
|
|
||
|
|
2. Click on the delete icon next to the Workspace Variable you want to delete.
|
||
|
|
<img className="screenshot-full" src="/img/workspace-const/delete-variable.gif" alt="Workspace constants"/>
|