Changes between Version 7 and Version 8 of BluePrint/PrePopulate

Timestamp:

03/18/12 14:44:18 (13 years ago)

Author:

graeme

Comment:

--

BluePrint/PrePopulate

@@ -15 +15 @@
 == Methods ==
 === On First Run ===
-In models/000_config.py their is a deployment setting to control prepopulate. This is a list of directory names and will import data from a number of CSV files. The directories must be in the private/prepopulate directory tree and must include a file called tasks.cfg.
+In models/000_config.py their is a deployment setting which is used to control prepopulate. This is a list of directory names and will import data from a number of CSV files. The directories must be in the private/prepopulate directory tree and must include a file called tasks.cfg.
+
+The prepopulate deployment setting can also be a number which will relate to a single directory, the numerical value is still supported because existing instances of Eden and their maintenance scripts use this number. The use of a number is discouraged in favour of the list of names because this new approach is clearer and more flexible.
+
+==== Deployment setting examples ====
+Use the Shipment folder as the starting point for the prepopulate.
+{{{
+deployment_settings.base.prepopulate = ["Standard"]
+}}}
+The Standard folder is not in the root directory, which is private/prepopulate, rather it is in demo (private/prepopulate/demo) but this will be found automatically.
+
+Uses the roles to import some special roles and then the user directory which is a special directory which is external to the version control and so private data (potentially sensitive data - such as volunteer details) can be held and then imported.
+{{{
+deployment_settings.base.prepopulate = ["roles", "user"]
+}}}
+
 
 The tasks.cfg file comprises a list of import jobs. They can be of two distinct types:
@@ -42 +57 @@
 *,gis_set_default_location,defaultlocation.csv
 }}}
-This uses the csv file '''default_location.csv''' and the function '''gis_set_default_location''' to set, in this case, the default location.
+This uses the csv file '''default_location.csv''' and the function '''gis_set_default_location''' to set, in this case, the default location. Another special function is import_role which is used to import user permissions (or roles) examples of the roles and what the csv looks like can be found in the private/prepopulate/roles directory.
+
 === URL Import ===
 Data can be imported using URL calls:
@@ -76 +92 @@
 
  
-