com.informatica.powercenter.sdk.mapfwk.core
Class UnionTransformation

java.lang.Object
  extended by com.informatica.powercenter.sdk.mapfwk.core.Table
      extended by com.informatica.powercenter.sdk.mapfwk.core.Transformation
          extended by com.informatica.powercenter.sdk.mapfwk.core.UnionTransformation
All Implemented Interfaces:
Transform

public class UnionTransformation
extends Transformation

This class implements the Union Transformation. It extends the base Transformation to provide this functionality.

The Union transformation is a multiple input group transformation that you can use to merge data from multiple pipelines or pipeline branches into one pipeline branch.

The Union transformation is created using set of InputSets and a RowSet. The RowSet is a group ports used in Union Transformation. The apply method validates each InputSet with RowSet (group ports). It checks the number of fields in InputSet and it get compared with RowSet and also checks each field's datatype, scale and precision. It throws InvalidTransformationException if it doesn't match.

The snippet code shows how to create the Union Transformation,

          //create a Union Transformation using the constructor given below: 
          Mapping mapping = ...; // mapping to which the transform should be added
          Vector inputSets = ...; // collection of InputSet objects
          RowSet groupFieldSet = ...; // RowSet of group field object
          TransformationProperties props = ...; // properties           
          UnionTransformation unionTrans = new UnionTransformation
                              ( "UnionTrans", "UnionTrans", 
                                                  "This is Union Transformation", "UnionTrans", 
                                                  mapping, inputSets, groupFieldSet, props);
          
          //apply the transformation
          OutputSet outputSet = unionTrans.apply();
          
          //get the first rowset as Union Transformation always returns a RowSet
          RowSet outRowSet = (RowSet)outputSet.getRowSets().get(0); 
 


Field Summary
 
Fields inherited from class com.informatica.powercenter.sdk.mapfwk.core.Transformation
m_templateID, m_templateName, m_transformFieldAttr, sessionTransformInst
 
Fields inherited from class com.informatica.powercenter.sdk.mapfwk.core.Table
m_bReusable, m_readOnly
 
Constructor Summary
UnionTransformation()
          Default Constructor
UnionTransformation(java.lang.String name, java.lang.String busName, java.lang.String desc, java.lang.String instName)
          Initialize the object with name, business name, description and instance name.
UnionTransformation(java.lang.String name, java.lang.String busName, java.lang.String desc, java.lang.String instName, Mapping mapping, java.util.Vector inputSets, RowSet groupFieldSet, TransformationProperties properties)
          Constructor for Union Transformation
 
Method Summary
 OutputSet apply()
          Apply the Transformation.
 
Methods inherited from class com.informatica.powercenter.sdk.mapfwk.core.Transformation
add, addInitProp, defaultDuplicateNameRemovalSchema, genOutputSet, getGroupSet, getInitProps, getMapping, getOutFields, getOutputSet, getProperties, getSessionTransformInstanceKeySet, getSessionTransformInstanceProperty, getTemplateID, getTemplateName, getTransContext, getTransformationFieldAttr, getTransformationType, getTransformGroup, setGroupSet, setGroupSet, setMapping, setOutFields, setOutputSet, setReusable, setSessionTransformInstanceProperty, setTemplateIDAndName, setTransContext, setTransformationFieldAttr, setTransformationType, setTransformGroup, standardizeString
 
Methods inherited from class com.informatica.powercenter.sdk.mapfwk.core.Table
addField, addMetaExtension, getBusinessName, getDescription, getField, getFields, getInstanceName, getMetaExtensions, getName, getReferencedField, isReadOnly, isReusable, removeField, removeMetaExtension, setBusinessName, setDescription, setFields, setInstanceName, setMetaExtensions, setMetaExtensionValue, setName, setReadOnly
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

UnionTransformation

public UnionTransformation()
Default Constructor


UnionTransformation

public UnionTransformation(java.lang.String name,
                           java.lang.String busName,
                           java.lang.String desc,
                           java.lang.String instName)
Initialize the object with name, business name, description and instance name.

Parameters:
name - name of the table
busName - business name
desc - description
instName - instance name

UnionTransformation

public UnionTransformation(java.lang.String name,
                           java.lang.String busName,
                           java.lang.String desc,
                           java.lang.String instName,
                           Mapping mapping,
                           java.util.Vector inputSets,
                           RowSet groupFieldSet,
                           TransformationProperties properties)
                    throws InvalidTransformationException
Constructor for Union Transformation

Parameters:
name -
busName -
desc -
instName -
mapping -
inputSets -
groupFieldSet -
properties -
Throws:
InvalidTransformationException
Method Detail

apply

public OutputSet apply()
                throws InvalidTransformationException
Description copied from interface: Transform
Apply the Transformation.

Returns:
OutputSet object
Throws:
InvalidTransformationException - exception