Workspace Environment Management

Triggers

Create triggers and associate tasks with them. When activated, the triggers start the associated tasks in the user environment. To view the tasks associated with a trigger, click the trigger to expand its row.

You can perform the following operations:

  • Create a trigger

  • Refresh the view

  • Edit a trigger

  • Clone a trigger

  • Manage associations

  • Delete a trigger

Tip:

You can quickly enable or disable a trigger by using the toggle in the State column.

There are five built-in triggers:

  • Session triggers:

    • Agent refresh. Activated when users refresh the agent.
    • Reconnect. Activated when a user reconnects to an agent machine.
    • Logon. Activated when users log on to their machines.
    • Logoff. Activated when users log off from their machines.
    • Disconnect. Activated when users disconnect from their machines.
    • Lock. Activated when users lock their machines.
    • Unlock. Activated when users unlock their machines.

    Note:

    Session triggers let you configure session activities as triggers and are currently available only for external tasks.

  • Machine triggers:

    • Machine shutdown. Activated when machines shut down.
    • Machine startup. Activated when machines start up.

Note:

Create a trigger

To create a trigger, perform the following steps:

  1. In Triggers, click Create trigger.

  2. Specify a name for the trigger.

  3. Optionally, specify additional information to help you identify the trigger.

  4. Choose whether to enable (Yes) or disable (No) the trigger.

    Note:

    If disabled, the agent does not evaluate and process the trigger.

  5. Select a trigger type from the list and fill in the required information.

    • Scheduled

    • Process started

    • Process ended

    • Windows event

    • Cloud Health Check result

    • Profile Management health check result

    • Custom scripted task result

    Tip:

  6. In Summary, verify that you created the trigger as intended.

  7. When you have finished, click Done to save and exit.

Available trigger types

The following trigger types are available for selection:

  • Scheduled. Schedules when to activate the trigger. The following options are available:

    • Date and time. Specify when the trigger is activated.
    • Repeat. Select Yes to specify how often the trigger is activated. For example, every one hour, every two hours, every day, every two days. If you select Week or Month, you can specify one or more specific days. Select No if you want the trigger to activate only once.
  • User process triggers

    • Process started. Activates the trigger when specified processes start.
    • Process ended. Activates the trigger when specified processes end.

    Note:

    User process triggers let you configure user processes as triggers and are currently available only for external tasks.

  • Windows event. Lets you define the criteria that Windows events must meet to activate the trigger. The following options are available:

    • Add criterion. Define the criteria that Windows events must meet to activate the trigger.

    • Interval. Specify an interval, in minutes, for the trigger. After being activated, the trigger will not be activated again until the specified interval elapses.

    Note:

    Only Windows classic event logs such as Application, System, or Security are supported.

  • Cloud Health Check result. Activates the trigger when Cloud Health Check returns a specified health status. The following options are available:

    • VDA health status. Use VDA health status to activate the trigger. VDAs can be in normal or unusual state, as shown in Home > Overview.

    • Task data. Select data to pass to associated tasks, and specify the parameters in those tasks to receive the data. If a parameter you specify here is the same as the one configured for associated tasks, the former takes precedence. We recommend using the default parameter names. Update your script files if necessary. You can specify the following data:

      • VDA health status (string). The health status that Cloud Health Check returns. Use the parameter in associated tasks to receive the status.

      • Health report (string). The VDA health check report that Cloud Health Check generates. Use the parameter in associated tasks to receive the full path of the report. For more information, see Heath check results.

  • Profile Management health check result. Activates the trigger when Profile Management health check returns a specified health status. The following options are available:

    • Profile Management health status. Use the following Profile Management health statuses to trigger associated tasks: Warning (suboptimal state of Profile Management) and Error (Profile Management configured incorrectly).

    • Task data. Select data to pass to associated tasks, and specify the parameters in those tasks to receive the data. If a parameter you specify here is the same as the one configured for associated tasks, the former takes precedence. We recommend using the default parameter names. Update your script files if necessary. You can specify the following data:

      • Profile Management health status (string). The health status that the Profile Management health check returns. Use the parameter in associated tasks to receive the status. For more information, see Administration.

      • Health report (string). The health check report that the Profile Management health check generates. Use the parameter in associated tasks to receive the full path of the report. For more information, see Reports.

  • Custom scripted task result. Activates the trigger when scripted tasks return specified results. You first specify custom scripted tasks and then define the criteria that the tasks must meet to activate the trigger. The following options are available:

    • Add criterion. Select one or more scripted tasks and then define the criteria that those tasks must meet to activate the trigger.

    • Task data. Select data to pass to associated tasks, and specify the parameters in those tasks to receive the data. If a parameter you specify here is the same as the one configured for associated tasks, the former takes precedence. We recommend using the default parameter names. Update your script files if necessary. You can specify the following data:

      • Task name (string). The name of the scripted task that triggers the associated task. Use the parameter in associated tasks to receive the name.

      • Exit code (integer). The exit code value that the scripted task returns. Use the parameter in associated tasks to receive the value.

      • Console output (string). The console output that the scripted task writes. Use the parameter in associated tasks to receive the full path of the output.

      • File output (string). The file output that the scripted task generates. Use the parameter in associated tasks to receive the full path of the output.

Edit a trigger

To edit a trigger, perform the following steps:

  1. In Triggers, select the trigger.

  2. Click Edit in the action bar.

  3. Make changes as needed.

  4. In Summary, verify that you made the changes as intended.

  5. When you have finished, click Done to save and exit.

Clone a trigger

To clone a trigger, perform the following steps:

  1. In Triggers, select the trigger.

  2. Click Clone in the action bar.

  3. Specify a name for the clone.

  4. Optionally, specify additional information to help you identify the trigger.

  5. Select a configuration set to clone the trigger to.

  6. When you have finished, click Done to save and exit.

Manage associations

To manage associations for a trigger, perform the following steps:

  1. In Triggers, select the trigger.

  2. Click Manage associations in the action bar.

  3. Select scripted tasks to associate them with the trigger or unselect scripted tasks to unassociate. If needed, use the search box to quickly search for a task.

  4. Choose whether to show only triggers that apply to this task.

  5. When you have finished, click Done to save and exit.

When managing associations, keep the following in mind:

  • To prevent endless looping, WEM supports up to 10 triggering times in a single loop chain. The following is an example, in which Task A triggers Task B, Task B triggers Task C, …, and Task K triggers Task L. Task K fails to trigger Task L — the loop terminates because the triggering times in this single loop chain have exceeded 10.

Loop chain consideration

Delete a trigger

To delete a trigger, perform the following steps:

  1. In Triggers, select the trigger.

  2. Click Delete in the action bar.

Note:

If you delete a trigger with which scripted tasks are associated, it will no longer trigger those tasks.

Supportability matrix for triggers

The following table lists which triggers are supported for which tasks.

  Scripted task External task
Agent refresh   X
Reconnect   X
Logon   X
Logoff   X
Disconnect   X
Lock   X
Unlock   X
Machine startup X  
Machine shutdown X  
Scheduled X X
Process started   X
Process ended   X
Windows event X  
Cloud Health Check result X  
Profile Management health check result X  
Custom scripted task X  
Triggers