AuthenticatorFlowElement

Require respondents to authenticate (login)

Typestringrequired

Possible values: [Authenticator]

FlowIDFlow Id (string)

Unique identifier. Should be of form FL_1

Possible values: Value must match regular expression ^FL_[1-9][0-9]*$

PanelData objectrequired

LibraryIDUser Id (string)

The unique identifier for a specific user.

Possible values: Value must match regular expression ^UR_[a-zA-Z0-9]{11,15}$

PanelIDPanel Id (string)

The unique identifier for the Panel.

Possible values: Value must match regular expression ^CG_[a-zA-Z0-9]{11,15}$

Typestring

Type of SSO option.

Possible values: [Expression]

LogicTypestring

Logic type.

Possible values: [Panel]

property name*any

FieldData objectrequired

Send respondents down different paths in the survey. See Qualtics Documentation for more information on Branch Logic

Typestringrequired

Type of branch logic.

Possible values: [BooleanExpression]

property name* object

oneOf

• QuestionExpression
• EmbeddedDataExpression
• DeviceTypeExpression
• QuotaExpression
• GeoIPExpression
• EvaluatorMetadataExpression
• PanelDataExpression
• LoopAndMergeExpression
• RelationshipExpression
• SubjectMetadataExpression
• OrgHierarchyUnitsExpression
• OrgHierarchyMetadataExpression

ChoiceLocator objectrequired

Locator.

anyOf

• Classic locator, begins with two alpha characters followed by a | and any combination of alpha and | characaters
• Current url locator regex pattern, matching entire string
• Current url locator regex pattern, matching the entire string, allow no white space, this should mirror the above* regex but allow no white space

LogicTypestringrequired

The logic type of a question expression.

Possible values: [Question]

Operatorstringrequired

Operator.

Possible values: [Selected, NotSelected, EqualTo, NotEqualTo, Empty, NotEmpty, Displayed, NotDisplayed, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, Contains, DoesNotContain, MatchesRegex, IsNot, Uploaded, NotUploaded, PDF, Document, ClickedIn, NotClickedIn, Extensions, Graphic, Spreadsheet]

QuestionIDQuestion Id (string)required

The unique identifier for the question.

Possible values: Value must match regular expression ^QID[a-zA-Z0-9]+$

QuestionIsInLoopstringrequired

If yes, question is in loop.

Possible values: [yes, no]

Typestringrequired

The type of question expression.

Possible values: [Expression]

FilterDataFieldsbooleanrequired

If true, filter data fields.

SSOOptions objectrequired

SSO options.

CaptureRespondentInfostring

Capture respondent info.

Possible values: [Yes, No]

casstring[]

Central Authentication Service.

ldap object

Lightweight Directory Access Protocol

Hostnamestring

Hostname.

Possible values: <= 100 characters

Portstring

Port.

Possible values: <= 100 characters

EmailFieldstring

Email field.

Possible values: <= 100 characters

ExternalDataReferenceFieldstring

External data reference field.

Possible values: <= 100 characters

Filterstring

Filter.

Possible values: <= 100 characters

FirstNameFieldstring

Field for first name.

Possible values: <= 100 characters

LastNameFieldstring

Field for last name.

Possible values: <= 100 characters

property name*any

Lightweight Directory Access Protocol

respondentMap object[]

Respondent map.

Possible values: <= 100

Array [

keystring

A unique identifier for a value.

valuestring

An attribute associated with key.

property name*any

Object.

]

token object

Token.

EncryptionMethodstring

Encryption method for the token.

Possible values: [3DES, AES128, BLOWFISH]

Keystring

Token key.

Leewayinteger

Leeway.

MacMethodstring

MacMethod.

Possible values: [md5, MD5, sha1, sha256, sha512]

BlockCipherstring

Block Cipher.

Possible values: [CBC, ECB]

property name*any

Token.

Typestringrequired

SSO option type.

Possible values: [Token, CAS, LDAP, LTI, Shibboleth, UseBrandSettings, GoogleOpenID, Facebook]

UsePanelstring

Use Panel.

Possible values: [Yes, No]

UsePersonstring

Use person.

Possible values: [Yes, No]

UseSSOstring

Use SSO.

Possible values: [Yes, No]

property name*any

SSO options.

Options objectrequired

SSO options.

maxAttemptsinteger

Maximum number of attempts allowed.

authenticationError object

Authenticator message.

SystemMessage object

System message.

Sectionstring

Section of system message.

Possible values: [ErrorCodes]

Messagestring

System message.

Possible values: Value must match regular expression ^EAUTH\d+$

