Action URIs
What is an action URI​
An action URIAction URIA dynamic link, populated with fields from a task, job or appointment, that opens an external system in one click. is a web request template that another application can parse and execute. When a user invokes it, Dime.Scheduler replaces the placeholders in the template with values from the record in the action's context, then runs the web request.
To give you a sense of what action URIs make possible, here are a few things customers have built:
- Create new absences
- Create transportation orders from the generated route on the map
- Send e-mails and text messages
- Update the status of an order
- Check the stock level of the required components for the jobJobA high-level container, comparable to a project, that bundles related tasks together with common information such as customer, billing, and address.
How to invoke action URIs​
The following components support action URIs:
- Open tasksOpen taskA task that has not been scheduled yet. It waits in the open task list to be placed on the planning board.
- Planned tasksPlanned taskAn appointment together with the resources assigned to it - the full picture of what will be done, by whom, and when.
- Planning boardPlanning boardThe main graphical scheduling surface where dispatchers drag tasks onto resources across a timeline.
- Map
- Route sequenceRoute sequenceAn ordered list of a resource's appointments for a day, optimized by location so travel between jobs is minimized.
In most cases, you invoke an action URI from the context menu of the selected entity. The map works a little differently.
To launch an action URI on a task in the map, select the pin or pins linked to the task and click the anchor icon. A list appears with all available action URIs to choose from. Because you can select multiple tasks and pins on the map, you can launch a single action URI that covers every selected item at once. This lets you configure your back-office application to run logic in a context where all the items are available.
One thing to keep in mind: action URIs for multiple items are only available when the selected items share the same Source App and Source Type.