Distribution List is a list of all the users to whom the survey will be distributed for collecting data. They can be created from the
Distribute
page either manually
one by one OR by uploading the list.
To create a list,
Adding members to Distribution list Manually
Once the Distribution list has been created, users can start adding members. To add members,
-
Click on the Distribution List in which you wish the add the users.
-
Click on
Add.
-
Blank fields will be added below the default columns
Sample ID
and
Email.
-
You can enter any Sample Id for example "1" or "a" in the sample ID field.
- Enter the Email of the member below the Email column.
Repeat the above steps and add as many members as you wish.
Note: If you do not enter any Sample id and leave the field blank, a system generated ID will automatically reflect in the field which cannot be edited.
Adding Columns to your Distribution List
Users can also add extra
columns in their Distribution list apart from the existing default columns
that are Sample ID and Email. This is useful if you want to record more details about the listed users or if you want to configure that information while sending out Email invitations. (Refer Sec.
Distribute Surveys
via Email
)
To add Columns to your Distribution list:-
- Click on "Add Column icon (+)" next to the Email column.
- A pop-up will appear. Enter the Column Name for your new column.
- Enter Mapped Variable Name if you are uploading your Distribution list in CSV format. Enter the Column name mentioned in your CSV file that you want to map with the column you are creating.
There are five types of
columns that users can add to their Lists:-
1. Language
: If you choose to add the Language column in
your Dist. list, it will allow you to select languages for the members so
that the survey launched for them will be in that specified language.
2. Option List
: This is generally helpful when the user
chooses to upload a distribution list (CSV format). It allows the user to specify
before hand the number of options in a column. For Example: If a column name is Gender, than the
responses Male and Female become its options.
- If you wish to create a
column which has certain specific options in the data you wish to upload, select the column Type as "Option List".
- Properties related to "Option list" will appear.
- Click on "Add Item". Fields will appear to add your item/option for the give column name.
- Enter
Analysis Label
,
Factor
and
Mapped Option Code
(if code for the option is given in the List you wish to upload. For Example: Female=1 & Male=2).
- Repeat the above steps to add multiple options to your option list as given in the file you are about to upload.
- Click on
OK
. A column will be created so that now when you upload your Distribution list, it will automatically show the responses as options.
Note: After mapping your option list, If you select the checkbox " Only allow the options below :", only the data (members for which the specified option is relevant) for the options in the distribution list that you have mapped in the option list properties will get uploaded.
For Example: Assume that the CSV file you are uploading has a column named "Gender" and has two options Male and Female. Now if you only map "Male" option in the Option list properties, and click on the check box for " Only allow the options below :", only the members assigned as gender "Male" will get uploaded.
3. Text
: Text type column can be added for fields like member's address etc.
4. Number
: Numeric type columns can be added like a person’s age etc.
5. Date/time
: Date/time column can be added for mentioning
the date and time in any case scenario.
- After Selecting the Column Type,click on OK.
- A new column will be created in your List.
- Repeat the above steps to create as many columns as you want.
Uploading Distribution ListTo upload a CSV file, follow the steps below:-
- In the Distribution List pop-up, create the columns you wish to have in your upload file and click on Download.
- A CSV template will be downloaded to your system with two default columns Sample ID and Email. It is mandatory to have data in these two columns.
- You can enter the details of the members in these two columns of the CSV file or you can add extra columns if you wish to Add in your CSV file.
Note: If you create extra columns in your CSV file, make sure that you have those columns in your Distribution List as well with the required column types and properties. Only then the data for those columns will get uploaded.
Tip: Its always better to first create the extra columns in your Distribution List first and then Download the CSV Schema. So that the downloaded schema already has the extra columns.
Deleting Records in Distribution List
You can delete records from the list by selecting the records form their adjacent check box and clicking on
Delete.