3.1.4.3 CreateDataSource

  • Article

The CreateDataSource operation is used to create a DataSource complex type (section 2.2.4.85) on the server (2).

The following is the WSDL port type specification of the CreateDataSource WSDL operation.

 <wsdl:operation name="CreateDataSource" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input message="tns:CreateDataSourceSoapIn"/>
   <wsdl:output message="tns:CreateDataSourceSoapOut"/>
 </wsdl:operation>

The protocol client sends a CreateDataSourceSoapIn request message (section 3.1.4.3.1.1), and the server (2) responds with a CreateDataSourceSoapOut response message (section 3.1.4.3.1.2) as follows:

  • The protocol client MUST send the DataSource and its target location on the server (2).

  • The server (2) MUST create the specified DataSource at the specified server (2) location.

  • If creation is successful, the server (2) MUST return the created DataSource with the following fields set as specified in the FirstClassElement complex type (section 2.2.4.99):

  • Location

  • CreatedBy

  • ModifiedBy

  • CreatedDate

  • LastModified

  • Version

Exceptions:

Error code

Description

InvalidDataSource

See Common List of Error Codes (section 2.2.2.1.3).

InvalidObject

See Common List of Error Codes (section 2.2.2.1.3).

InvalidFirstClassElementField

See Common List of Error Codes (section 2.2.2.1.3).

InvalidElement

See Common List of Error Codes (section 2.2.2.1.3).

InvalidElementField

See Common List of Error Codes (section 2.2.2.1.3).

InvalidCategoryName

See Common List of Error Codes (section 2.2.2.1.3).

InvalidPermission

See Common list of Error Codes (section 2.2.2.1.3).

FCOCreateFailed

See Common List of Error Codes (section 2.2.2.1.3).

FCOCreateFailedListAccess

See Common List of Error Codes (section 2.2.2.1.3).

FCOCreateFailedListType

See Common List of Error Codes (section 2.2.2.1.3).

RepositoryLocationUrlLength

See Common List of Error Codes (section 2.2.2.1.3).

RepositoryLocationAbsoluteUrl

See Common List of Error Codes (section 2.2.2.1.3).

Unknown

See Common List of Error Codes (section 2.2.2.1.3).

In case of any other failure, the error code MUST be one of the values specified in section 2.2.2.1.2. A detailed specification of how exceptions are reported by the server (2) is in section 2.2.2.1.