A wizard is an ordered sequence of screens (pages) through which you interact with Flex in order to carry out work. Dalet Flex's wizard framework is very extensible so that developers can create their own wizards with their own associated screens.
Wizards can be launched in three different ways:
- From a User Task: If a wizard is referenced by a task definition, then the wizard is run when a user carries out a task instance as part of a workflow.
- Stand-alone: If a wizard is set as stand-alone then it can be launched from a dashboard and run in the Dalet Flex console. Example of a stand-alone wizard, is a wizard to create a new asset group. Clearly this does not need to happen as part of a workflow.
- Remotely: A wizard page can be created in an external system. The wizard is then orchestrated through API calls to the Dalet Flex platform.
A stand alone wizard can be found inside the I Want To... box on each dashboard for easy access.
Wizard Pages
Wizard pages are the individual screens through which you interact with in Dalet Flex to get work done. When wizards are created, the specific pages are selected and the order in which the pages should be presented are also set.
Running a Wizard
To run a stand-alone wizard simply find the I Want To... box on any dashboard in the Dalet Flex console. Click on the name of the wizard you wish to run.
Wizard Object Properties
Property | Support | Explanation |
Scope | Account | The scoping of this object |
Visibility | Whether the object supports visibility | |
Plugins | Supports plugins | |
Extended Config. | Whether the object has an extended configuration tab | |
Scripting | Whether the object can be configured using scripting | |
Enable / Disable | Whether the object can be enabled and disabled | |
Start / Stop | Whether the object can be started and stopped | |
Copy | Whether the object can be copied | |
Export / Import | Whether the object can be exported and imported | |
Delete | Whether the object can be deleted | |
Unique Name | Whether the object name must be unique within its scope | |
Variants | Whether the object supports variants |
Creating a New Wizard
On the toolbar, click New and select Wizard from the drop down menu.
In the Create new Wizard section, fill in the relevant details such as name, visibility, plugin, launch rules, and so on.
You use Spring Expression Language (SpEL) to configure a run-rule that manages when a particular wizard is available, for example this run-rule #{object.type.name == "media-asset" && object.variant.name == "Video"} allows you to run the wizard for a media asset with a variant = Video. See this article for more information on Working with Spring Expressions in Dalet Flex.
Click Save to finalise.
Adding Pages to a Wizard
Click the Pages sub-tab.
Click Add Page.
Assign a page path that relates to the task that you want to carry out (e.g. assigning metadata to a task).
Assign an action parameter: Some wizard plugin pages support action parameters which control their behaviour.
Assign an asset context: An asset context expression can be used to ensure the page references the correct asset in an asset hierarchy.
Click Save to finalise.
Managing Pages
Once a page has been created, you have the option of editing, deleting, or re-ordering the sequence of the pages for a Wizard. To do this, hover over the chevrons to the right hand side of each page, and make your selection.
Working with Wizards
To run a stand-alone wizard simply find the I Want To... box on any dashboard in the Dalet Flex Console. Then click on the name of the wizard you wish to run.
Running an "Add an asset to a group" Wizard
An example of how this functionality works, can be shown using the "Add an asset to a group" wizard, as follows:
To begin, select the Add an asset to a group wizard.
This will take you through to the Add an asset to a group screen pop-up.
Search and then select the desired group and select Next.
Assign members to the group and click Next.
View and approve the confirmation page, which confirms the group and the members of the group. Click Finished.
Comments
0 comments
Please sign in to leave a comment.