3.1.4.3 Document

Document libraries are represented as EntityTypes that have an associated media resource, as specified in [RFC5023].

Inserting new documents to a document library involve sending a POST request containing the contents of the document to the EntitySet representing the document library. The protocol client MUST include the SLUG header (as specified in [RFC5023] section 9.7) whose value is the name of the file that is being created in their POST requests. The client can include the content type identifier of the document. If the content type identifier is omitted, the document will be assigned the default content type identifier of the document library. The Augmented BNF for SLUG header construction when inserting new documents is as follows:

slug     = path [ "|" contenttype ]
 
path     = serverpath                 
            "/"
            filename
            
 
serverpath     = *pchar                ; section 3.3 of [RFC3986]
         ; server-relative path of document
 
filename     = *pchar                ; section 3.3 of [RFC3986]
        ; desired name of the document including its extension
 
contenttype     = *pchar                ; section 3.3 of [RFC3986]
 
         ; content type identifier of the document

Using the preceding Augmented BNF causes a document to be created on the protocol server. For more details, see [MS-ODATA] section 3.2.5.