property name*any

System message.

property name*any

Authenticator message.

failedAuthenticationError object

Authenticator message.

SystemMessage object

System message.

Sectionstring

Section of system message.

Possible values: [ErrorCodes]

Messagestring

System message.

Possible values: Value must match regular expression ^EAUTH\d+$

property name*any

System message.

property name*any

Authenticator message.

questionText object

Authenticator message.

SystemMessage object

System message.

Sectionstring

Section of system message.

Possible values: [ErrorCodes]

Messagestring

System message.

Possible values: Value must match regular expression ^EAUTH\d+$

property name*any

System message.

property name*any

Authenticator message.

allowRetakeboolean

If true, allow retake.

loadExistingSessionboolean

If true, load existing session.

property name*any

SSO options.

Flow object[]

Definition of the inner flow elements (maximum of 5000)

Array [

anyOf

• Option 1
• BlockStandardFlowElement
• BlockRandomizerFlowElement
• BranchFlowElement
• EmbeddedDataFlowElement
• EndSurveyFlowElement
• GroupFlowElement
• ReferenceSurveyFlowElement
• TableOfContentsFlowElement
• WebServiceFlowElement

]

property name*any

Require respondents to authenticate (login)

AuthenticatorFlowElement

{
  "Type": "Authenticator",
  "FlowID": "string",
  "PanelData": {
    "LibraryID": "string",
    "PanelID": "string",
    "Type": "Expression",
    "LogicType": "Panel"
  },
  "FieldData": {
    "Type": "BooleanExpression"
  },
  "FilterDataFields": true,
  "SSOOptions": {
    "CaptureRespondentInfo": "Yes",
    "cas": [
      "string"
    ],
    "ldap": {
      "Hostname": "string",
      "Port": "string",
      "EmailField": "string",
      "ExternalDataReferenceField": "string",
      "Filter": "string",
      "FirstNameField": "string",
      "LastNameField": "string"
    },
    "respondentMap": [
      {
        "key": "string",
        "value": "string"
      }
    ],
    "token": {
      "EncryptionMethod": "3DES",
      "Key": "string",
      "Leeway": 0,
      "MacMethod": "md5",
      "BlockCipher": "CBC"
    },
    "Type": "Token",
    "UsePanel": "Yes",
    "UsePerson": "Yes",
    "UseSSO": "Yes"
  },
  "Options": {
    "maxAttempts": 0,
    "authenticationError": {
      "SystemMessage": {
        "Section": "ErrorCodes",
        "Message": "string"
      }
    },
    "failedAuthenticationError": {
      "SystemMessage": {
        "Section": "ErrorCodes",
        "Message": "string"
      }
    },
    "questionText": {
      "SystemMessage": {
        "Section": "ErrorCodes",
        "Message": "string"
      }
    },
    "allowRetake": true,
    "loadExistingSession": true
  },
  "Flow": [
    null,
    {
      "ID": "string",
      "Type": "Block",
      "FlowID": "string"
    },
    {
      "Type": "BlockRandomizer",
      "FlowID": "string",
      "SubSet": 0,
      "EvenPresentation": true
    },
    {
      "Type": "Branch",
      "FlowID": "string",
      "Description": "string",
      "BranchLogic": {
        "Type": "BooleanExpression"
      }
    },
    {
      "Type": "EmbeddedData",
      "FlowID": "string",
      "EmbeddedData": [
        {
          "Description": "string",
          "Type": "Recipient",
          "Field": "string",
          "VariableType": "Nominal",
          "DataVisibility": {
            "Private": true,
            "Hidden": true
          },
          "AnalyzeText": true,
          "Value": "string"
        }
      ]
    },
    {
      "Type": "EndSurvey",
      "FlowID": "string"
    },
    {
      "Type": "Group",
      "FlowID": "string",
      "Description": "string"
    },
    {
      "Type": "ReferenceSurvey",
      "ID": "string",
      "FlowID": "string",
      "Description": "string",
      "LibraryID": "string"
    },
    {
      "Type": "TableOfContents",
      "FlowID": "string",
      "Description": "string",
      "Options": {
        "ShowSidebar": "Yes",
        "TocConclusion": "Yes"
      }
    },
    {
      "Type": "WebService",
      "FlowID": "string",
      "URL": "string",
      "Method": "GET",
      "RequestParams": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "EditBodyParams": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "Body": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "ContentType": "application/x-www-form-urlencoded",
      "Headers": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "ResponseMap": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "FireAndForget": true,
      "StringifyValues": true
    }
  ]
}