.. 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.