Command Reference > infacmd Control Files > Export Control Files
  

Export Control Files

An export control file is an XML file that you use with infacmd commands. The control file filters the objects that infacmd exports from a domain or Model repository.
You can use an export control file with the following commands:
infacmd isp ExportDomainObjects
Exports native users, native groups, roles, and connections from the domain to an export file in XML format. When you specify an export control file for the command, you filter the objects that you want to export. For example, use a control file to export all objects created after a certain date or to export connections but no other object types.
infacmd oie ExportObjects
Exports all Model repository object types from a specified project to an export file in XML format. When you specify an export control file for the command, you filter the objects that you want to export. For example, use a control file to export all objects created by a specific user or to export specific object types in the project.
Infacmd does not export empty folders. When you export Model repository objects, infacmd also exports the dependent objects. A dependent object is an object that is used by another object. Dependent objects can be in the same or different projects.
An export control file uses different parameters based on whether you configure the file to export domain objects or Model repository objects.

Export Control File Parameters for Domain Objects

Use the export control file parameters to configure the objects that you want to export from the domain.
An export control file for domain objects can contain the following elements:
The following table lists the export control file elements that have configurable attributes:
Element
Attribute Name
Attribute Description
objectList
type
Required. Type of domain object to export. Specify one of the following values:
  • - User
  • - Group
  • - Role
  • - Connection
The value is not case sensitive.
objectList
createdBefore
Optional. Date and time. Exports objects of the specified type created before this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
objectList
createdAfter
Optional. Date and time. Exports objects of the specified type created after this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
objectList
lastUpdatedBefore
Optional. Date and time. Exports objects of the specified type updated before this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
objectList
lastUpdatedAfter
Optional. Date and time. Exports objects of the specified type updated after this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
object
name
Required. Name of the object to export. If the containing objectList element includes a time attribute, infacmd exports objects that match both the specified object name and the time filter. The value is not case sensitive.

Export Control File Sample for Domain Objects

The following code shows an example export control file for domain objects:
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<exportParams xmlns="http://www.informatica.com/oie/exportControl/9">

<!-- Export a specific connection. -->
<objectList type="connection" >
<object name="connection1" />
</objectList>

<!-- Export groups created before the specified date and time. -->
<objectList type="group" createdBefore="2010-11-12 10:00:00 +0530" />

<!-- Export role1 and role2 if created after the specified date and time. -->
<objectList type="role" createdAfter="2010-12-25 10:00:00 +0530">
<object name="role1" />
<object name="role2" />
</objectList>

<!-- Export all users. -->
<objectList type="user" />
</exportParams>

Export Control File Parameters for Model Repository Objects

Use the export control file parameters to configure the objects that you want to export from the Model repository.
An export control file for Model repository objects can contain the following elements:
The following table describes the configurable attributes for the folder element in the export control file:
Attribute Name
Attribute Description
path
Optional. Path of the folder that contains the objects you want to export. Use the following format:
"/<folder_name>/<folder_name>"
For example, if a project contains a folder named F1, then the folder path of F1 is "/F1." To export all objects in the project, specify "/." The value is not case sensitive. Default is "/."
recursive
Optional. Indicates whether to export objects from subfolders of the specified folder. Set to true to export from subfolders. Valid values are true and false. The value is case sensitive. Default is true.
select
Optional. Indicates whether infacmd exports all remaining objects in the specified folder when you define an objectList element for the folder. Set to all to export all remaining objects. For example, the following lines export mappings that were created by user1. The lines export all remaining objects in the specified folder:
<folder path="/Testfolder" select="all">
<objectList type="Mapping" createdBy="user1" />
</folder>
If you define an objectList element and do not use the select attribute, then infacmd exports objects that satisfy the attributes defined in objectList. For example, the following lines export mappings that were created by user1 in the specified folder:
<folder path="/Testfolder">
<objectList type="Mapping" createdBy="user1" />
</folder>
If you do not define an objectList element for the folder, then the default value of the select attribute is all. For example, the following line exports all objects in the specified folder:
<folder path="/Testfolder" />
Valid value is all.
createdBy
Optional. User name. Exports objects created by this user. The value is not case sensitive.
createdBefore
Optional. Date and time. Exports objects created before this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
createdAfter
Optional. Date and time. Exports objects created after this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
lastUpdatedBefore
Optional. Date and time. Exports objects updated before this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
lastUpdatedAfter
Optional. Date and time. Exports objects updated after this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
lastUpdatedBy
Optional. User name. Exports objects that were last updated by this user. The value is not case sensitive.
The following table describes the configurable attributes for the objectList element in the export control file:
Attribute Name
Attribute Description
type
Required. Type of Model repository object to export from the specified folder path. Valid values include all object types present in the Model repository. You can view the type of the object in the Properties view in the Developer tool. For example, you can enter "Relational Data Object" or "Profile." The value is not case sensitive.
createdBy
Optional. User name. Exports objects of the specified type created by this user. The value is not case sensitive.
createdBefore
Optional. Date and time. Exports objects of the specified type created before this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
createdAfter
Optional. Date and time. Exports objects of the specified type created after this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
lastUpdatedBefore
Optional. Date and time. Exports objects of the specified type updated before this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
lastUpdatedAfter
Optional. Date and time. Exports objects of the specified type updated after this date and time. Enter the date and time in the following format:
yyyy-MM-dd HH:mm:ssZ
lastUpdatedBy
Optional. User name. Exports objects of the specified type that were last updated by this user. The value is not case sensitive.
The following table describes the configurable attribute for the object element in the export control file:
Attribute Name
Attribute Description
name
Required. Name of the object to export. If the containing objectList element includes a user or time attribute, infacmd exports objects that match both the specified object name and the user or time filter. The value is case sensitive.

Export Control File Sample for Model Repository Objects

The following code shows an example export control file for Model repository objects:
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<exportParams xmlns="http://www.informatica.com/oie/exportControl/9">
<folders>

<!-- Consider exporting all objects in the project. Do not export from subfolders. -->
<folder recursive="false" select="all">

<!-- Export mapping1 if created by the specified user. -->
<objectList type="Mapping" createdBy="user1">
<object name="mapping1"/>
<!-- Export all other mappings. -->
</objectList>

<!-- Export Aggregator transformations created by the specified user. -->
<objectList type="Aggregator" createdBy="user1" />

<!-- Export all remaining objects. -->
</folder>
</folders>
</exportParams>