5 Mapping

32.3673GPPEntry Point (EP) Integration Reference Point (IRP)SOAP Solution Set (SS)Telecommunication managementTS

5.1 Operation and notification mapping

The Entry Point IRP IS (3GPP TS 32.362 [4]) defines the operations and their semantics.

Table 5.1 maps the operations defined in the Entry Point IRP IS to their equivalent types, messages, port type operation, and binding operation in this Solution Set (SS).

Table 5.1 also maps the notifications of the Entry Point IRP IS, as well as inherited operations.

Table 5.1 also qualifies if an operation is Mandatory (M) or Optional (O).

Table 5.1: Mapping from IS Operation to SS Equivalents

IS Operation in 3GPP TS 32.362 [4]

SS: Operation for WSDL port type and WSDL binding

SS: Port of EntryPointIRPService

Qualifier

getIRPOutline

getIRPOutline (note 1)

EntryPointIRPPort

M

getIRPReference

getIRPReference (note 1)

EntryPointIRPPort

M

releaseIRPReference

releaseIRPReference (note 1)

EntryPointIRPPort

M

notifyIRPInfoChanges

notify (note 2)

NotificationIRPNtfPort

M

getIRPVersion (note 3)

See TS 32.317 [8]

GenericIRPPort

M

getOperationProfile (note 3)

See TS 32.317 [8]

GenericIRPPort

O

getNotificationProfile (note 3)

See TS 32.317 [8]

GenericIRPPort

O

NOTE 1: The operation is under the port type entryPointIRPSystem:EntryPointIRPPortType and under the binding entryPointIRPSystem:EntryPointIRPBinding.

NOTE 2: The IS equivalent maps to an XML definition specified in 3GPP TS 32.365 [5], and this being an input parameter to the operation notify under the port type ntfIRPNtfSystem:NotificationIRPNtf and under the binding ntfIRPNtfSystem:NotificationIRPNtf of 3GPP TS 32.307 [10]. This binding is linked to a port of the EntryPointIRPService as indicated in the table above.

NOTE 3: The IS operation is inherited from the ManagedGenericIRP IOC specified in 3GPP TS 32.312 [7].
This inheritance is by the EPIRP IOC of 3GPP TS 32.362 [4] inheriting from the ManagedGenericIRP IOC. The corresponding binding is linked to a port of the EntryPointIRPService as indicated in the table above.

5.2 Operation parameter mapping

The Entry Point IRP IS (3GPP TS 32.362 [4]) defines semantics of parameters carried in the operations. The tables below show the mapping of these parameters, as per operation, to their equivalents defined in this SS.

5.2.1 Operation getIRPOutline

5.2.1.1 Input parameters

Table 5.2.1.1: Mapping from IS getIRPOutline input parameters to SS equivalents

IS Operation parameter

SS WSDL type sub-element

used in corresponding input message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

iRPVersion

iRPVersion

M

5.2.1.2 Output parameters

Table 5.2.1.2: Mapping from IS getIRPOutline output parameters to SS equivalents

IS Operation parameter

SS WSDL type sub-element

used in corresponding output message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

supportedIRPList

supportedIRPList

M

status

status

M

5.2.1.3 Fault definition

Table 5.2.1.3: Mapping from IS getIRPOutline exceptions to SS equivalents

Assertion name

SS WSDL type enumeration value

used in corresponding fault message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

invalidIRPVersion

InvalidIRPVersion

M

operationFailed

OperationFailed

M

5.2.2 Operation getIRPReference

5.2.1.1 Input parameters

Table 5.2.1.1: Mapping from IS getIRPReference input parameters to SS equivalents

IS Operation parameter

SS WSDL type sub-element

used in corresponding input message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

managerIdentifier

managerIdentifier

M

systemDN

systemDN

M

rDN

rDN

M

5.2.1.2 Output parameters

Table 5.2.1.2: Mapping from IS getIRPReference output parameters to SS equivalents

IS Operation parameter

