This function must be called before any action that creates a task. It groups one or more edits into a single transaction which is either committed or rolled back. Each save is committed against a single project. You can call multiple API methods as part of a single "save" and all work done will be logged under the save and its project.
The project must be either "New", "Under Construction", or "Rejected" in order to be used to save data. If the project is "New" or "Rejected", then it is automatically set to "Under Construction".
The oracle transaction must be rolled back or committed before another save is started.
Input
Parameter | Type | Description |
|---|---|---|
project_id | NUMBER | The ID of the project under which the edits are done, or NULL. |
Exceptions
• Project ID 'PROJECT_ID' does not exist.
• Project status must be set to 'New', 'Under Construction', or 'Rejected'.
• Save already started with save_id: SAVE_ID