Self Service Migration Workspace
In this topic:
Dashboard
The Dashboard displays key information and metrics about device migration. It provides a centralized overview of important data to help users monitor progress, manage migration schedules, and make informed decisions.
To open the Dashboard, follow the steps below:
- Login to Quest and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Self Service > Device Migration.
The components of the Dashboard are described below:
Notification panel - presents relevant information and shortcuts to migration activities. Appears only when a system notification is available.
Dashboard tiles
Users
The Users tab helps you to notify users, set up migration schedules and migrate devices that are listed and categorized by linked user profiles. See Users for more details.
Workstations
The Workstations tab helps you to setup migration schedules, migrate devices, and notify users. See Workstations for more details.
Settings
The Settings tab helps you configure the schedule, schedule limits, and user email used for notifications. See Settings for more details.
Notifications
The Notifications tab lets you setup the templates that administrators and end-users can use to send notifications to intended recipients. See Notifications for more details.
Working with Lists
Details of users, workstations, their migration states and other pertinent details are displayed in lists.
Each list has multiple columns that display properties of the list items. The first column in the list is the list selector. All lists have this column and cannot be hidden.
The list header contains the list selector and column headers.
To select the columns to display
- Click Edit Columns.
- From the drop-down, select the columns you want to display, or clear the check boxes of columns you want to hide. The list will be automatically updated to reflect your choices.
To configure the number of list items displayed on a page
Large lists can be better managed with paging. A long list is divided into smaller subsets called pages. Each page contains a fixed number of items or records. Only one page of data is displayed at a time, with navigation controls allowing users to move between pages.
At the bottom of lists, the count of items displayed in a page is indicated on the left-hand side, and page controls are available on the right-hand side.
- Click the Show dropdown. Then select the predefined number of items (25, 50 or 100) to display one page.
- Use the navigation controls to move between pages. The current page number is displayed as you scroll through the pages.
To select or deselect specific list items
When you want to perform an action on one or more list items, you must select the items.
- Select the corresponding check box in the list selector column of each list item that you want to select, or clear the check box to deselect the list item. Details of the most recently selected list item is displayed in the details pane that opens.
- Click anywhere in a specific list item to view the details of the item. Although you can view the list item details, the item is not considered as selected unless you select the check box in the corresponding list selector column.
To select or deselect multiple list items automatically
- Select the check box in the list selector column header. All list items across all pages are selected. Alternatively, click the drop down icon in the list selector column header, and then click Select All.
- Click the drop down icon in the list selector column header. Then click Select All on Page to select all list items on the current page.
- Click Reset Selection to clear all previously selected list items across all pages.
Searching
Lists could be large and hard to manage. You cannot scroll past 10,000 items or rows in a view. Use the Search box above this list to look for items that match your custom criteria.
To start a search:
- Use words, phrases, and special queries in your search.
- Click Search to get the search results. The search is performed across the following fields: User, User Email Address, Workstation.
- Click the ✖ icon in the filter box to clear the search criteria.
|
TIP: User email address can be searched with the "contains" operator but the others are only searchable with "starts with" |
Users
In this topic:
About Users
The Users tab has the following components:
Info panel
- Summary - this section presents a summary of users with the following metrics:
- Total Users - total number of user profiles discovered.
- With 1 Workstation - number of user profiles that are linked to only one workstation.
- With Multiple Workstations - number of user profiles that are linked to one or more workstations.
- Migration Status by Users - number of workstations in categorized by its migration status. See the Status column description in the List View below for descriptions about each migration status.
List View
Displays a tabular information about workstations discovered in the source AD categorized by linked users. If you are an end user and not an administrator, you will see only the workstations linked to your user profile. Use the Edit Columns to show or hide columns in the list. The columns are as described below:
- User - username discovered in the source AD.
- User Email - UPN of the user.
- Last Login - the most recent date and time when the user logged into the device.
- Last Notified - date and time when the most recent notification about this device was sent.
- Workstation - name of the device discovered in the source AD.
- Status - indicates the migration status of each device. The status values are described below:
- Not Ready - device is configured in the source tenant but are not ready to be migrated. Additional preparation is required.
- Ready to Migrate - devices in the source tenant are configured and ready for migration. A device is considered ready for migration when the following criteria are met:
- Device is registered in ODMAD.
- Device is assigned to a Self-Service Profile in ODMAD.
- Device ACL permissions are updated (ReACLed) in ODMAD.
-
- Scheduled - device is scheduled for migration.
- In Progress - device is being migrated.
- Migrated - device has been successfully migrated.
- Canceled - device was manually stopped from being migrated, or the device was removed from a migration schedule.
- Failed - device could not be migrated.
- Self-Migration - indicates whether or not self-service is enabled for the end user. If it indicates that it is enabled, the end user can schedule a migration from the self-service portal.
- Scheduled Time - date and time when the device migration is scheduled.
- Migrated Time - date and time when the device migration was successfully completed.
- Target State - indicates whether or not the user has been granted access to the target tenant. Valid values are Enabled or Disabled.
- Target UPN - the UPN of the user in the target tenant.
- Last Password Changed - date and time when the password of the user was most recently changed in the target tenant.
User Detail Panel
Displays more information about the selected user as described below:
- Title - name of the selected user.
- As of Date - date when the linked user was discovered.
- User Details - specific information about the user.
- Name - name of the linked user.
- Email - email address of the linked user.
- Last Login - the most recent date and time the user logged into the device.
- Linked Workstations - list of workstations linked to the user. The total number of workstations is also indicated.
- Name - name of the workstation.
- Status - indicates the migration status of each workstation.
- Last Login - the most recent date and time the user logged into the device.
- Scheduled Time - date and time when the device migration is scheduled.
- Notification History - list of notification emails that were sent by an administrator or the end user.
- Template Name - name of the email template that was used to send the notification.
- Sent Date - date and time the notification was sent.
Managing Self-Migration
- Click Manage Self-Migration from the Actions Menu. The Manage Self-Migration panel opens.
- Review and update the configuration setting in this panel as described below:
- Self-Migration - select one of the following options described below:
- Enabled - the device can be migrated by a linked user.
- Disabled - the device can be migrated only by the administrator.
- Schedule Migration - set a schedule time slot. See Scheduling in the Settings topic for more details. When you set the schedule and save the settings, the Scheduled Time column for the selected workstation in the List View will display the date and time. The Status column value will change to Scheduled.
Uploading User Emails
This is a two step process to provide email addresses to use for notifications.
Prepare the CSV file
- Click Upload User Emails. The Upload User Emails panel opens.
- Click Download Example. The CSV template is downloaded to you default folder.
- Specify the UPN and email addresses of the recipients as shown in template. Save the CSV file. You may rename the file if needed.

