This is not the latest version of Identity Director documentation.
View available documentation.

Icon

Refresh User Workspace

Add the Refresh User Workspace action to force a refresh of the Ivanti Workspace Control session of the subscriber. This is useful in Ivanti Workspace Control environments, for example if a service installs new software and the user workspace needs to be refreshed before it is available.

  • This action requires the installation of the Windows Client on the device of the subscriber.

Configuration

Item

Explanation and Tips

Action Name

Optionally specify a friendly name for the action. This name must be unique in the workflow.

Actor

This field always specifies Subscriber, because this action always refreshes the user workspace of the subscriber to the service.

Message

Specify a message.

  • The markup editor supports styling functionality like headings, colors and numbered lists, but also hyperlinks and drag-and-drop.

Send e-mail notification

Enable e-mail notification for this specific action. This sends an e-mail to the user that a message has been delivered in the Web Portal, if you have enabled E-mail Integration (at Setup > E-mail Integration).

  • This option is selected by default. It is also selected in upgraded environments.
  • Clear the option to disable e-mail notification. This is useful in actions that send notifications to multiple actors as the result of a smart rule: it prevents unnecessary e-mail notifications. For example, if you configured a service with a Refresh User Workspace action that is sent to all actors on a smart rule list, and the workflow should proceed with the first response, you probably do not want to send this notification by e-mail. You can prevent this by disabling e-mail notification for this specific action.

After confirmation

Ask the subscriber to confirm the refresh of the user workspace.

  • If you clear the option, the user workspace refreshes immediately.

Email reminder

Starting with Identity Director 2021.2, you can optionally notify the person that needs to approve or confirm the action, according to the time interval you input.

  • You can set the time interval to a number of days, weeks, or months.

  • The system keeps sending notifications until the action is approved, canceled, or when it expires.

Expiration

Specify when the action expires. If the action hasn't been performed in time, it fails.

  • You can use placeholders to make the expiration time for the action dynamic.
    • When the action is executed, the placeholder needs to resolve into an integer (e.g. "9"). Invalid input (e.g. "Nine") causes the action to ignore the expiration time. The transaction continues immediately.
  • If Ivanti Workspace Control users already have pending refreshes when they log on to a workspace session, this results in a single refresh.
  • The Windows Client polls the Mobile Gateway at an interval of 10 seconds. If it receives multiple refresh messages within this time frame, this results in a single refresh.
  • If the Windows Client receives multiple refresh messages that include both manual and auto-refresh messages, this results in a single auto-refresh.
  • When the Windows Client has executed a refresh message, it isn't marked as done for another 10 seconds. In multiple concurrent workspace sessions that use the same user account, this allows the Windows Clients in the other workspace sessions to execute the refresh.
  • This action can be translated. The RESX file of the service that uses the action, contains the translatable fields.
See also