Version Notice: This article covers features in our r9/IS Pro platform. If you're looking for information on this topic related to r8, see Panel administration.
Programmers can add panels with SPL (survey programming language) by adding the use panels
, auto redirect
, and panel sheet
tags to the app config
widget in the survey source code.
define sheet: system.system_panels translate: n app config auto redirect: system.system_panels panel sheet: system.system_panels use panels: 2,100,991
Details
- The
auto redirect
andpanel sheet
tags should reference the system panel sheet 'system_panels' or a local panel survey sheet. - The
use panels
tag specifies a list of panel numbers to be used in the survey. These panel numbers are found in the id column in your panel sheet. - To prevent the sheet being translated, use the
define sheet
tag to reference the panel sheet. Then, applytranslate: n
.
For additional assistance, reach out to Support.
Note: If panels are added with use panels
in SPL, the Panels applet will be disabled.
Creating a local panel sheet
Although adding panels via SPL is always an option, we highly recommend using the Panels applet for adding and managing all existing panels.
If you need to add a new panel or edit an existing panel beyond what the Panels applet can offer, you need to create a local panel sheet. Please download the latest version of the system panel sheet from your server to use as a template.
- If you are updating an existing panel, use the same row in the Excel file and make adjustments to the data as needed.
- If you are adding a new panel. Assign it a unique ID that is not being used by another panel in the sheet. Enter the information required for each column.
- Upload the sheet to the survey's Sheets applet.
- Add the code below to the top of the survey source, replacing 'surveyid' and 'panelsheetname' with your survey's ID and and the name of your newly uploaded sheet.
- List the panels your survey will use at the
use panels
tag, separated by a comma. - Publish the survey.
define sheet: surveyid.panelsheetname translate: n
app config auto redirect: surveyid.panelsheetname panel sheet: surveyid.panelsheetname use panels: 2,40,256
Masking panel names
It's common to "mask" panel names so that clients and panel partners cannot see all of the panel organizations involved in the online study. Panel names are visible in the Quota Manager and in all of the reporting applets and exports. Therefore, we highly recommend masking all panels that are involved in the study in your local panel sheet.
Locate the text and panel columns in the sheet and replace the text in these columns with something vague, lacking any identifiable information. See an example below.
Update all relevant panels. Then, return to step 3 above to upload the local panel sheet in the Sheets applet.
Comments
0 comments
Please sign in to leave a comment.