Skip to main content
Version: 0.7.0

Integration

Definition​

An integration is a governed interaction between two endpoints that transfers information or invokes behavior.

Boundaries​

An integration is not every technical dependency or merely a line on a diagram. It has a purpose, direction, owner, and lifecycle. Endpoint detail depends on the profile: systems, components, or interfaces.

Minimum characteristics​

  • source and purpose;
  • direction;
  • synchronous or asynchronous mode;
  • protocol or mechanism;
  • transferred information;
  • state and owner.

Relationships​

An integration connects systems, components, or interfaces and transfers information objects.

Example​

INT-PORTAL-CRM-CASE transfers a customer case from the portal to CRM through the case-management REST interface.

Common mistakes​

  • omitting direction and transferred data;
  • modeling one bidirectional exchange without distinguishable obligations;
  • confusing an integration with an interface or network connection.