The format of the representation to post to the URL may be XML or JSON. Here is the basic structure in JSON: | Code Block |
|---|
{
"name": "",
"value": "",
"controls": "",
"position": ""
} |
Only the following position values are allowed: | Position | Since | Description |
|---|
replace-or-add |
| 1.0 | Replaces an existing property or - if it does not exist - add it (default). | replace |
| 1.0 | Replaces an existing property. | merge |
| 1.0 | Merges the information into an existing property |
merge-values - merges | Merges the information into an existing property |
. Looking at the property as a list of properties |
the service integrates the given values into the existing list |
. Duplicates are not added. | delete-values |
| the information into an existing property |
| . Looking at the property as a list of properties |
| the service removes values from the list. |
For these list values the following macros are supported: - Name List Macro (Names parameter)
- Tag List Macro (Names parameter)
- Name Body List Macro (body)
- Tag Body List Macro (body)
- Parent Property Macro (Parent Doctype parameter)
| Caution Box |
|---|
If you use replace and you do not specify a value for controls, the property controls will be overridden with blank. Typically you would use merge to only set the value. |
| 
