XMLParse Function User Guide v1

7/29/2019 XMLParse Function User Guide v1

1/15

XMLPARSE FUNCTION FOR INFORMATICA POWERCENTER

USER /DEVELOPER GUIDE

8.6.1 Release

Version 2010.06.31.01


2/15

XMLParse Function for Informatica PowerCenter User / Developer Guide

Copyright 2010 FyghtSoft, LLC All Rights Reserved Page 2

ABOUT FYGHTSOFT

FYGHTSOFT PRODUCTS

Our products are created out of real world necessity and based on best business practices. Each of our products aims

to solve a business or integration problem that existed at one or more of our current or previous clients. Our products

are field tested and battle ready. In order to keep our solutions fresh and products relevant we continually ask our

clients and potential buyers of our products to tell us about their integration issues. If you have an idea for a product

or an existing integration issue, let us know. Our products are designed to help.

COPYRIGHT

All rights and ownership of FyghtSoft products are reserved by FyghtSoft, LLC.

LIMIT OF LIABILITY /DISCLAIMER

While every precaution has been taken in the preparation of this article, the publisher and author assume no

responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.

TRADEMARKS

Designations used by companies to distinguish their products are often claimed as trademarks or registered

trademarks. In all instances in which FyghtSoft is aware of such claim, the product names appear in initial capital or all

capital letters. Readers, however, should contact the appropriate companies for more complete information regarding

trademarks and registration.

WEBSITE

http://www.fyghtsoft.com

SALES &SUPPORT

If you have any questions regarding the purchase of this product or require additional product licenses, please contact

our sales office, Monday-Friday from 9am 4pm EST at 704-904-3667 or [email protected].

If you have technical issues or need to report a problem with the software please log the issue on our support forum

at http://www.fyghtsoft.com/forums/.

PARTNERS

FyghtSoft maintains relationships with several organizations, however, mention of any organization within this

document does not construe entitlement, relationship, partnership, ownership, or management of any entity unless

otherwise explicitly stated.
mailto:[email protected]:[email protected]://www.fyghtsoft.com/forums/http://www.fyghtsoft.com/forums/http://www.fyghtsoft.com/forums/mailto:[email protected]


3/15



Table of Contents

About FyghtSoft .......................................................................................................................................................... 2

Getting Started with Development/Usage ................................................................................................................... 4

Introduction ............................................................................................................................................................ 4

Overview ................................................................................................................................................................. 4

License Granted ....................................................................................................................................................... 4

Pre-Requisites ......................................................................................................................................................... 4

XMLParse Function Breakdown ................................................................................................................................... 6

Overview ................................................................................................................................................................. 6

References .............................................................................................................................................................. 6

Conclusion ............................................................................................................................................................... 6

XMLParse Function Syntax ........................................................................................................................................... 7

Overview ................................................................................................................................................................. 7

Example XML Document .......................................................................................................................................... 7

XMLParse XPath Syntax ........................................................................................................................................... 8

Disclaimer ............................................................................................................................................................... 9

Conclusion ............................................................................................................................................................... 9

Demo Quickstart ....................................................................................................................................................... 10

Using the XMLParse Custom Function ........................................................................................................................ 10

Setting up the Demo Environment ......................................................................................................................... 10

Further Understanding .......................................................................................................................................... 15

Conclusion ............................................................................................................................................................. 15


4/15



GETTING STARTED WITH DEVELOPMENT/USAGE

INTRODUCTIONThe FyghtSoft XMLParse function for Informatica PowerCenter integrates seamlessly into the Informatica Designer

client tool and Informatica Server. You will take advantage of a familiar set-up when using this product - now you just

have a little bit more power as an Informatica PowerCenter developer. The XMLParse function solves a serious

development need of moving data from an XML Document string/file stored in a database table. The XMLParse

function can really be stated as an XPath function in that it uses XPath statements to retrieve the elements and data

within and XML document that are sought.

Unlike existing solutions that only allow parsing of XML data as it exists on the File System, the XMLParse function is

dynamic, provides immediate integration into transformation design and existing workflows. Finally, a solution exists

to leverage the XML data stored relationally.

OVERVIEW

The XMLParse Function is a key integration function developed as a custom extension for Informatica PowerCenter

transformations. Usage of the function is limited only to the creative solution imagination of the end users; however

a sample mapping and data source are provided to test the function immediately upon your installation of the

product.

This document provides a basic to advanced look at using the XMLParse function. It briefly tours through the steps

needed to run the demo included with the product and shows syntax related to proper operation of the function. As

you read through the document, if some information is vague or you simply need more information on this product,

