Edit resource Version 8 (Java)
Action group: Orchestrator Subgroup: Resource queue
Description
The action edits the current value and parameters of the resource in the resource queue.
- The action sends a request to get the value and/or parameters of the resource created in the resource queue in the Orchestrator database. The resource is searched by the specified resource identifier.
The action can deny a resource for reading or writing if the corresponding input parameters are filled in. In addition, the date of unlocking the resource will be specified. The presence of the unlocking date means that the resource will be locked until the specified date, even if the robot has already finished its work. When the specified date occurs, the Orchestrator server side will remove the block itself. However, the current instance of the robot can also remove the block if it performs the corresponding action.
- When a resource is blocked, this robot instance becomes the owner of the set blocking type. Being the owner of the blocking means that only the same robot instance can remove this blocking. And 2 different launches of the same robot (2 different instances) are considered as different owners.
- The user has more authority than robots, so they can remove/set the blocking regardless of who owns it.
- If the resource is already blocked for writing and the initiator is not the given robot instance, the action is pending the removal of that blocking.
- If an action should block a resource for reading, but it is already blocked for reading by a user or another robot instance, the action waits for the block to be lifted. If the resource is blocked for reading, but the action should not set this type of blocking, waiting for the read blocking to be lifted does not occur, it is simply ignored.
Action icon
Settings of parameters
| Property | Description | Type | Filling example | Mandatory field |
| Parameters | ||||
| Identifier | The unique identifier of the resource. | Robin.String | Yes | |
| Value | The new resource value. | Robin.Object | No | |
| Tags | A collection of strings where each element is a separate new tag for a resource. If the field is empty, the current resource tags will not change. If a collection with 0 elements is specified, the current tags will be removed. | Robin.Collection | No | |
| Priority | The priority of the element over other elements in the queue. If the field is empty, the resource’s current priority will not change. | Robin.Numeric | No | |
| Timeout, ms | The time to wait for the lock to be released from the resource. Specified in milliseconds. If «-1» is specified, the action will wait indefinitely. | Robin.Numeric | No | |
| Temporarily stop reading | The date on which the read lock was automatically released. Must be greater than the current date. If the field is filled, the resource will be blocked immediately. | Robin.DateTime | No | |
| Temporarily stop writing | The date on which the write lock was automatically disabled. Must be greater than the current date. If the field is filled, the resource will be blocked immediately. | Robin.DateTime | No | |
| Results | ||||
| Tags | A collection of strings, where each element is a separate tag of the resource. | Robin.Collection | ||
| Priority | The priority of the resource over other resources in the queue. | Robin.Numeric | ||
| Date of creation | The date and time the resource was created. | Robin.DateTime | ||
| Date of update | The date and time the resource was last updated. | Robin.DateTime | ||
Special conditions of use
None.
Example of use.
Task
There is a resource. Change it to priority "1" and get the date of creation of the resource.
Solution
Use the "Edit resource", "Message in Log" actions.
Implementation
- Move the "Edit resource" action to the workspace and set its parameters.
- Specify the resource ID in the "Identifier" field.
- Specify the new priority of the resource in the "Priority" field.
- Move the "Message in Log" action to the workspace and set its parameters.
- Specify the result (date of creation) of the "Edit resource" action in the "Message" field.
- Specify the result (date of creation) of the "Edit resource" action in the "Message" field.
- Click "Start" in the top panel to start the robot.
Result
The program robot completed successfully.
The priority of the resource was changed to "1", as well as the new date of creation of the resource was output to the log.
Обзор
Инструменты контента