Actions
Asset Actions
Raise Event
Raise event action enables you to receive notifications when a specific event occurs. To define a raise event action, simply specify the event name, message, and optional data that you wish to be notified about.
Read How to set up app listeners App Listeners
For example, an insurance company wants to raise an event whenever a new insurance policy is issued to its customer.
Please make sure that app listeners are set up for the app you are setting the Workflow and "Workflow Event" is selected under events in order for the workflow to function correctly.
1. Create Asset
Create Asset action generates a new asset record on the blockchain. To define a Create Asset action, specify the asset type, along with any optional data for the asset as properties.
For example, an insurance company wants to create a user asset whenever an insurance asset is created for that user with data.
2. Update asset
The ‘Update Asset’ action will replace the current data of an existing asset with newly defined data.
Suppose, an insurance firm aims to modify the complete set of insurance information in response to a user's inquiry subsequent to the establishment of the insurance coverage. For example, in the event that a user decides to cancel their policy, the insurance company will remove the user. Simultaneously, insurance company can update whole insurance object with the data given in the "update asset" action block.
3. Update Asset Property
An action that modifies or updates specific properties or attributes of an existing asset. To define an update asset property action, specify the asset type, and the property key that you would like to update, along with the new value.
Suppose, an insurance holder wants to update his/her name as correction, the same should be updated in the user database of the insurance as well. Then, we can use the update asset property to update the user asset also in the same workflow.
4. Delete asset
An action that removes or deletes an existing asset. To define the delete asset, specify the asset type and ID to be deleted.
Asset ID can be variable using Variables & Identifiers like '$currentitem.data.userid}
Asset ID can also be a fixed id 'efjhl93283274'
For example, if insurance is expired or the user wants to discontinue the policy, an insurer can delete the insurance asset along with user asset.
5. Update Asset Owner
An action that updates owner of a particular asset. To define the update owner action, specify the
asset type
asset ID either variable or fixed ID
owners organisation
owner user ID (optional)
Owner can be either an organization or a specific user within an organization. Specific users can be defined by adding their key-value identifier. If user ID (optional field) is not added, the owner will be the selected organisation.
For example, when a car is manufactured, the organization which manufactured the car will be the owner of that car, but when a dealer sells the car to the end user, then the ownership of that car (asset) gets transferred to a customer.
6. Update Current Asset
Update Current Asset action will only update the trigger asset for the workflow under which it is defined. To define the action, specify the data that needs to be updated on the trigger asset.
It is similar to "update Asset Property" action, but in "update current asset" action, it updates the field only on the asset on which the triggered workflow is running.
For example, a workflow is defined as when a patient is admitted to the hospital, the hospital as an organization creates a patient asset. While creating the patient asset if they want to update the room number and ward based on conditions in the given input like if the patient's gender is male, then update the "ward" field of the asset to the value "male ward", then "update current asset" action can be used.
Please note that if the workflow trigger is set to "Approval Action," this action will not work.
Approval
1. Create Approval
An approval action can be created in a workflow to allow the workflow to branch based on approval conditions such as approved, rejected, and cancelled.
To create an approval action, specify the
Approvers- Approvers can be either an organization or specific users within an organization. Specific users can be defined by adding their key-value identifier. If user ID (optional field) is not added, the approval will be an organisation.
Approver count- The minimum number of approvers required for the status to turn to APPROVED.
Timeout- The time, in minutes, from the approval request after which the approval status will turn to CANCELLED.
Data- Optional data that can be utilized in steps after approval.
A created approval can be used as a trigger for another workflow. #5.-approval-action
For example, a car is sold to a customer only after an approval action of governing body approves it.
Fetch external data (oracle)
An action that activates an oracle to retrieve external data for use in subsequent tasks or processes.
To create an oracle action block, specify the
Arguments- the arguments depend on the param type of the selected oracle source URL.
What is 'Do not trigger workflows' field?
The 'Do not trigger workflows' field is applicable for actions like- create asset, update asset, update asset property, delete asset, update owner.
If this field is checked, no other workflow will be triggered upon execution of this action. For instance, if this field is checked for a create asset action with asset type = insurance in workflow A, and workflow B has a trigger on create asset with asset type = insurance, workflow B will not be triggered if this field is checked.
Tokens
1. Mint
The Mint Token action is used to create new tokens. To define a Mint Token action, specify the token type, amount, the account to which the tokens will be minted, and any optional data.
If the token type is a non-fungible token (NFT), you also need to provide the asset ID.
2. Burn
The Burn Token action is used to destroy or remove tokens from circulation. No new tokens can be created after burning.
3. Transfer
The Transfer Token action is used to transfer tokens from one account to another. To define a Transfer Token action, specify the token type, amount, the account from which the tokens will be transferred, the account to which the tokens will be transferred, and any optional data.
Last updated
