How to work with Panels in LimeSurvey

Transcription

1 University of Guelph How to work with Panels in LimeSurvey LimeSurvey Drill Down Document Note: The author of this guide is the University of Guelph s Computing and Communication Services and was downloaded from this website: Although this is an annotated version created to be compatible with our LimeSurvey Website, the authorship and credit for this entire document is to be considered unchanged. Identifying annotations: 1) insertions are in red font, 2) deletions are marked like this, and other comments are in red-framed text boxes. Travis Seymour, April /14/2011

2 Often you wish to restrict access to your survey to members of a pre-defined list of participants. For example, if your survey consists of questions comprising the various ballots for an election, you will want to restrict access to the survey to the people on the voters list. In online surveys such a pre-defined list of eligible participants is called a panel. In LimeSurvey panels are implemented by a concept known as a token table. This Drill-Down document shows you how to create a token table for your survey, and set the metadata in your survey so only people listed in the token table can take your survey. There are four broad steps involved in working with panels. 1. Create a comma separated values (csv) file containing your panel information. 2. Create and populate a token table for your survey. The token table is populated with the content from your csv file. 3. Activate your survey and specify that it should use a token table (i.e. that it should be closed access ). 4. Announce your survey. Step 1: Create a comma separated values (csv) file containing your panel information. The csv file must have the information as illustrated below: firstname,lastname, The first line in the file must be: firstname,lastname, Enter each panel member s information on a separate line. This person s firstname is Reanne. Their lastname is Fruer. Their address is 2

3 Note that: the first line in the csv file must read: firstname,lastname, you enter your panel members information on subsequent lines in the file. For each member of your panel, enter their firstname, lastname, and address - separated by commas. You must supply the firstname, lastname and address for every member of you panel. It is often easiest to create and maintain your panel information in an Excel spreadsheet as shown in Figure 1. Figure 1: An Excel spreadsheet containing sample panel information Within Excel, you can then save the spreadsheet as a csv file as illustrated in Figure 2. 3

5 Step 2: Create and populate a token table in your survey. Step 2a: Click the Token management icon on the survey toolbar, as pointed to by the red arrow in the Figure 3: Figure 3: The location of the token management icon on the Survey toolbar. Step 2b: Click the Initialize tokens button as pointed to by the red arrow in Figure 4. 5

6 Figure 4: The location of the Initialize tokens button Step 2c: Click the Continue button as pointed to by the red arrow in Figure 5. Figure 5: The location of the Continue button 6

7 Step 2d: You will then be presented with the Token control toolbar, as illustrated in Figure 6. Click the Import tokens from CSV file icon, pointed to by the red arrow in Figure 6. Figure 6: The Token control toolbar Step 2e: Locate your csv file on your computer (the csv file was created in step 1 of this document) by clicking the Browse button (pointed to by red arrow 1 in Figure 7), then click the Upload button (pointed to by red arrow 2 in Figure 7). 7

8 Figure 7: The location of the Browse and Upload buttons Your csv file will be uploaded to the LimeSurvey server, and your token table will be populated with the information from the file. Step 2f: Next, generate tokens for each person in your token table by clicking the Generate tokens icon pointed to by the red arrow in Figure 8 below. A token is a unique password for each member of your panel. When a person accesses your closed access survey they will be asked for their token. Alternatively, within LimeSurvey you can send an invitation to selected or all people in your token table. Within the message is a customized link the respondent can click to access your survey. The link includes the respondent s specific token so they will not be prompted for a token 8

9 when the survey loads. Sending invitations is covered in Step 4 of this Drill Down document. Figure 8: The location of the Generate tokens icon on the Token control toolbar. Step 2g: Next click the Yes button to proceed with token generation, as shown in Figure 9. Figure 9: Click the Yes button to proceed with token generation. 9

