Maintain XML tags

Maintaining XML tags

The EPC rulebooks and guidelines allow for bank or country-specific requirements in the XML file to be sent to the bank. These local or specific requirements can be fulfilled using optional XML tags. Therefore, you can add, delete, or edit XML tags in the initialized default layout.

To delete an XML tag, select the appropriate XML-tag line and use the Delete command in the session menu. If the XML tag type is mandatory because it was specified as a minimum requirement in the EPC Rulebook, the layout line cannot be deleted.

Note

An XML tag can be deleted only if any child tags were deleted.

To Edit an XML tag (layout status: Initial), double-click the required XML-tag line to start the XML Payment/Receipt Layout Lines (tfcmg0125m000) details session.

FieldDescription
XML Tag IdentifierThe XML tag number.
XML TagThe XML tag name.
XML Tag DescriptionThe XML tag description.
XML Tag TypeDefines a set of values and the allowable operations on those values. This field indicates what sort of value is expected for this tag. This is compared with the element type of mapping elements. If a mismatch occurs, the user is informed.

For mapping XML elements to LN records, the following data types exist:

  • Attribute
    For example, currency code, quantity
  • Boolean
    Yes/No
  • Date
    Absolute date
  • Decimal Number
  • Node
    Only for parents
  • String
    Alphanumeric code
  • UTC Date
    Time-zone-independent date
Parent XML Tag IdentifierThe number in this field indicates the parent of the current XML tag, which is used to construct the XML tree structure.
Sequence in ParentA parent tag can have multiple child tags. This field indicates the sequence in which the current tag occurs for the parent.
MandatoryIf this check box is selected, the layout line cannot be deleted.
SelectIf this check box is selected, the XML tag will be included in the file generation.
Map to Payment ElementIf this check box is selected, the tag value for this layout line will be set based on one or more LN table fields or variables. Fixed text means the value specified by the user will be used as a (static) tag value. Map to Payment Element and Fixed/Prefix Text are mutually exclusive.
Fixed/Prefix TextSee the Map to Payment Element field
Maximum Text CharactersThe maximum number of text characters allowed.
ChoiceIf this check box is selected, the tag is a mutually exclusive choice element. If two child elements are marked as Choice, the user is informed about this when both tags are selected.

Note

This field is predefined and merely indicates whether the tag is considered to be a choice field according to the EPC rulebooks.

TransactionalIf this check box is selected, the data for this line is based on the actual transaction. The transactional tags are repeated as many times as there are transactions.
Sort SequenceThe sequence of the XML tag in the file. Sort Sequence is a system-generated sequence of the XML file. After activation, all selected lines should have a non-zero value here. This field is for technical reasons only and disabled for user input.

 

Caution!

Do not change XML Tag Type, Parent XML Tag Identifier, or Sequence in Parent values unless the format that is required by the bank necessitates this change.

Guidelines for editing

  • If the Select check box is selected, almost all fields are editable. However, if the tag is generated as, for example, the payment identifier, it only makes sense to change the following fields:
    • XML Tag Description
    • Mandatory
    • Map to Payment Element
    • Fixed/Prefix Text
    • Maximum Text Characters
    • Choice
  • The value of the Sort Sequence field is generated and cannot be changed.
  • Only when you create a new tag can you change the following fields:
    • XML Tag
    • XML Tag Type
    • Parent XML Tag Identifier
    • Sequence in Parent
    • Choice

    • Transactional

      Except tags that belong to the group header, all tags must have this check box selected.

  • For a particular local requirement, you can define that a tag is mandatory. If the Map to Payment Element check box is selected, this means that the tag must be mapped, or is already mapped in case of a default generated tag, to data in LN. If this check box is cleared, the tag is specified at runtime and/or a fixed text can be added. The Fixed/Prefix Text field and the Map to Payment Element check box are mutually exclusive.

To add an XML tag, in the XML Payment/Receipt Layout (tfcmg0624m000) session, on the XML Payment/Receipt Layout Lines tab, click the New Layout Details button.

Related topics