IMPORTANT: Questionmark recommendeds using the Delivery Odata API (click here for documentation) for new integrations, not the QMWISe API. Although we currently continue to issue maintenance updates to this API to support customers with current QMWISe-based integrations, we are no longer adding new methods/functionality to QMWISe. 

CreateQuestionResultInfoList2

Applies to the following products: 
Questionmark OnDemand
Questionmark Perception
Applies to the following Perception versions: 
Perception 5.7

This method creates one or more questions from a list of question information supplied. If a question ID that is included in the information does not exist in the repository, a new question is not created.

The number of new questions created is returned. If a new question is created, then both a new A_Question record and its corresponding A_Outcome record will be created in the repository database.

The only information that must be provided for each new question is:

  • The question's unique question ID
  • The question's description
  • The question type for the question
  • The name of the topic or subtopic to which the question belongs
  • The number of distinct outcomes the question has
  • For each outcome:
    • The outcome number
    • The outcome name

New properties added to this method are:

  • Base
  • Language

A SOAP fault will be returned if a database error occurs at any point during processing the list.

Available in:
  • Version 5.2 +

Parameters

Input name     Description Data type Optional field?

QuestionResultInfo

(may appear several times)

 

 

 

 

 

 

Question_ID

 

The unique question ID for a new question

String

N

 

Revision

 

The current revision for a new question (defaults to 1 if not set)

Integer

Y

 

Question_Description

 

The description of a new question

String

N

 

Question_Type

 

The question type for a new question, as used in its QML

String

N

 

Topic_Name

 

The full name of the topic or subtopic to which the new question will belong

String

N

 

Number_Outcomes

 

The number of distinct outcomes that a new question will have, and can have a value in the range 1 to 65 (values greater than 32 are be written to the field A_Answer.Outcome_Exponential_2

Short

N

 

Question_Wording

 

The full wording for a new question (defaults to blank if not set)

String

Y

 

OutcomeList

 

 

 

 

 

 

Outcome_Number

The number assigned to an outcome within a new question

Short

N

 

 

Outcome_Name

The name of an outcome within a new question

String

N

 

 

Feedback

The feedback for an outcome within a new question

String

Y

 

Last_Updated

 

The date when a new question was last updated (defaults to the current date if not set)

String

Y

 

Base

 

Identifies if the language is the base language of the question

Boolean

Y

 

Language

 

Identifies the language of the question

String

Y

Response

Output name Description Data type

NumberRecordsCreated

The number of new questions created

Integer

Troubleshooting

Please refer to the following page for any error codes that are displayed when using this method.

Appendix - Error codes