# Integration Landscape

The OIM dashboard gives a quick view of integrations configured in <code class="expression">space.vars.SITENAME</code>. Users can check overall health of integrations and know if integrations are working fine or have any failures. Users can navigate directly to integrations, systems, and failures from the dashboard.

Here is a video on how to use the dashboard in OIM:

{% embed url="<https://youtu.be/ZPXRxJduU1A>" %}

## Graphical View

* Login into <code class="expression">space.vars.SITENAME</code>.
* Dashboard will appear on home page under Integration Landscape tab.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-da866393b392fe264122b7c36fb4205ac8280ea3%2Fintegration-landscape.png?alt=media" alt=""></div>

\- Click on !\[]\(../assets/rotate.png) at top right corner of dashboard to rotate graphical representation of integration.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-f4afb097ac81a5eced7dce9d440858e1f6d30ca8%2Fdashboard.png?alt=media" alt=""></div>

* **Node:** Represents system created in <code class="expression">space.vars.SITENAME</code>.
* **Branch:** Represents that two nodes are connected through integration. Click on branch to view integration in read-only mode. Color of branch depicts status of integration.
  * **Green:** Integration is active.
  * **Gray:** Integration is inactive.
  * **Red:** Job failure in integration.
  * **Orange:** Processing failures in integration.
  * Click on ![](https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-8e1348a7c9713d4692c3f72ecbbba1f5692cb48a%2Fintegrationbranch.png?alt=media) to view integration details from dashboard.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-ef4d7968b191889a805cd41f23df4e4f0a0b3a9b%2Fintegrationdetail.png?alt=media" alt="" width="1500"></div>

In integration details window, the following information is shown:

* Entity type(s) integrated.
* Flow of integration (Uni-directional or Bi-directional) for each entity type.
* For each flow:
  * **Last processed time:** Last time when integration was executed.
  * **Last processed entity ID:** Last entity processed by integration.
  * **Health:** Shows failures, if any, logged in integration.

## Filtering the Dashboard by Various Functions

> **Note**: The dashboard display data associated with the currently selected folder, including its child folders. To view data across all folders, select the Default Folder. You can also select any other folder that you have access to.

Users can filter the integrations according to the system and integration status.

* Click the funnel icon to view the filter options.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-2da92f25f820877294dc5487479e6d4f78ac034b%2Fdashboard_filter.PNG?alt=media" alt=""></div>

* Select the **systems** and click **Filter** button. All the integrations that use the selected systems will be displayed.
* The available options for **integration status** are: All, Active, Inactive, and In error. Select one and click **Filter**.
* If “Include from child folders” is enabled, integrations from child folders are also included. This option is enabled by default.
* You can try combinations — for example: set Jira as a system filter, Active as an integration status filter, and enable include from child folders to view all active Jira integrations of current folder and its child folders.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-aad738397a5f082634547b3a33a4e5fb39212023%2Fdag-graph-with-filters.png?alt=media" alt="" width="1500"></div>

* Click **Clear** to view all integrations and remove applied filters.

## Navigation from Dashboard

### Navigate to System

* Click on a system node in the graph. For example, clicking on the “Team Foundation Server” icon will open that system’s configuration.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-7f10b23ede25bc02cd6115cbee154b1eebaa91c9%2FDashboard_Image3.png?alt=media" alt="" width="1000"></div>

### Navigate to Integration

* Click on the integration name in the graph to open its details.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-b0e46e22c0f68801ceb6af988d60ae5c122048be%2FDashboard_Image1.png?alt=media" alt="" width="2000"></div>

### Navigate to Failure

* Click on "Global Failure(s)" or "Processing Failure(s)" to go directly to the Failures module.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-eef954e3fb4ff7386df3c3db62180323df88539e%2FDashboard_Image2.png?alt=media" alt="" width="2000"></div>
