.. _export:

Exporting data
==============

The :fa:`bars` menu button on the assignment overview page contains the export actions:

.. image:: ../results/manage-menu.png
   :align: center

.. _upload_scores:

Uploading scores to Canvas
--------------------------

*Only teachers can upload scores to Canvas*

Click the :fa:`cloud-upload` :guilabel:`Upload scores to Canvas...` option to open the score upload form:

.. image:: upload_modal.png
   :align: center

The :guilabel:`Section` selector can be used to select the section for which the scores should be uploaded.

It is possible to only upload scores for accepted or failed submissions, or both. Use the first two options
on the upload form to chose exactly which scores to upload. At least one of these options must be selected to
continue.

The last option indicates whether submission for which a score is already available in Canvas should be uploaded
again.

Click the :guilabel:`Upload` button to initiate the upload. A progress bar will be shown while
the upload is in progress and Canvas processes the grades.

.. _export_as_csv:

Export as CSV
-------------

The :fa:`file` :guilabel:`Export as CSV` option generates a :abbr:`CSV (Comma-separated values)` file.
This CSV file contains the results as visible for the submissions for the currently selected section(s).

.. image:: export-csv-modal.png
   :align: center

The section to be exported can be selected using the :guilabel:`Section` selector.

The :guilabel:`Field separators` option can be used to select the field separator to use in the CSV file.

.. _export_as_pdf:

Export as PDF archive
---------------------

The :fa:`file` :guilabel:`Export as PDF archive` option is used to generate and download a zip archive containing
a :abbr:`PDF (Portable Document Format)` file for each submission.

.. image:: export-pdf-modal.png
   :align: center

The section to be exported can be selected using the :guilabel:`Section` selector.

When the :guilabel:`Include secret steps` option is enabled, the secret steps will be included in the PDF.
*Only teachers can create an export containing the secret steps.*

Background processing of export options
=======================================

For all export options, clicking the :guilabel:`Export` or :guilabel:`Upload` button starts a background process
and progress is shown. The :guilabel:`Hide` button can be used to close the popup and use Momotor in the mean time.
The :guilabel:`Cancel` button cancels the background process. Cancel is not available for the :guilabel:`Upload`
export.

.. image:: job-hide.png
   :align: center

When the background process is finished, this will be indicated on the :fa:`bars` menu with a notification
dot, and the export option that finished will be highlighted with a status icon.

.. image:: manage-menu-with-notification.png
   :align: center