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

Notifications

Notifications

A notification is a signal that a condition has occurred in a transformation. When the condition occurs, a transformation triggers the notification. You can configure handlers that process the notifications.
The following examples illustrate some ways to use notifications:
  • A validator can trigger a notification. A
    NotificationHandler
    component can write a validation warning message to the result file of the transformation or to a log.
  • A
    StructureDefinition
    anchor can define a set of
    NotificationHandler
    components to process mismatches between the input records and the required input structure. If a mismatch occurs, the appropriate
    NotificationHandler
    writes a message to the result file or to a log.
  • A
    Notify
    action to trigger a notification in any location of a transformation. A
    NotificationHandler
    can write a message to the result file or to a log.
The following table describes the types of notifications:
Notification
Description
MandatoryStructureMissing
A mandatory record does not appear in the input.
MismatchIDs
The record and subelement IDs partially match. For example, there are two record identifiers, and only one of them matches.
StructureBelowMinOccurs
There are fewer matching records of the subelement than defined in
minOccurs
.
StructureExceedsMaxOccurs
There are more matching records of the subelement than defined in
maxOccurs
.
StructureOutOfSequence
The records match the subelements but not in the required sequence. For example, the subelements define a sequence
ABC
, but the input contains
ACB
.
UnexpectedRecord
The records match the subelements, but not in the required hierarchy. For example, the subelement define a sequence
ABC
, and
D
is defined in another location. The input contains
ABD
.
UnrecognizedRecord
No subelement matches any of the record identifiers.
XsdValidationError
The input does not match the requirements of the schema.


Updated September 26, 2018