> 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/synchronize-cpi-artifacts.md).

# Synchronize CPI Artifacts

#### SAP CPI Management – Add Packages

1. Navigate to **Build → SAP CPI Management**.
2. Click **Add Packages** to synchronize packages from the registered **SAP Integration Suite** environment.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FcrekgC3DzOx0hqDEZxTu%2Fimage.png?alt=media&amp;token=652a330c-b942-4fa6-b993-f7cd673d2bf0" alt=""><figcaption></figcaption></figure>

3. The system displays the list of available packages for selection.
4. Select the required packages and click **Add**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FV4Dn7PVerWatM3Wyry6q%2Fimage.png?alt=media&amp;token=dfa9948a-3eb4-45ed-a0ff-77a0fef7a9b0" alt=""><figcaption></figcaption></figure>

5. After the packages are added, the following details are displayed:

* **Version**
* **Synced On**
* **Synced By**
* **Modified By**
* **Modified On**

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F7wnZdG5X8oqqeacwfjEa%2Fimage.png?alt=media&amp;token=2beec50f-2917-464a-bae7-ba6f52fbbde2" alt=""><figcaption></figcaption></figure>

#### Metadata Behavior

6. For supported artifact types, ReleaseOwl retrieves the **Modified By** and **Modified On** details directly from **SAP Integration Suite**. Supported artifact types include:

* **IFLOW**
* **ODATAAPIPROVIDER**
* **SOAPAPIPROVIDER**
* **RESTAPIPROVIDER**

7. For the following artifact types, **SAP Integration Suite** does not expose metadata details through its public APIs:

* **SCRIPT\_COLLECTION**
* **MESSAGE\_MAPPING**
* **VALUE\_MAPPING**

8. For these artifact types, ReleaseOwl generates the **Modified By** and **Modified On** details based on internal processing activity, indicating when the artifact was last processed or updated within the platform

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fdp9UKUdQedXxyIqdRRZz%2Fimage.png?alt=media&amp;token=89ee70f8-0ddb-4b22-8ec1-6f22f8eed9b9" alt=""><figcaption></figcaption></figure>

### **Sync History**

Click **Sync History** to view the history of all synchronization activities performed for the **SAP CPI** packages, including previously synced packages and their corresponding sync details.

<div><figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FlEFmZEjZ3tvvxAkJxZ7l%2Fimage.png?alt=media&amp;token=de87c990-a4f3-4d03-9c64-a8aeb5591caf" alt=""><figcaption></figcaption></figure> <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F4Sijj874hRaSwTqNJ62A%2Fimage.png?alt=media&amp;token=fb53bb53-8d45-40ca-98e9-9d6c66a57cc4" alt=""><figcaption></figcaption></figure></div>

### **Sync Artifacts**

1. After a package is added, click the **Actions** button associated with the package.
2. Select **Sync Artifacts**.
3. Click **Sync Artifacts** to retrieve artifacts associated with the selected package from the registered **SAP Integration Suite** environment.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FjwpbwwTkGAoXDxBxvN4u%2Fimage.png?alt=media&amp;token=965cbad0-d7be-47f3-bf6a-5aadd1498cda" alt=""><figcaption></figcaption></figure>

### **Remove From Project**

This option is used to remove a package from the project in **ReleaseOwl**. When you select this action, the package is automatically removed from the project and will no longer be available within the project scope.

<div><figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FCvoiVRwdifeocI04nOQb%2Fimage.png?alt=media&amp;token=ff42a62e-e9a9-49fb-9efa-db2644adf7ef" alt=""><figcaption></figcaption></figure> <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FXGGrmTUh62kTjHy4NiYs%2Fimage.png?alt=media&amp;token=3a92b91c-4743-4267-9fae-509944d23ae8" alt=""><figcaption></figcaption></figure></div>

### **Sort**

You can sort the artifacts as per your convenience. To sort them:

