RecordsRepository.SubmitFile Method
Submits a file as a given record routing type, along with its metadata and, optionally, its audit history.
Namespace: websvcOfficialFile
Assembly: MOSSSOAP (in MOSSSOAP.dll)
Syntax
'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/recordsrepository/SubmitFile", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/recordsrepository/", _
ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/recordsrepository/", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function SubmitFile ( _
fileToSubmit As Byte(), _
properties As RecordsRepositoryProperty(), _
recordRouting As String, _
sourceUrl As String, _
userName As String _
) As String
'Usage
Dim instance As RecordsRepository
Dim fileToSubmit As Byte()
Dim properties As RecordsRepositoryProperty()
Dim recordRouting As String
Dim sourceUrl As String
Dim userName As String
Dim returnValue As String
returnValue = instance.SubmitFile(fileToSubmit, _
properties, recordRouting, sourceUrl, _
userName)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/recordsrepository/SubmitFile", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/recordsrepository/",
ResponseNamespace = "https://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
Type: []
The file being submitted.
- properties
Type: []
A string representing a collection of RecordsRepositoryProperty objects, each of which represents a document property being submitted with the file.
- recordRouting
Type: System.String
A string representing the record routing type of the file.
- sourceUrl
Type: System.String
A string representing the current URL of the file being submitted.
- userName
Type: System.String
A string representing the logon name of the user who is submitting the file.
Return Value
Type: System.String
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.
<ResultCode>MoreInformation</ResultCode>
<ResultUrl>
https://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.