please visit our community forums at http://www.fyghtsoft.com/index.php/support and send us an email [email protected].

LICENSE GRANTED

Purchase of this product entitles your organization to a single (1) Informatica PowerCenter production server

Repository Service license. If you have more than one Informatica PowerCenter Repository Service which will

utilize this product, you will need to purchase additional products/licenses to satisfy each instance. Please contact our

Sales department ([email protected]) as volume pricing is available. If you have any questions regarding your

license or any compliance thereto, please contact our sales department.

PRE-REQUISITESAs a pre-cursor to reading and utilizing this guide, one should have read and completed the installation of the

FyghtSoft Premier Function Toolbox into the Informatica server and client environments. Please reference the

Installation Guide included with this product download for this information.
http://www.fyghtsoft.com/index.php/supporthttp://www.fyghtsoft.com/index.php/supporthttp://www.fyghtsoft.com/index.php/support


5/15



In addition, as a developer, one will need developer level access to Informatica PowerCenter Designer and the

repository under which the Premier Function Toolbox plug-ins were installed. Please confer with the Informatica

administrator if necessary to attain this information.


6/15



XMLPARSE FUNCTION BREAKDOWN

OVERVIEWThe Informatica PowerCenter Premier Functions Toolbox extends the existing transformation expression functions in a

myriad of ways. Some of these are minor while others provide major functionality that reduces development time

and thus cost. The Premier Functions Toolbox also eliminates the need for development of code outside of the

Informatica development environment to be performed. Below is a summary breakdown of each function included in

the Premier Functions Toolbox. Please see the accompanying demo included with the product download and/or the

video demo found in the resources section of our website.

Function Name

XMLParse Arguments 3

XMLParse(XMLDoc, Default Value, XPath Statement)

Returns String (Max 4000 characters)

Description Using XML and XPath technology the XMLParse function takes 3

parameters and returns a scalar value as the XPath query result.

The XPath syntax is similar to the base XPath syntax with minor

adjustments in order to retrieve scalar values accurately within

Informatica PowerCenter.

REFERENCES

For this and more information regarding some technical definitions of functionality provided within the XMLParse

function please reference the following:

XPath:o http://www.w3.org/TR/xpath/o http://www.w3schools.com/xpath/default.asp

http://www.w3schools.com/xpath/xpath_syntax.asp

CONCLUSION

The above breakdown of each function provides an immediate syntactical reference and brief understanding for the

overall capabilities of this product. Importing and running the demo included with this product is highly recommended

in order to see how the functions operate. Please also reference the quickstart videos and guides from

http://www.fyghtsoft.com/index.php/resources.
http://www.w3.org/TR/xpath/http://www.w3schools.com/xpath/default.asphttp://www.w3schools.com/xpath/xpath_syntax.asphttp://www.fyghtsoft.com/index.php/resourceshttp://www.fyghtsoft.com/index.php/resourceshttp://www.fyghtsoft.com/index.php/resourceshttp://www.w3schools.com/xpath/xpath_syntax.asphttp://www.w3schools.com/xpath/default.asphttp://www.w3.org/TR/xpath/


7/15



XMLPARSE FUNCTION SYNTAX

OVERVIEWThe syntax used for the XPath argument required by the XMLParse function is basically core XPath with a few

modifications. Since the XMLParse function can only return a scalar/single value, the XPath syntax is best utilized

when requiring a single value from an element or attribute of a single node. Although the XMLParse function will

accept core XPath syntax an error is most likely to occur if attempts are made to pull back all values of a sub-element

or use similar non-scalar XPath logic.

In this section, many of the useful XPath syntax examples are provided based on real-world usage and the demo

provided with the product. Clearly, attempts to parse your relation XML documents will vary in path structure but the

syntax will be very similar in object/element retrieval.

EXAMPLE XMLDOCUMENTThe XML document seen here is the XML document used as an example for the XPath syntax shown within this

section.


8/15



XMLPARSE XPATH SYNTAX

The items below are desired for retrieval along with the modified XMLParse XPath logic used to retrieve the respective

item information from the above XML Document. Please note that all syntax must stem from the core level of the

XML Document. This is consistently shown in the examples below.

Basic Syntax Matrix

Description Example

Text()

Retrieves the value of any position

declared in the XPath syntax /purchaseOrder/shipTo/name/text()

Attribute Locates an attribute within an element to

provide the desired value

/purchaseOrder/billTo/@country


9/15



Node by # Select a specific node by position within a

parent node

/purchaseOrder/item/items[2]/productName/text()

DISCLAIMER

This product is only officially certified to retrieve scalar/single value using the text() retrieve method at the end of the

XPath statement. This has been tested on multiple platforms and varying XML documents without issue.

