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

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.