10 Your tokens will be created. Each token will be unique. Step 2h: You can then click the Display tokens icon to display the contents of your token table. The location of the Display tokens icon is pointed to by the red arrow in Figure 10 below. Figure 10: The location of the Display tokens icon on the Token control toolbar. In the resulting display (shown in Figure B below), note the tokens that have been assigned to the various members of your panel. The tokens are unique and their length is determined by a setting in your survey s metadata as illustrated in Figure A below. In Figure B, note also the icons beside each panel member s entry, in the Actions column (outlined with a red rectangle in Figure B below). As with all icons in LimeSurvey, you can mouse over each icon to view the associated tooltip to determine the icon s action. For example: a) clicking the pencil icon will let you edit the information (i.e. attributes ) associated with the person s entry in the token table. You can change any attribute. b) clicking the green gear icon will let you complete the survey on behalf of the panel member. c) clicking the red X icon will delete the entry from the panel. d) clicking the symbol that looks like an envelope will let you send an invitation to the panel member inviting them to complete your survey. (This icon will change to send a reminder after the initial invitation has been sent). 10

11 Figure A: The location of the survey metadata setting that governs the length of the tokens in the token table. By default, tokens are 15 characters in length. Note also in Figure B the Export tokens to CSV file icon, pointed to by red arrow 1. Clicking this icon will export a copy of all your token information to a CSV file for review and in-depth analysis as required. 11

12 Figure B: The location of the icons beside each panel member s entry, and the Export tokens to CSV file icon. Note also the Edit templates icon (pointed to by the red arrow in Figure 11 below). Included with your token table are a number of message templates of content you can send to invite members of the panel to take your survey, remind members of your panel about your survey if they have not yet responded, thank the participant when they submit your survey, notify you when a response has been received, etc. You can edit the content of these message templates by clicking the Edit templates icon. Tip: Include yourself in the token table so you can send messages to yourself for testing purposes before sending to your panel members. 12

13 Figure 11: The location of the Edit templates icon on the Token control toolbar. Clicking the Edit templates icon pointed to by the red arrow in Figure 11 above presents the screen in Figure 12 below. 13

14 Figure 12: The screen displayed when you click the Edit templates icon. Referring to Figure 12 above: a) The templates are arranged on tabs (see the area outlined with a red rectangle in Figure 12 - these are the tabs). In the figure the Invitation tab is the active tab so you are seeing the template for the invitation message. This is the message that is sent to your panel members to invite them to take your survey). b) placeholders are present in your templates. In Figure 12, red arrows 1, 2, and 3 are pointing to placeholders. placeholders are of the form: 14

15 {PLACE_HOLDER_NAME} (note the name is always in capitals and is always enclosed in brace brackets) c) When you send the message LimeSurvey replaces the placeholder with the value appropriate for the specific panel member. Refer to the Placeholder section of the LimeSurvey User Manual for a complete listing of all placeholders (the section is within the Tokens chapter). Below is a list of the most commonly used placeholders. Note that if you include an placeholder in your message it must be all capitals, and it must be enclosed in brace brackets. placeholder {ADMIN } {ADMINNAME} {SURVEYNAME} {SURVEYDESCRIPTION} { } {FIRSTNAME} {LASTNAME} {SURVEYURL} {TOKEN} Description of the Survey administrator (set in your survey s metadata) Name of Survey Administrator (set in your survey s metadata) Title of your survey Description of your survey address of the recipient i.e. the person in the token table. First Name of the recipient i.e. the person in the token table. Last Name of the recipient i.e. the person in the token table. The URL pointing to the survey start - if you are sending HTML s this will be a fully linked HTML version. The recipient can click this link to go directly to your survey. The recipient s token to access the survey d) After making any changes to the template, ensure you click the Save button to save your changes. 15

