# Landscape Mapping

In any DevOps or CI/CD setup for SAP or cloud-based applications, it is essential to define and manage the sequence of environments through which your applications or transport artifacts move — typically from Development to Production.

**ReleaseOwl** introduces **Landscape Mapping(Beta)** to streamline and govern this structured progression. Landscape Mapping in ReleaseOwl is composed of two main components:

1. **Landscape Stages**
2. **Landscape Stage System Mapping**

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

### Landscape Stages

**Landscape Stages** represent the logical progression of environments that are part of the software delivery process. These stages reflect the different checkpoints where code or configurations are built, tested, validated, and finally released to users.  Typical stages in a landscape include: DEV, QA and Prod.&#x20;

**To define Landscape Stages:**

* Navigate to the **Landscape Mapping** screen.
* Click on the **"Landscape Stages"** tile.

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

* Click the **Edit** button to begin adding or modifying stages.

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

* Click **Add Stage** to insert a new stage (e.g., DEV, QA, PROD).
* After configuring the required stages, click the **Save** button to apply the changes.

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

### Landscape Stage System Mapping

Once the stages are defined, each stage needs to be connected to an actual system or environment. **Landscape Stage System Mapping** is the process of linking each logical stage to a corresponding application runtime environment.

**To configure Landscape Stage System Mapping:**

1. Click on the **"Landscape Stage System Mapping"** tile.
2. Click the **Edit** button to begin mapping.

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

3. Click the **+ Add Landscape** button.&#x20;

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

4. A pop-up window will appear prompting you to provide the following details:

* **Landscape Name** – Enter a descriptive name for the landscape.
* **Environment Type** – Select the appropriate environment type from the dropdown (e.g., SAP CPI, API Management etc.).

5. Click **OK** to add the landscape mapping entry.

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

6. Once all mappings have been added, click the **Save** button to save the landscape-to-environment mapping configuration.

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


---

# 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://releaseowl.gitbook.io/releaseowl-docs/releaseowl-admin-guide/landscape-mapping.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.
