Help Desk

Submit a ticket My Tickets
Welcome
Login

Variables

In OneCloud, variables take many different forms depending on where they are created and used. This guide will explore different types of variables and their usage.

Simple variables

Simple variables are inputs that can be set and reused during the Chain execution. Variables defined for a Workspace can be used across all Chains, and variables defined for a Chain can only be used for that Chain.

For your reference, here is a quick summary of OneCloud’s simple variables:

System Variables

There are a variety of system-level variables that are available by default. The following lists what is currently available:

VariableDescription
Chain Variables
Chain IDThe numeric ID of the Chain in the non-running state
Chain Executer IDThe numeric ID of the currently running Chain
Chain EnvironmentThe Environment of the currently running Chain
Chain NameThe name of the currently running Chain
Chain URLThe unique URL of the currently running Chain
Chain Execution Date & TimeThe date and time of the current Chain has started
Chain Previous Execution Date & TimeThe date and time of when the Chain last ran
Command Variables
Command IDThe numeric ID of the Command in the non-running state
Command Executor IDThe numeric ID of the currently running Command
Command NameThe name of the currently running Command
Command URLThe unique URL of the currently running Command
Runner Installation DirectoryThe location of a Command's GroundRunner (note: NULL with a CloudRunner)
System Date & Time Variable
System DateThe current system date
System Data & TimeThe current system date and time
User EmailThe email of the user running the Chain
User NameThe name of the user running the Chain
User IdThe numeric ID of the user running the Chain

System Variables

System variables are globally available and can be modified and formatted by leveraging variable transformation.

Command Outputs

Command Outputs can be considered variables since, depending on the command and usage, they can hold different data be leveraged by various commands. 

Start Using Variables

Variables can be used as inputs to Commands, and they are available in any text-based Command input. To start using variables, select a Command with text input, and a variable selector will appear on the lefthand side of the Command. After selecting a variable, the variable will appear as a bubble in the relevant field.

Connect your Commands!

If a Command is not connected to another one on the Chain, the previous Command's outputs will not be available in the variable menu. Make sure the Command is connected to the rest of the Chain before adding variables.

To remove a variable, use the backspace or delete key when the cursor is adjacent to the variable.

Variable and Text Concatenation

Note that for text fields, multiple variables can be selected and concatenated with text strings. Upon execution, the variables and text will be concatenated together.

Variable Composition

Variable composition allows Chain and Workspace variables to contain other variables at the same level or above. This feature allows a range of possibilities to create new variables from existing variable values. The following is an example of creating a new file variable, "stacked_file", from the value of "stacked_file_dir". 


What's Next?

Learn how to use Dynamic Outputs.

B
Brian is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.