16 When you have completed working with your token table, click the Return to survey administration icon to return to the previous multi-toolbar display. The Return to survey administration icon is pointed to by the red arrow in Figure 13 below. Figure 13: The location of the Return to survey administration icon on the Token control toolbar. Step 3: Activate your survey and specify that it should use a token table (i.e. that it Step 3a: should be closed access ). First, click the Activate this survey icon on the Survey toolbar. The icon resembles a small green triangle and is pointed to by the red arrow in Figure 14 below. 16

17 Figure 14: The location of the Activate this survey icon on the Survey toolbar. Step 3b: After reviewing the content of the warning messages, click the Activate survey button as pointed to by the red arrow in Figure 15 below. 17

18 Step 3c: On the resulting screen, click the Switch to closed-access mode button that appears, as pointed to by the red arrow in Figure 16 below. 18

19 Figure 16: The location of the Switch to closed-access mode button Step 3d: The Token control toolbar will appear as shown in Figure 17 below. Click the Return to survey administration icon (pointed to by the red arrow in Figure 17) to return to the previous multi-toolbar display. 19

20 Figure 17: The location of the Return to survey administration icon on the Token control toolbar. Step 3e: Your survey is now active, in closed access mode, which means participants will require a token to participate. The URL of your survey is pointed to by the red arrow in Figure 18 below. 20

21 Figure 18: The URL of your survey is pointed to by the red arrow. Step 4: Announce your survey. Once your survey has been activated you announce its availability to your panel of respondents. You can do this within LimeSurvey by sending an invitation message to your panel. Start this process by clicking the Send invitation icon on the Token control toolbar. The location of the icon is pointed to by the red arrow in Figure

22 Figure 19: The location of the Send invitation icon on the Token control toolbar. After clicking the icon the form illustrated in Figure 20 will appear. Review the text of your invitation message for accuracy, noting that some placeholders have already been replaced with content (see red arrow 1) while others are still present (see red arrow 2). The placeholders not yet replaced with content are those that will be replaced with recipient-specific information from the token table as the message is sent to an individual. When you are ready to send the invitations click the Send invitations button pointed to by red arrow 3 in Figure 20. The messages will be sent in groups of X (e.g. 200) messages, where X has been set by the CCS LimeSurvey system administrator. After a group of X messages has been sent, if you have more recipients in your token table, you will be prompted for authorization to send the next group of X messages. Tip: Always send an invitation to yourself first, to check for accuracy and completeness, before sending the invitation to your full panel. Refer to Step 2h and Figure B above for information on how to do this. 22

23 Figure 20: The form that appears containing the text of your invitation message. Leveraging the dynamic nature of LimeSurvey s token table As you send invitations to your panel members, LimeSurvey updates the token table with the date/time the invitation was sent. As your panel members complete the survey LimeSurvey again updates the token table with this indication. This dynamic nature of the token table lets you track who has and has not responded to your survey. You can click the Send reminder icon on the Token control toolbar to initiate the process of sending reminder s to the panel members who have not yet completed 23

24 the survey. The location of the icon is pointed to by the red arrow in Figure 21 below. As your reminder messages are sent, LimeSurvey again updates the relevant information in the token table. Figure 21: The location of the Send reminder icon on the Token control toolbar. For more information on working with tokens and the token table, please refer to the relevant section of the LimeSurvey User Guide. 24

University of Guelph Tips for using Lime- Survey s internal editor LimeSurvey Drill Down Document Note: The author of this guide is the University of Guelph s Computing and Communication Services and was

Creating and Managing Online Surveys LEVEL 2 Accessing your online survey account 1. If you are logged into UNF s network, go to https://survey. You will automatically be logged in. 2. If you are not logged

University of Guelph Tips for using LimeSurvey s internal editor LimeSurvey Drill Down Document Computing and Communications Services 7/18/2011 For most areas of the LimeSurvey system when you are editing

Blackboard 1: Course Sites This handout outlines the material covered in the first of four workshops on teaching with Blackboard. It will help you begin building your Blackboard course site. You will learn

