Roster Question Types

There are 6 Roster question types. They are based on actions performed on a roster. The 6 question types are:

Roster Add Line	add a line to a roster
Roster Delete Line	delete a line from a roster
Roster Edit Line	modify fields in a roster line
Roster Pick All Entry	pick multiple roster lines
Roster Pick One Entry	pick one roster line
Roster Present Only	display the roster, no editing

After selecting one of these question types, the roster to use for this action is selected from the list of existing/new rosters.

Add New Roster

In the answer data, the question name generated for each of the five roster variables has the form 'RosterName_FieldName'. For example HOUSEHOLD_NAME, HOUSEHOLD_AGE, etc. A minimal documentation record is provided by the CAPI Designer.

Once the question type and roster have been selected, the CAPI Designer provides additional fields that govern the display of a roster in the survey. These roster-component fields include text for the roster heading, which roster fields to display (Show checkbox), which to ask/alter (Ask checkbox), roster field sequence (top-to-bottom = left-to-right), and text for the column headers (Field Names). The Ask checkbox appears in the Roster Edit and Roster Add question types only. These are outlined in examples below.

Continuing with our HOUSEHOLD example:

The structure of the HOUSEHOLD Roster would look like the following:

	Roster name is HOUSEHOLD.
	HOUSEHOLD is composed of 5 roster field names (in caps) with text headings (in parentheses)
	that will appear in the survey if the Show field is checked:  
		NAME ("Name");
		AGE ("Age");
		GENDER ("Sex");
		MAR_STAT ("Marital Status");
		HGC ("Highest Grade").

If the designer wants the interviewer select a line in a roster, and only two fields in the line need to be displayed, the designer would use a Roster Pick One Entry question type and the question would be entered as:

	Qname:	SEC5_HH_PICK1 (arbitrary);
	Qtype:	Roster Pick One Entry;
		Qtext: "Please click on the line with the person's name you are interviewing.";
		Rostername: HOUSEHOLD;
		Show checkboxes checked: NAME, MAR_STAT.

After the interviewer highlights the row and presses return, the designer would then begin a series of questions about that line (name, maritial status). Internally, the line number of the row 'picked' is used, for example, to substitute a name in the next question's text or to perform an internal function. Likewise, any field in an existing roster may be used as a symbol in any question.

If we want to 'add a line to a roster' and fill in three of the roster fields, the designer would use a Roster Add Line question type and the question would be entered as:

	Qname:	SEC5_HH_ADD1 (arbitrary);
	Qtype:	Roster Add Line;
		Qtext: INTERVIEWER.  ADD ANY ADDITIONAL HH MEMBERS TO THE ROSTER;
		Rostername: HOUSEHOLD;
		Ask checkboxes checked: NAME, AGE, GENDER.

In the above question type, Roster Add Line, the three roster fields to be filled-in (Ask checkbox) will appear on a single CAPI screen. In the Design phase but for future documentation purposes, because there are three fields, they are entered as three separate questions. The question text, question type, allowable min/max, and other fields in each of the three roster questions above will be used to document each question. When the interviewer advances to the next display, these data will be added to the roster.

If the designer wants to simply the interviewer and respondent to view a roster', i.e., display it on-screen with all columns, the designer would chose the Roster Present Only question type and the question would be entered as:

	Qname:	SE5_HH_PRESENT (arbitrary);
	Qtype:	Roster Present Only;
		Qtext: Current Household Roster;
		Rostername: HOUSEHOLD;
		SHOW checkboxes checked: NAME, AGE, GENDER, MAR_STAT,HGC.

If a line needs to be deleted from a roster, the designer would chose the Roster Delete Line question type and the question would be entered as:

	Qname:	SE5_HH_DELETE (arbitrary);
	Qtype:	Roster Delete Line;
		Qtext: Current Household Roster;
		Rostername: HOUSEHOLD;
		Show checkboxes checked: NAME, AGE, GENDER, MAR_STAT, HGC.

If a line in a roster needs to be edited, specific fields may be isolated for editing. Use the 'Show' and 'Ask' fields to control which fields are displayed and which are 'prompted' (Ask) for editing. For example, if it is necessary to update information on the education of household members, the question mught look like:

	Qname:	SE5_HH_EDIT (arbitrary);
	Qtype:	Roster Edit Line;
		Qtext: Current Household Roster;
		Rostername: HOUSEHOLD;
		Show checkboxes checked: NAME, AGE, GENDER, MAR_STAT, HGC;
		Ask checkboxes checked:  NAME, HGC.

Finally, if the designer wants the interviewer to pick multiple line and then design a loop through those lines gathering or updating information about some data in them, the designer would chose the Roster Pick All question type, and the question setup might look like:

	Qname:	SEC5_HH_PICK_ALL (arbitrary);
	Qtype:	Roster Pick ALL Entry;
		Qtext: "Please click on the lines that contain the names of household members who 
		have permanently moved out of the home.";
		Rostername: HOUSEHOLD
		Show checkboxes checked: NAME.