SS WSDL type sub-element

used in corresponding output message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

iRPReference

iRPReference

M

status

status

M

5.2.1.3 Fault definition

Table 5.2.1.3: Mapping from IS getIRPReference exceptions to SS equivalents

Assertion name

SS WSDL type enumeration value

used in corresponding fault message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

invalidRequestedParameters

InvalidRequestedParameters

M

operationFailed

OperationFailed

M

5.2.3 Operation releaseIRPReference

5.2.1.1 Input parameters

Table 5.2.1.1: Mapping from IS releaseIRPReference input parameters to SS equivalents

IS Operation parameter

SS WSDL type sub-element

used in corresponding input message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

managerIdentifier

managerIdentifier

M

iRPReference

iRPReference

M

5.2.1.2 Output parameters

Table 5.2.1.2: Mapping from IS releaseIRPReference output parameters to SS equivalents

IS Operation parameter

SS WSDL type sub-element

used in corresponding output message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

status

status

M

5.2.1.3 Fault definition

Table 5.2.1.3: Mapping from IS releaseIRPReference exceptions to SS equivalents

Assertion name

SS WSDL type enumeration value

used in corresponding fault message

under corresponding port type operation

as indicated in Table 5.1

Qualifier

unknownIRPReference

UnknownIRPReference

M

operationFailed

OperationFailed

M

Annex A (normative):
WSDL specifications

<?xml version="1.0" encoding="UTF-8"?>

<!–

3GPP TS 32.367 Entry Point IRP SOAP Solution Set

–>

<definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:entryPointIRPSystem="http://www.3gpp.org/ftp/Specs/archive/32_series/32.367#EntryPointIRPSystem" xmlns:entryPointIRPData="http://www.3gpp.org/ftp/Specs/archive/32_series/32.367#EntryPointIRPData" xmlns:xn="http://www.3gpp.org/ftp/specs/archive/32_series/32.625#genericNrm" xmlns:genericIRPSystem="http://www.3gpp.org/ftp/Specs/archive/32_series/32.317/schema/32317-810/GenericIRPSystem" xmlns:genericIRPData="http://www.3gpp.org/ftp/Specs/archive/32_series/32.317/schema/32317-810/GenericIRPData" xmlns:ntfIRPNtfSystem="http://www.3gpp.org/ftp/Specs/archive/32_series/32.307/schema/32307-810/notification/NotificationIRPNtfSystem" targetNamespace="http://www.3gpp.org/ftp/Specs/archive/32_series/32.367#EntryPointIRPSystem">

<import namespace="http://www.3gpp.org/ftp/Specs/archive/32_series/32.307/schema/32307-800/notification/NotificationIRPNtfSystem" location="http://www.3gpp.org/ftp/Specs/archive/32_series/32.307/schema/32307-810-wsdl.zip"/>

<import namespace="http://www.3gpp.org/ftp/Specs/archive/32_series/32.317/schema/32317-800/GenericIRPSystem" location="http://www.3gpp.org/ftp/Specs/archive/32_series/32.317/schema/32317-810-wsdl.zip"/>

<types>

<schema targetNamespace="http://www.3gpp.org/ftp/Specs/archive/32_series/32.367#EntryPointIRPData" xmlns="http://www.w3.org/2001/XMLSchema">

<import namespace="http://www.3gpp.org/ftp/specs/archive/32_series/32.625#genericNrm"/>

<import namespace="http://www.3gpp.org/ftp/Specs/archive/32_series/32.317/schema/32317-810/GenericIRPData"/>

<!– The following types are defined for the Entry Point IRP operations –>

<simpleType name="OperationStatusTwo">

<restriction base="string">

<enumeration value="OperationSucceeded"/>

<enumeration value="OperationFailed"/>

</restriction>

</simpleType>

<complexType name="IRPManagementScope">

<sequence>

<element name="subTreeDN" type="xn:dn" minOccurs="0" maxOccurs="unbounded"/>

</sequence>

</complexType>

