# Mappings View

Mappings describe the data flow from one topic to another, such as the data flow between devices and processing rules.

See also: [Cybus::Mapping resource](/2-1-2/documentation/services/service-commissioning-files/resources/cybus-mapping.md)

## Overview

<figure><img src="/files/TxjIJcWQcAnnHD7AZ3E9" alt=""><figcaption><p>Connections Overview</p></figcaption></figure>

In the list, all mappings are displayed with the following information:

**Service ID**

* The unique identifier of the service that contains this mapping.

**Name**

* The name of the mapping.

**Entries**

* The number of entries for the mapping.

**Agent**

* The agent that is assigned to the mapping.

**Status**

* The current state of the mapping (e.g., enabled or enabling).

## Mapping Details View

* To open the **Mappings View** for a specific service, click **Services** > **Service Overview** and select a service. In the **Service Details** view of the selected service, click the **Mappings** tab.

<figure><img src="/files/fC0RuTBPs4xjIhjhDIQG" alt=""><figcaption><p>Mapping Details View</p></figcaption></figure>

At the top of the **Mapping Details View**, the following information is displayed:

**Mapping ID**

* The unique identifier of the service that contains this mapping.

**Service ID**

* The unique identifier of the service that contains this mapping.

**Entries**

* The number of entries for the mapping.

**Agent**

* The agent that is assigned to the mapping.

**Status**

* The current state of the mapping (e.g., enabled or enabling).

## Resources of Mappings

Each mapping has resources itself.

* To open the resources of mappings, click a mapping in the **Mappings View**.

See also: [Cybus::Mapping resource](/2-1-2/documentation/services/service-commissioning-files/resources/cybus-mapping.md)

{% hint style="warning" %}
For reliable operation, MQTT shared subscriptions are not supported in the **Entries tab**, as they could interfere with other clients subscribed to the same topics.
{% endhint %}

<figure><img src="/files/uOqQKuNZuOZDURVedtOY" alt=""><figcaption></figcaption></figure>

**Subscribe**

* The resource that the mapping subscribes data from.

**Subscribe Broker**

* Indicates which message broker is used to receive the subscribed data (e.g., internal).

**Publish**

* The resource that the mapping publishes data to. You can click the entry to open the details view of the resource.

**Publish Broker**

* Indicates which message broker is used to publish the data (e.g., internal).

**Rules**

The **Rules tab** lists associated Rule Engine rules for the mapping. The rules define how data should be processed between subscribing and publishing. For more information, see [Rule Engine](/2-1-2/documentation/services/rule-engine.md).

### Search

The search allows you to filter the list.

* Minimum search length is 3 characters.
* Search services by service ID or name.
* Search resources by name, ID, protocol, parent resource ID, agent name, or service ID.
* Search is case-insensitive.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cybus.io/2-1-2/documentation/services/service-resources-view/mappings-view.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.