Просмотр исходного кода

Fixes #9651 - Document Pre-Change process for scripts

Daniel Sheppard 3 лет назад
Родитель
Сommit
86d366be4d
1 измененных файлов с 13 добавлено и 0 удалено
  1. 13 0
      docs/customization/custom-scripts.md

+ 13 - 0
docs/customization/custom-scripts.md

@@ -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