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. Using the IntelliScript Editor
  7. XMap
  8. Libraries
  9. Schema Object
  10. Command Line Interface
  11. Scripts
  12. Parsers
  13. Script Ports
  14. Document Processors
  15. Formats
  16. Data Holders
  17. Anchors
  18. Transformers
  19. Actions
  20. Serializers
  21. Mappers
  22. Locators, Keys, and Indexing
  23. Streamers
  24. Validators, Notifications, and Failure Handling
  25. Validation Rules
  26. Custom Script Components

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.


Updated March 18, 2021