About Participants Tools
In EmployeeXM, you are given a set of Tools that you can use to manage the participants uploaded into your project. To get to these tools, navigate to the Participants section of the Participants tab, then select Tools.
Export Participants will download your current participant list to a CSV file, complete with metadata columns. This file can act as a sample file you can re-import when you want to update your metadata, or if you want to run a survey with the exact same participants a following year.
This file comes with one custom column named Status that shows whether a participant has completed their response, or if you are still waiting for them to respond.
Export Filtered Participants List
Instead of exporting all the participants in your project at once, you can narrow down who should be included in the export by metadata.
- Go to Tools.
- Select Export Filtered Participants List.
- Select the metadata you want to filter your export by.
- Select the values you want to include. You can select multiple values.
- Click Add Criteria to add more metadata to set conditions by.
- To remove a condition, use the minus sign ( – ).
- Click Export.
Remove Participants lets you remove some participants from your project. To remove participants, you will upload a file containing the unique identifiers of every participant you want to remove. See Removing Participants for more information.
If you uploaded the correct participants, but not the correct metadata, then you can use a CSV import to update your participants’ metadata.
You can manage all the metadata for your EmployeeXM project using the Manage Metadata tool. Editing metadata here won’t affect metadata in the directory, but it will affect it for the whole project.
- Navigate to the Participants section in the Participants tab.
- Click Tools on the top-right.
- Select Manage Metadata.
- Click on a metadata field so it is highlighted in blue.
- For the selected metadata field, note the possible Values listed to the right. Only the first 500 are displayed.
- Hover your mouse over a field to get the gear button. Click this button.
- Click Delete to permanently delete the selected metadata from your brand.
- Click Close when you’re done making changes.
Update All Responses With Current Metadata
If you have made changes to your participants’ information by importing new metadata or through the participant information window, you will want to make sure these updates are reflected in your dashboards and with your responses. Update All Responses With Current Metadata updates this information for every single one of your participants.
Update Data & Analysis With Current Participant Metadata
The Update Data & Analysis With Current Participant Metadata option helps your participant metadata stay updated in your project’s data. When you select this option, the following will be performed to your responses:
- If a metadata field has been added to your project’s participants, using this option will make that field available as a column in Data & Analysis.
- If a metadata field has been deleted from all participants in the project, using this option will remove the field as a column in Data & Analysis.
Please note that this option will not change the metadata values for your recorded responses. For example, let’s say you have a metadata field called “Location” which has a value of “Provo” for a participant’s response. You change the field value to “Seattle” in the Participants tab, and run the Update Data & Analysis With Current Participant metadata job. In your recorded responses, the metadata value will still be “Provo.”
If you need to change the recorded value for a metadata field in your data, you can edit the value directly in Data & Analysis. Note that this direct editing functionality is only available for Lifecycle projects. See the linked page for more information about response editing.
Update All Action Plans With Current Metadata
If you have made changes to your participants’ information by importing new metadata or through the participant information window, you will want those updates reflected in your dashboards’ action plans. The Update All Action Plans With Current Metadata option updates this information for all of your participants. Note, while this update is processing, Action Plans in your dashboard will be unavailable.
Update Invited Counts
If changes are made to your participants or your Org Hierarchy after you’ve started working on your dashboard, you may need to Update Invited Counts. The Update Invited Counts job makes sure that the invited counts in your Response Rates and Participation Summary widgets accurately reflect the participants who have been invited to participate in your project.
You need to Update Invited Counts for all of the following scenarios:
- Participants were added/removed from the project.
- Metadata for participants were updated.
- Metadata fields were added or removed.
- The Org Hierarchy was updated.
While this job is running, you won’t be able to use other update jobs, like the Update All Responses with Current Metadata job. Additionally, widgets dependent on invited counts will show an error message while the job is processing.
Manage Previous Imports/Updates
If you have recently imported your participants or chosen to Update All Responses With Current Metadata, the Manage Previous Imports/Updates tool will allow you to look back on a history of your imports.
A column is provided for the Status, the Type of import, the Progress of the import, Date imported, and the opportunity to Delete the import from your history.
If you click View Results underneath the Status column, you will receive a report of what this upload accomplished. If there were any errors that prevented the upload, they will be mentioned here.
In the above image, there were no errors, but all the users updated already existed in the directory, so no new users were added. In addition, any new metadata that might have been included with these users was added to their metadata in the directory so it could be used for later surveys.