Function documentationExport Manager

 

You use this function to export configured metadata, called as entities, from a source system to an export data file. You can then import the metadata from the export data file to other systems.

You can export entities using the Search or Load from File functions in the Export-Import/Export Manager tile set of Mobile System Maintenance (MSY).

Advanced users can load the entities for export directly from SQL Manager.

For more information, see Export Management for Advanced Users.

Prerequisites

Export Entity Types

What You Should Know

Choice Fields

  • You have created a choice field using the Choice Fields tile set of the Cross-Component Settings component in MSY.

    For more information, see Choice Field Overview.

  • You have exported the parent of the choice field from the choice field hierarchy to the target system.

    Note Note

    Choice fields of the type System entry are not modifiable. Such fields can be exported but cannot be imported.

    End of the note.

    For more information, see Creating and Changing Choice Fields.

Relationship Category

  • You have created a relationship category using the Relationship Category tile set of the Cross-Component Settings component in MSY.

    For more information, see Relationship Category.

    Relationship categories of the type System entry can be exported but cannot be imported. For more information, see Relationship Category Maintenance.

Reports

  • You have created a report using the Report Maintenance component in MSY.

    For more information, see Report Maintenance.

  • If you have created a super report, then you must export the subreport to the target system before exporting the super report.

  • If the source of data for a report is a business content provider, then you must export the business content provider before exporting the report.

Advanced Selection

  • You have created an advanced selection using the Advanced Selection component in MSY.

    For more information, see Advanced Selection Workflow.

  • If you have modified an advanced selection criterion, then you need to export only the modified advanced selection criteria and not the entire advanced selection. The export function takes care of exporting the entire criteria hierarchy.

    For more information about advanced selection, see Advanced Selection.

Document Layouts

  • You have created a document layout using the Document Generation component in MSY.

    For more information, see Document Generation.

  • You have exported the elements of the document layout before exporting the document layout.

    Note Note

    Elements that are reused across layouts require only a one-time export.

    End of the note.

    For more information about elements, see Document Generation Workflow.

    Note Note

    If you have not exported the elements of the document layout to the target system, the import may be successful. During runtime, however, the layout may not function as required.

    End of the note.

Charts

  • You have designed a chart using the Charts component in MSY.

    For more information, see Charts.

  • If the source of data for the chart is a business content provider, then you must export the business content provider before exporting the chart.

    Note Note

    Charts of the type System entry are not modifiable. Such charts can be exported but cannot be imported.

    End of the note.

Features

  • You can search for entities based on the entity type.

  • You can select specific entities for export from the export entity list and include them in the export basket.

    Note Note

    You can select multiple entities, such as reports, choice fields, or advanced selections for export.

    End of the note.
  • The export basket contains a list of entities that you have selected for export. From this list, you can perform the following functions:

    • You can choose the export operation that you want to perform for an entity:

      • Insert/Update:

        The system triggers an insertion when it detects that the entity does not exist in the target system.

        The system triggers an update when it detects a difference between the entity being imported and the entity that exists in the target system.

        Example Example

        A report in your source system has two parameters, X and Y, and you have recently added another parameter, Z. The same report in the target system has only two parameters, X and Y. In such a case, the system triggers an update operation for this report.

        End of the example.
      • Delete: The system triggers a deletion. Deleting occurs only at the parent level.

        Note Note

        You can delete subdata for an entity only when you import the data into the target system, using Import Manager.

        End of the note.
    • You can save the entities in your export basket to a text file, so that you can export the data at a later time

    • You can load entities from a text file to the export basket.

    • You can generate the export data file (.car file) by choosing Export Entity Basket. The Export Import Process Status Viewer allows you to view selected details of the log or view the entire log. This log provides information about the success or failure of the export process.

      Caution Caution

      Do not change the name of the export data file after it is created.

      If you change the name of the file, you cannot import the entities into the target system.

      End of the caution.
  • You can perform the export by referring to another export data file (.car file). You use this function when you want to export only a few changes that are done with reference to the previously exported data file.

    When you export the entities, the export process checks whether the entities in the Export Entity Basket have changed with respect to the referenced export data file. Only the differences between the current state in the SQL database on your PC and the referenced export data file are exported to the new .car file.