Package com.highdeal.cnd.message

Class RerateSubscriptionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.highdeal.hci.OperationFailureException

com.highdeal.cnd.message.RerateSubscriptionException

All Implemented Interfaces:

OperationResult, XMLMarshallable, Serializable

public class RerateSubscriptionException
extends OperationFailureException

Exception thrown when an error occurs during the execution of a subscription rerating operation in the connected SAP CC system; this exception includes a nested exception that explains the cause.

Note

Consult the SAP CC Application Help for more information about the rerating process in an offline charging scenario.

Reasons

The rerating operation of a subscription in customer master data may fail for several possible reasons.

The nested exception can be:

• ForbiddenChargeException
• TransactionClearingException
• InvalidItemException

Note

Consult the specifications of these exceptions in this Java API Reference documentation. They are detailed in the HCI infrastructure (in the com.highdeal.pnr.hci package) but they are relevant in the Message TCP technical interface.

Exception and Error Handling

Depending on your business requirements design and develop the handling functions in your client application.

For each exception reason, you determine the expected treatments in your charging client.

See Also:

• Serialized Form

XML API for HCI

The XML APIs specify the following XSD fragment:

XSD Fragment

<xs:element name="rerateSubscriptionFault">
   <xs:complexType>
     <xs:sequence>
       <xs:choice>
         <xs:element ref="serverFault" minOccurs="1" maxOccurs="1"/>
       </xs:choice>
     </xs:sequence>
     <xs:attribute name="reratingStatus" type="xs:ReratingStatus" />
     <xs:attribute name="suggestedDate" type="xs:DateTime" />
     <xs:attribute name="snapshotId" type="xs:integer" />
     <xs:attribute name="adaptedFromDate" type="xs:DateTime" />
     <xs:attribute name="previousLockCode" type="xs:String" />
   </xs:complexType>
  </xs:element>

Constructor Summary

Constructors

Constructor	Description
RerateSubscriptionException(OperationFailureException e)	Constructs an exception with a nested exception that represents the cause.
RerateSubscriptionException(ReratingStatus reratingStatus, Date suggestedDate, Date adaptedFromDate, int snapshotId, String previousLockCode)	Constructs an exception with the error details of the failed subscription rerating.

Method Summary

Modifier and Type	Method	Description
void	addCharacterData(String cData)	Adds character data to the content element.
void	addChild(String tagName, XMLMarshallable child)	Adds a child to the object, the child representing the marshallable object which must be added to the element.
Date	getAdaptedFromDate()
OperationFailureException	getException()
String	getPreviousLockCode()
ReratingStatus	getReratingStatus()
int	getSnapshotId()
Date	getSuggestedDate()
void	marshal(XMLOutputter output)	Gives an XML representation of this object, including its children.
void	setAttributes(XMLAttributes atts)	Sets the attributes of the XML representation of the element being processed.

Methods inherited from class com.highdeal.hci.OperationFailureException

getOperandReference

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

RerateSubscriptionException

public RerateSubscriptionException(ReratingStatus reratingStatus,
 Date suggestedDate,
 Date adaptedFromDate,
 int snapshotId,
 String previousLockCode)

Constructs an exception with the error details of the failed subscription rerating.

Parameters:

reratingStatus - The status of the subscription

suggestedDate - The date suggested by the external billing system

adaptedFromDate - The restoration date adapted by the counter restoration

snapshotId - The snapshot ID retrieved by the counter restoration

previousLockCode - The previous lock code

RerateSubscriptionException

public RerateSubscriptionException(OperationFailureException e)

Constructs an exception with a nested exception that represents the cause.

Parameters:

e - The nested exception to add

Method Details

getReratingStatus

public ReratingStatus getReratingStatus()

Returns:

The rerating status

getSuggestedDate

public Date getSuggestedDate()

Returns:

The suggested date

getAdaptedFromDate

public Date getAdaptedFromDate()

Returns:

The adapted from date

getSnapshotId

public int getSnapshotId()

Returns:

The snapshot ID

getPreviousLockCode

public String getPreviousLockCode()

Returns:

The previous lock code

getException

public OperationFailureException getException()

Returns:

The nested OperationFailureException

setAttributes

public void setAttributes(XMLAttributes atts)

Description copied from interface: XMLMarshallable

Sets the attributes of the XML representation of the element being processed.

Parameters:

atts - The XML attributes of the current element

addChild

public void addChild(String tagName,
 XMLMarshallable child)

Description copied from interface: XMLMarshallable

Adds a child to the object, the child representing the marshallable object which must be added to the element.

Parameters:

tagName - The name of tag for the child

child - The child to be added

addCharacterData

public void addCharacterData(String cData)

Description copied from interface: XMLMarshallable

Adds character data to the content element.

Parameters:

cData - The character data to be added

marshal

public void marshal(XMLOutputter output)

Description copied from interface: XMLMarshallable

Gives an XML representation of this object, including its children.

Parameters:

output - The XML output to marshal the object into