Most Powerful Open Source ERP

Developer Documentation

16- 04 2024

Guideline Never Log Level Info Or More In Execution Path

Avoid trivial logs.
Categories crime ; commit ; debug ; test ; log
16- 04 2024

Guideline Never Create Interdependent Test Methods

It makes finding broken tests much harder.
Categories crime ; commit ; test
16- 04 2024

Guideline FailUnless Should Not Be Used In Python Unit Tests To Test Identity

Use assertEqual.
Categories crime ; coding ; Python ; test
15- 07 2019

Guideline Never Use GetPath To Retrieve A Url In ERP5

Absolute and physical path may differ.
Categories crime ; coding ; url
15- 07 2019

Guideline Never Use ZODB Temp Folder Across Multiple Requests

Incompatible with ZEO and clustering.
Categories crime ; coding ; zodb ; scale
15- 07 2019

Guideline Never Store Calculation Result In Python Property

Only store original content.
Categories crime ; coding ; property ; Python
15- 07 2019

Guideline Never Use Aq_parent To Get Document Parent In Python

Use getParentValue()
Categories crime ; coding ; Python
15- 07 2019

Guideline Never Access State_change Object In ERP5 Workflow Scripts

Use state_change["attribute_name"].
Categories crime ; coding ; workflow
15- 07 2019

Guideline Never Modify 100+ Objects In A Transaction

Use activities instead.
Categories crime ; coding ; transaction
15- 07 2019

Guideline Never Name A Base Category The Same As A Property In ERP5

They form a global vocabulary.
Categories crime ; coding ; property ; category
15- 07 2019

Guideline Cookies Are Not Allowed

Cookies have limitations and should not be used in ERP5.
Categories crime ; coding ; scale
15- 07 2019

Guideline Never Write To ZODB If Not Required

ZODB is an incremental storage and every write creates more data.
Categories crime ; coding ; zodb
15- 07 2019

Guideline Never Hardcode Interactions

Use interaction workflows instead.
Categories crime ; coding ; workflow
15- 07 2019

Guideline Never Override Python Builtin Names

Debugging will be much harder.
Categories crime ; coding ; Python
15- 07 2019

Guideline Never Use ContentValues or ObjectValues On More Than 50 Documents In ZODB

Folders may contain million of documents.
Categories crime ; coding ; ZODB
15- 07 2019

Guideline Never Use Reindex In ERP5

Reindexing is for debugging only.
Categories crime ; coding ; reindex ; debug
15- 07 2019

Guideline Never Use Or Overload Reserved CSS Ids

To ensure the UI stays consistent.
Categories crime ; program ; css
15- 07 2019

Guideline Never Show Or Make User Work With Document Id

Expose title and reference only.
Categories crime ; module ; form
15- 07 2019

Guideline Never Set Search Row And Select Column On Listbox Inside Document View

It is not allowed in view mode.
Categories crime ; module ; form ; listbox
15- 07 2019

Guideline Never Allow Relation String Fields To Set Relations To Categories

Categories are too complex to relate.
Categories crime ; module ; form ; document
/ 2