.. include:: /Includes.rst.txt .. _export: ====== Export ====== The export functionality is only available for admin users and Backend users for which the Page TSconfig option :ref:`options.impexp.enableExportForNonAdminUser ` has been enabled. .. attention:: The export functionality has the following security drawbacks: * Export for editors is not limited on field level * The "Save to filename" functionality saves to a shared folder, which other editors with different access rights may have access to. Thus, permissions should be handed out restrictively. .. rst-class:: bignums 1. Go to 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 2. Configure the export 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 also included - even if they are outside the pages selected for export. Under :guilabel:`Use static relations for tables` you select which relations of the records should be included in the export file - 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 :guilabel:`Include relations to tables` and :guilabel:`Use static relations for tables`, the relation is treated as static. The :guilabel:`Exclude disabled elements` checkbox means, when checked, that these records are excluded from export which are disabled according to their TCA configuration, e.g. by the "disabled", "starttime" or "endtime" fields. It is marked by default. Apply your changes via the :guilabel:`Update` button and repeat this step until the preview matches your expectations. .. include:: /Images/AutomaticScreenshots/ConfigureExport.rst.txt 3. Check the included records All pages selected for export are listed in the upper part of the dialog (1). Below the dialog is a detailed list of all data to be exported (2). Here it is possible to exclude individual records. For some data types it is possible to make them editable manually. If the relation to records is lost, this is marked with an orange exclamation mark. Reasons for lost relations include records stored outside the page tree to be exported and excluded tables. Apply your changes by pressing the :guilabel:`Update` button and repeat this step until the preview is as you want it (3). Then switch to the :guilabel:`Advanced Options` tab (4). .. include:: /Images/AutomaticScreenshots/CheckExport.rst.txt 4. 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 ..` means that files linked in records will be saved in a separate folder instead of being included directly in the export file. This is mandatory for use in :ref:`distributions` or when there are a large number of files that would otherwise bloat the export file and exhaust memory. The folder name pattern is "{filename}.files". Apply your changes by hitting the :guilabel:`Update` button (2) and switch to tab :guilabel:`File & Preset` (3) to start the export process. .. include:: /Images/AutomaticScreenshots/SelectAdvancedExportOptions.rst.txt 5. Perform the export In the second tab of the export module you can specify the metadata of the export (1) before starting the export process. You can download the export file (2.a) or save it on your server (2.b). Currently it is necessary to choose saving on the server if the export is configured to save related files in a separate folder (see "Optionally select advanced export options" step). .. include:: /Images/AutomaticScreenshots/DownloadExport.rst.txt