Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Warning
While EagleML and EJM are version independent, your Eagle product suite must be at least version 12.1.5.

In On this page:

Table of Contents

...

The main purpose of EagleML is to serve as Eagle Canonical Data Modelthe Eagle canonical data model. EagleML uses an industry standard based XSD that serves as Eagle’s canonical data model (standardized template) for exchanging different data formats and . It also establishes a clear set of communication rules for communication for inbound and outbound data exchange. 

Inbound EagleML data interfaces (loads) deliver data to Eagle databases, whereas outbound EagleML data interfaces (extracts) extract , extract data out of Eagle databases and deliver it to specified locations. EagleML covers a large variety of models including models for data interfaces (which are divided into transactions and object interfaces) as well as  and interfaces for messaging and flow control.

This section describes the general structure of EagleML-2-0, including the an explanation of the data and control interfaces and , object types and inheritance, and the relations relationship between them.

EagleML-2-0 is was developed to be used for any interfacing interface with Eagle. It can be used with messaging architectures architecture and delivery protocols like JMS, MQS, ESB-based architectures, SOAP/REST Web Services ; as well as and FTP, SFTP, HTTP FILE-based transfers.

...

The control section of EagleML-2-0 is meant to enable SOA-based flow control interfacing and allow for external orchestration. It can be especially useful for Enterprises enterprises that are looking for a modern style application integration where BPM acts as a central workflow control of the entire system.

There are 3 three distinct types of objects which constitute EagleML:​

...

Messages are used for providing data exchange between systems. They act as envelopes that carry either data transactions or , control instructions or as exception alerts alert or events and notifications. Structurally, messages have headers that contain messaging specific elements (such as  Message Id Message ID or Message Address) and , and bodies. The body of the message can be either data transaction or control instructions.

There are a large variety of messages in EagleML-2-0, which can be grouped into two main types - : data messages and control messages.

...

Control messages are intended for application integrations and have elements for tasks and workflow execution , and exception and notification patterns such as Task Correlation IdID, Task Parameters, Task Status, Severity Code, Reason Codes, Error description Description and Resolutions. Control messages are XML-based files that contain descriptions of tasks to be performed on the data being transferred and how the data is to be consumed and published. Control messages are also known as CMs or Run Task Requests (RTRs). The coordination of control messages forms the basis of the Eagle Job Management (EJM) framework. 

There is a high level of relationship between message headers. The headers for data and control messages have common elements that encapsulated in most base type MessageHeader. However, they also They also have specific elements based on the purpose of the message to reflect integration patterns such as Message IdID,  Correlation IdCorrelation ID, and Message Address.

Transactions

Transaction types are wrappers over Data Objectsdata objects. A transaction has a header and body that contain a data object. Headers of transactions Transaction headers describe data object types and actions to be performed over the data object that is contained in transaction’s body.

...

Transactions are always wrapped into Messages. One Message can carry one or many transactions. This is done to support both single record real-time loads as well as batch-based loads.This  This enables EagleML-2-0 to serve as both a payload for messaging systems and FILE based transfers.

...

Data objects are the types that describe various interfaces. They actually comprise what we refer to as the Eagle Canonical Data Model. Data objects are all extended from one base type, EagleObject, which has minimum required elements.

...

EagleML provides a generic set of XML-based interfaces. They are described as XSD and implemented on the Message Center framework as Message Streamsmessage streams. The term Message Stream message stream is used to describe components that make up the Message Center interfaces, including the delivery location for the incoming data, XML mapping rule files, and panels. The data is being delivered to the designated streams by using a variety of methods including file based uploads to the Incoming folder on the Web server, or by Messaging: MQ Series, JMS, HTTP, or by using the Send Data feature in the Eagle's Automation Center.

...