Events
An event is a record of a processing step from a component in the Data Processor transformation. In a Script or Library, each anchor, action, or transformer generates an event. In an XMap, each mapping statement generates an event.
You can view events in the Data Processor Events view.
Event Types
The Data Processor transformation writes events in log files. Each event has an event type that indicates if the event was successful, the event failed, or if the event ran with errors.
A component can generate one or more events. The component can pass or fail depending on whether the events succeed or fail. If one event fails, a component fails.
The following table describes the types of events that the Data Processor transformation generates:
Event Type | Description |
|---|
Notification | Normal operation. |
Warning | The Data Processor transformation ran, but an unexpected condition occurred. For example, the Data Processor transformation wrote data to the same element multiple times. Each time the element is overwritten, the Data Processor transformation generates a warning. |
Failure | The Data Processor transformation ran, but a component failed. For example, a required input element was empty. |
Optional Failure | The Data Processor transformation ran, but an optional component failed. For example, an optional anchor was missing from the source document. |
Fatal Error | The Data Processor transformation failed because of a serious error. For example, the input document did not exist. |
Data Processor Events View
The Data Processor Events view displays events when you run a Data Processor transformation from the Developer tool.
The Data Processor Events view has a Navigation panel and a Details panel. The Navigation panel contains a navigation tree. The navigation tree lists the components that the transformation ran in chronological order. Each node has an icon that represents the most serious event below it in the tree. When you select a node in the Navigation panel, events appear in the Details panel.
The navigation tree contains the following top-level nodes:
- •Service Initialization. Describes the files and the variables that the Data Processor transformation initializes.
- •Execution. Lists the components that the Script, Library or XMap ran.
- •Summary. Displays statistics about the processing.
When you run an XMap, each node name in the navigation panel has a number in square brackets, such as [5]. To identify the statement that generated the events for the node, right-click in the statements grid and select Go to Row Number. Enter the node number.
When you run a Script and double-click an event in the Navigation panel or the Details panel, the Script editor highlights the Script component that generated the event. The Input panel of the Data Viewer view highlights the part of the example source document that generated the event.