You are on page 1of 16

XML Source

User Guide

2013 Informatica Corporation. No part of this document may be reproduced or transmitted in any form, by any means
(electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. All other company and
product names may be trade names or trademarks of their respective owners and/or copyrighted materials of such
owners.

Abstract
XML Source user guide provides a brief introduction on cloud connectors and its features.
The guide provides detailed information on setting up the XML source connector and running
data synchronization tasks (DSS). A brief overview of supported features and task operations that
can be performed using XML Source connector is mentioned.

Table of Contents
Overview .......................................................................................................................................... 3
XML Source Connector ................................................................................................................... 3
Supported Objects and Task Operations ........................................................................................ 4
Enabling XML Source Connector .................................................................................................... 4
Creating a XML Source Connection ................................................................................................ 4
How XML Source Connector Works ................................................................................................ 6
Creating a XML Source Data Synchronization Task ..................................................................... 10
Increasing Heap Size to Execute Bigger XML Files ...................................................................... 13
Guidelines for XML Source Connections ...................................................................................... 16
Big Split Feature......................................................................................................................... 16

Overview
Informatica cloud connector SDKs are off-cycle, off release add-ins that provide data integration
to SaaS and on-premise applications, which are not supported natively by Informatica cloud. The
cloud connectors are specifically designed to address most common use cases such as moving
data into cloud and retrieving data from cloud for individual application.

Figure 1. Informatica Cloud Architecture


Once the XML Source cloud connector is enabled for your ORG Id, you need to create a
connection in Informatica cloud to access the connector.

XML Source Connector


The XML Source connector effectively parses the data within the document. By providing multiple
source support functionality, the connector offers flexibility to attach child with parent in single
Data Synchronization Task (DSS).

Supported Objects and Task Operations


The following table provides the list of supported objects and operations by XML source
connector.

Objects

Source

XML

Target

Query

NA

Insert

Update

Delete

Upsert

Look
Up

NA

NA

NA

NA

NA

Remarks:
The following multiple source are supported
- Parent-Child
- Sibling
: Supported
NA : Not Applicable

Enabling XML Source Connector


To enable XML Source connector, contact Informatica support or Informatica representative. It
usually takes 15 minutes for the connector to download to secure agent, after it is enabled.
Note: To install secure agent, see Installing Informatica Secure Agent.

Creating a XML Source Connection


To use XML source connector in data synchronization task, you must create a connection in
Informatica Cloud.
The following steps help you to create XML Source connection in Informatica Cloud.
1. In Informatica Cloud home page, click Configure.
2. The drop-down menu appears, select Connections.
3. The Connections page appears.
4. Click New to create a connection.
5. The New Connection page appears.

Figure 2. Creating a Connection


6. Specify the following details.

Connection Property

Description

Connection Name

Enter a unique name for the connection.

Description

Provide a relevant description for the connection.

Type

Select XML source from the list.

Secure Agent

Select the appropriate secure agent from the list

Sample XML File Name

Enter the required XML file path (Mandatory). See Also Big
Split Feature.

Sample XSD Schema


Name

Enter the required XSD file path.

7. Click Ok to save the connection.


Note: It is recommended to test the connection before saving it. Click Test to evaluate the
connection.

How XML Source Connector Works


The XML source connector works on the simple principle of organizing the elements into
tables/fields. The unbound elements are segregated and considered as separate tables.
Let us consider the sample XML file of Customer Account/Address details to explain how a XML
source connector works.
The following figure is a sample XML file of Customer Account/Address details.

Figure 3. How a XML Source Connector works

Figure 4. How a XML Source Connector Works

Table-1: Table CustomerAccountSummary_Customers_Customer with XPath


/CustomerAccountSummary/Customers/Customer
Table-2: Table Accounts_Account with XPath
CustomerAccountSummary_Customers_Customer_Accounts_Account
Table-3: Table Accounts_Account_PhoneNumbers_Phone with XPath
/CustomerAccountSummary/Customers/Customer/Accounts/Account/PhoneNumbers/Phone
Table-4: Accounts_Account_Addresses_Address with XPath
/CustomerAccountSummary/Customers/Customer/Accounts/Account/Addresses/Address
Note: Any bound element to the former element becomes the child element of the former
element.
For example,
- Phone numbers is the child element of Accounts.
- Accounts is the child element of customers.
Note: All simple and attribute elements are considered as fields. Complex elements are not
considered as fields to the table.
The following figure displays the option to see tables in cloud source

Figure 5. Option to Display Tables in Cloud Source

The following figure depicts the relations between different tables.


-

Table-1 and Table-2 has a parent-child relation.


Table-2 is parent to Table-3 and Table-4.

Figure 6. Relationship between Tables


The following figure depicts the sibling relation between tables.
-

Table-3 is sibling to Table-4

Figure 7. Relationship between Tables

Creating a XML Source Data Synchronization Task


Note: You need to create a connection before getting started with data synchronization task.
The following steps help you to setup a data synchronization task in Informatica Cloud.
Let us consider the task operation Insert to perform the Data synchronization task.
1. In Informatica Cloud home page, click Apps.
2. The drop-down menu appears, select Data Synchronization.
3. The Data Synchronization page appears.
4. Click New to create a data synchronization task.
5. The Definition tab appears.

Figure 8. Definition Tab


6. Specify the Task Name, provide a Description and select the Task Operation Insert.
7. Click Next.
8. The Source tab appears.

10

Figure 9. Source Tab


9. Select the source Connection, Source Type and Source Object to be used for the task.
Note: Source Object corresponds to tables present in the sample XML file used for creating a
connection.
10. Click Next.
11. The Target tab appears. Select the target Connection and Target Object required for the
task.
Note: In the above considered task operation Target object is a flat file/CSV file.

11

Figure 10. Target Tab


Note: To create a new target, click Create Target.
Note: The Target Object file will contain the tables selected in the source object.
12. Click Next.
13. In Data Filters tab by default, Process all rows is chosen.
14. Click Next.
15. In Field Mapping tab, map source fields to target fields accordingly.

Figure 11. Field Mapping

12

16. Click Next.


17. The Schedule tab appears.
18. In Schedule tab, you can schedule the task as per the requirement and save.
19. If you do not want schedule the task, click Save and Run the task.

Figure 12. Save and Run Task


After you Save and Run the task, you will be redirected to monitor log page. In monitor log page,
you can monitor the status of data synchronization tasks.

Increasing Heap Size to Execute Bigger XML Files


When you want to setup data synchronization task for XML files (>10MB size), you need to
increase the JAVA heap size in associated secure agents for active instances.
The following procedure helps you to increase Java heap size.
1. At first, shutdown the secure agent and then proceed to configure the heap size.
2. Login to Informatica Cloud environment using admin credentials.
3. In Informatica Cloud home page, click Configuration.
4. Select Secure Agent.
5. The following screen appears.

13

Figure 13. Increasing Heap Size-1


6. Click pencil icon of the secure agent, for which you want to increase heap size.
7. The following screen appears, in Type field, select TOMCAT JRE from the drop-down list.

Figure 14. Increasing Heap Size-2

14

8. Click pencil icon corresponding to INFA_Memory to edit. The default value of Xms32mXmx256m needs to be edited to Xms256m-Xmx512m or more according to the
requirement.
9. Click Ok to save changes.
10. In the same page, in Type field, select DTM from the drop-down list.
11. The following options appear, Click pencil icon corresponding to JVM_Option 1 to edit.
Mention the value as Xmx512m or more according to the requirement.

Figure 15. Increasing Heap Size-3


12. Click Ok to save changes
13. Restart the secure agent.
You have successfully increased the heap size of the required secure agent.

15

Guidelines for XML Source Connections


The following guidelines help you to use XML source connections effectively.

The XML file must have a valid XSD (XML schema directory).
The XML file must not contain the path of DTD or XSD files.
The XML file must not have references pertaining to other XML files.
The XML file must not contain any name spaces with the root element.
It is not suggested to run the same data synchronization task repeatedly, as it will create
duplicate XML records.
It is strongly recommended to use XML file for the XSD schema path in connection.
When the XSD (XML Schema) file signifies the namespace that needs to be present in XML
file, then avoid using schema file for metedata parsing.

Big Split Feature


When you have a XML file of large size, the big split feature helps you to divide the large XML file
into many smaller files. By splitting the large XML file, you can parse the files without facing any
memory constraints. See Creating a XML Source Connection.
While creating a connection mention the XML File path along with split tag. For example,
C:\MyWorkspace\XML.xml;splitTag=<Patient>.
Note: The big spilt feature can be implemented only when you have XML file size greater than
100MB.
Note: splittag is the 1st unbound element from root node (for a given schema).

16

You might also like