RecordsRepository.SubmitFile Method

RecordsRepository.SubmitFile Method

Submits a file as a given record routing type, along with its metadata and, optionally, its audit history.

Web Service: Official FileWeb Reference: http://<Site>/_vti_bin/OfficialFile.asmx

Syntax

[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sharepoint/soap/recordsrepository/SubmitFile", RequestNamespace="http://schemas.microsoft.com/sharepoint/soap/recordsrepository/", ResponseNamespace="http://schemas.microsoft.com/sharepoint/soap/recordsrepository/", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
public string SubmitFile (
    byte[] fileToSubmit,
    RecordsRepositoryProperty[] properties,
    string recordRouting,
    string sourceUrl,
    string userName
)

Parameters

• fileToSubmit
  The file being submitted.

• properties
  A string representing a collection of RecordsRepositoryProperty objects, each of which represents a document property being submitted with the file.

• recordRouting
  A string representing the record routing type of the file.

• sourceUrl
  A string representing the current URL of the file being submitted.

• userName
  A string representing the logon name of the user who is submitting the file.

Return Value

The SubmitFile method returns a string that represents the result of the method call, in the following format.

 

<ResultCode>Success</ResultCode>

Result code values include:

• Success

• MoreInformation

• InvalidConfiguration

• InvalidArgument

• InvalidUser

• NotFound

• FileRejected

• UnknownError

If the file is missing required properties, the SubmitFile method can return a request for more information, using the MoreInformation result code.

XML

<ResultCode>MoreInformation</ResultCode>
<ResultUrl>
http://servername/officialsitename/MissingProperties/Forms/EditForm.aspx?ID=GUID
</ResultUrl>

Where the ResultUrl element represents the path to the edit form for the item, where the user can enter the missing properties for the item. If the file is successfully uploaded, the SubmitFile method returns a Success result code.

Remarks

You can include a property that represents the audit history of the file being submitted. To do this, include a RecordsRepositoryProperty object with a Name property of "Audit History", and a Type property of XML. Store the actual audit history as XML in the Other property.