States
States are magnificent, they are holders of your data in an orderly manner and provide a flexible wat of storing and retrieving that data.
What a state is
In its essence a state is just a list of Key/Value's. There are though different kind of states
Workspace state
Each workspace has a single state for workspace related data.
You could store API urls here or other Workspace related data.
This state is readable throughout all operations but only writable from the workspace settings
Vault state
Each workspace has a vault, the contents of this state can only be read by non-human readable settings such as in adapters. Note: while you can use the vault state in adapters their values are not present in the logs for security reasons
This state is readable throughout all operations but only writable from the workspace settings
Execution environment state
Each execution environment has its own state where you can store specific details such as a Test authentication token.
This state is readable throughout all operations but only writable from the execution environment settings
Ticket
Each Ticket has its own state, you can store ticket related data in here
This state is readable and writable throughout all operations.
Flow
Each Flow has its own state, you can store flow related data in here This state is usually used to hold answers within a flow and is continued to be used in sub-flows.
This state is readable and writable throughout all operations.
Communicator
Each Communicator has its own state, you can store communicator related data in here.
Note: When assigning state items known as communicator properties these will also be updated
Communicator properties you can set by storing data in it's state are: - Name => Stored as the communicator name
This state is readable and writable throughout all operations.
Tick
This state is somewhat different from the others because it is a read-only state from where you can ask Tick about its state
Current supported Tick states are:
- Tick.NowUtc => returns the current datetime in UTC sortable format (// Displays 2023-04-10 13:30:00Z)
- Tick.Users.NrLoggedIn => returns the number of logged in users
- [email protected] => returns if a user with @UserHandle as handle is logged in.
This state is readable but not writable.