5 Mapping

32.3473GPPFile Transfer (FT) Integration Reference Point (IRP)SOAP Solution Set (SS)Telecommunication managementTS

5.1 Operation and notification mapping

The FT IRP IS (3GPP TS 32.342 [4]) defines the operations and their semantics.

Table 5.1 maps the operations defined in the FT IRP IS to their equivalent port type and binding operations in this Solution Set (SS).

Table 5.1 also maps the notifications of the FT 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.342 [4]

SS: Operation for WSDL port type and WSDL binding

SS: Port of FileTransferIRPService

Qualifier

listAvailableFiles

listAvailableFiles (note 1)

FileTransferIRPPort

M

fileDownloadIndication

fileDownloadIndication (note 1)

FileTransferIRPPort

O

notifyFileReady

notify (note 2)

NotificationIRPNtfPort

M

notifyFilePreparationError

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 fTIRPSystem:FileTransferIRPPortType and under the binding fTIRPSystem:FileTransferIRPBinding.

NOTE 2: The IS equivalent maps to an XML definition specified in 3GPP TS 32.345 [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 FileTransferIRPService 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 FileTransferIRP IOC of 3GPP TS 32.342 [4] inheriting from the ManagedGenericIRP IOC. The corresponding binding is linked to a port of the FileTransferIRPService as indicated in the table above.

5.2 Operation parameter mapping

The FT IRP IS (3GPP TS 32.342 [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 listAvailableFiles

5.2.1.1 Input parameters

Table 5.2.1.1: Mapping from IS listAvailableFiles 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

managementDataType

managementDataType

M

beginTime

beginTime

M

endTime

endTime

M

5.2.1.2 Output parameters

Table 5.2.1.2: Mapping from IS listAvailableFiles 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

fileInfoList

fileInfoList

M

status

status

M

5.2.1.3 Fault definition

Table 5.2.1.3: Mapping from IS listAvailableFiles 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

invalidTimes

InvalidTimes

M

5.2.2 Operation fileDownloadIndication

5.2.2.1 Input parameters

Table 5.2.2.1: Mapping from IS fileDownloadIndication 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

fileInfoList

fileInfoList

M

5.2.2.2 Output parameters

Table 5.2.2.2: Mapping from IS fileDownloadIndication 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.2.3 Fault definition

Table 5.2.2.3: Mapping from IS fileDownloadIndication 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

InvalidFileInfoList

InvalidFileInfoList

M

Annex A (normative):
WSDL specifications

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

<!–

3GPP TS 32.347 File Transfer (FT) IRP SOAP Solution Set

–>

<definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:fTIRPSystem="http://www.3gpp.org/ftp/Specs/archive/32_series/32.347#FTIRPSystem" xmlns:fTIRPData="http://www.3gpp.org/ftp/Specs/archive/32_series/32.347#FTIRPData" xmlns:xfi="http://www.3gpp.org/ftp/specs/archive/32_series/32.345#fTIRPIOCs" xmlns:genericIRPSystem="http://www.3gpp.org/ftp/Specs/archive/32_series/32.317/schema/32317-810/GenericIRPSystem" 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.347#FTIRPSystem">

<import namespace="http://www.3gpp.org/ftp/Specs/archive/32_series/32.307/schema/32307-810/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-810/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.347#FTIRPData" xmlns="http://www.w3.org/2001/XMLSchema">

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

<!– The following types are defined for the File Transfer IRP operations –>

<simpleType name="OperationStatusTwo">

<restriction base="string">

<enumeration value="OperationSucceeded"/>

<enumeration value="OperationFailed"/>

</restriction>

</simpleType>

<complexType name="FileInfo">

<sequence>

<element ref="xfi:fileLocation"/>

<element ref="xfi:fileSize"/>

<element ref="xfi:fileReadyTime"/>

<element ref="xfi:fileExpirationTime"/>

<element ref="xfi:fileCompression"/>

<element ref="xfi:fileFormat"/>

</sequence>

</complexType>

<complexType name="FileInfoList">

<sequence>

<element name="fileInfo" type="fTIRPData:FileInfo" minOccurs="0" maxOccurs="unbounded"/>

</sequence>

</complexType>

<!– listAvailableFiles Request–>

<element name="listAvailableFiles">

<complexType>

<sequence>

<element ref="xfi:managementDataType"/>

<element name="beginTime" type="dateTime" minOccurs="0"/>

<element name="endTime" type="dateTime" minOccurs="0"/>

</sequence>

</complexType>

</element>

<!– listAvailableFiles Response –>

<element name="listAvailableFilesResponse">

<complexType>

<sequence>

<element name="fileInfoList" type="fTIRPData:FileInfoList"/>

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

</sequence>

</complexType>

</element>

<!– listAvailableFiles Fault –>

<element name="listAvailableFilesFault">

<simpleType>

<restriction base="string">

<enumeration value="InvalidTimes"/>

</restriction>

</simpleType>

</element>

<!– fileDownloadIndication Request–>

<element name="fileDownloadIndication">

<complexType>

<sequence>

<element name="fileInfoList" type="fTIRPData:FileInfoList"/>

</sequence>

</complexType>

</element>

<!– fileDownloadIndication Response –>

<element name="fileDownloadIndicationResponse">

<complexType>

<sequence>

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

</sequence>

</complexType>

</element>

<!– fileDownloadIndication Fault –>

<element name="fileDownloadIndicationFault">

<simpleType>

<restriction base="string">

<enumeration value="InvalidFileInfoList"/>

</restriction>

</simpleType>

</element>

</schema>

</types>

<message name="listAvailableFiles">

<part name="parameter" element="fTIRPData:listAvailableFiles"/>

</message>

<message name="listAvailableFilesResponse">

<part name="parameter" element="fTIRPData:listAvailableFilesResponse"/>

</message>

<message name="listAvailableFilesFault">

<part name="parameter" element="fTIRPData:listAvailableFilesFault"/>

</message>

<message name="fileDownloadIndication">

<part name="parameter" element="fTIRPData:fileDownloadIndication"/>

</message>

<message name="fileDownloadIndicationResponse">

<part name="parameter" element="fTIRPData:fileDownloadIndicationResponse"/>

</message>

<message name="fileDownloadIndicationFault">

<part name="parameter" element="fTIRPData:fileDownloadIndicationFault"/>

</message>

<portType name="FileTransferIRPPortType">

<operation name="listAvailableFiles">

<input message="fTIRPSystem:listAvailableFiles"/>

<output message="fTIRPSystem:listAvailableFilesResponse"/>

<fault name="listAvailableFilesFault" message="fTIRPSystem:listAvailableFilesFault"/>

</operation>

<operation name="fileDownloadIndication">

<input message="fTIRPSystem:fileDownloadIndication"/>

<output message="fTIRPSystem:fileDownloadIndicationResponse"/>

<fault name="fileDownloadIndicationFault" message="fTIRPSystem:fileDownloadIndicationFault"/>

</operation>

</portType>

<binding name="FileTransferIRPBinding" type="fTIRPSystem:FileTransferIRPPortType">

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

<operation name="listAvailableFiles">

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

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

<fault name="listAvailableFilesFault">

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

</fault>

</operation>

<operation name="fileDownloadIndication">

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

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

<fault name="fileDownloadIndicationFault">

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

</fault>

</operation>

</binding>

<service name="FileTransferIRPService">

<port name="FileTransferIRPPort" binding="fTIRPSystem:FileTransferIRPBinding">

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

</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):
Void

Annex C (informative):
Change history

Change history

Date

TSG #

TSG Doc.

CR

R

Subject/Comment

Cat

Old

New

March 2009

SA_43

SP-090060

Presentation to SA for information and approval

1.0.0

8.0.0

Dec 2009

SA_46

SP-090719

0001

Discontinuation of the maintenance of WSDL/XML schema folders

F

8.0.0

9.0.0