|
NOTE: Only users linked to workstations should be added to the CSV. Users without workstations will not be uploaded. CSV file names with non-ASCII characters are not supported. |
Upload the CSV file
- Click Upload User Emails. The Upload User Emails panel opens.
- Click Browse and select the CSV that contains the recipient details. The file is attached to the panel.
- Click Upload. Users that are successfully uploaded will appear in the Users list view.
Sending Notifications
This action lets you send a notification at any time to selected users.
- Select one or more user profiles if you are an administrator, or select your use profile if you are an end user.
- Click Send Notifications. The Send Notification panel opens.
- Configure the options as described below:
- Template - choose a notification template.
- Send To - select from one of the following recipient options:
- All users on workstation - all users whose profiles are associated to the selected workstation will receive the notification
- Last Logged in user - only the user who most recently logged into the selected workstation will receive a notification.
Migrating Workstations manually
This action is available to administrators only unless this action is granted to end users from the Settings tab. Workstations can be migrated manually without any scheduling.
|
NOTE:
- The workstation migration process will start immediately and cannot be canceled once submitted.
- The migration job will start in about 15 minutes.
- The linked workstation will automatically reboot.
- Migration time varies (usually 15 to 30 minutes) based on connection and data size.
|
- Select one or more user profiles if you are an administrator, or select your user profile if you are an end user. Workstations that are not ready will not be submitted for migration.
- Click Migrate Now. The Migrate Now panel opens.
- Review the workstations listed in the two sections:
- Eligible Workstations - lists the workstations or devices that meet the following criteria: Self-Service is Enabled and Status is Ready to Migrate.
- Non-Eligible Workstations - lists the workstations or devices that do not comply with the eligibility criteria described.
- Click Start Migration.
Removing a Scheduled Migration
- Select one or more user profiles if you are an administrator, or select your use profile if you are an end user.
- Click Remove from Schedule. The Remove from Schedule panel opens.
- Configure the options as described below:
- Send Notification - select this checkbox if you want to send a notification about the cancellation
- Template - choose a notification template.
- Send To - select from one of the following recipient options:
- All user on workstation - all users whose profiles are associated to the selected workstation will receive the notification
- Last Logged in user - only the user who most recently logged into the selected workstation will receive a notification.
- Click Confirm. The Status column value for the selected workstation will change to Canceled.
Workstations
In this topic:
About Workstations
The Workstations tab has the following components:
Info panel
- Summary - this section presents a summary of discovered workstations with the following metrics:
- Total workstations - total number of workstations discovered.
- With 1 User Profile - number of workstations that are linked to only one user profile.
- With Multiple User Profiles - number of workstations that are linked to one or more user profiles.
- Migration Status by Workstations - number of workstations categorized by its migration status. See the Status column description in the List View below for descriptions about each migration status.
Actions Menu
Filter
These are predefined filters that display the count of items for each value available in the dropdown list. These values take into consideration any other filter that is already applied. You cannot scroll past 10,000 items or rows in a view. To see relevant records, you can filter lists based on predefined or custom criteria. The steps to filter a list is the same across all lists.
To apply a filter, select a value from the filter dropdown. You can select values from other dropdown filter lists to apply a combined filter. Filters are applied immediately when selected.
To clear a filter, click the ✖ icon in each filter that was applied, or click Clear All to clear all filters.
- Status - filters the list by migration status. See the Status column description in the List View below for descriptions about each migration status.
- Self-Migration - filters the list by whether or not self-service is enabled for the end user. Valid values are Enabled and Disabled.
- Scheduled Time - filters the list by predefined date ranges when the device migration is scheduled. Valid values are All Scheduled, Next 24 Hours, Next 7 Days, Next 14 Days, Not Scheduled.
- Migrated Time - filters the list by predefined date ranges when the device migration is was completed successfully. Valid values are All Migrated, Last 24 Hours, Last 7 Days, Last 14 Days.
- Last Notified - filters the list by whether or not a notification about this device was sent. Valid values are Notified and Not Notified.
Manage Self-Migration
This action allows a workstation user who has access to On Demand Migration Self-Service to perform a workstation migration if Self-Migration is enabled for the user. See Managing Self- Migration for more details.
Send Notification
This action allows lets you sens a notification to workstation users at any time. See Sending Notifications for more details.
Migrate Now
This action lets administrators migrate one or more workstations immediately. See Migrating Workstations manually for more details.
Export
Lets you export the data in the list view as a CSV file as described below:
- Click More > Export. A background task is run to collect and collate the data for export.
- When the export file is ready, a message appears in the Notification panel.
- Click Download. The CSV file is saved to your default download folder.
List View
Displays a tabular information about workstations discovered in the source AD. Use the Edit Columns to show or hide columns in the list. The columns are as described below:
- Workstation - name of the device discovered in the source AD.
- Status - indicates the migration status of each workstation. The status values are described below:
- Not Ready - device is configured in the source tenant but are not ready to be migrated. Additional preparation is required.
- Ready to Migrate - devices in the source tenant are configured and ready for migration. A device is considered ready for migration when the following criteria are met:
- Device is registered in ODMAD.
- Device is assigned to a Self-Service Profile in ODMAD.
- Device ACL permissions are updated (ReACLed) in ODMAD.
-
- Scheduled - device is scheduled for migration.
- In Progress - device is being migrated.
- Migrated - device has been successfully migrated.
- Canceled - device was manually stopped from being migrated, or the device was removed from a migration schedule.
- Failed - device could not be migrated.
- Self-Migration - indicates whether or not self-service is enabled for the end user. If it indicates that it is enabled, the end user can schedule a migration from the self-service portal.
- Last Login - the most recent date and time a registered user of this device logged into the device.
- Scheduled Time - date and time when the device migration is scheduled.
- Migrated Time - date and time when the device migration was successfully completed.
- Collection - name of the migration wave configured in ODMAD.
- Last Notified - date and time when the most recent notification about this device was sent.
- Last Discovered - date and time when the device discovery was run from ODMAD.
- Events - link to the ODM Active Directory for this device where you can get more details about jobs and other information about the selected device.
Workstation Detail Panel
Displays more information about the selected workstation or device as described below:
- Title - name of the selected workstation.
- As of Date - date when the linked user of the workstation was discovered.
- Events - link to the ODM Active Directory for this device where you can get more details about jobs and other information about the selected device.
- Linked Users - list of active users with a user profile in the source AD that are linked to the selected device. The total number of linked users is also indicated.
- Name - name of the linked user.
- Email - email address of the linked user.
- Last Login - the most recent date and time the user logged into the device.
- Notification History - list of notification emails about the device that were sent by an administrator or linked user.
- Template Name - name of the email template that was used to send the notification.
- Sent Date - date and time the notification was sent.
- Recipient - name of the user who receives the email.
- Scheduling History - list of migration scheduling attempts for the device. All scheduling attempts are logged irrespective of the status of the migration.
- Name - full name and username of the On Demand Migration Self-Service migration administrator who scheduled a migration.
- Migration Date - date and time the migration was scheduled.
Managing Self-Migration
- Click Manage Self-Migration from the Actions Menu. The Manage Self-Migration panel opens.
- Review and update the configuration setting in this panel as described below:
- Self-Migration - select one of the following options described below:
- Enabled - the device can be migrated by a linked user.
- Disabled - the device can be migrated only by the administrator.
- Schedule Migration - set a schedule time slot. See Scheduling in the Settings topic for more details. When you set the schedule and save the settings, the Scheduled Time column for the selected workstation in the List View will display the date and time. The Status column value will change to Scheduled.
Sending Notifications
This action lets you send a notification at any time for one or more selected workstations.
- Select one or more workstations.
- Click Send Notifications. The Send Notification panel opens.
- Configure the options as described below:
- Template - choose a notification template.
- Send To - select from one of the following recipient options:
- All users on workstation - all users whose profiles are associated to the selected workstation will receive the notification
- Last Logged in user - only the user who most recently logged into the selected workstation will receive a notification.
Migrating Workstations manually
This action is available to administrators only unless this action is granted to end users from the Settings tab. Workstations can be migrated manually without any scheduling.
|
NOTE:
- The workstation migration process will start immediately and cannot be canceled once submitted.
- The migration job will start in about 15 minutes.
- The linked workstation will automatically reboot.
- Migration time varies (usually 15 to 30 minutes) based on connection and data size.
|
- Select one or more workstations. Workstations that are not ready will not be submitted for migration.
- Click Migrate Now. The Migrate Now panel opens.
- Review the workstations listed in the two sections:
- Eligible Workstations - lists the workstations or devices that meet the following criteria: Self-Service is Enabled and Status is Ready to Migrate.
- Non-Eligible Workstations - lists the workstations or devices that do not comply with the eligibility criteria described.
- Click Start Migration.
Removing a Scheduled Migration
This action allows you to remove the schedule setting for one or more selected workstations in the list.
- Select one or more workstations.
- Click Remove from Schedule. The Remove from Schedule panel opens.
- Configure the options as described below:
- Send Notification - select this checkbox if you want to send a notification about the cancellation
- Template - choose a notification template.
- Send To - select from one of the following recipient options:
- All user on workstation - all users whose profiles are associated to the selected workstation will receive the notification
- Last Logged in user - only the user who most recently logged into the selected workstation will receive a notification.
- Click Confirm. The Status column value for the selected workstation will change to Canceled.
Notifications
In this topic:
About Notifications
The Notifications tab lists the Default and custom notification templates that are reusable formats for creating and sending automated emails to users. By using templates, administrators can quickly generate and send notifications without having to manually create each message from scratch. Notification Templates ensure that all notifications related to a specific event have a consistent format, including subject line, body text, and visual elements. They allow for dynamic data insertion to personalize the notification content.
Notification emails are sent from the On Demand Migration Self-Service service.
Actions Menu
New Template
This action lets you create new notification template from scratch. It uses the system default properties as suggestions that you can either keep or modify. See Creating a Notification Template fro more details.
Duplicate Template
This action lets you create new notification template from an existing notification template. It uses the properties of the selected template as suggestions that you can either keep or modify. See Creating a Notification Template for more details.
Remove Template
This action lets you remove a selected template. You cannot remove the Default notification template. See Removing a Notification Template for more details.
List View
Displays a tabular information about all the templates created. Use the Edit Columns to show or hide columns in the list. The columns are as described below:
- Template Name - name of the notification template.
- Added By - indicates whether the template is a system template or created by an end user. valid values are: System and User.
- Created Date - date and time stamp indicating when the notification template was created.
- Last Modified - date and time stamp indicating when the notification template was most recently modified.
Template Detail panel
Displays more information about the selected notification template as described below:
- Template Name - enter name of the template.
- Sender Display Name - enter your name, business, or a custom identifier that appears in the “From” field of the email.
- Message Subject - enter the title of the message.
- Message Body - enter text that will be displayed as the message body. You can use the markup syntax as described below. Click Clear All to delete the entire content.
[b]bold text[/b] |
bold text |
[i]italic text[/i] |
italic text |
[u]underlined text[/u] |
underlined text |
[a(url)custom link][/a] |
custom link |
%%Table%% |
list of workstations |
%%PortalLink%% |
link to Self-Service Portal |
- Add Logo - click this link to add am image to the logo box. Supported formats are: JPEG, PNG, and SVG. The maximum size of the image is 100 KB.
- Revert to Default - click this link to reset the notification template properties to the system default.
Creating a Notification Template
You can create customized notification templates in two ways by creating a new template from scratch or copy an existing template.
To create a new template
- Login to Quest and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Self Service > Device Migration.
- Select the Notifications tab.
- Click New Template. The New Notification Template panel opens.
- Specify a name for the template.
- Modify the suggested property values. Properties are described in the previous section.
- Click Save. The new notification template is added to the List View.
To copy an existing template
- Login to Quest and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Self Service > Device Migration.
- Select the Notifications tab.
- Select any template that you want to copy. Click Duplicate Template. The New Notification Template panel opens.
- Provide a new name for the template.
- Modify or retain the copied property values. Properties are described in the previous section.
- Click Save. The new notification template is added to the List View.
Editing a Notification Template
- Login to Quest and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Self Service > Device Migration.
- Select the Notifications tab.
- Click any template that you want to modify. The Edit Notification Template panel opens. You can modify the Default template as well.
- Modify or retain the property values. Properties are described in the previous section.
- Click Save. The modified notification template is updated.
Removing a Notification Template
- Login to Quest and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Self Service > Device Migration.
- Select the Notifications tab.
- Select the templates that you want to remove from the list. Click Remove Template. The Remove Notification Template confirmation dialog opens.
- Click Remove. The modified notification template is removed from the List View.