About Managing Drivers
After you create drivers in Studio, you can carry out a range of actions on the Drivers page, including the following:
For information about viewing and managing driving results, using the impact rank to differentiate drivers, and hiding and unhiding drivers that are not useful for your analysis, see Working With Driver Results.
Editing Drivers
Qtip: You can edit your own drivers and drivers to which you have Can Edit access.
Qtip: You need to choose Save And Find Drivers after editing the driver settings to update the results of your investigation.
Click Drivers.
Select the content provider’s project to use.
If you have access to more than one account, select the relevant account.
If you have access to more than one project, select the relevant project.
Locate the driver you wish to edit. You can enter the name of the driver in the
Find Drivers box to find it.
Click the name of the driver to open the
Edit Drivers window.
Alternatively, you can click the actions menu next to the driver and select
Edit.
Edit the driver settings in the
Edit Drivers window. For more information about editing drivers in the
Edit Drivers window, see
Creating Drivers.
Select the
Save And Close button.
Attention: This option does not update existing drivers if they have been found previously.
To update the driver, click the Save And Find Drivers button.
Qtip: Drivers and their impact rank are derived when you click Save and Find Drivers or Find Drivers (for more information, see the Finding Driver Results section). However, you can re-run and iterate on drivers, for example after updating the time range and scope or excluding attributes and topics that are not useful.
Click
Save And Find Drivers to save your changes and run the investigation.
Qtip: Click Cancel to close the Edit Drivers window without saving the changes.
Sharing Drivers
Qtip: Once you share a driver, its status changes from Private to Shared or Public.
You can share your drivers with other users if you wish to let them view the drivers and report on them. You can share drivers with individual users, groups, or everyone in your master account. When sharing, you can choose between viewer-level access (requires a Can View permission) and editor-level access (requires a Can Edit permission).
When you share a driver with a group, all members of that group will be able to use the driver. Users who join the group after you have shared a driver will still get access to it. As soon as any user leaves the group, the driver will no longer be accessible to that user. You can stop sharing your driver at any time.
Click Drivers.
Select the content provider’s project to use.
If you have access to more than one account, select the relevant account.
If you have access to more than one project, select the relevant project.
Locate the driver you wish to share.
Qtip: You can enter the name of the driver in the Find Drivers box to find it.
Click the actions menu next to the driver.
Select the checkbox beside each of the drivers that you want to share to share more than one driver at once.
Type the email of the individual Studio user or the name of the group that you wish to share the driver with in the
Enter users or groups to share with box.
Qtip: Wait for the email address (or the name of the group if sharing with a group) to appear in the dropdown menu and then select it.
Select the
Share with all Users checkbox to distribute organization-wide drivers to every Studio user in your master account. Bulk sharing is only available for the drivers you own. When sharing multiple items, previously shared information is not available. You can combine public sharing with select user and group sharing.
Attention: Bulk sharing overwrites any previously shared permissions a user may have.
Qtip: This action requires a Share to All permission.
Users and groups you specify appear in the Add section. Select 1 of the following access levels for each user and group from the dropdown menu in the Access column:
- Can View: Allows the user or group to view driver settings, results, and report on them.
- Can Edit: Allows the user or group to edit driver settings, find drivers, and report on them.
Qtip: The Can Edit access is not available when you share a driver with all Studio users.
Qtip: You can add as many users and groups to the Addsection as required.
Click X to remove items that have been selected for sharing.
To stop sharing a driver with a user or a group, locate the user or group that you are sharing the driver with in the
Previously Shared section in the
Share Driver window.
Select
Remove Access from the dropdown menu in the
Access column.
Qtip: When a driver is shared with a group, removing a user from that group will also make your driver inaccessible to that user.
To stop sharing a driver with everyone, click the Remove All link in the Share Driver window.
Click Share.
Drivers Permissions
The following table provides an overview of the available permissions for each access level when sharing drivers.
| Permission | Owner | Can Edit | Can View |
| Can view driver settings | Yes | Yes | Yes |
| Can view driver results | Yes | Yes | Yes |
| Can report on drivers | Yes | Yes | Yes |
| Can edit driver settings | Yes | Yes | No |
| Can find driver results | Yes | Yes | No |
| Can share a driver | Yes | No | No |
Transferring Drivers
Qtip: Once you reassign driver ownership to another user, you cannot undo this action. Only the new owner can change driver ownership further. You can retain a Can Edit permission to the driver by selecting the Retain Share Edit Access checkbox during the transfer.
Driver owners can transfer their drivers to other users, making them the new owners. Driver ownership can only be transferred to users who satisfy the following conditions:
Click Drivers.
Select the content provider’s project to use.
If you have access to more than one account, select the relevant account.
If you have access to more than one project, select the relevant project.
Locate the driver you wish to transfer.
Qtip: You can enter the name of the driver in the Find Drivers box to find it.
Click the actions menu next to the driver.
Select the checkbox beside each of the drivers that you want to transfer to transfer more than one driver at once.
Click Transfer.
Select the new owner’s email from the menu.
If desired, you can select the
Retain Share Edit Access checkbox to keep editor-level access to your drivers after the transfer.
Qtip: Deselect this checkbox if you don’t need to access the drivers.
Click Transfer.
After you click Transfer, the drivers are transferred to the new owner.
Finding Driver Results
After you create a driver, you need to run it for XM Discover to find the drivers in your data. You need to find drivers in the following cases:
- For a driver in the Defined state, finding drivers is a necessary step before you can view them or use them in reports.
- For a driver in the Reportable state, finding drivers is required after you change driver settings to update the results.
For information on viewing and working with driver results, see Working With Driver Results.
Click Drivers.
Select the content provider’s project to use.
If you have access to more than one account, select the relevant account.
If you have access to more than one project, select the relevant project.
Locate the driver you wish to run.
Qtip: You can enter the name of the driver in the Find Drivers box to find it.
Click
Find Drivers in the
Results column.
Qtip: If you need to make changes to the driver before running it, click the driver name, change the settings, and then click Save And Find Drivers. For more information, see Editing Drivers.
If there are critical issues with the driver, you will see a warning (similar to the warnings returned when creating a driver).
Qtip: Red warnings must be fixed before drivers can be found.
If there are no critical issues with the driver, XM Discover will find drivers and generate the results. For information about driver results, see
Working With Driver Results.
The driver’s status changes to
Reportable in the
Status column. You can then view drivers or report on them.
Duplicating Drivers
In addition to creating new drivers, you can duplicate the drivers you created previously.
Click Drivers.
Select the content provider’s project to use.
If you have access to more than one account, select the relevant account.
If you have access to more than one project, select the relevant project.
Locate the driver you wish to make a copy of.
Qtip: You can enter the name of the driver in the Find Drivers box to find it.
Click the actions menu next to the driver.
Select Duplicate.
This creates a copy of the driver.
Qtip: You can edit and rename the copy.
Reporting on Drivers
You can group data by drivers and combine the impact score with other calculations using the scatter widget. There are 2 ways you can add a driver-based scatter widget:
Grouping Data by Drivers Manually
Click
Edit to open the dashboard in edit mode.
Click the scatter widget and drag it to your dashboard canvas. Hover your mouse over the widget icons to see the widget name.
Click the
Visualization tab.
Select the driver you wish to report on from the
Drivers options in the
Group By Click the plus (
+ ) icon to view all the available
Drivers options.
Select your preferred calculations for the
Vertical Axis.
Select your preferred calculation for the Horizontal Axis.
Select your preferred calculation for the Bubble Size.
The best way to analyze drivers is in their context which is achieved by syncing widget filters with drivers. When data in a scatter widget is grouped by drivers, you can switch filter syncing between the widget and drivers on and off.
Click
Edit to open the dashboard in edit mode.
Click the scatter widget and drag it to your dashboard canvas.
Click the
Filters tab in the
Edit Widget window.
Qtip: When widget filters are synced to drivers, the Filters tab has a lock icon on it.
Select the
Sync to Drivers A Driver Filter Conditions checkbox to turn filter syncing on.
Qtip: Deselect the Sync to Drivers A Drier Filter Conditionscheckbox to turn filter syncing off.
Deleting Drivers
Attention: If you delete a driver used in a widget, the widget will remain in the dashboard, but will return an error because the driver definition will be gone.
You can delete the drivers you no longer need.
Click Drivers.
Select the content provider’s project to use.
If you have access to more than one account, select the relevant account.
If you have access to more than one project, select the relevant project.
Locate the driver you wish to delete. You can enter the name of the driver in the Find Drivers box to find it.
Click the actions menu next to the driver.
Select the checkbox beside each of the drivers that you want to delete to delete more than one driver at once.
Select Delete.
Click
Delete to confirm that you wish to delete the driver or drivers.
Hiding and Unhiding Drivers
Qtip: Hiding a driver only affects its visibility for the current user and has no impact on other Studio users.
Hiding a Driver
You can hide drivers without deleting them.
Click Drivers.
Select the content provider’s project to use.
If you have access to more than one account, select the relevant account.
If you have access to more than one project, select the relevant project.
Locate the driver you wish to hide. You can enter the name of the driver in the Find Drivers box to find it.
Click the actions menu next to the driver.
Qtip: Select the checkbox beside each of the drivers that you want to delete to delete more than one driver at once.
Select Show/Hide.
Select Hide.
Switch hidden drivers visibility off. See the Turning Hidden Drivers Visibility On or Off subsection below for more information.
Unhiding a Driver
You can unhide hidden drivers.
Make sure hidden drivers visibility is switched on. For more information, see the Turning Hidden Drivers Visibility On or Off subsection below.
Click the actions menu next to the driver you wish to unhide. Hidden drivers are displayed using lighter colors.
Qtip: Select the checkbox beside each of the drivers that you want to delete to delete more than one driver at once.
Select Show/Hide.
Select Show.
Turning Hidden Drivers Visibility On or Off
You can turn hidden driver visibility on or off.
Click Drivers.
Select the content provider’s project to use.
If you have access to more than one account, select the relevant account.
If you have access to more than one project, select the relevant project.
Click the
Object menu next to the
Drivers Name column.
Click
Show All Hidden to show hidden objects.
Click
Hide All Hidden to hide objects that are currently shown.