Furthermore, the XPath syntax for attributes using the @ symbol has been certified for use as well. An example of

each of these is shown in the matrix above.

CONCLUSION

The above breakdown of each function provides an immediate syntactical reference and brief understanding for theoverall capabilities of this product. There are very few caveats inherent within this custom functions product and we

sought to highlight those items in this section. Importing and running the demo included with this product is highly

recommended in order to see how the functions operate. Please also reference the quickstart section of this guide or

visit other support resource from our website at http://www.fyghtsoft.com/index.php/resources.
http://www.fyghtsoft.com/index.php/resourceshttp://www.fyghtsoft.com/index.php/resourceshttp://www.fyghtsoft.com/index.php/resources


10/15



DEMO QUICKSTARTSeveral quickstart videos have been produced to educate developers on usage of this product. The quickstart videos

are not a replacement for the core documentation found here and within the product directory. The quickstart videoscan be found on the FyghtSoft website at http://www.fyghtsoft.com/index.php/resources.

USING THE XMLPARSE CUSTOM FUNCTIONIf the XMLParse custom function was installed correctly following by installation guide (see /_Docs/ directory) each

developer workstation with the Informatica PowerCenter client tools will see a folder for FyghtSoft within the

transformation editor in PowerCenter Designer. Under this folder will reside the XMLParse function object. Behind

the scenes the Informatica administrator will have installed the XMLParse binaries on the Integration Services server

as well. The steps outlined below provide a quickstart on using the XMLParse function. The quickstart is based on

demo data and Informatica PowerCenter mappings created by FyghtSoft in order to ramp up developers.

SETTING UP THE DEMO ENVIRONMENT

1. Locate the extract directory for this products main zip file.

2. The demo that was created for this quickstart is for an Oracle RDBMS. You may convert the SQL to anotherdatabase if desired, but this quickstart will continue to reference the Oracle RDBMS.

Open your favorite RDBMS GUI Editor (SQL*Plus, SQLDeveloper, etc.). Navigate to the folder path

/Demo/SQL/ORCL/. Execute the script, Demo_InstallX.sql.

NOTE: An existing database scheme is expected when running the script. Typically for demo purposes our

team utilizes the HR schema. Please contact your RDBMS administrator if you are not familiar with a test

schema available for use.
http://www.fyghtsoft.com/index.php/resourceshttp://www.fyghtsoft.com/index.php/resources


11/15



3. Confirm that your schema now has the following new objects.

4. Open Informatica PowerCenter Repository Manager.5. Connect to a Repository Service that will be used for this demo purpose. The next step requires an importing

of objects into a Repository Service. If a demo folder already exists for your testing purposes then you may

use it. Otherwise, choose Folder > Create from the menu bar to create a new folder called Demo.


12/15



6. From the menu bar choose Repository > Import Objects7. On the Import Objects wizard, click the Browse button and navigate to the /Demo/Informatica_Objects/

path under the extract product folder. Select the .XML file.

Click Next.

8. Select Add All from the Import Objects step. Click Next.


13/15



9. Choose the folder name you determined in Step 5 above.

10. Determine any conflict resolutions and complete the import utility.


14/15



Click Import.

Click Done.

11. Open Workflow Manager.12. Modify your connection to ensure that you have a connection that references the database schema under

which you executed the script in Step 2 above.


15/15



Be sure that in the workflow you assign the connection to the session appropriately.

13. You should now be able to successfully run the demo workflow. Execute the workflow and once completed(use Workflow Monitor to view completion), in your favorite GUI IDE, run any of the queries from the script

XMLParse_Queries.sql found in the /Demo/SQL/ORCL/ folder of the extracted product.

FURTHER UNDERSTANDING

As detailed above, the XMLParse custom function is based on XPath syntax. Although the demo provides several

examples of how the XMLParser function may be used in a real-world situation, there may be several other uses for

the function not provided in the quickstart demo. Further understanding may be accomplished by unit testing the

function. If there are any issues, please contact the FyghtSoft support team.

CONCLUSION

The above function is unique to Informatica PowerCenter in that FyghtSoft is adding some new approaches to the way

that transformation expressions have been utilized in the past. FyghtSoft aims to continue the education of our

customers about our products so that ease of use and transparency exists. If there are any questions, comments, or

concerns please express these through our forums at http://www.fyghtsoft.com/forums/so that other users may also

share in discovery and solutions.
http://www.fyghtsoft.com/forums/http://www.fyghtsoft.com/forums/http://www.fyghtsoft.com/forums/

XMLParse Function User Guide v1

Documents

Transcript of XMLParse Function User Guide v1