> For the complete documentation index, see [llms.txt](https://releaseowl.gitbook.io/releaseowl-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://releaseowl.gitbook.io/releaseowl-docs/releaseowl-user-guide/sap-integration-suite/cpi-management/b2b-scenarios.md).

# B2B Scenarios

The Trading Partner Management (TPM) module in Releaseowl lets you synchronize, manage, version, and deploy SAP TPM artifacts across your SAP Integration Suite environments.

Releaseowl integrates with SAP Trading Partner Management to manage the deployment lifecycle of TPM artifacts. Using this module, you can synchronize the  exported Agreements and Partner Directory artifacts from a source environment, organize them into User Stories, and promote them through your Release Pipelines

## &#x20;B2B Scenarios&#x20;

Open **B2B Scenarios** within the CPI project. This screen has **three tabs**:

1. **Agreements**
2. **Partner Directory**
3. **Partner Directory Configuration**

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FgJINxlSRBOuZ4IxJm2IJ%2Fimage.png?alt=media&amp;token=1071565b-368a-450c-bb4a-4a67772a3683" alt=""><figcaption></figcaption></figure>

### **1. Agreements**

This tab is used to import agreements exported from the **B2B Scenarios** application in SAP Integration Suite, allowing you to view and manage them  in ReleaseOwl.

&#x20;**Adding an Agreement**

* Click **Add Artifacts**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FORA5q46RG7nbrgaeq8Zy%2Fimage.png?alt=media&amp;token=9bac29b9-4ef9-4621-9de5-b723d8c959f8" alt=""><figcaption></figcaption></figure>

* The dialog displays all agreement artifacts that have been exported from the **B2B Scenarios** application in SAP Integration Suite and are available for import.
* Select the required agreement(s) and add them to ReleaseOwl for deployment.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FIDM3nf2aFiFoFciddAHs%2Fimage.png?alt=media&amp;token=a535ce03-e981-4d90-ad03-52cdfd0c8556" alt=""><figcaption></figcaption></figure>

* Once an agreement is added, use the action options to view its details, download the artifact, and check its deployment history.

**Details**

Displays the details of the selected exported agreement, including the **Version**, **ID**, **Created On**, and **Created By** information.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FJEzaRN8CGcsBHxLVO282%2Fimage.png?alt=media&amp;token=1d722445-f3a8-45f4-9aa8-4a458b293559" alt=""><figcaption></figcaption></figure>

**Download-** Downloads the exported agreement artifact to your local machine.

**Deployment History-** Shows the history of deployments carried out for that agreement, including the environment, deployment time, and the deployment outcome.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FNNz2UIbvsbEDpJSoxMt9%2Fimage.png?alt=media&amp;token=58c18ccd-dcf9-44f1-923c-9703f20afec6" alt=""><figcaption></figcaption></figure>

### 2. Partner Directory Data

Use this tab to view the Partner Directory data associated with Trading Partner Management (TPM).

* Click **Sync Artifacts** to synchronize Partner Directory data from the **B2B Scenarios** application in SAP Integration Suite into ReleaseOwl. Use **Search by ID** to quickly locate a specific Partner Directory ID.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FkAKOdNWhh4WFaKYakNSR%2Fimage.png?alt=media&amp;token=9fef5d69-6fd9-455d-8b29-cd9ce35693be" alt=""><figcaption></figcaption></figure>

* Click the **Expand** (arrow) icon to view the details of a Partner Directory entry, including the **Parameter ID**, **Value**, **Type**, and **Content Type**.
* Parameter ID entries can be of type **String** or **Binary**.
* For Parameter ID entries of type **Binary**, you can download the associated binary content.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FKUSIZsVm4XXbSXMIirhB%2Fimage.png?alt=media&amp;token=58a1ea30-58eb-41ba-8126-487f1f2e58a9" alt=""><figcaption></figcaption></figure>

### 3.  Partner Directory Configuration&#x20;

This is the Releaseowl-only artifact used to **group specific Partner Directory attributes together** so they can be versioned and deployed as a single unit — instead of moving every attribute one at a time.

**Create a configuration**

1. Go to the **Partner Directory Configuration** tab.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FWnNmotzvTB4kNWCNRqX0%2Fimage.png?alt=media&amp;token=465b4050-0348-42f4-b57b-4c8a62485368" alt=""><figcaption></figcaption></figure>

2. Click **Create Partner Directory Configuration**.
3. In the pop-up, enter:
   * **Artifact Name**
   * **Version**
4. Click **Create**. Your new configuration now appears in the configuration list.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F0mne6Zdov2ZNDl6jZL57%2Fimage.png?alt=media&amp;token=dfc01e0f-6c83-402a-9bb0-aa000941d846" alt=""><figcaption></figcaption></figure>

5. Click the **Actions** button on your configuration, then choose **Edit**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FgLGnqJIOiy9jKX06AVCv%2Fimage.png?alt=media&amp;token=5ae40ab1-a0b3-4665-8df9-3f395b1b5262" alt=""><figcaption></figcaption></figure>

6. Click **Add**, and select the Partner Directory data (attributes/IDs) you want included.
7. Click **Save**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FULcUAQpEqBCAi96mzAmb%2Fimage.png?alt=media&amp;token=0687867c-1162-42ec-be1a-28cd75eb1232" alt=""><figcaption></figcaption></figure>

8. After adding the Partner Directory entries, you can choose one of the following options:
   * **Save** – Saves the changes to the current Partner Directory Configuration.
   * **Save as Version** – Creates a new version of the Partner Directory Configuration while preserving the existing version.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FGEo34sIz0KWMNum0H00A%2Fimage.png?alt=media&amp;token=9b4339c7-ac96-4473-be30-ff459151b125" alt=""><figcaption></figcaption></figure>

**Configure:**

* To modify the value of a parameter in the target environment, click the **Configure** button for the corresponding **Partner Directory Configuration**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FAiD8nEVjHtvzzj4rebN7%2Fimage.png?alt=media&amp;token=618484c9-29e1-4971-a77f-5298b4b60f42" alt=""><figcaption></figcaption></figure>

* Click the **Edit** (pencil) icon next to the required field.
* Update the necessary configuration parameters.
* Click **Save** to persist changes.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fqv28AjYKarn0mCyd0ZXI%2Fimage.png?alt=media&amp;token=30856961-de69-4d1c-a914-f58def820afb" alt=""><figcaption></figcaption></figure>

* For parameters with **Type** set to **Binary**, clicking the **Edit** icon opens a pop-up window. Update or replace the binary content as required, and click **Save** to persist the changes.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FciIoXBxF8RIulXkFaf2Z%2Fimage.png?alt=media&amp;token=2613a78f-4e7a-467c-b33c-aafe83fbaecd" alt=""><figcaption></figcaption></figure>

**Deployment History**&#x20;

* **Deployment History** : Displays the deployment history of the Partner Directory Configuration.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FXvSFx0mT3g3xGmmyhzdB%2Fimage.png?alt=media&amp;token=d8eb12d0-7469-4de1-9eb4-c999fdfe3a02" alt=""><figcaption></figcaption></figure>

* **Versions** lists every version created for the configuration.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FMWeB1yI6PVstv6YNpZUq%2Fimage.png?alt=media&amp;token=0e59dfd4-566e-46ac-948c-80a5cbe7dd87" alt=""><figcaption></figcaption></figure>

* &#x20;From here, you can **assign a specific version to a User Story** for deployment.&#x20;
* To assign a specific version to a User Story for deployment:

  1. Click **Assign User Story**.

  <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FhJOIWcmGFTYI2TipF6IT%2Fimage.png?alt=media&amp;token=994520a4-01e3-4ff8-b931-ae20a81b9abe" alt=""><figcaption></figcaption></figure>

  2\. Select the required User Story or User Stories from the list.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fja8CMQlTq3I54XKAlXXD%2Fimage.png?alt=media&amp;token=78285614-728a-496e-8ec9-b6f583e2f3b7" alt=""><figcaption></figcaption></figure>

3. Complete the assignment.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FjktMSQiZJnsrWS6EpOgA%2Fimage.png?alt=media&amp;token=ab777176-b40d-4a99-82d1-d66e0b800e98" alt=""><figcaption></figcaption></figure>

**Remove Artifacts:** Users can remove previously added artifacts from **Agreements** and **Partner Directory Configurations** when they are no longer required.

<div><figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FCw019RzDx7gkKwbWr7TD%2Fimage.png?alt=media&amp;token=95f0488b-5087-46d4-9304-cfbd4e775339" alt=""><figcaption></figcaption></figure> <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FwEENBUoyCzOdiiVWmCwN%2Fimage.png?alt=media&amp;token=f568113e-8ded-4af6-954b-c0a0effa4401" alt=""><figcaption></figcaption></figure></div>
