[IMP] survey_record_generation: add README

survey_record_generation/readme/CONFIGURE.rst

@@ -0,0 +1,40 @@
+Record generation configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. |Image of record creation list| image:: ../static/description/record-creations.png
+
+#. Go to the the survey
+#. In *Record creation* tab add a new line        
+#. Set a name for created record, select the Model of the record (eg: Prospect)
+#. Add a field configuration. So for each field : 
+
+    .. |Image of record creation fields| image:: ../static/description/record-creation-customer.png
+
+    #. You can check "unicity constraint" to prevent duplicates. 
+        In case of duplicates and if other record use this record to fill a m2o field, the founded record will be used
+    #. You can configure explicitly where Odoo should retrieve the value of field : 
+        * **fixed**: To set explicit value
+        * **question**: If value come from user's answer
+            For m2o or m2m links, question should be configured before. See Question answers configuration section below.
+        * **other created record**: If value come from other created record (m2o case only)
+
+
+
+Question answers configuration 
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In a survey question : to configure value of choices
+
+.. |Question answers| image:: ../static/description/question-answers.png
+
+#. Configure a multiple choice question
+#. Select value type associated to answer:
+    * **Value** > eg: to fill a selection field
+    * **Record** > to fill m2o or m2m field
+#. In case of *record* type: 
+    #. Select referenced model
+    #. You can directly fill answers (eventualy with help of the domain field) 
+    #. Or create new answers and set associated record
+#. In case of *value* type: 
+    #. Add new selectable answers and set associated value
+

survey_record_generation/readme/CONTEXT.rst

@@ -0,0 +1,10 @@
+In several cases we want to use survey application to create records. 
+Website form application give the same possibility but the design is integrated on the web site. 
+Futhermore this module add other functionnalities like "duplicate" check, or creation of several interconnected records
+
+Typical use case : Information request form
+
+#. Submitting the form will create a contact (partner) only if it does not already exist in the database.
+#. Submitting the form will also create a crm opportunity linked to previously created partner
+
+

survey_record_generation/readme/CONTRIBUTORS.rst

@@ -0,0 +1,3 @@
+* `Elabore <https://www.elabore.coop>`_
+
+  * Clément Thomas

survey_record_generation/readme/DESCRIPTION.rst

@@ -0,0 +1 @@
+This module allows to generate any record from surveys answers.

survey_record_generation/readme/USAGE.rst

@@ -0,0 +1,6 @@
+When a survey is properly configured, once it is submited by a user, records should be created.
+
+To find records generated from a participation go to:
+
+#. Survey > participation
+#. Click on **# Generated records** button (top-right)