Supported in API v17 +
The key benefit of metadata bulk update APIs is that they allow synchronizing a dimension within the Adaptive Suite with counterparts in an external system on a regular, scheduled basis. Instead of calling out individual elements one by one, these APIs let you submit a raw XML file to update, reorder, and create elements.
With metadata bulk APIs, the new version of the tree of existing elements imports into the Adaptive Suite. The new tree sends the desired end-state to the Adaptive Suite, and the Adaptive Suite adjusts to it.
Metadata bulk update APIs:
- Never delete. Elements missing from the uploaded version remain untouched.
- Create any new elements found in the upload, if they can.
- Update the properties of any elements being uploaded, including their parentage properties.
- Update the attribute assignments being uploaded.
- They specifically allow partial tree upload (since deletion is never performed, partial uploads are non-destructive).
- They allow identifying the existing elements in a tree either by their internal ID number or their "original" (pre-update) unique identifier field.
- Halt on catastrophic errors and roll back. Catastrophic errors include:
- Attempts to create a cycle in a hierarchy
- Attempts to create a new element whose identifying field collides with one already in the system (e.g. creating a new account with a code that is in use)
- Attempts to update an element's identifying field such that it collides with one already in the system.
- Proceed on ignorable errors that do not halt the import, and report in the result response as warnings. Ignorable errors include those unlikely to produce any cascading effect, such as:
- Attempts to change an attribute assignment to a value that does not exist.
- Attempts to set a level name to something that is too long for the field.
Metadata Bulk Update APIs: