About the Load Users into CX Directory Task
The Load Users into CX Directory task is used to save CX user data to Qualtrics. This task allows you to keep your CX user data up-to-date on a regular basis. To use this task, you must first load data into Qualtrics using a data extractor task.
Setting Up a Load Users into CX Directory Task
- Click the navigation menu in the top left corner.
- Go to Workflows.
- Click Create a workflow.
- Determine whether the workflow should be Started by an event (i.e. event-based), or Started at a specific time (i.e. scheduled). For a comparison of these options, see Scheduled Workflows vs. Event-Based Workflow. Most of the time, you’ll use a scheduled workflow.
- Click Get started.
- If desired, rename your workflow.
- If using a scheduled workflow, determine when the workflow runs. If using an event-based workflow, determine the event that begins the workflow.
- Click the plus sign ( + ), select Task, and choose the data extracting task that imports data into Qualtrics. You must first set up a data extracting task before you can use the load users into CX Directory task. See using workflows tasks to build ETL workflows for more information. Your task must import the following fields: Unique Identifier, Username, FirstName, LastName, and Email.
Qtip: We recommend using the extract data from SFTP files task. The users example file is configured for use with this task.Qtip: There is a maximum file size of 100 MB.
- After setting up your extracting task, click the plus sign ( + ) and select Task.
- Choose the Load Users into CX Directory task.
- Select the data extracting task you set up earlier.
- Begin mapping your imported data fields to CX user attributes using the dropdown menus. Fields marked with an asterisk are required.
Qtip: By default, all existing CX user attributes in your license will be included in your mapping. You can remove any unneeded fields by clicking the trash can icon next to the field.Qtip: If your source field and CX directory field names match exactly, then they will be automatically mapped for you!
- If needed, click the blue plus sign ( + ) below a field to map individual field values. This is useful if you want to use different data values in Qualtrics.
Example: In the above screenshot, the value “Europe” from our imported data file will be saved as “EMEA” in Qualtrics.
- If needed, click Add field to add additional fields to your mapping. When adding a new field, you can map to an existing CX user attribute, or create a new one.
Qtip: If creating a new field, you must give the field a name. Be careful when naming your field, as you cannot edit or delete it without contacting your Brand Administrator.
- Click the trash can icon next to a field mapping to delete it.
Qtip: You must remove any unmapped CX user attributes.
- A Mapped Values counter is at the bottom of the task to track your mapping progress. Make sure that all imported fields are mapped.
- When finished, click Save.
Qtip: The task will not let you save if your mapping is incomplete. If the Save button is grayed-out, then double-check your mapping.
- Toggle your workflow On.
When the workflow runs, your users will be imported to Qualtrics and saved in your CX user admin.
This section covers common issues that can appear when setting up this task.
- After selecting the task, you may see the error Directory not found, try reloading the page. This error appears if your license does not have access to CX user admin. To enable CX user admin, contact your Customer Success Representative.
- After selecting the task, you may see the error Unique ID is required to be enabled to use this extension. This error appears when your license does not have unique identifiers. To enable unique identifiers, contact your Customer Success Representative.
- If the Save button is grayed-out, then that means your mapping is not complete. Make sure that all of your imported fields are included as indicated by the field counter in the lower left corner. Additionally, make sure that any fields included in the task are completely mapped.