Quentin Mondot
07d0af5e7f
survey_xlsx_expand_multiple_choice: expand multiple_choice questions into one Oui/Non column per option, and matrix questions into one column per row (value = selected option). Relies on the extension hooks added to survey_xlsx. survey_xlsx_extra_fields: bridge (auto_install) with survey_extra_fields that excludes 'file' question types from the XLSX export. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
110 lines
3.9 KiB
ReStructuredText
110 lines
3.9 KiB
ReStructuredText
.. image:: https://odoo-community.org/readme-banner-image
|
|
:target: https://odoo-community.org/get-involved?utm_source=readme
|
|
:alt: Odoo Community Association
|
|
|
|
====================================
|
|
Survey XLSX - Expand Multiple Choice
|
|
====================================
|
|
|
|
..
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!! This file is generated by oca-gen-addon-readme !!
|
|
!! changes will be overwritten. !!
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!! source digest: sha256:2ec53fabb2863ebd536f204a7cb4fa4833a634a5711a9e325ed64f50a4c3c4b6
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
|
|
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
|
|
:target: https://odoo-community.org/page/development-status
|
|
:alt: Beta
|
|
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
|
|
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
|
|
:alt: License: AGPL-3
|
|
.. |badge3| image:: https://img.shields.io/badge/gitea-Elabore%2Fsurvey--tools-lightgray.png
|
|
:target: https://git.elabore.coop/Elabore/survey-tools/tree/18.0/survey_xlsx_expand_multiple_choice
|
|
:alt: Elabore/survey-tools
|
|
|
|
|badge1| |badge2| |badge3|
|
|
|
|
This module improves the **Survey Results XLSX export** provided by
|
|
``survey_xlsx`` for questions that can hold several answers.
|
|
|
|
By default such questions are exported as a single column containing every
|
|
selected value joined together, which is hard to analyse in a spreadsheet.
|
|
This module splits them into dedicated columns:
|
|
|
|
* **Multiple choice** questions (*multiple answers allowed*): one column per
|
|
possible answer, with ``Oui`` / ``Non`` as value.
|
|
* **Matrix** questions: one column per matrix row, with the selected option
|
|
as value.
|
|
|
|
.. warning::
|
|
|
|
This module relies on report extension hooks that are **not part of the
|
|
standard** ``survey_xlsx`` yet. They are introduced by this pull request:
|
|
|
|
https://github.com/elabore-coop/survey/pull/1
|
|
|
|
You must run a ``survey_xlsx`` that includes these hooks (the PR branch,
|
|
until it is merged upstream). Installed against a plain ``survey_xlsx``,
|
|
this module installs without error but the export **silently falls back**
|
|
to the default one-column-per-question behaviour.
|
|
|
|
**Table of contents**
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
Usage
|
|
=====
|
|
|
|
Export the results of a survey as usual:
|
|
|
|
#. Go to *Surveys* and open a survey.
|
|
#. Print the *Survey Results XLSX* report.
|
|
|
|
In the generated spreadsheet:
|
|
|
|
* A multiple choice question ``Favorite colors`` with options *Red*, *Green*
|
|
and *Blue* produces three columns ``Favorite colors / Red``,
|
|
``Favorite colors / Green`` and ``Favorite colors / Blue``, each containing
|
|
``Oui`` or ``Non``.
|
|
* A matrix question ``Satisfaction`` with rows *Dashboards* and *Customer
|
|
relationship* produces two columns ``Satisfaction / Dashboards`` and
|
|
``Satisfaction / Customer relationship``, each containing the selected
|
|
option (e.g. *Not satisfied at all*).
|
|
|
|
Other question types keep their standard single-column export.
|
|
|
|
Bug Tracker
|
|
===========
|
|
|
|
Bugs are tracked on `Gitea Issues <https://git.elabore.coop/Elabore/survey-tools/issues>`_.
|
|
In case of trouble, please check there if your issue has already been reported.
|
|
If you spotted it first, help us to smash it by providing a detailed and welcomed
|
|
`feedback <https://git.elabore.coop/Elabore/survey-tools/issues/new?body=module:%20survey_xlsx_expand_multiple_choice%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
|
|
|
|
Do not contact contributors directly about support or help with technical issues.
|
|
|
|
Credits
|
|
=======
|
|
|
|
Authors
|
|
~~~~~~~
|
|
|
|
* Elabore
|
|
|
|
Contributors
|
|
~~~~~~~~~~~~
|
|
|
|
* `Elabore <https://www.elabore.coop>`_
|
|
|
|
* Quentin Mondot
|
|
|
|
Maintainers
|
|
~~~~~~~~~~~
|
|
|
|
This module is part of the `Elabore/survey-tools <https://git.elabore.coop/Elabore/survey-tools/tree/18.0/survey_xlsx_expand_multiple_choice>`_ project on git.elabore.coop.
|
|
|
|
You are welcome to contribute.
|