1. Click the **Sort icon**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FV4NbHNYp192YmuyCcYYO%2Fimage.png?alt=media&amp;token=8670402c-0135-42f9-9471-d712d6c8a383" alt=""><figcaption></figcaption></figure>

2. In the page displayed, choose an option and click **OK**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fwdzq9Oe2zj9Fkd5t5ft6%2Fimage.png?alt=media&amp;token=d9321fb9-ade5-4af0-9061-93429134e2c9" alt=""><figcaption></figcaption></figure>

### **Actions**

After a package is added to the project, you can view its artifacts and perform various actions on each artifact based on its type.&#x20;

The available actions are described below:

* **Synchronize**\
  Used to sync the latest changes of the artifact from the connected SAP Integration Suite environment into ReleaseOwl. This ensures that the artifact details in ReleaseOwl are up to date.
* **Configure**\
  Used to configure artifact-specific settings required for deployment or execution.
* **Resources**\
  Displays additional supporting information related to the artifact, such as its **type and size**. This helps users quickly understand the nature and storage details of the artifact within the project.
* **Deployment History**\
  Displays the complete history of deployments for the selected artifact, including status and timestamps.
* **Versions**\
  Shows all available versions of the artifact, allowing you to track changes over time.
* **Download**\
  Allows you to download the artifact for offline use or reference.
* **Comment**\
  Enables you to add or view comments related to the artifact for collaboration and tracking purposes.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FehNMvekdGZ17SAhDRnic%2Fimage.png?alt=media&amp;token=d7884710-9779-4423-bf76-aaa39a3d879f" alt=""><figcaption></figcaption></figure>

### Synchronize

It is used to retrieve and update the latest artifacts from the connected SAP Integration Suite (CPI) environment into **ReleaseOwl**. This ensures that **ReleaseOwl** reflects the most recent changes made in the source system, including updates to artifact details such as version, configuration, and metadata.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FLKaztOh3DrB5rLRICH5L%2Fimage.png?alt=media&amp;token=a3317974-883e-469b-91e5-31c157511ec2" alt=""><figcaption></figcaption></figure>

### Configure

You can maintain configuration parameters for IFlows for each environment separately in ReleaseOwl. These will be updated accordingly during the deployment.

#### **To configure an artifact:**

1\. Go to the required artifact, click **Actions** and choose **Configure**.

2\. The following screen is displayed that will show various configuration parameters for the Integration Suite environments that are part of the landscape.

3\. No changes can be made to **Dev** environment.

4\. To make changes in any other environment, click the edit icon on the required name and make changes. Click **Save**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FsQedd2Kz3oItuP04ddVY%2Fimage.png?alt=media&amp;token=76ea526f-9652-4687-85ee-9f42bdde4067" alt=""><figcaption></figcaption></figure>

### **Versions**

1\. To view the versions, go to the required artifact, click **Actions** and choose **Versions**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F9JbGIhPB5zMJIKYMf473%2Fimage.png?alt=media&amp;token=404b93cb-ee28-4989-80fb-b3694a3751c3" alt=""><figcaption></figcaption></figure>

2. &#x20;The following screen is displayed showing the user different versions of the artifact.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fv65S4hNFPF2AiI5k6BVU%2Fimage.png?alt=media&amp;token=77e6bfb0-6e92-47c1-a21b-a05dfbbe33ea" alt=""><figcaption></figcaption></figure>

#### **Compare Environments**

The **Compare Environments** option is used to compare an iFlow between two different environments. It helps you identify differences between:

* **Source Environment**: Contains the source version of the iFlow
* **Destination Environment**: Contains the active version of the iFlow

#### Steps:

1. Click **Compare Environments**
2. Select the **Source Environment**
3. Select the **Destination Environment**
4. Click **Submit**

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FxklVhYJ59eZlzZnpUDcj%2Fimage.png?alt=media&amp;token=24c77cdb-f0cf-441e-a677-ae9562f03672" alt=""><figcaption></figcaption></figure>

