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

Optional Sections

Optional Sections

In this example, suppose that the second section,
Professional Experience
, is missing from some input XML documents, but you want to write its separator to the output, like this:
---------------------------- Jane Palmer Employee ID 123456 ---------------------------- ---------------------------- Education ...
To support this situation, configure the
DelimitedSectionsSerializer
in the following way:
  • In the second
    GroupSerializer
    , select the
    optional
    property. This means that if the
    GroupSerializer
    fails, it should not cause the
    DelimitedSectionsSerializer
    to fail.
  • In the
    DelimitedSectionsSerializer
    , set
    using_placeholders
    to
    always
    . This means to write the separator of an optional section, even if the section itself is missing.
Alternatively, suppose that if the
Professional Experience
section is missing, you do not want to write its separator:
---------------------------- Jane Palmer Employee ID 123456 ---------------------------- Education ...
In this case, configure the
DelimitedSectionsSerializer
as follows:
  • In the second
    GroupSerializer
    , select the
    optional
    property.
  • In the
    DelimitedSectionsSerializer
    , set
    using_placeholders
    to
    never
    . This means not to write the separator of a missing section.