DigiOffice API Services Services

<back to all web services

AddUploadFile

Add a uploadfile with metadata.

Requires Authentication
The following routes are available for this service:
POST/api/DMS/AddUploadFile
import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class MetaDataField:
    id: Optional[str] = None
    document_veld_i_d: Optional[str] = None
    name: Optional[str] = None
    label: Optional[str] = None
    datatype: Optional[str] = None
    print_label: Optional[str] = None
    entity: Optional[str] = None
    print_value: Optional[str] = None
    registration_value: Optional[str] = None
    sp_site_column_name: Optional[str] = None
    shadow_name: Optional[str] = None
    shadow_datatype: Optional[str] = None
    shadow_s_p_site_column_name: Optional[str] = None
    shadow_s_p_site_column_registration_value: Optional[str] = None
    shadow_registration_value: Optional[str] = None
    is_key_field: bool = False
    kopieren_bij_nieuwe_versie: bool = False


# @Api(Description="Add a uploadfile with metadata.")
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class AddUploadFile:
    """
    Add a uploadfile with metadata.
    """

    # @ApiMember(Description="Registration profile ID", IsRequired=true)
    registration_profile_i_d: Optional[str] = None
    """
    Registration profile ID
    """


    # @ApiMember(Description="Registration navigation path")
    navigation_path: Optional[str] = None
    """
    Registration navigation path
    """


    # @ApiMember(Description="File name", IsRequired=true)
    file_name: Optional[str] = None
    """
    File name
    """


    # @ApiMember(Description="File date", IsRequired=true)
    file_date: datetime.datetime = datetime.datetime(1, 1, 1)
    """
    File date
    """


    # @ApiMember(Description="File content", IsRequired=true)
    file_content: bytes = field(default_factory=list)
    """
    File content
    """


    # @ApiMember(Description="File description", IsRequired=true)
    description: Optional[str] = None
    """
    File description
    """


    # @ApiMember(Description="Keep document in uploads (false; register immediately)")
    document_upload: bool = False
    """
    Keep document in uploads (false; register immediately)
    """


    # @ApiMember(Description="Source of the file")
    source: Optional[str] = None
    """
    Source of the file
    """


    # @ApiMember(Description="MetaDataFields")
    meta_data_fields: Optional[List[MetaDataField]] = None
    """
    MetaDataFields
    """


    # @ApiMember(Description="Document ID")
    document_i_d: Optional[str] = None
    """
    Document ID
    """


    # @ApiMember(Description="Main Document ID")
    main_document_i_d: Optional[str] = None
    """
    Main Document ID
    """


    # @ApiMember(Description="Sub Document IDs")
    sub_document_i_ds: Optional[List[str]] = None
    """
    Sub Document IDs
    """


class MessageType(IntEnum):
    INFORMATION = 1
    WARNING = 2
    ERROR = 3
    SUCCESS = 4


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class InformationMessageBase(IInformationMessage):
    type: Optional[MessageType] = None
    summary: Optional[str] = None
    full_message: Optional[str] = None
    field_name: Optional[str] = None
    keep_open: bool = False


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class InformationMessages(List[InformationMessageBase], IInformationMessages):
    pass


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class AddUploadFileResponse:
    document_id: Optional[str] = None
    document_upload_id: Optional[int] = None
    document_nr: Optional[str] = None
    messages: Optional[InformationMessages] = None

Python AddUploadFile DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/DMS/AddUploadFile HTTP/1.1 
Host: test-do-services.klokgroep.nl 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"RegistrationProfileID":"00000000-0000-0000-0000-000000000000","NavigationPath":"String","FileName":"String","FileDate":"0001-01-01T00:00:00.0000000","FileContent":"AA==","Description":"String","DocumentUpload":false,"Source":"String","MetaDataFields":[{"ID":"00000000-0000-0000-0000-000000000000","DocumentVeldID":"00000000-0000-0000-0000-000000000000","Name":"String","Label":"String","Datatype":"String","PrintLabel":"String","Entity":"String","PrintValue":"String","RegistrationValue":"String","SPSiteColumnName":"String","ShadowName":"String","ShadowDatatype":"String","ShadowSPSiteColumnName":"String","ShadowSPSiteColumnRegistrationValue":"String","ShadowRegistrationValue":"String","IsKeyField":false,"KopierenBijNieuweVersie":false}],"DocumentID":"00000000-0000-0000-0000-000000000000","MainDocumentID":"00000000-0000-0000-0000-000000000000","SubDocumentIDs":["00000000-0000-0000-0000-000000000000"]}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"DocumentId":"00000000-0000-0000-0000-000000000000","DocumentUploadId":0,"DocumentNr":"String","Messages":[{}]}