export

The export task exports resource, translator, and language definitions to an Ant build script. The build script that is created by the export can be run on the same Engineering Workflow Management system as a backup mechanism to restore system definitions or on a different Engineering Workflow Management system as a mechanism to transfer system definitions from one system to another.

When you run the build script on the same system after you deleted system definitions, or on a new system, a new set of system definitions is created. These new system definitions have the same attributes as the original system definitions but they have different universally unique identifiers (UUIDs). You must associate your files and folders with these new system definitions by running the resolveMetadata task in each SCM project that contains Enterprise Extensions source control.

The following table describes the task attributes.

Attribute Description Required
file The fully qualified path to a build script file that is used as the output.

Yes
global The range of system definitions to export.

If the value of this attribute is set to true, all the readable system definitions in one or more project areas are exported.

If the value of this attribute is set to false (default value), only the system definitions in the current project area are exported.

No
Notes:
  • This task must be run in an Eclipse environment.
  • The init task of the Enterprise Extensions System Definition Toolkit must be run before the export task. The init task needs to be run once per session, not repeatedly between other System Definition tasks.
  • The export task can be accessed through the Build Extensions Toolkit namespace by defining that namespace in the project element and by calling the loadBuildExtensions task to register participating Engineering Workflow Management and Enterprise Extensions Ant tasks and types under the Build Extensions Toolkit namespace.
    For example, you can enter the following code:
    <project
    default="main"
    name="export"
    xmlns:xt="antlib:com.ibm.team.build.extensions.toolkit">
    
    <xt:loadBuildExtensions/>
    
    <target name="main">
        
        <xt:export   …   />
        
    </target>
<project>

Example

You can enter the following code to export the system definitions to the specified file:


<target name="export" description="Export system definitions">
    <xt:export file="C:/tmp/export.xml"/>
</target>