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]. |
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 |