Key Concepts¶ WSO2 Integrator: MI is a comprehensive integration solution that streamlines the process of digital transformation. It provides a robust, configuration-based approach, enabling developers to create integration solutions visually through a user-friendly, low-code graphical design interface. The following diagram illustrates key components of WSO2 Integrator: MI. WSO2 Integrator: MI Runtime¶ Listed below are the key concepts of the WSO2 Integrator: MI runtime. Message entry points¶ Message entry points are the entities that a message can enter into the WSO2 Integrator: MI mediation flow. APIs¶ An API in WSO2 Integrator: MI is a key component for exposing integration services. Each API is anchored at a user-defined URL context and processes only requests that fall under the given URL context. An API is made of one or more resources, which are logical components of an API that can be accessed by making a particular type of HTTP call. See the REST APIs documentation for more information. Proxy Services¶ A Proxy service is a virtual service that receives messages and optionally processes them before forwarding them to a service at a given endpoint. This approach allows you to perform the necessary message transformations and introduce additional functionality without modifying your actual services. Unlike in APIs, here, the protocol does not always need to be HTTP/S. Proxy Services support other well-known protocols such as JMS, FTP, FIX, and HL7. See the Proxy Services documentation for more information. Inbound Endpoints¶ In APIs and proxy services some parts of the configuration are global to a particular instance. For example, the HTTP port needs to be common for all the APIs. The Inbound Endpoints do not contain such global configurations. This provides greater flexibility in configuring the Inbound Endpoints compared to the other two message entry points. See the Inbound Endpoints documentation for more information. Message processing units¶ Mediators¶ Mediators are individual processing units that perform a specific function on messages that pass through the WSO2 Integrator: MI. The mediator takes the message received by the message entry points, performs predefined actions on it (such as transforming, enriching, filtering), and modifies the message. See the Mediators documentation for more information. Sequences¶ A sequence is a set of mediators organized into a logical flow, allowing you to implement pipes and filter patterns. The mediators in the sequence will perform the necessary message processing and route the message to the required destination. See the Sequences documentation for more information. Message Stores and Processors¶ A Message Store is used to temporarily store messages before they are delivered to their destination. This approach is useful for several scenarios. Serving traffic to back-end services that can only accept messages at a given rate, whereas incoming traffic arrives at different rates. This use case is called request rate matching. If the back-end service is not available at a particular moment, the message can be kept safely inside the message store until the back-end service becomes available. This use case is called guaranteed delivery. The task of the Message Processor is to pick the messages stored in the message store and deliver them to the destination. See the Message Stores and Processors documentation for more information. Templates¶ A Template is a reusable configuration that helps streamline and simplify the creation and management of sequences and endpoints. Templates allow developers to abstract common logic and reuse it across multiple services, reducing redundancy and ensuring consistency in configurations. See the Templates documentation for more information. Message exit points¶ Endpoints¶ An endpoint defines an external destination for a message. It could represent an HTTP URL, a mailbox, a JMS queue, a TCP socket, and other connection types, along with the settings needed for the connection. See the Endpoints documentation for more information. Connectors¶ A Connector allows mediation flows to connect and interact with external services such as Twitter and Salesforce. Typically, connectors are used to wrap the API or the SDK of an external service. Each connector provides operations that perform different actions in that service. For example, the Twitter connector has operations for creating a tweet, getting a user's followers, and more. To download a required connector, go to the WSO2 Connector Store. See the Connectors documentation for more information. Other concepts¶ Data Services¶ A Data service allows users to expose data from various data sources such as databases, spreadsheets, and CSV files through services, enabling easy access to this data over HTTP. WSO2 MI simplifies the process of interacting with databases by abstracting the data access logic and offering a way to expose data as services, such as RESTful or SOAP APIs, without requiring developers to write complex code. See the Data Services documentation for more information. Scheduled triggers¶ Executing an integration process at a specified time is a common requirement in enterprise integration. For example, in an organization, there may be a need to run an integration process to synchronize two systems every day at the end of the day. In the WSO2 Integrator: MI, the execution of a message mediation process can be automated to run periodically by using a Scheduled trigger. Furthermore, you can use cron expressions for more advanced scheduling configurations. See the Scheduled triggers documentation for more information. Transports¶ A transport protocol is responsible for carrying messages that are in a specific protocol. WSO2 Integrator: MI supports all the widely used transports including HTTP/S, JMS, and VFS, as well as domain-specific transports like FIX. Each transport provides a receiver implementation for receiving messages and a sender implementation for sending messages. See the Transports documentation for more information. Registry¶ WSO2 Integrator: MI uses a Registry to store various configurations and resources, such as endpoints. A registry is simply a content store and a metadata repository. Various resources such as XSLT scripts, WSDLs, and configuration files can be stored in a registry and referred to by a key, which is a path similar to a UNIX file path. The WSO2 Integrator: MI uses a file-based registry that is configured by default. You can also define and use a local registry when you develop your integration artifacts. Message Builders and Formatters¶ When a message comes into WSO2 Integrator: MI, the receiving transport selects a message builder based on the message's content type. It uses that builder to process the raw payload data of the message and converts it to a common format, which the mediation engine of WSO2 Integrator: MI can then read and understand. WSO2 Integrator: MI includes message builders for text-based and binary content. Conversely, before a transport sends a message out from WSO2 Integrator: MI, a message formatter is used to build the outgoing stream from the message back into its original format. As with message builders, the message formatter is selected based on the message's content type. See the Message Builders and Formatters documentation for more information. Development Tool¶ WSO2 Integrator: MI for VS Code¶ WSO2 Integrator: MI Visual Studio Code extension (MI for VS Code) is a comprehensive integration solution that simplifies your digital transformation journey. It streamlines your integration development workflow using a user-friendly low-code graphical designing experience. This leverages AI to assist developers throughout the integration development process which elevates the integration experience to new heights. See the WSO2 Integrator: MI for VS Code documentation for more information. Monitoring Tools¶ Listed below are the key concepts of the WSO2 Integrator: MI monitoring tools. Integration Control Plane¶ The WSO2 Integration Control Plane (ICP) can be used to monitor the WSO2 Integrator: MI instances in a deployment. It provides a graphical view of the integration artifacts that are deployed in the WSO2 Integrator: MI instances. You can also perform various management and administration tasks using the ICP server. See the Integration Control Plane documentation for more information. WSO2 Integrator: MI CLI¶ The WSO2 Integrator: MI CLI allows you to monitor the Synapse artifacts (deployed in a specified WSO2 Integrator: MI server) and perform various management and administration tasks from the command line. See the WSO2 Integrator: MI CLI documentation for more information.