Updating package variables

View and manage package variables that are added to your project through custom packages. Package variables store values that can be shared or reused across services. You can link package variables to the vault for centralized management and enhanced security.

About this task

All variables added to a project through a package are displayed in the Variables page. The variables can be either global or package-specific. The variables are accessible at the project-level and not across projects in a tenant.

Note: For project and tenant-level variables that are used in flow services, see About Tenant and Project Variables.

Package variables can be linked to the vault, providing centralized management and synchronization capabilities. When a package variable is linked to the vault:

  • The variable value is stored securely in the vault.
  • The variable can be synchronized across multiple projects.
  • Changes to the vault value can be propagated to all linked projects.
  • The variable becomes read-only in the project and can only be modified through the vault.

Procedure

  1. From the navigation pane, go to Projects and select a project.
  2. Click Configurations > General > Variables.

    The Variables page displays all relevant variables, whether from the project or custom packages. These variables are accessible at the project-level and not across projects in a tenant.

  3. Click Edit to update the variables.
  4. In the Edit Variables dialog, update the variable in one of the following ways:
    • Enter the new value for the selected variable.
    • Click Update Variable.
    • To link the package variable to the vault, enable the Select from Vault toggle switch.
    • Enter the variable value.
      Note: If the variable does not exist in the vault, a new vault entry is created by using the specified value. If the variable already exists, the existing vault value is used.
    • Click Update Variable.

      The package variable icon changes to a Vault Item icon, indicating the variable is now linked to the vault.

    Note:
    • Once a package variable is linked to the vault, the variable becomes read-only in the Edit Variables dialog.
    • To modify a vault-linked variable, you must update it through the vault interface.
    • Updating a variable overwrites its previous value.
    • Changes apply only to the current project and are not pushed to the external repository.
    • If the variable was overridden from a self-managed runtime, that value takes precedence over the project-level update.
  5. To unlink a package variable from the vault:
    1. Open the Edit Variables dialog for the variable.
    2. Disable the Select from Vault toggle switch.
    3. Click Update Variable.
  6. Optional: To revert package variable changes, click the Revert icon to restore the original value provided in the package.
    Note:
    • Changes are reverted only after you restart Cloud Designtime.
    • If the variable is linked to the vault, reverting the variable unlinks it from the vault and restores the original package value.
  7. Click Sync variables to update the variables with the Cloud Designtime. This option is enabled only when the variables are not in sync with Cloud Designtime.
    Note: Package variables that have been overridden at the project level are indicated by a special icon on the Variables page. This helps you distinguish between:
    • Variables that use the default package value.
    • Variables that have been customized at the project level.