Service Questions
post
https://server:port/spl/rest/apis/customer/service/startStopTransferTasks/serviceQuestions
This operation uses the Read Questions algorithm on the CS request type BO to retrieve the applicable service questions when starting new service, adding service, stopping service, or transferring service. The SP-based services to start at a premise and/or the SP-based services to stop for an account should be determined, and a pending self-service start/stop/transfer task already exist before this operation can be used.
Request
There are no request parameters for this operation.
Supported Media Types
- application/xml
- application/json
Root Schema : schema
Type:
Show Source
object
-
accountId: string
Maximum Length:
10
Account ID -
premiseId: string
Maximum Length:
10
Premise ID -
premises: object
premises
-
questionPlacementGroup: string
Allowed Values:
[ "C1-SelfServiceStartService", "C1-SelfServiceStopService" ]
Question Placement Group is used to logically group questions, based on where the questions are shown on the user interface. * `C1-SelfServiceStartService` - Self-Service - Start Service, * `C1-SelfServiceStopService` - Self-Service - Stop ServiceExample:C1-SelfServiceStartService
-
servicePoints: object
servicePoints
-
serviceTaskId: string
Maximum Length:
14
Self-Service Task ID is the system-assigned unique identifier of the self-service task.Example:69216126491457
Root Schema : schema
Type:
Show Source
object
-
accountId: string
Maximum Length:
10
Account ID -
premiseId: string
Maximum Length:
10
Premise ID -
premises: object
premises
-
questionPlacementGroup: string
Allowed Values:
[ "C1-SelfServiceStartService", "C1-SelfServiceStopService" ]
Question Placement Group is used to logically group questions, based on where the questions are shown on the user interface. * `C1-SelfServiceStartService` - Self-Service - Start Service, * `C1-SelfServiceStopService` - Self-Service - Stop ServiceExample:C1-SelfServiceStartService
-
servicePoints: object
servicePoints
-
serviceTaskId: string
Maximum Length:
14
Self-Service Task ID is the system-assigned unique identifier of the self-service task.Example:69216126491457
Response
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Nested Schema : items
Type:
Show Source
object
-
answerStyle: string
Allowed Values:
[ "CHBX", "CHTY", "DATE", "DTTM", "RBTN", "TEXT" ]
Answer Style defines the response's data type and controls how the valid answer(s) are rendered on the user interface. * `CHBX` - Checkbox, * `CHTY` - Predefined Characteristic Type, * `DATE` - Date, * `DTTM` - Date/Time, * `RBTN` - Radio Button, * `TEXT` - Text InputExample:CHTY
-
defaultAnswer: string
Maximum Length:
254
Default answer to the question. It is either one of the valid answers or freeform text.Example:OWN
-
level: number
Minimum Value:
0
Maximum Value:99999
Level Number indicates where a particular question is in the overall hierarchical structure. For DSS, there is a need to identify the 'top-level' instructions.Example:3
-
parentSequence: number
Minimum Value:
-999
Maximum Value:999
Parent Sequence is populated on related questions. 'Top-level' questions would not reference a parent.Example:3
-
promptText: string
Maximum Length:
4000
Detailed Description -
question: string
Maximum Length:
30
Customer Question is used to capture specific information related to a request.Example:SST-OWNPROP
-
questionApplicability: string
Allowed Values:
[ "C1OP", "C1RQ" ]
Question Applicability: * `C1OP` - Optional, * `C1RQ` - Required - relatedObjects: object relatedObjects
- relatedQuestions: object relatedQuestions
-
sequence: number
Minimum Value:
-999
Maximum Value:999
Sequence -
sortSequence: number
Minimum Value:
-99999
Maximum Value:99999
Sequence -
validAnswers: object
validAnswers
Nested Schema : items
Type:
Show Source
object
-
answer: string
Maximum Length:
30
Answer is the unique identifier across the customer question's valid answersExample:OWN
-
description: string
Maximum Length:
4000
Detailed Description -
sequence: number
Minimum Value:
-999
Maximum Value:999
Sequence
400 Response
Bad Request
Root Schema : problemDetailDocument
Type:
Show Source
object
-
detail: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0
Maximum Value:9999
The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60
Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction. -
problemType: string
Maximum Length:
60
URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework. -
serverMessage: object
serverMessage
-
stackTrace: string
Maximum Length:
60
The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object
-
callSequence: string
Maximum Length:
60
Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0
Maximum Value:0
Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999
Maximum Value:99999
Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60
Name of the program that encountered the error.
500 Response
Internal Server Error
Root Schema : problemDetailDocument
Type:
Show Source
object
-
detail: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0
Maximum Value:9999
The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60
Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction. -
problemType: string
Maximum Length:
60
URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework. -
serverMessage: object
serverMessage
-
stackTrace: string
Maximum Length:
60
The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object
-
callSequence: string
Maximum Length:
60
Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0
Maximum Value:0
Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999
Maximum Value:99999
Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60
Name of the program that encountered the error.