Update Panelists from a File - Passwords Retained

Update Panelists from a File - Passwords Retained

Overview

You can efficiently update panelist information for multiple panelists by importing their new information from a file. When updating panelists' information from a file, you have the option to update their passwords or leave their passwords unchanged. This workflow's focus is on the more common scenario, which is updating panelist information in the Panelists library without changing panelist passwords.

Visit the Panelist Library page for other topics that may be of interest to you.

The panelist information update involves the following steps:
  1. Exporting current panelist information
  2. Updating panelist information in the exported file
  3. Importing updated panelist information

Export Panelist Information

  1. From the black ribbon at the top of the screen, select Libraries > Panelists.

  2. Click on a panel you wish to update, or use the Find panelists feature to list the panelists you wish to update.

  3. If you wish to update all listed panelists, click in the checkbox in front of the Username.


    Alternatively, if you do not wish to update all the listed panelists, either refine your search, or manually click the individual panelists' checkboxes until you select those that you intend to update.

  4. Select Import/export > Export panelists. The Import/export history page will open for you with the option to download the file you just exported.

  5. Click on the down arrow or the file name and save the file to a location on your local or network drive. Open the file.

Update Panelist Information in the File

We will follow an example scenario for updating Email for our panelists. In our example scenario, initially panelists were imported without their email addresses until the Legal Department approved that emails can also be added.

The file you exported by following previous steps will contain all the fields coming from the Panelists library, except for the Password. Some fields can be updated in the Panelists library, while others cannot. The fields that cannot be updated are:
  1. Unique Panelist Id - A system generated numeric code at the time the panelist record was originally created.
  2. Panelist Name -  System generated information representing a combination of panelist First name and Last name.
  3. Date Created - The date when the panelist record was originally created.
  4. Last Product Test - The date of the last product test in which the panelist completed a sample set.
  5. Last Screener Test - The date of the last screener test in which the panelist completed a sample set.
If you try to import data for fields that cannot be updated, the data in your file for these fields will be ignored, but the rest of panelist information included in the file will be updated if the import is successful.

Going back to our example scenario, as a reminder, we are only interested in updating the email address field for all panelists. For this reason, we will keep the Email column in the file and two other columns outlined below the screenshot.

When deleting unwanted columns:
  1. To select and delete one column at a time, click on the column letter, right-click on the selected area and select Delete.

  2. To select and delete multiple columns at a time, use the combination of Ctrl key and mouse click. Right-click on the selected area and select Delete.



The three columns that should remain in your file are:
  1. Username - Required field that enables the software to know which email belongs to which panelist

  2. Panelist Name - Although this field cannot be updated in the Panelists library, it will not give you errors if you do try to import it. The information in this column might be useful to you when populating the email addresses if the Username is not descriptive enough for this purpose. When done updating your file with the email addresses, this column can be removed, if you prefer that.

  3. Email - Required in our example scenario because this is the information we wish to update for all the panelists in our file.


The importing information must start in the cell A1 and continue into the column C without any blank columns between. Please see the screenshot above. If your columns are separated by blank columns, please remove the blank columns (select entire blank column at a time, right-click and select Delete).

Update the email addresses for your panelists. When done and certain that each email address corresponds to the right panelists, save the file making sure that you maintain the .csv file format.

Import Updated Panelist Information

  1.  In the Panelists library, select a panel. It does not matter which panel you select for this workflow.

  2. On the right, select Import/export > Import panelists .


  3. In the Import panelists options screen, select Update existing panelists > Do not change password > Next .

  4. In the Import panelists screen, click Browse and locate your panelist import file that you prepared earlier. Click Open .

  5. Click Submit .

You will be provided with a message indicating whether your import was successful or not.


Message
Description

All the records in your file imported successfully. No action is required for successful imports.

Your file imported partially. The portion of your original file that did not successfully import is saved to a new file.

Download the revised file to review what has caused the import to be unsuccessful, and update the file to eliminate the issue.
  1. If the newly updated file corresponds to existing panelists in the Panelists library, repeat the importing steps above.

  2. If the newly updated file contains information for panelists that do not currently exist in the Panelists library, follow the steps for importing new panelists.


Your entire file did not import.

Download the revised file to review what has caused the import to be unsuccessful, and update the file to eliminate the issue.
  1. If the newly updated file corresponds to existing panelists in the Panelists library, repeat the importing steps above.

  2. If the newly updated file contains information for panelists that do not currently exist in the Panelists library, follow the steps for importing new panelists.

 
Once the import is complete, your panelists will be able to access the panelist website the same way they were used to (their passwords will be unchanged). With our example scenario, email addresses that were added to each panelist's record will be useful to you for communicating with panelists directly from the software.


To review the import and export history for a panel at any time, in the Panelists library, select the panel you are interested in, and on the right, select Import/export > Import/export history .



    • Related Articles

    • Panelists Library

      Overview In order to invite panelists to your tests and to otherwise communicate with panelists from our software, the panelists need to be imported into the Panelists library. You can organize your panelists into panels and subpanels. There are ...
    • Update Panelists from a File - Passwords Updated

      Overview When updating panelists' information from a file, you have the option to update panelist passwords as well, or leave their passwords unchanged. This workflow's focus is on the scenario where updating panelist information in the Panelists ...
    • Import Panelists with Preset Passwords

      Overview When importing panelists, you have the option to set passwords for panelists or let them set their own passwords. This workflow's focus is on importing "real" panelists with preset passwords. In other words, you are in control of their ...
    • Import Panelists - Panelists Set Their Own Passwords

      Overview When importing panelists, you have the option to let panelists set their own passwords, or you set the passwords for panelists. This workflow's focus is on importing "real" panelist information prompting those panelists to set their own ...
    • Panelists Reset Their Passwords

      Overview For security reasons, panelist passwords are not retrievable in any way after the panelists are added to the Panelists library. Therefore, it is not possible to display to panelists what their password is. If they forget their password a new ...