Access Your SharePoint Web Site... 2 Work with Folders and Documents in a Shared Documents Library... 2 Edit a Document... 2 Create a New Document... 3 Create a New Folder... 4 Upload One or Multiple Documents...

How Do I Upload Multiple Trucks? 1. Log into account. Please see the How Do I Log into My Account? document (DOC-0125) for additional assistance with logging into PrePass.com. 2. On the Admin Home tab,

Qualtrics Survey Software Qualtrics is online survey software with the ability to create and distribute surveys, quizzes, and polls. Katz and CBA faculty, staff, and students may create accounts. There

Initial Setup Guide Welcome to SafeSend! This guide has been created to assist with your initial setup. Please follow the below steps to get started. If you are a Firm Administrator and are setting your

Project management deliverables (e.g. reports); WBS deliverables can be used for report timing Steps to Create a Project from an Existing Template: 1. Click File then New. 2. Select any of the featured

introduction to emarketing emarketing is typically used for promotional campaigns for attendee generation and for attendee communication. It works closely with ereg which also includes email capabilities

University of Guelph How to change the order of Questions and Question Groups in your survey LimeSurvey Drill Down Document Computing and Communications Services 7/21/ As you add questions to your survey

emarketing Manual- Creating a New Email Create a new email: You can create a new email by clicking the button labeled Create New Email located at the top of the main page. Once you click this button, a

Virtual Communities Operations Manual The Chapter Virtual Communities (VC) have been developed to improve communication among chapter leaders and members, to facilitate networking and communication among

Introduction The wireless guest server solution provides a simple means of utilizing the University s network resources while securing access to critical network areas. Guests of the University who require

Pinpointe User s Guide Edition 2.1 October 2008 About This User s Guide How to Use This User s Guide This user s guide describes Pinpointe s Graphical User Interface (GUI). It shows you how to use each

How to design and print cards using a database connection with emedia CS Software Open up emedia software by clicking on the desktop icon. On opening the software you will see the following screen: Click

Work with the MiniBase App Trademark Notice Blackboard, the Blackboard logos, and the unique trade dress of Blackboard are the trademarks, service marks, trade dress and logos of Blackboard, Inc. All other

How to Edit an Email Editing a new email created during the Create an Email wizard or editing an existing email in the Edit Email section of the Manage Emails tab is easy, using editing tools you re probably

Creating Codes with Spreadsheet Upload Ad-ID codes are created at www.ad-id.org. In order to create a code, you must first have a group, prefix and account set up and associated to each other. This document

Using Webmail Technical Manual: User Guide The Webmail Window To save an attachment: 1. Click once on the attachment name. Or, if there are multiple attachments, click the Save icon to save all attachments

Adobe Acrobat Professional X Part 3 - Creating Fillable Forms Preparing the Form Create the form in Word, including underlines, images and any other text you would like showing on the form. Convert the

Email -- Reading and Printing Email Checking for New Email By default, webmail checks for new email automatically. If you want to manually check for new email, click the Check Email button. Or, click the

Logging into the control panel Before any changes can be made to your email system, you must first login to the Plesk control panel. To get access to the control panel login screen, enter http://mymail.bam.com.au

Create, Share and Export a Presentation Portfolio folioci allows you to insert electronic artifacts into an online portfolio, just as you would normally insert paper artifacts into a portfolio. You can

Lime Survey - General outline & guide: This document is to serve as a general outline for the successful creation of a survey using the Lime Survey product. The source of this material: Part of this tutorial

Outlook Plug In User Guide InterCall, in partnership with JCS Technologies, provides an Outlook Plug In that allows you to quickly and easily create, edit and schedule meetings with pre defined information

WhatCounts Newsletter System Manual Last Updated: November 21, 2008 This instruction manual describes the basic steps required to create, edit, and manage a mailing list for use with the WhatCounts Email

Your Personal Homepage You can use your Personal Homepage to share information about yourself, something that interests you, or a course topic. Your classmates can view your home page from the Classlist

