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. 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 ## Variable Reference
### Default Options ### Default Options