129 lines
4.3 KiB
ReStructuredText
129 lines
4.3 KiB
ReStructuredText
:navigation-title: Export
|
|
|
|
.. include:: /Includes.rst.txt
|
|
.. _export:
|
|
|
|
==========================================
|
|
Exporting content from TYPO3 to XML or T3D
|
|
==========================================
|
|
|
|
The export functionality is only available for admin users and backend
|
|
users for which the Page TSconfig option
|
|
:ref:`options.impexp.enableExportForNonAdminUser
|
|
<t3tsref:useroptions-impexp-enableExportForNonAdminUser>` has been enabled.
|
|
|
|
.. attention::
|
|
|
|
Exporting content may expose sensitive data or allow unwanted file access.
|
|
Review the :ref:`security considerations regarding exports <security>`
|
|
before using this functionality.
|
|
|
|
.. _export-open-module:
|
|
|
|
Open the export module
|
|
======================
|
|
|
|
In the page tree, right-click the page from which you want to start the
|
|
export (1) and select :guilabel:`More options ... > Export` (2).
|
|
|
|
.. include:: /Images/AutomaticScreenshots/ContextMenuExport.rst.txt
|
|
|
|
.. _export-configure-settings:
|
|
|
|
Configure the export settings
|
|
=============================
|
|
|
|
On the first tab of the export module you can fine-tune the export (1).
|
|
|
|
- If you want to export all data of the selected page including its
|
|
subpages, select the "Infinite" option in the :guilabel:`Levels`
|
|
selection box.
|
|
|
|
- Under :guilabel:`Include tables` you can limit the types of records to
|
|
be exported.
|
|
|
|
- Under :guilabel:`Include relations to tables` you specify which
|
|
relations of the records should be included in the export file. The
|
|
related records will be included even if they are outside the pages
|
|
selected for export.
|
|
|
|
- Under :guilabel:`Use static relations for tables` you select which
|
|
relations should be included without including the related record. This
|
|
is useful if the related record already exists in the target TYPO3
|
|
instance.
|
|
|
|
- If the same table is selected in both :guilabel:`Include relations to
|
|
tables` and :guilabel:`Use static relations for tables`, the relation
|
|
is treated as static.
|
|
|
|
- The :guilabel:`Exclude disabled elements` checkbox excludes records
|
|
that are disabled according to their TCA configuration. This is checked
|
|
by default.
|
|
|
|
Apply your changes via the :guilabel:`Update` button and repeat this step
|
|
until the preview meets your expectations.
|
|
|
|
.. include:: /Images/AutomaticScreenshots/ConfigureExport.rst.txt
|
|
|
|
.. _export-review-records:
|
|
|
|
Review the records to be exported
|
|
=================================
|
|
|
|
All pages selected for export are listed in the upper part of the dialog
|
|
(1).
|
|
|
|
Below this is a detailed list of all data to be exported (2). Here you
|
|
can exclude individual records or manually make them editable, if
|
|
supported.
|
|
|
|
If the relation to records is lost, an orange exclamation mark will be
|
|
shown. This happens if records are stored outside the export page tree
|
|
or if excluded tables break relations.
|
|
|
|
Apply your changes by pressing the :guilabel:`Update` button and repeat
|
|
this step as needed until the preview matches your expectations (3).
|
|
|
|
Then switch to the :guilabel:`Advanced Options` tab (4).
|
|
|
|
.. include:: /Images/AutomaticScreenshots/CheckExport.rst.txt
|
|
|
|
.. _export-advanced-options:
|
|
|
|
Optionally select advanced export options
|
|
=========================================
|
|
|
|
In the third tab of the export module you can specify further export
|
|
options (1).
|
|
|
|
Checking :guilabel:`Save files in extra folder ..` saves linked files
|
|
in a separate folder instead of embedding them in the export file. This
|
|
is mandatory for :ref:`distributions <t3coreapi:distribution>` or
|
|
useful when handling large file sets that would otherwise bloat the
|
|
export file and potentially exhaust memory. The folder is named
|
|
"{filename}.files".
|
|
|
|
Apply your changes via the :guilabel:`Update` button (2) and then switch
|
|
to the :guilabel:`File & Preset` tab (3) to proceed.
|
|
|
|
.. include:: /Images/AutomaticScreenshots/SelectAdvancedExportOptions.rst.txt
|
|
|
|
.. _export-perform:
|
|
|
|
Perform the export
|
|
==================
|
|
|
|
In the second tab of the export module you can specify the metadata for
|
|
the export (1) before starting the export process.
|
|
|
|
You can then either:
|
|
|
|
- Download the export file (2.a), or
|
|
- Save it on the server (2.b).
|
|
|
|
Saving on the server is currently required if you have enabled saving
|
|
related files in a separate folder (see
|
|
:ref:`export-advanced-options`).
|
|
|
|
.. include:: /Images/AutomaticScreenshots/DownloadExport.rst.txt
|