Overview
The Survey Status for Targets module lets users configure how the completion status for their targets will be defined using the submission data coming in from SurveyCTO. Configuring this module correctly is critical to ensure that SurveyStream can accurately determine the completion status of the targets for your survey. Each submission in the SurveyCTO main form is expected to have a numericSurvey status variable which indicates the outcome of the survey for that target, such as whether it is completed, refused, not found, etc. This module allows you to map these numeric survey status values to specific labels and flags that will be used for calculating productivity metrics and determining assignment eligibility.
Needed for features
- Productivity Dashboards The list of survey status values and corresponding labels and flags are used for calculating various productivity metrics for the survey.
- Assignments The survey status values are used to determine whether a target is assignable or not. For example, if a target has a submission with completed survey status it will not be assignable to any surveyor.
- Emails When emails containing assignments are sent to surveyors, the survey status is used to filter and send only pending target information.
-
Data Quality Dashboards
SurveyStream provides an option to filter data based on
survey statusbefore applying checks. This can be used to run checks only on completed and partially completed submissions. To apply this filter, you need to configure the required survey status values in this module.
Prerequisites
-
Configure the main form on SurveyStream
Complete the SurveyCTO Integration step on SurveyStream as survey status values are defined for a main form.
Ensure the form has a numeric variable for
Survey statusthat captures the outcome of the target interaction. The variable in your SurveyCTO form definition should be ofselecttype with a predefined list of survey status values to choose from.
Configuration
Process
For surveys with survey modalityphone and in-person, the module preloads a list of default survey status values. You can edit the list, add and remove survey status values as per your requirements.
For surveys with survey modality mixed mode, there is no default list and you will need to populate the statuses manually.
Add a survey status

Add button. This will open a pop-up where you can enter the following details:
Edit a survey status
To edit a survey status, select the survey status from the list and click on theEdit button. This will open a pop-up where you can edit all fields except Survey status.
Delete a survey status
Select one or more survey status values from the list and click on theDelete button. This will remove the survey status values from the list.
Additional notes
Default survey status values
-
For surveys with
in-personsurvey modality: -
For surveys with
phonesurvey modality: