# SAP Datasphere

This guide details the step-by-step process for registering SAP Datasphere in ReleaseOwl, including environment management, user permission configuration, package synchronization, and efficient execution of deployment processes.

### Credential Registration <a href="#pdf-page-dk8rbzgxugve408ig5ly-credential-registration" id="pdf-page-dk8rbzgxugve408ig5ly-credential-registration"></a>

1. Admin users can switch to the **Administration View** to access the **Credential Manager**.
2. Click the **Credential Manager** menu option on the left-hand pane to view the list of registered credentials.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FCeBmWsdcT0pNjjPyoZku%2Fimage.png?alt=media&#x26;token=3acdb7d3-1076-4e88-a451-09870d38d867" alt=""><figcaption></figcaption></figure>

3. To add a new credential, click **Register Credential** available on the right-hand panel, and then click on the **Register Credential** button.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F62nEB3RkbrlpvqcxRxpp%2Fimage.png?alt=media&#x26;token=7aca2efa-da36-41a9-bad8-21cca3103af1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://open.gitbook.com/~gitbook/image?url=https%3A%2F%2F1890383800-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDWyxe6hm5vqosFaByVgs%252Fuploads%252FOlQXbRau9NAUz064D5V8%252Fimage.png%3Falt%3Dmedia%26token%3D403b126d-ca63-4a3f-ab49-49cb64c161bd&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=cb343d62&#x26;sv=2" alt=""><figcaption></figcaption></figure>

4. Fill in the required fields:

* **Credential Name**: Enter a name of your choice.
* **Credential Type**: Select **SAP Datasphere.**

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fqnb2U2JI54BlMrOGLR2o%2Fimage.png?alt=media&#x26;token=9456301b-87e9-4dda-9e02-c4012828e0f5" alt=""><figcaption></figcaption></figure>

5. For the Client ID, Secret, Token URL, and Authorization URL:
6. Log in to your **SAP Datasphere** (formerly known as SAP Data Warehouse Cloud) instance.

* Click on your **profile icon** in the top-right corner.
* Select **System** > **Administration**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F9A3Jb9kcATspJHUtVpKL%2Fimage.png?alt=media&#x26;token=6d6e95e0-7aae-4781-95b3-9191e7efee86" alt=""><figcaption></figcaption></figure>

* Navigate to the **App Integration** tab.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FGLSfDF3EfkHUelt1zKIv%2Fimage.png?alt=media&#x26;token=786b7f71-e696-4361-87d8-5e472a082148" alt=""><figcaption></figcaption></figure>

7. **Add a New OAuth Client:**

* Click on **Add OAuth Client**.
* Provide a **Client Name**.
* Enter the **Redirect URI** (callback URL for your application).
* Click **Add** to register the client.

{% hint style="info" %}
**Note :** Once added, the system will generate the **Client ID** and **Client Secret**. Ensure these values are copied and stored securely.
{% endhint %}

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fv4SWiQUhfNqeTLkNp6pQ%2Fimage.png?alt=media&#x26;token=5376df64-80bf-48b8-adca-302f79cd4fa4" alt=""><figcaption></figcaption></figure>

8. **Obtain OAuth Endpoints:**

* The **Authorization URL** and **Token URL** can be accessed from the **App Integration** section, typically shown outside the list of registered clients.

9. **Save OAuth Credentials:**

In the Credential Manager, provide the following details:

* **Client ID**
* **Client Secret**
* **Authorization URL**
* **Token URL**

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F5GJ6eq9o8DDOXfZjmn3d%2Fimage.png?alt=media&#x26;token=ff58dbdc-e46f-4403-8959-ebe467488eb9" alt=""><figcaption></figcaption></figure>

* After entering the required information, click the **Save** button. Upon successful save, a **Generate Token** button will appear. Click this button to initiate token generation and validate the entered credentials.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F5mWS3sdZ2B5TzHvM6Zar%2Fimage.png?alt=media&#x26;token=bd6c0b73-e11e-4040-9fc5-b7be637d879c" alt=""><figcaption></figcaption></figure>

* This process confirms whether the provided details can establish a successful connection with the authentication server.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FGZluGvZAqz4npAx9dnIE%2Fimage.png?alt=media&#x26;token=dbcfc225-5bbc-465f-aa4c-54f44e76fd4d" alt=""><figcaption></figcaption></figure>

### **To Register SAP Datasphere:** <a href="#pdf-page-dk8rbzgxugve408ig5ly-to-register-sap-datasphere" id="pdf-page-dk8rbzgxugve408ig5ly-to-register-sap-datasphere"></a>

1. In Environments, go to **SAP Datasphere**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FcOnY2nOMckLwNvG50I3f%2Fimage.png?alt=media&#x26;token=bdac6f54-b636-4671-8006-4f3482c8a40a" alt=""><figcaption></figcaption></figure>

2. Click **Register SAP Datasphere Environment**. The following screen is displayed:

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FbotkbMB5CHNb0MrIQksP%2Fimage.png?alt=media&#x26;token=32e73a33-71eb-4fda-8c37-d809e0c6d5e6" alt=""><figcaption></figcaption></figure>

3. **Fill in the required details:**

* **Name**: Enter a name for your reference.
* **OAuth Credentials**: Select the SAP Datasphere OAuth Credentials registered with ReleaseOwl.
* **Host URL**: Enter the host URL of the SAP Datasphere environment.
* **Environment Type**: Select the environment type you are registering (e.g., Dev or QA, etc.).

4. Click **Save** to register the environment.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FYa2RL6bxRXjwyfRUZHQv%2Fimage.png?alt=media&#x26;token=671f198e-c8a9-4486-948b-ae41ebffc776" alt=""><figcaption></figcaption></figure>

5. The registered environments are displayed.
6. Click on the required environment to view the details.
7. Click the **edit icon** to edit the registered SAC Environment.
8. Click the **delete icon** to delete the required environment.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FMCexsMzTN4PDZ7xQqgo9%2Fimage.png?alt=media&#x26;token=b534e16a-a9e4-418b-ae5b-4c3eb4c1cc57" alt=""><figcaption></figcaption></figure>

### **Adding SAP Datasphere to the Project:** <a href="#pdf-page-gxe94pcl07aymb35lkd4-adding-sac-environments-to-the-project" id="pdf-page-gxe94pcl07aymb35lkd4-adding-sac-environments-to-the-project"></a>

The SAP Datasphere must be registered in **Project Settings** in ReleaseOwl.

1. **To register SAP datasphere:**

   * Go to the **Projects** drop-down at the top right corner and click **Project Settings**.
   * In **Project Settings**, navigate to **Environment**.
   * The following screen is displayed.

   <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FYwDRYpPwm3aQOSlZhrd3%2Fimage.png?alt=media&#x26;token=cc3617a1-bd1d-40d3-83e3-fd0127dface1" alt=""><figcaption></figcaption></figure>
2. **Click Add** to add a new environment in ReleaseOwl.

   * In the subsequent screen, select the required environments from the list displayed.
   * Select **Source environment** and **Save** the changes.

   <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FQ4lzNy2xIwL6AA4ufyWm%2Fimage.png?alt=media&#x26;token=c8594c9c-ef8b-465f-bbb6-b584a59cd982" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** Only the artifacts from the source are synced to ReleaseOwl.
{% endhint %}

3. The environment gets added to the corresponding project in ReleaseOwl.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FJa0xnwKJt3FlVTa7qiCB%2Fimage.png?alt=media&#x26;token=62407487-20d9-40ce-b4c3-2bf2b6047d5d" alt=""><figcaption></figcaption></figure>

4. Click on the **Users** tab. This tab lists all existing users associated with the project.
5. Click on the **edit (lock)** icon next to the user for whom you want to manage roles and permissions.
6. This will open the **Permissions** page for the selected user.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FGwVlxsLznkiDTxgKeW01%2Fimage.png?alt=media&#x26;token=6829a373-c323-41bb-9e9d-69ea5baec8d9" alt=""><figcaption></figcaption></figure>

7. Under the **lock icon** button. The roles assigned to the selected user are displayed.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FNzA2uZdZ0kcI8Y9JVvPN%2Fimage.png?alt=media&#x26;token=4fe04f42-b921-4e9b-989e-db8f2a80cae6" alt=""><figcaption></figcaption></figure>

8. Scroll down to the Environments section.
9. Check the Deploy checkbox for the relevant environment(s) to enable deploy access.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FBO7SWnt1ImlhY2DkOJtE%2Fimage.png?alt=media&#x26;token=7df07e6f-aee7-46b6-a2f3-48af1543c7eb" alt=""><figcaption></figcaption></figure>

### **SAP Datasphere  and Deployment**

1. **Sync Packages:**

   * Go to **SAP Datasphere** in the **Build** section and click on **Sync Packages**.

   <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F5cgGnyCnWxe2eSXjsexl%2Fimage.png?alt=media&#x26;token=06d2fd9d-b301-4892-86e7-6e5fab29cac8" alt=""><figcaption></figcaption></figure>

   * You can see the **Deployment History** by clicking on the **Actions** button and selecting **Deployment History**.

   <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FWPdPRuMgpklm8pjfQj1U%2Fimage.png?alt=media&#x26;token=423e94cf-d184-41a3-8847-06a222ae1008" alt=""><figcaption></figcaption></figure>
2. **View Package Details:**

   * Click the **Actions** button and select **Import Settings** to view package details.

   <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FbMSkPWGmjUfjUBmfVYpH%2Fimage.png?alt=media&#x26;token=b80974ef-b03f-4ea7-a216-37d9c7636d48" alt=""><figcaption></figcaption></figure>

   * Each package has different import settings, and you need to configure the import settings for the required package.

   <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FJ6w52cBhtCD7RCOlRHSJ%2Fimage.png?alt=media&#x26;token=0078fa5e-a7a5-418d-a28b-93555fab5970" alt=""><figcaption></figcaption></figure>
3. **Release  Pipelines:**

* Go to the Release Pipelines and click on the **Create New Release Pipeline.**

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FkSnDwEwJoSJqmuvGF11h%2Fimage.png?alt=media&#x26;token=254fd1db-aa4d-4378-bce5-80e9c85a0acd" alt=""><figcaption></figcaption></figure>

* Enter a **Pipeline Name**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FH4e0Bzc3dMBzsSkrnrSl%2Fimage.png?alt=media&#x26;token=332e0bcf-d984-4176-af8b-040d74dba946" alt=""><figcaption></figcaption></figure>

* Click **Add Stage**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F43XhnuNWkHuq90mJVFNI%2Fimage.png?alt=media&#x26;token=24b7a8bc-bc5d-4a99-b6d0-796b6c24dbae" alt=""><figcaption></figcaption></figure>

* Enter the stage name say for e.g., UAT or QA where the deployment has to be carried out and click OK.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FIAG9q4iMCKFiUqJcVz0P%2Fimage.png?alt=media&#x26;token=617e6ef7-dd02-4385-bf87-c4b8f7ce925f" alt=""><figcaption></figcaption></figure>

* **Tasks:** Click **Add** to enter any tasks that are to be performed.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FuIhxtE6lqwSYnupD8TGv%2Fimage.png?alt=media&#x26;token=1b0cf350-a35d-49c4-abad-e1ec97ac9ac7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** To remove any stage, click Remove stage button.
{% endhint %}

* Different tasks that can be added are as follows:\\

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FH9LidZKgB1rSZwR82KwN%2Fimage.png?alt=media&#x26;token=3740d758-e0d0-439d-9540-5943ca8ff4f9" alt=""><figcaption></figcaption></figure>

