Entity References Summary
post
https://server:port/spl/rest/apis/customer/v-model/entityReferences/hierarchyInfo
This service provides summary information for a selected list of entities along with their hierarchical information for presentation purposes.
Request
There are no request parameters for this operation.
Supported Media Types
- application/xml
- application/json
Root Schema : schema
Type:
Show Source
object
-
personId: string
Maximum Length:
10
Sets an optional scope for the referenced entities as associated with a specific person record. -
referenceEntities: array
referenceEntities
Nested Schema : items
Type:
Show Source
object
-
entityId: string
Maximum Length:
60
Entity ID 1 -
entityName: string
Allowed Values:
[ "ACC ", "BILL", "DEV ", "PREM", "PYMT", "SP " ]
Entity Hierarchy: * `ACC ` - Account, * `BILL` - Bill, * `DEV ` - Device, * `PREM` - Premise, * `PYMT` - Payment, * `SP ` - Service Point
Root Schema : schema
Type:
Show Source
object
-
personId: string
Maximum Length:
10
Sets an optional scope for the referenced entities as associated with a specific person record. -
referenceEntities: array
referenceEntities
Nested Schema : items
Type:
Show Source
object
-
entityId: string
Maximum Length:
60
Entity ID 1 -
entityName: string
Allowed Values:
[ "ACC ", "BILL", "DEV ", "PREM", "PYMT", "SP " ]
Entity Hierarchy: * `ACC ` - Account, * `BILL` - Bill, * `DEV ` - Device, * `PREM` - Premise, * `PYMT` - Payment, * `SP ` - Service Point
Response
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Nested Schema : items
Type:
Show Source
object
-
description: string
Maximum Length:
60
Description -
entityId: string
Maximum Length:
60
Entity ID 1 -
entityName: string
Allowed Values:
[ "ACC ", "BILL", "DEV ", "PREM", "PYMT", "SP " ]
Entity Hierarchy: * `ACC ` - Account, * `BILL` - Bill, * `DEV ` - Device, * `PREM` - Premise, * `PYMT` - Payment, * `SP ` - Service Point -
hierarchyLevel: number
Minimum Value:
0
Maximum Value:9.99999999999999E8
Represents the entity's relative hierarchical position in relationship to other referenced entities. This information, along with each entity's reference to its immediate parent entity, may be used to present the entities in a hierarchical view. The lowest value represents the root level of the hierarchy. -
parentEntityId: string
Maximum Length:
60
Entity ID 1 -
parentEntityName: string
Allowed Values:
[ "ACC ", "BILL", "DEV ", "PREM", "PYMT", "SP " ]
Entity Hierarchy: * `ACC ` - Account, * `BILL` - Bill, * `DEV ` - Device, * `PREM` - Premise, * `PYMT` - Payment, * `SP ` - Service Point -
primary: string
Maximum Length:
1000
Info -
referenceName: string
Maximum Length:
60
An optional alternate name for the referenced entity. For an account, this is the Account Name characteristic. -
restricted: boolean
Indicates whether the user's access to the associated account is restricted or not. Minimal information is provided for restricted accounts.
-
secondary: string
Maximum Length:
1000
Info -
tertiary: string
Maximum Length:
1000
Info
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.