update_question: Update attributes of a question

In sumtxt/qsf: Qualtrics Survey File (QSF) Editing and Construction in R

Description

Versatile function to change the behavior of a question and the survey.

Usage

update_question(qsf, id_name, id, ...)

Arguments

qsf	qsf file as R list
id_name	which question ID to use: "PrimaryAttribute" or "SecondaryAttribute"?
id	Value of id_name.
...	key-value tuples (see details)

Details

The list below catalogs some of common keys that control the behavior of a question. The function accepts all key-value tuples.

• Validation: A list controlling the validation. Use construct_validation() to construct.

• DisplayLogic : A list controlling the display logic. Use construct_displaylogic() to construct.

• DataExportTag : A string without whitespace.

• QuestionJS : A string with JavaScript code attached to the question.

• Selector and SubSelector:

  Selector	SubSelector	Choice display
  MAVR	'TX'	Multiple choice
  SAVR	'TX'	Single choice
  DL		Dropdown
  SB		Select box
  MSB		Multi select box

Examples

data(svy_qsf)

# Change data export tag 
qsf <- update_question(qsf, 
	id_name='SecondaryAttribute', 
	id='sex', 
	DataExportTag='gender')

# Convert to multiple choice 
qsf <- update_question(qsf, 
	id_name='SecondaryAttribute', 
	id='sex', 
	Selector='MAVR',
	SubSelector='TX')

# Forced choice for both questions 
qsf_mod <- update_question(svy_qsf, 
 id_name='SecondaryAttribute', 
 id=c('sex', 'born'), 
 Validation=construct_validation(type='force'))

sumtxt/qsf documentation built on Nov. 22, 2021, 9:31 p.m.