<complexType name="IRPElement">

<sequence>

<element name="rDN" type="xn:dn"/>

<element name="iRPVersionSet" type="genericIRPData:VersionNumberSetType"/>

<element name="iRPManagementScope" type="entryPointIRPData:IRPManagementScope" minOccurs="0"/>

</sequence>

</complexType>

<complexType name="IRPList">

<sequence>

<element name="iRPElement" type="entryPointIRPData:IRPElement" maxOccurs="unbounded"/>

</sequence>

</complexType>

<complexType name="SupportedIRP">

<sequence>

<element ref="xn:systemDN"/>

<element name="iRPList" type="entryPointIRPData:IRPList"/>

</sequence>

</complexType>

<complexType name="SupportedIRPList">

<sequence>

<element name="supportedIRP" type="entryPointIRPData:SupportedIRP" maxOccurs="unbounded"/>

</sequence>

</complexType>

<!– getIRPOutline Request–>

<element name="getIRPOutline">

<complexType>

<sequence>

<element name="iRPVersion" type="genericIRPData:VersionNumberType"/>

</sequence>

</complexType>

</element>

<!– getIRPOutline Response –>

<element name="getIRPOutlineResponse">

<complexType>

<sequence>

<element name="supportedIRPList" type="entryPointIRPData:SupportedIRPList"/>

<element name="status" type="entryPointIRPData:OperationStatusTwo"/>

</sequence>

</complexType>

</element>

<!– getIRPOutline Fault –>

<element name="getIRPOutlineFault">

<simpleType>

<restriction base="string">

<enumeration value="InvalidIRPVersion"/>

<enumeration value="OperationFailed"/>

</restriction>

</simpleType>

</element>

<!– getIRPReference Request –>

<element name="getIRPReference">

<complexType>

<sequence>

<element name="managerIdentifier" type="xn:dn"/>

<element ref="xn:systemDN"/>

<element name="rDN" type="xn:dn"/>

</sequence>

</complexType>

</element>

<!– getIRPReference Response –>

<element name="getIRPReferenceResponse">

<complexType>

<sequence>

<element name="iRPReference" type="xn:dn"/>

<element name="status" type="entryPointIRPData:OperationStatusTwo"/>

</sequence>

</complexType>

</element>

<!– getIRPReference Fault –>

<element name="getIRPReferenceFault">

<simpleType>

<restriction base="string">

<enumeration value="InvalidRequestedParameters"/>

<enumeration value="OperationFailed"/>

</restriction>

</simpleType>

</element>

<!– releaseIRPReference Request –>

<element name="releaseIRPReference ">

<complexType>

<sequence>

<element name="managerIdentifier" type="xn:dn"/>

<element name="iRPReference" type="xn:dn"/>

</sequence>

</complexType>

</element>

<!– releaseIRPReference Response –>

<element name="releaseIRPReferenceResponse">

<complexType>

<sequence>

<element name="status" type="entryPointIRPData:OperationStatusTwo"/>

</sequence>

</complexType>

</element>

<!– releaseIRPReference Fault –>

<element name="releaseIRPReferenceFault">

<simpleType>

<restriction base="string">

<enumeration value="UnknownIRPReference"/>

<enumeration value="OperationFailed"/>

</restriction>

</simpleType>

</element>

</schema>

</types>

<message name="getIRPOutline">

<part name="parameter" element="entryPointIRPData:getIRPOutline"/>

</message>

<message name="getIRPOutlineResponse">

<part name="parameter" element="entryPointIRPData:getIRPOutlineResponse"/>

</message>

<message name="getIRPOutlineFault">

<part name="parameter" element="entryPointIRPData:getIRPOutlineFault"/>

</message>

<message name="getIRPReference">

<part name="parameter" element="entryPointIRPData:getIRPReference"/>

</message>

<message name="getIRPReferenceResponse">

<part name="parameter" element="entryPointIRPData:getIRPReferenceResponse"/>

</message>

