Creates a new projectdoc document based on a document representation.
Representation
The representation is posted to the REST service and requires the following form.
Since version 4.0 this service requires to post a document with properties and optional sections. Properties must contain a doctype, a name (will be uses as the title of the document), and a short description.
{
"property": [
{
"name": "New Property",
"value": "My Value",
"controls": "",
"position": "after",
"ref": "Name"
}
],
"section": [
{
"title": "My Section",
"content": "<p>Some text</p>",
"position": "before",
"ref": "References"
}
]
}
The name, value, and controls specify the values for the property to apply. The title and content specify the information for the section.
The position and ref specify the position where to add the property or section. The position may be one of the following keywords, while ref (that is: reference) specifies the name of a property or title of a section relative to which the position is evaluated.
| Position | Target | Supports ref | Description |
|---|---|---|---|
before | Property |  | Add the property before the property specified by ref. If the referenced property is not found, a 404 will be returned for that document. |
before | Section | | Add the section before the section specified by ref. If the referenced section is not found, a 404 will be returned for that document. |
after | Property | | Add the property after the property specified by ref. If the referenced property is not found, a 404 will be returned for that document. |
after | Section | | Add the section after the section specified by ref. If the referenced section is not found, a 404 will be returned for that document. |
first | Property |  | Add the property in front of all properties. |
first | Section | | Add the section in front of all sections. |
last | Property | | Add the property after all properties. |
last | Section | | Add the section after all sections. |
delete | Property | | Deletes the specified property. |
delete | Section | | Deletes the specified section |
replace | Property |  | Replaces the specified property with this information. The ref references the property to be replaced (defaults to name). |
merge | Property | | Merges the specified property with this information. If no information is provided for value or controls, the existing information is not changed. The Since version 4.10 this position allows to rename a property if value and controls are empty. |
merge-values | Property | | Like merge but also merges properties provided into list values. Available since version 3.1. |
delete-values | Property | | Like merge-values but removes the elements from the property list value. Available since version 3.1. |
replace-values | Property | | Like merge-values but clears the values before inserting the new. Available since version 6.0. |
replace-or-add | Property | | Replaces the property with the given name if it exist, otherwise adds a new property at the end. The ref references the property to be replaced (defaults to name). |
replace | Section | | Replaces the specified section. The ref references the section to be replaced (defaults to title). |
