XML Source Qualifier Overview: When you add an XML source definition to a mapping, you need to connect it to an XML

Source Qualifier transformation. The XML Source Qualifier represents the data elements that the Informatica Server reads when it runs a session with XML sources. ou can use the XML Source Qualifier only with an XML source definition. ou can lin! only one XML Source Qualifier to one XML source definition. "n XML Source Qualifier always has one input#output port for every column in the XML source. When you create an XML Source Qualifier for a source definition, the $esigner automatically lin!s each port in the XML source definition to a port in the XML Source Qualifier. ou cannot remove or edit any of the lin!s. If you remove an XML source definition from a mapping, the $esigner also removes the corresponding XML Source Qualifier. ou can lin! ports of one group to ports in different transformations to form separate data flows. %owever, you cannot lin! ports from more than one group in an XML Source Qualifier to ports in the same target transformation. If you drag columns of more than one group in an XML Source Qualifier to one transformation, the $esigner copies the columns of all the groups to the transformation. %owever, it lin!s only the ports of the first group to the corresponding ports of the columns created in the transformation. " group in an XML Source Qualifier can lin! to one group in an XML target definition. ou can lin! more than one group in an XML Source Qualifier to an XML target definition. ou cannot use an XML Source Qualifier in a mapplet. Transformation Datatypes: The XML Source Qualifier determines how the Informatica Server reads data from XML sources. "s in other transformations, the columns in an XML Source Qualifier display the transformation datatypes that the $esigner uses to move data from source to target. ou cannot alter the datatypes in an XML Source Qualifier.

Adding an XML Source Qualifier to a Mapping: ou can add an XML Source Qualifier to a mapping &y dragging an XML source definition to the Mapping $esigner wor!space or &y manually creating one. Automatically Creating an XML Source Qualifier: When you drag an XML source definition to the Mapping $esigner wor!space, the $esigner automatically creates an XML Source Qualifier. To automatically create an XML Source Qualifier transformation' In the Mapping $esigner, create a new mapping or open an e(isting one. )lic! and drag an XML source definition into the mapping. The $esigner automatically creates an XML Source Qualifier and lin!s each port in the XML source definition to a port in the XML Source Qualifier. Manually Creating an XML Source Qualifier: ou can create an XML Source Qualifier in a mapping if you have a mapping that contains XML source definitions without Source Qualifiers or if you delete the XML Source Qualifier from a mapping. To manually create an XML Source Qualifier transformation' In the Mapping $esigner, create a new mapping or open an e(isting one. Ma!e sure that there is at least one XML source definition without a source *ualifier in the mapping. +rom the menu, choose Transformation,)reate. The )reate Transformation dialog &o( appears. Select XML Source Qualifier and type a name for the new transformation. The naming convention for XML Source Qualifier transformations is XSQ-TransformationName. )lic! )reate. The $esigner lists all the XML source definitions in the mapping with no corresponding XML Source Qualifiers. Select a source definition and clic! ./. The $esigner creates an XML Source Qualifier in the mapping and lin!s each port of the XML source definition to a port in the XML Source Qualifier.

diting an XML Source Qualifier: ou can edit XML Source Qualifier properties, such as transformation name and description and other transformation attri&utes. To edit an XML Source Qualifier transformation' In the Mapping $esigner, dou&le,clic! the title &ar of the XML Source Qualifier. .n the Transformation ta&, edit the settings as necessary' Transformation Setting Select Transformation 0ename 1utton $escription Description $isplays the transformation you are editing. To choose a different transformation to edit, select it from the list. 2dit the name of the transformation. $escription of the transformation.

.n the 3orts ta&, you can view the details of the XML Source Qualifier ports. ou cannot edit any of the port settings. .n the 3roperties ta&, you can select options that affect how the Informatica Server runs the mapping during a session. "s you scroll over the transformation attri&ute options, the $esigner displays a description of the option. 2dit the properties as necessary and clic! ./. !roperties Setting Select Transformation Description $isplays the transformation you are editing. To choose a different transformation to edit, select it from the list. $etermines the amount of information a&out this transformation the Informatica Server writes to the session log when it runs the session. ou can override this tracing level when you configure a session. "t the end of a session, resets the value se*uence for all generated !eys in all groups. "lways start the generated !ey se*uence for all groups at one.

Tracing Level

0eset 0estart

)hoose 0epository,Save to save any changes to the XML Source Qualifier.

"sing t#e XML Source Qualifier in a Mapping: 2ach group in an XML definition is analogous to a relational ta&le, and the $esigner treats each group within the XML Source Qualifier as a separate source of data. In a mapping, the ports of one group in an XML Source Qualifier can &e part of more than one data flow. %owever, the ports of more than one group in the same XML Source Qualifier cannot lin! to one transformation or &e part of the same data flow. Therefore, you need to organi4e the groups in the XML source definition so that each group contains all the information you re*uire in one data flow. The $esigner uses the following rules for XML Source Qualifiers in a mapping' $ou can lin% ports of only one group in an XML Source Qualifier to ports in one transformation& ou can copy the columns of several groups to one transformation, &ut you can lin! the ports of only one group to the corresponding ports in the transformation. $ou can lin% ports of one group in an XML Source Qualifier to ports in more t#an one transformation& 2ach group in an XML Source Qualifier can &e a source of data for more than one data flow. $ata can pass from one group to several different transformations. $ou can lin% groups from more t#an one XML Source Qualifier to one transformation& If you need to use data from two different XML source definitions, you can lin! a group from each source *ualifier and 5oin the data in a 6oiner transformation. ou can also use the same source definition more than once in a mapping. )onnect each source definition to a different XML Source Qualifier and 5oin the groups in a 6oiner transformation.