Function: append
Use
Effect
Data is appended to a content unit of a component in the content repository. The parameters contRep, docId, and compId describe the component (see Definition of Terms). The document addressed and the corresponding component must exist.
Default
Data is appended to the content unit of the addressed component.
Access Mode
change (u)
Client -> Server
The client sends an HTTP-PUT-Request. The URL or the body can contain the following parameters:
|
Parameter |
Optional/Mandatory |
Default |
Position |
Sign |
|
contRep |
Mandatory |
URL |
X |
|
|
docId |
Mandatory |
URL |
X |
|
|
compId |
Mandatory |
URL |
X |
|
|
pVersion |
Mandatory |
URL |
||
|
accessMode |
s-mandatory |
URL |
X |
|
|
authId |
s-mandatory |
URL |
X |
|
|
expiration |
s-mandatory |
URL |
X |
|
|
secKey |
optional |
URL |
||
|
Content Length |
Mandatory |
Body |
The data to be appended is transferred as an entity body.
Example
http://pswdf009:1080/ContentServer/ContentServer.dll?append&pVersion=0046&contRep=K1&docId=4B7689654E73D21197E70060B0672A3C&compId=data&Content-Length=98 0
Data transferred in the request body is appended to the content unit of the component "data" in the specified document.
Server -> Client
The server answers the request with a response. The response status code indicates the outcome of the call.
|
HTTP Status Code |
Meaning |
|
200 (OK) |
OK, data appended |
|
400 (bad request) |
Unknown function or unknown parameter |
|
401 (unauthorized) |
Security breach |
|
404 (not found) |
Document or component not found |
|
409 (conflict) |
Document or component inaccessible |
|
500 (Internal Server Error) |
Internal error on Content Server |
The content server must set the dates ( dateM or compDateM) and the times ( timeM or compTimeM) for changing the components and the document.