<message name="getIRPReferenceFault">

<part name="parameter" element="entryPointIRPData:getIRPReferenceFault"/>

</message>

<message name="releaseIRPReference">

<part name="parameter" element="entryPointIRPData:releaseIRPReference"/>

</message>

<message name="releaseIRPReferenceResponse">

<part name="parameter" element="entryPointIRPData:releaseIRPReferenceResponse"/>

</message>

<message name="releaseIRPReferenceFault">

<part name="parameter" element="entryPointIRPData:releaseIRPReferenceFault"/>

</message>

<portType name="EntryPointIRPPortType">

<operation name="getIRPOutline">

<input message="entryPointIRPSystem:getIRPOutline"/>

<output message="entryPointIRPSystem:getIRPOutlineResponse"/>

<fault name="getIRPOutlineFault" message="entryPointIRPSystem:getIRPOutlineFault"/>

</operation>

<operation name="getIRPReference">

<input message="entryPointIRPSystem:getIRPReference"/>

<output message="entryPointIRPSystem:getIRPReferenceResponse"/>

<fault name="getIRPReferenceFault" message="entryPointIRPSystem:getIRPReferenceFault"/>

</operation>

<operation name="releaseIRPReference">

<input message="entryPointIRPSystem:releaseIRPReference"/>

<output message="entryPointIRPSystem:releaseIRPReferenceResponse"/>

<fault name="releaseIRPReferenceFault" message="entryPointIRPSystem:releaseIRPReferenceFault"/>

</operation>

</portType>

<binding name="EntryPointIRPBinding" type="entryPointIRPSystem:EntryPointIRPPortType">

<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<operation name="getIRPOutline">

<soap:operation soapAction="http://www.3gpp.org/ftp/Specs/archive/32_series/32.367#getIRPOutline" style="document"/>

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

<fault name="getIRPOutlineFault">

<soap:fault name="getIRPOutlineFault" use="literal"/>

</fault>

</operation>

<operation name="getIRPReference">

<soap:operation soapAction="http://www.3gpp.org/ftp/Specs/archive/32_series/32.367#getIRPReference" style="document"/>

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

<fault name="getIRPReferenceFault">

<soap:fault name="getIRPReferenceFault" use="literal"/>

</fault>

</operation>

<operation name="releaseIRPReference">

<soap:operation soapAction="http://www.3gpp.org/ftp/Specs/archive/32_series/32.367#releaseIRPReference" style="document"/>

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

<fault name="releaseIRPReferenceFault">

<soap:fault name="releaseIRPReferenceFault" use="literal"/>

</fault>

</operation>

</binding>

<service name="EntryPointIRPService">

<port name="EntryPointIRPPort" binding="entryPointIRPSystem:EntryPointIRPBinding">

<soap:address location="http://www.3gpp.org/ftp/Specs/archive/32_series/32.367#EntryPointIRP"/>

</port>

<port name="GenericIRPPort" binding="genericIRPSystem:GenericIRPBinding">

<soap:address location="http://www.3gpp.org/ftp/Specs/archive/32_series/32.317#GenericIRP"/>

</port>

<port name="NotificationIRPNtfPort" binding="ntfIRPNtfSystem:NotificationIRPNtf">

<soap:address location="http://www.3gpp.org/ftp/Specs/archive/32_series/32.307#NotificationIRPNtf"/>

</port>

</service>

</definitions>

Annex B (informative):
WSDL electronic files

The electronic files corresponding to the normative WSDL/XML schema defined in the present document are available in native form in the following archive:

http://www.3gpp.org/ftp/Specs/archive/32_series/32.367/schema/32367-800-wsdl.zip

Annex C (informative):
Change history

Change history

Date

TSG #

TSG Doc.

CR

R

Subject/Comment

Cat

Old

New

Mar 2009

SA-43

SP_090061

Presentation to SA for information and approval

1.0.0

8.0.0

Dec 2009

Update to Rel-9 version (MCC)

8.0.0

9.0.0