5. The system will display the differences between the iFlow versions across the selected environments.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F0RB9T8fxdxujHCZq1aGz%2Fimage.png?alt=media&amp;token=da09f6b9-32bc-4ced-97b9-819294c23732" alt=""><figcaption></figcaption></figure>

#### Compare Versions

The **Compare Versions** option is used to compare two different versions of the same iFlow within an environment.

**Steps:**

1. Click **Compare Versions**
2. Select the two iFlow versions you want to compare
3. Submit the selection

The system will show a side-by-side comparison highlighting the differences between the selected versions.<br>

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fxh7q7kBOgEhFgOauNOXI%2Fimage.png?alt=media&amp;token=169c2660-c760-43fc-aca6-ddfce2960f24" alt=""><figcaption></figcaption></figure>

### Assign User Story

The **Assign User Story** option is used to link a specific version of an artifact (such as a configuration or integration flow) to a designated User Story.

This helps maintain traceability between development requirements and artifact versions.

**Steps:**

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%2F1m726O7DISK8pfbxcLvU%2Fimage.png?alt=media&amp;token=ca278918-2d5c-4b2f-97db-f87553dbb609" alt=""><figcaption></figcaption></figure>

2. The system will prompt a selection window
3. Select the required **User Story**
4. Confirm the selection

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FRMKVKNSv5hn8SYgj9lXc%2Fimage.png?alt=media&amp;token=59b1c72a-8c33-402e-a16c-6a4b845eaed0" alt=""><figcaption></figcaption></figure>

The current version of the artifact is associated with the selected User Story, creating a traceable link between the implementation and the requirement.

### Download

You can download the required artifact. To download:

1. Go to the required artifact. Click **Actions** and choose **Download**.
2. A zip file of the artifact is downloaded into your computer.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FwGibIkBaVtR1tmkPdQ2K%2Fimage.png?alt=media&amp;token=4286827a-1d9e-40fe-9074-fc00b2d16a80" alt=""><figcaption></figcaption></figure>

### Comment

To add or update a comment for a specific version of an artifact:

1. Navigate to the required artifact.
2. Click the **Actions** button.
3. Select **Comment** from the dropdown.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fuci2bgvulmkQgDllODpf%2Fimage.png?alt=media&amp;token=98ac202c-e6b6-41d8-ae9f-3f60af893686" alt=""><figcaption></figcaption></figure>

4. Click the **Edit** next to the comment.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FzGSx4nQlUW9X3FmuOdze%2Fimage.png?alt=media&amp;token=279aaf68-0b66-4ada-abcb-021046e451cd" alt=""><figcaption></figcaption></figure>

5. Enter  the comment text as needed.
6. Click **Save** to store the comment for the CPI artifact.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fj5gjGmpxGutapdrWyLNi%2Fimage.png?alt=media&amp;token=d7203dd1-2c43-44e2-a99e-7a8c82ce55a2" alt=""><figcaption></figcaption></figure>

7. The **Comment** button is located adjacent to the **Version** field.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FZ16R6wtWAcwJfy4h1wrh%2Fimage.png?alt=media&amp;token=afd2d991-b531-44d7-bd42-d38241f3637f" alt=""><figcaption></figcaption></figure>

8. When clicked, it displays the **Created by**, **Created on**, **Modified by**, and **Modified on** information.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fek8h5CbYjeS36gnyGT9S%2Fimage.png?alt=media&amp;token=6cd255ee-a54d-4349-a732-05419f8bc0ce" alt=""><figcaption></figcaption></figure>

### Deployment History

The **Deployment History** option displays the complete history of a package’s deployment activities. It provides detailed tracking of each artifact deployed within the package.

<div><figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FvnxvDRrWDtfDxHEMFy1P%2Fimage.png?alt=media&amp;token=c66fbc02-602c-4a4d-b266-dfdc1c0ed7da" alt=""><figcaption></figcaption></figure> <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fib7apGsKYPKjEtDUFsGB%2Fimage.png?alt=media&amp;token=434b69ad-2bf7-442f-98f9-c14edde2241a" alt=""><figcaption></figcaption></figure></div>
