wiki:DeveloperGuidelines/EdenMobile/Settings

Version 17 (modified by Fran Boon, 4 years ago) ( diff )

+showHidden

Settings

table.settings (& consequently resource.settings) is a flexible JSON storage for configuration settings (equivalent to s3db.configure() on the Eden web application).

Here are some of the settings which are in-use:

Developer Settings

These are settings which a developer may see, but generally shouldn't need to touch

Setting Purpose Structure
autoUpload Whether a resource should prompt to sync new/modified records directly back to the server Boolean (Defaults to False if not defined)
autototals Allow a field to default to the sum of a set of other fields, whilst still allowing manual entry {"sumFieldname": ["sourceFieldname1", "sourceFieldname2"]}
grids Allow a set of fields to render as a Table in the form {"pseudoFieldname": {"r": ["rowLabel1", "rowLabel2"], "c": ["colLabel1", "colLabel2"], "f": [["realFieldname_forC1R1","realFieldname_forC1R2"],["realFieldname_forC2R1","realFieldname_forC2R2"]]}
insertable Whether a resource should allow local creation of new records Boolean (Defaults to True if not defined)
showHidden When this checkbox field is selected then unhide all the relevant fields {"fieldname": "fieldname2"} or {"fieldname": ["fieldname2", "fieldname3"]}
subheadings Provide subheadings within CRUD create/update forms {"fieldname": "Heading"} or {"fieldname": ["Heading1", "Heading2"]}

NB

  • For server-side dynamic models to export their table.settings to Mobile table.settings need to add to SERIALIZABLE_OPTS in s3model.py

Internal Settings

These are settings which a developer may see, but generally shouldn't need to touch

Setting Purpose Structure
main Whether this is a primary resource rather than a component or lookup table boolean
Note: See TracWiki for help on using the wiki.