Export portal

You can export portals manually via the "Start" module or automatically via the "Tools" module.

When exporting automatically, you can configure a number of additional options. This includes defining the export time or an export cycle if you want to carry out an export regularly. In addition, you can automatically trigger further follow-up orders during automatic export.

Export portal manually

Step-by-step guide

To export a portal manually, proceed as follows:

  1. Launch the portal you want to export.

  2. Click on "Start > Export portal..."

    The "Export portal..." dialog box is displayed.

    Template name

    Template name This corresponds to the filename used for the export file.

    Display name

    When importing the portal, the display name in the template list (Own) is used.

    Description

    You can provide the portal export with a description here.

    Export directory

    The path where the export file will be saved is shown here.

    Select directory

    Opens a dialog in which a directory can be selected.

    Clear mail configuration

    With this setting, the settings that are set in the current portal in the "Tools" module in the e-mail service are not transferred to the export.

    Overwrite previous export

    With this setting, the last export will be overwritten by the new one.

    Empty certificate store

    With this setting, no certificates are included in the export. Further information on this topic can be found here.

    export ".noexport" directories

    You can exclude directories from the export by placing a ".noexport" file in the corresponding directories.
    If you do not want to exclude directories that contain a .noexport file from the export in certain scenarios, you can do so by activating this checkbox.

    File ".noexport"

    By default, temporary directories in Intrexx contain .noexport files, as these are not required for the portal export or the exported portal.

    If you exclude directories from export yourself with the help of .noexport files, you should document this.

    You can create a .noexport file yourself using an editor.

    You can find a sample file that you can copy in the following directory: <intrexx-installation directory>\orgtempl\blank\internal\tmp

    File ".keep"

    In addition to the ".noexport" file, you can also create a ".keep" file in connection with the portal export. If you save a .keep file in an empty directory, this will also be exported during the portal export. (Empty directories are not exported by default)

    You can find a sample file that you can copy in the following directory: <intrexx-installation directory>\orgtempl\blank\internal\tmp

    Remove database passwords

    With this setting, the passwords for authentication to the portal database will be reset in the portal export. Logging on to the database will then be possible without a password.

    Number of exports to be retained

    Here you can specify how many portal exports should be retained in total. If this number is exceeded, the oldest export is automatically deleted.

    Skip files from data groups

    With this setting, files from data groups are not included in the export.

    (Detailed information on files in file fields or data groups can be found in section Data fields

    Export format

    Four export formats are available:

    • ZIP archive

    • tar archive

    • tar.gz archive

    • Directory (uncompressed)

    Use speed optimized data format

    With this setting, the XML in the export file is written in a format that can be read more quickly during import.

    Compress database exports

    With this setting, the database export files (.data) are compressed as a gz file (.data.gz). In this way, the database export files require less space in the export directory.

portal.wcf

The portal.wcf file contains central settings that are required for the operation of your portal. It is supplied with Intrexx with default settings. You will find the portal.wcf file in the following location:
<intrexx-installation directory>\org\<portalname>\internal\cfg\.
If necessary, you can make manual changes to the file.

Please note that although the portal.wcf file is exported when exporting a portal, it is imported without any manual changes during a subsequent import. This means that you may have to update the portal.wcf file manually.

Background The portal.wcf file contains system-specific information such as paths or ports that cannot normally be transferred 1:1 from one system to another.

Export portal automatically

Step-by-step guide

To export a portal automatically, proceed as follows:

  1. Start the "Tools" module.

  2. Click on "Export" in the navigation area.

  3. Click on "Configure".

    The "Export configuration" dialog box appears.

    Portal description

    Template name

    Template name This corresponds to the filename used for the export file.

    Display name

    When importing the portal, the display name in the template list (Own) is used.

    Description

    You can provide the portal export with a description here.

    Export directory

    The path where the export file will be saved is shown here.

    Select directory

    Opens a dialog in which a directory can be selected.

    Clear mail configuration

    With this setting, the settings that are set in the current portal in the "Tools" module in the e-mail service are not transferred to the export.

    Overwrite previous export

    With this setting, the last export will be overwritten by the new one.

    Empty certificate store

    With this setting, no certificates are included in the export. Further information on this topic can be found here.

    export ".noexport" directories

    You can exclude directories from the export by placing a ".noexport" file in the corresponding directories.
    If you do not want to exclude directories that contain a .noexport file from the export in certain scenarios, you can do so by activating this checkbox.

    File ".noexport"

    By default, temporary directories in Intrexx contain .noexport files, as these are not required for the portal export or the exported portal.

    If you exclude directories from export yourself with the help of .noexport files, you should document this.

    You can create a .noexport file yourself using an editor.

    You can find a sample file that you can copy in the following directory: <intrexx-installation directory>\orgtempl\blank\internal\tmp

    File ".keep"

    In addition to the ".noexport" file, you can also create a ".keep" file in connection with the portal export. If you save a .keep file in an empty directory, this will also be exported during the portal export. (Empty directories are not exported by default)

    You can find a sample file that you can copy in the following directory: <intrexx-installation directory>\orgtempl\blank\internal\tmp

    Remove database passwords

    With this setting, the passwords for authentication to the portal database will be reset in the portal export. Logging on to the database will then be possible without a password.

    Number of exports to be retained

    Here you can specify how many portal exports should be retained in total. If this number is exceeded, the oldest export is automatically deleted.

    Skip files from data groups

    With this setting, files from data groups are not included in the export.

    (Detailed information on files in file fields or data groups can be found in section Data fields

    Export format

    Four export formats are available:

    • ZIP archive

    • tar archive

    • tar.gz archive

    • Directory (uncompressed)

    Use speed optimized data format

    With this setting, the XML in the export file is written in a format that can be read more quickly during import.

    Compress database exports

    With this setting, the database export files (.data) are compressed as a gz file (.data.gz). In this way, the database export files require less space in the export directory.

  4. Switch to the "Schedule" tab.

    Schedule

    Define the how often the task should be automatically executed.

    Rules for automatic execution

    Any number of rules with differing schedules can be created here. Created rules can be selected and activated individually meaning the task is executed with the corresponding schedule. Create a rule, change the settings (e.g. the time) in the dialog as required and save the rule by selecting another rule or closing the dialog by clicking on "OK".

    Add rule

    Adds a new rule.

    Delete rule

    Deletes the rule currently selected.

    Time frame

    From

    Defines the start of the period. The first time execution is started at the next full hour from the value entered in the "From" field.

    To

    Defines the end of the period.

    Time zone

    Defines the time zone.

    Time

    At

    With this option, a specific time can be entered when the task should be executed.

    Redo

    With the "In the hours / minutes / seconds" settings, a single hour (or minute, second), a list (separated by a comma) or a range (e.g. 8-10) can be entered here using an integer.

    Click on the arrow button to the right of the settings listed here to select the "All" entry. This allows you to define an interval in hours, minutes and seconds relative to the last execution.

    Date

    During the month(s)

    Here, you can enter an integer for a single month, a list (separated by a comma) or a period (e.g. 3-5) to determine in which month(s) the task should be executed. Click on "All" to start the execution every month.

    On specific days of the month

    Corresponds to the "In the months" setting for the day unit.

    Click on the arrow button to the right of the setting to display further options.

    Repeat every

    Enter the desired number of days before the end of the month.

    On specific days of the week

    Define the desired days of the week.

    Days before the end of the month

    Enter the desired number of days before the end of the month.

    Scheduler rule

    The scheduler rule can be entered manually here. Information on the structure of the rules can be found here. The detailed description of the CronTrigger expressions can be found here (CronTrigger class).

    Reset to default rule

    If you click on this button, Intrexx will check the scheduler rule. If Intrexx detects errors, a rule is automatically built, which can be implemented via the input fields in this dialog box. Invalid values in the scheduler rule are discarded.

  5. Switch to the "Execution options" tab.

    Execution options

    Run at server startup when schedule has been missed

    With this setting, task will be executed that have not been carried out while the server was stopped.

    Maximum history length

    The number of entries is limited to the integer entered here.

    Maximum age in the history

    Defines how long the history entries are valid in milliseconds, seconds, minutes, hours or days. The entries in the history are only corrected when a new run takes place.

    Purge successful entries in history

    If you activate this checkbox, only the last successfully completed order will be displayed in the history.

    Email

    An email address can be entered that a message will be sent to as soon as the status, which is selected below, applies.

    As of Status

    You can select the following values:

    • Never

      A message will not be sent.

    • Errors

      Notification is sent in the event of incorrect execution.

    • Warnings

      A message will be sent when warnings are encountered.

    • Always

      A message will always be sent.

  6. Switch to the "Follow-up orders" tab.

    Subsequent jobs

    You can arrange for Intrexx to automatically execute other subsequent jobs after the portal export. Follow-up orders can also be defined in the "Tools" module in task planning when configuring tasks and in the "Integration" module when configuring data transfers.

    Click on the icon to add a new follow-up order.

    You can have follow-up orders executed in "Simple" and "Advanced" mode.

    Simple

    After the actual order, all subsequent orders are executed one after the other.

    Advanced

    Using this option, subsequent jobs can be organized into groups. Orders of the same group are executed simultaneously after the actual order, the groups one after the other.

    Process Event GUID

    A process can be executed once the follow-up orders have been successfully completed. Enter the GUID of the process here.

    Start the following processes even in the event of an error

    If you activate this checkbox, all entered orders are executed, even if one of the orders was canceled due to an error.

  7. Click on "OK" to complete the configuration.

portal.wcf

The portal.wcf file contains central settings that are required for the operation of your portal. It is supplied with Intrexx with default settings. You will find the portal.wcf file in the following location:
<intrexx-installation directory>\org\<portalname>\internal\cfg\.
If necessary, you can make manual changes to the file.

Please note that although the portal.wcf file is exported when exporting a portal, it is imported without any manual changes during a subsequent import. This means that you may have to update the portal.wcf file manually.

Background The portal.wcf file contains system-specific information such as paths or ports that cannot normally be transferred 1:1 from one system to another.

# All tables starting with "CRITICAL_TABLE_"
CRITICAL_TABLE_.*
# Completely ignored tables
[schema+data]
CRITICAL_TABLE

# Export without data
[data]
HUGE_TABLE
GDPR_.*.