runtask

runtask allows DMScript to invoke a task associated with a Domain. It allows tasks to be invoked via scripts, providing more opportunities for automation. Executing tasks via DMScript allows you to:

• Automatically move an _Application Version_ from one Domain to Another
• Approve an _Application Version_
• Create a New _Application Version_
• Run a "Request" Task.

NOTE: runtask cannot be used to run a Deploy Task. The invoking user must have execute access to the task otherwise a runtime error occurs.

runtask takes a mandatory named parameter. Other parameters can be specified depending on the task type:

runtask is also useful for occasions where it may be required to suspend a deployment whilst a manual operation is performed. For example, it may be required to stop the deployment whilst a backup is taken of a target Endpoint. Once the backup is performed, the deployment can be allowed to continue. To do this, runtask can be used in combination with waitfor in order to implement a “wait for manual step”. In this case, runtask executes a “request” task which is linked to a stand-alone task which confirms the manual step has been performed.

Example 1

Execute an automatic approval following a successful deployment:

runtask(

task: "${_Application_.fqdomain}.Approve",

note: "This is an automated approval",

approve: true);

Here, the deployed Application’s fully qualified domain is prepended to the name of the task “Approve” in order to accurately identify the task regardless of where the Application is in the lifecycle.

NOTE: Tasks that operate on _Application_s require the_Application_to be on the stack. During a deployment operation, the_Application_will be on the stack and accessible via the $Application_object. If you are running a task outside of the deployment process you will need to push the_Application_onto the stack by executing the task within a using_Application_block. See_using Application later in this chapter for more information.

Example 2

Send out a request for a manual step to be performed and suspend deployment:

runtask(task: "${_Application_.fqdomain}.Request Manual Step");

waitfor(task: "${_Application_.fqdomain}.Manual Step Performed");

Here, DMscript calls the task “Request Manual Step”. This is a “request” task linked to the “Manual Step Performed” task. When this task is invoked, DeployHub Pro will issue the notification to the users in the group who have execute access to the “Manual Step Performed” task and place the request to execute this task into those users’ To Do list on their home page.

The script will then call waitfor which will suspend the script execution until the “Manual Step Performed” task is run. At which point the script will continue automatically.