Table of Contents

Search

  1. Preface
  2. Introduction to Data Transformation
  3. Data Processor Transformation
  4. Wizard Input and Output Formats
  5. Relational Input and Output
  6. XMap
  7. Libraries
  8. Schema Object
  9. Command Line Interface
  10. Scripts
  11. Parsers
  12. Script Ports
  13. Document Processors
  14. Formats
  15. Data Holders
  16. Anchors
  17. Transformers
  18. Actions
  19. Serializers
  20. Mappers
  21. Locators, Keys, and Indexing
  22. Streamers
  23. Validators, Notifications, and Failure Handling
  24. Validation Rules
  25. Custom Script Components

Data Transformation User Guide

Data Transformation User Guide

AdditionalOutputPort

AdditionalOutputPort

The
AdditionalOutputPort
port defines an additional output port. Use this component to define output in multiple locations or multiple documents.
The following table describes the properties of the
AdditionalOutputPort
port:
Property
Description
add_BOM_prefix
Adds a byte-order mark (BOM) prefix to the output. The type of BOM prefix is determined by the output encoding defined in the
output_encoding
property. Default is cleared.
code_page
Defines the
encoding
attribute of the additional output. If this property is not set, the additional output is generated with the output encoding defined in the Data Processor transformation settings. The
code_page
property is a child of the
output_encoding
property when it is set to
PortEncoding
. Default is cleared.
disabled
Determines whether the Script ignores the component and all of the child components. Use this property to test, debug, and modify a Script. You can choose one of the following options:
  • Selected. The Script ignores the component.
  • Cleared. The Script applies the component.
The default is cleared.
encode_as_xml
Determines whether special characters are converted to XML entities. You can choose one of the following options:
  • Selected. Special characters are converted to XML entities.
  • Cleared. Special characters are not converted.
The
encode_as_xml
property is a child of the
output_encoding
property when it is set to PortEncoding. Default is cleared.
file_extension
Defines the file extension for the additional output file in the design environment. The name of the file is the name assigned to the
AdditionalOutputPort
component. This setting has no effect in the production environment. Default is .xml.
other_properties
Defines encoding properties when it is set to
XmlHeader
. You can choose one of the following options:
  • XmlHeader
    . Defines the XML header. The
    XmlHeader
    property has the following options:
    • add_BOM_prefix
    • process_instruction
    • process_instruction_string
    • root_element
    • xml_version
    • XSLT_stylesheet_name
  • Cleared. Output properties are determined by the Data Processor transformation settings.
Default is cleared.
output_encoding
Defines encoding properties when it is set to
PortEncoding
. You can choose one of the following options:
  • PortEncoding
    . The additional output has custom settings for
    code_page
    and
    encode_as_xml
    .
  • Cleared. The Data Processor transformation settings control the output encoding and conversion of XML entities.
Default is cleared.
PortEncoding
Defines custom settings for the additional output. You can choose one of the following options:
  • code_page
  • encode_as_xml
process_instruction
Defines a processing instruction in the output XML file. You can choose one of the following options:
  • None. Does not write a processing instruction to the XML output.
  • UseOutputCodePage. Outputs the code page defined in the
    output_encoding
    property.
  • FreeEncodingString. Outputs the string defined in the
    process_instruction_string
    property.
Default is UseOutputCodePage.
process_instruction_string
Defines a user-defined processing instruction. The
process_instruction_string
property has an effect only when the
process_instruction
property is set to FreeEncodingString.
root_element
Defines the name of the root element that is wrapped around the entire output.
xml_version
Defines the version attribute of the processing instruction. Default is 1.0.
XSLT_stylesheet_name
Defines an XSLT stylesheet that is written to the processing instruction.