DeepExport

The method is used to export a complete application structure all at once, i.e. the application entity together with all of its sub entities and its deployment model.

Siehe auch:

• Export - of a single entity
• DeepExport - for the equivalent CLI command

Request

DeepExport

Parameters

• username (String): Name of the user (syntax: system name / client number / user name / department)

  When only one client is installed, the system name is optional.

• password (String): Password of the user specified in username

• mainType (String): must be Application

• customType (optional, String): Name of the main type of the entities to export

  You can only specify custom types based on the main type Application.

  Use this option to export a specific custom type only. If you leave the parameter empty, all custom types will be exported.

• begin (optional, Integer): Index of the entity to begin the export from

  If not set, the export will begin with the first entity (index number of the first entity is 0).

• count (optional, Integer): Number of entities to export

  If not set, all entities are exported.

• startDate (optional, Date): If set, only entities that have been created on that day or after the specified day are considered in the export - otherwise, all entities are considered in the export

• endDate (optional, Date): If set, only entities that have been created until the specified date are considered in the export - otherwise, all entities are considered in the export

• conditions (optional, List): List of conditions to restrict the export

  You can only specify conditions to filter entities of the main type Application. You cannot set conditions for subordinate entities (e.g., workflows).

  You can use a string array of conditions to filter the data. The format of a single condition is: [propertyname] [operator] '[value]'.

  • propertyname: the name of the system or custom property which should be filtered. You can also filter on properties of related entities via the dot notation; e.g. system_owner.system_name eq 'Max' will filter all entities of the given main type, that are owned by Max.
    Note: in conditions only properties of directly related entities can be used. E.g. "system_component.system_application.system_name" is not valid.
  • operator: the operator which should be used for filtering. It can be: eq (equal), neq (not equal), gt (greater than), geq (greater than or equal), lt (lower than), leq (lower than or equal), like (matches a pattern with * as wildcard), unlike (matches a pattern with * as wildcard)
  • 'value': the filter value. It has to be quoted in single quotes. If you filter for something eq '' both empty values and NULL values will be found.

  If multiple conditions are given, all of them are applied (AND).

  Note: If there are multiple properties with the same name but different types (e.g. one is a date and time property, the other a longtext property), the operator will behave as if both properties are a string (e.g. greater or lower than will not work as expected for the date and time property).

All parameters (e.g. startDate or endDate) do affect the selection of the main entities only. They are not applied in the export of their sub entities.

Response

The response contains the result object containing the exported zip file in base64 encoded format. See section Result object on WebService.

Result ZIP File

Deep export validates the input parameters and generates a ZIP file in base64 encoded format that contains a set of the common single entity export files in a predefined file and folder structure, shown in the following example:

1. Application 1
1. All components
2. All component links
3. All deployment target filters
4. Dynamic properties of the application
5. Dynamic properties of the components
6. All workflows
7. All workflow definitions
8. Dynamic properties of the workflow
2. Application 2
1. All components
2. ...
3. Application n
1. ...

In addition to this, a meta file is generated for the deep export and attached to the ZIP file in its root folder. This meta file contains information about the content of the export file, about the included files as well as about the system version with which it was created (see Meta file with information about the export).

ZIP Folder Structure

For each application that gets exported the following folder and file structure is created:

Each single entity export uses the name as identifier of the entity itself and all of its references.

Meta Information File

The meta file Export.xml is a XML file that contains relevant data about the export files and consists of three sections (XML elements):

1. XML element System: Information about the ARA version the export was created with
2. XML element Files: Information about the exported files including their relative paths, listed in the order they need to be imported
3. XML element ExportContext: Information about the main entities that of the export file

System:

Files:

ExportContext:

The context information belongs to the main entities (currently applications only) for which the export was done. For each application the XML element ExportContext is written to the file:

Example

Example of a deep export meta file:

<?xml version="1.0" encoding="utf-8"?>
<DeepExport>
 <System>
   <!-- Application version with which the export was created -->
   <SystemVersion>3.5.168.20601</SystemVersion>
 </System>
 <Files>
   <!-- List of all files in the order they need to be imported --> 
   <File>\Application App1\Application Export Application.xml</File>
   <File>\Application App1\Component Database\Component Database.xml</File>
   <File>\Application App1\Component Database\Component Web App.xml</File>
 </Files>
 <ExportContext>
   <!-- List of all entities the export was performed for. -->
   <Entities>
     <Entity>
       <mainType>Application</mainType>
        <name>Export Application</name>
        <description>Some additional description</description> 
       <createdOn>2012-12-06T11:18:50.4790453+01:00</createdOn>
       <createdBy>2000/API/API</createdBy>
       <lastModifiedOn>2012-12-06T14:14:05.4790453+01:00</lastModifiedOn>
       <lastModifiedBy>2000/API/API</lastModifiedBy>
     </Entity>
   </Entities>
 </ExportContext>
</DeepExport>