Class FinTransmogrifier

Namespace
Subsembly.FinTS
Assembly
Subsembly.FinTS.Core.dll

The FinTransmogrifier transmogrifies FinTS segments to and from an arbitrary XML representation.

public class FinTransmogrifier
Inheritance
FinTransmogrifier
Inherited Members

Remarks

The FinTransmogrifier implementation is multi-thread safe. That means, that a single FinTransmogrifier instance can transmogrify any number of segments simuiltaneously on multiple threads.

See the FinTS Subsembly Technical Documentation for a detailed explanation of the mode of operation of the FinTransmogrifier class.

Constructors

FinTransmogrifier(string)

Creates a FinTransmogrifier instance for a specific type of segments.

public FinTransmogrifier(string sSyntax)

Parameters

sSyntax string

Syntax description that defines the XML format and its corresponding segment. Must not be null. Refer to the FinTS Subsembly Technical Documentation for a detailed description of the expected syntax description XML.

Exceptions

ArgumentNullException

The sSyntax parameter was null.

FinTransmogrifierException

The provided syntax description XML was not according to the requirements. The exception code will be BadSyntax.

FinTransmogrifier(XmlElement)

Creates a FinTransmogrifier instance for a specific type of segments.

public FinTransmogrifier(XmlElement xmlSyntax)

Parameters

xmlSyntax XmlElement

Syntax description that defines the XML format and its corresponding segment. Must not be null. Refer to the FinTS Subsembly Technical Documentation for a detailed description of the expected syntax description XML.

Exceptions

ArgumentNullException

The xmlSyntax parameter was null.

FinTransmogrifierException

The provided syntax description XML was not according to the requirements. The exception code will be BadSyntax.

Properties

ChallengeClass

The Smart-TAN challenge class for the order type handled by this FinTransmogrifier instance.

public int ChallengeClass { get; }

Property Value

int

Remarks

The default for this value is 90. It can be set through the attribute "c" on the root element of the segment syntax description.

ChallengeParameter

The Smart-TAN challenge parameter that was extracted by the last Transmogrify(XmlElement) operation.

public string ChallengeParameter { get; }

Property Value

string

Remarks

The default for this value is null. The challenge parameter can be selected in the syntax through the attribute "p=1" on the de-element.

SegmentTag

The XML tag of the segment type handled by this FinTransmogrifier instance.

public string SegmentTag { get; }

Property Value

string

SegmentType

The segment type handled by this FinTransmogrifier instance.

public string SegmentType { get; }

Property Value

string

SegmentVersion

The segment version handled by this FinTransmogrifier instance.

public int SegmentVersion { get; }

Property Value

int

Syntax

The syntax description that was passed to the constructor.

public XmlElement Syntax { get; }

Property Value

XmlElement

VisualizationClass

The visualization class required by HKTAN version 5.

public int VisualizationClass { get; }

Property Value

int

Remarks

The default for this value is 0. It can be set through the attribute "z" on the root element of the segment syntax description.

Methods

Transmogrify(FinSegment)

Transmogrify a FinSegment instance into XML data.

public XmlDocument Transmogrify(FinSegment aSegment)

Parameters

aSegment FinSegment

A segment according to the syntax defined for this FinTransmogrifier instance.

Returns

XmlDocument

The transmogrified XML data is returned as a new XmlDocument instance.

Remarks

See the FinTS Subsembly Technical Documentation for a detailed explanation of the mode of operation of this method.

Exceptions

ArgumentNullException

The parameter aSegment was null.

FinTransmogrifierException

Transmogrifier failed.

Transmogrify(FinSegment, XmlNode)

Transmogrify a FinSegment instance into XML data below a given parent node.

public void Transmogrify(FinSegment aSegment, XmlNode xmlParentNode)

Parameters

aSegment FinSegment

A segment according to the syntax defined for this FinTransmogrifier instance.

xmlParentNode XmlNode

Parent node that shall receive the transmogrified segment data nodes.

Remarks

See the FinTS Subsembly Technical Documentation for a detailed explanation of the mode of operation of this method.

Exceptions

ArgumentNullException

The parameter aSegment or xmlParentNode was null.

FinTransmogrifierException

Transmogrifier failed.

Transmogrify(XmlElement)

Transmogrify XML data into a new FinSegment instance according to the syntax defined for this FinTransmogrifier instance.

public FinSegment Transmogrify(XmlElement xmlOrder)

Parameters

xmlOrder XmlElement

An XML element that is structured according to the segment syntax of this FinTransmogrifier instance.

Returns

FinSegment

A new FinSegment instance completely filled with the data from the given XML element. The segment header contains no segment number so far.

Remarks

See the FinTS Subsembly Technical Documentation for a detailed explanation of the mode of operation of this method.

Exceptions

ArgumentNullException

The parameter xmlOrder was null.

FinTransmogrifierException

Transmogrifier failed.