Fixes #9651 - Document Pre-Change process for scripts

This commit is contained in:
Daniel Sheppard 2022-09-20 09:46:23 -05:00
parent 1b62c11db5
commit 86d366be4d
No known key found for this signature in database
GPG Key ID: 404B90359674611B

View File

@ -129,6 +129,19 @@ The Script object provides a set of convenient functions for recording messages
Log messages are returned to the user upon execution of the script. Markdown rendering is supported for log messages.
## Change Logging
To generate the correct change log data when editing an existing object, a snapshot of the object must be taken before making any changes to the object.
```python
if obj.pk and hasattr(obj, 'snapshot'):
obj.snapshot()
obj.property = "New Value"
obj.full_clean()
obj.save()
```
## Variable Reference
### Default Options