Whitepaper Do-It-Yourself Templates Using Your Own Content to Create Message Templates August 4, 2010 Copyright 2010 L-Soft international, Inc. Information in this document is subject to change without

Vodafone Business Product Management Group Hosted Services Announcer Pro V4.6 User Guide Vodafone Group 2010 Other than as permitted by law, no part of this document may be reproduced, adapted, or distributed,

Google Apps for Sharing Folders and Collecting Assignments The Google Drive is cloud (online) storage space, and it is also where you create and work with Google Docs, Sheets, Slides, etc. Create a Folder

Accessing course reports and analysis views What Do You Think? for Instructors Introduction As an instructor, you can use the What Do You Think? Course Evaluation System to see student course evaluation

EMAILING USING HOTMAIL Signing into Your Email Account Open up explorer and type in www.hotmail.com in the address bar. Enter your email address. Hit the tab key on the keyboard and enter your password.

Adding a File Attachment to a CFS Requisition When creating a requisition, there are certain purchases that may require additional documentation. The Attachment feature is used to attach this documentation.

Increasing Productivity and Collaboration with Google Docs charina.ong@nus.edu.sg Table of Contents About the Workshop... i Workshop Objectives... i Session Prerequisites... i Google Apps... 1 Creating

Creating Online Surveys with Qualtrics Survey Tool Copyright 2015, Faculty and Staff Training, West Chester University. A member of the Pennsylvania State System of Higher Education. No portion of this

Sending Email on Blue Hornet STEP 1 Gathering Your Data A. For existing data from Advance or Outlook, pull email address, first name, last name, and any other variable data you would like to use in the

How to Use Swiftpage for SageCRM 1 Table of Contents Basics of the Swiftpage for SageCRM Integration 3 How to Install Swiftpage for SageCRM and Set Up Your Account...4 Accessing Swiftpage s Online Editor

1.5 MONITOR Schools Accountancy Team INTRODUCTION The Monitor software allows an extract showing the current financial position taken from FMS at any time that the user requires. This extract can be saved

THE TOP TEN TIPS FOR USING QUALTRICS AT BYU TIP #1: CREATING A SURVEY FROM A COPY AND COLLABORATING ON SURVEYS TIP #2: CREATING AND USING PANELS TIP #3: LIBRARIES AND HOW TO USE THEM TIP #4: BASIC SKIP

Microsoft SharePoint 2010 End User Quick Reference Card Microsoft SharePoint 2010 brings together the people, documents, information, and ideas of the University into a customizable workspace where everyone

Mail Chimp Basics Mail Chimp is a web-based application that allows you to create newsletters and send them to others via email. While there are higher-level versions of Mail Chimp, the basic application

Oracle Collaboration Suite Using Oracle Web Conferencing Release 2 (9.0.4.2.0) Part No. B12133-02 March 2004 Use this document to learn the basics of Oracle Web Conferencing. It is recommended that conference

dotcms & Accessibility Folders Creating a New Folder Note: All folders showing on menu must have an index page. 1. Right-click the parent folder in which the new folder will reside. 2. Click New > Folder.

Importing Contacts to Outlook 1. The first step is to create a file of your contacts from the National Chapter Database. 2. You create this file under Reporting, Multiple. You will follow steps 1 and 2

Application Version 3.7.5 Confidentiality This document contains confidential material that is proprietary WatchDox. The information and ideas herein may not be disclosed to any unauthorized individuals

Hold the Ctrl key down & then left click on a link below to navigate to it: Table of Contents Overview of the Message Center Message Center Basics Working with the Message Journal Working with Documents

IMTS Exhibitor Passport Getting Started Guide Thank you for your purchase of the IMTS Exhibitor Passport! To help you make the most of your experience, this guide will give you an overview of each section

ProjectWise Explorer V8i User Manual for Subconsultants & Team Members submitted to Michael Baker International Subconsultants & Team Members submitted by Michael Baker International ProjectWise Support