**Add a Deployment Stage**

* Click on **Add** under the **Tasks** section.
* Select **SDS - Deployment** from the available task types.

**Configure Task Details**

In the **Task Details** panel on the right side, fill in the following information:

| **Field**                  | **Description**                                              |
| -------------------------- | ------------------------------------------------------------ |
| **Name**                   | Enter a unique name for your task.                           |
| **Description**            | Optionally, provide a brief description of the task.         |
| **Select SDS Environment** | Choose the SDS environment for deployment from the dropdown. |

**Optional Settings**

You may optionally configure the following:

* **Schedule Time**\
  Enable this checkbox to schedule the deployment at a specific date and time.
* **Notify Users**\
  Enable this checkbox to send email notifications to selected users after task execution.
* **Notify Promotion User**\
  Enable this checkbox to notify the user who promoted the pipeline.

**Finalize the Task**

* Once all configurations are complete, click **Next** to proceed to **Step 3: Notification Email(s)** or continue adding more tasks as needed.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Ft6Dxb2Ck4QYDwmgUOZby%2Fimage.png?alt=media&#x26;token=a2051c16-daae-4480-91c9-cccba785a98e" alt=""><figcaption></figcaption></figure>

4. **Change Management:**

* Navigate to the **Change Management** section.
* Go to **User Stories**, click on the **Create New User Story**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F4jByg9El0LMWo2uJuIPQ%2Fimage.png?alt=media&#x26;token=15bdeb7c-8cae-4fe8-bd73-737b3cce63d4" alt=""><figcaption></figcaption></figure>

* Fill in the required fields, such as:
  * **Summary**: A clear and concise name for the user story.
  * **Description**: Detailed explanation of the requirement or feature.
  * **Release Version**, **Sprint**, **Assigned To**, and any other custom fields as applicable.
* After entering the details, click the **Save** button to create the User Story.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FFFoOsEPzSFsjhF15UcUu%2Fimage.png?alt=media&#x26;token=afa74edb-d117-4770-ad03-2e0ced554b9c" alt=""><figcaption></figcaption></figure>

* Once the User Story is created, it will appear in the list/grid view.
* Click on the **Edit** next to the User Story entry.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FjD0VTj9bjVzWGRwzZLWv%2Fimage.png?alt=media&#x26;token=f51fa37e-ed63-44d6-b626-83cf7592ac0b" alt=""><figcaption></figcaption></figure>

* Click on the **+Add** button to add **SAC Packages**.
* Click on the **Save** button.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FErhRCokWdbvDEBDTywuy%2Fimage.png?alt=media&#x26;token=69c28255-2988-4ea9-a462-2191142ec6fa" alt=""><figcaption></figcaption></figure>

4. **Promote User Story:**

* Click on **Promote** to promote the user story.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fpk49PKP99ZYYZKZDfLnp%2Fimage.png?alt=media&#x26;token=35733827-b0c0-4eeb-9b4e-eba54709ec91" alt=""><figcaption></figcaption></figure>

5. **Check Deployment Status:**

   * Click on the **Pipeline Activity** to view the deployment status.

   <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FBtHw5Odb41CPajICh4q1%2Fimage.png?alt=media&#x26;token=07e56fd7-bc61-4183-9ac2-fa4a61929d8c" alt=""><figcaption></figcaption></figure>

* Click on the **"Deploy Log"** button.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FdLtCXZWdYxCa0HIa8j44%2Fimage.png?alt=media&#x26;token=4cec2b27-db72-4644-acf3-09a0d5875079" alt=""><figcaption></figcaption></figure>

* A pop-up window titled **SAP Datasphere Cloud Deploy Log** will appear, displaying deployment details.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FevgonxGWkeERlTsT3GbB%2Fimage.png?alt=media&#x26;token=8122168b-0685-49e4-8350-4212dee40df8" alt=""><figcaption></figcaption></figure>
