To pass data to a data masking routine from XML, you need to identify each data masking object in your XML code. A data masking object is one or more XML fields that each contain functionally equivalent data to be masked. You assign a tag identifier to each data masking object, and pass the identifier to the data masking routine as a literal string. This requires that you assemble your XML tags such that each data masking object can be uniquely identified by its elementary tag alone, or by qualification using its elementary and parental tags. The following examples illustrate this point:
Elementary tag identifier:
<Company> <Nm>Yoga Life Spa</Nm> </Company> <Client> <Nm>Hope Lesley Stressing</Nm> </Client>
In this example, the <Nm> tag contains either a company name or a client name. Each <Nm> elementary tag instance is a child of a different parent – <Company> to identify a company, and <Client> to identify a client. Assuming company and client data are functional equivalents, the tag identifier used to represent this data masking object and that is passed to the data masking routine is just the elementary tag name, Nm, without further qualification.
Hierarchical tag identifier:
<OrgId> <IBAN> <Id>IT7788990010000004245520999</Id> </IBAN> </OrgId> <OrgId> <TaxCode> <Id>XYZABC40S18L424B</Id> </TaxCode> </OrgId>
In this example, the <Id> tag is used to provide either the IBAN (International Bank Account Number) or the tax code associated with an organization. These are not functional equivalents, and therefore represent two different data masking objects. However, each is contained in an elementary <Id> tag; therefore, the tag identifier for each must be further qualified by including both the parent and the child tag. To do this, you specify the parent tag and its child tag in sequence, separated with a comma. For example: IBAN,Id and TaxCode,Id respectively.
Each tag identifier must include as many levels in the tag hierarchy as are required to uniquely identify the elementary tag that contains the data. For example, to uniquely identify each <Id> tag in the following code requires four levels of qualification: IBAN,Country,CountryCode,Id and TaxCode,Country,CountryCode,Id respectively.
<OrgId> <IBAN> <Country> <CountryCode> <Id>IT7788990010000004245520999</Id> </CountryCode> </Country> </IBAN> </OrgId> <OrgId> <TaxCode> <Country> <CountryCode> <Id>XYZABC40S18L424B</Id> </CountryCode> </Country> </TaxCode> </OrgId>
To learn how to pass a tag identifier to a data masking routine, see XML Masking Template UDCXML1 .