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

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.

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

1. Fill in the required fields:

• Credential Name: Enter a name of your choice.

• Credential Type: Select SAP Datasphere.

1. For the Client ID, Secret, Token URL, and Authorization URL:

2. 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.

• Navigate to the App Integration tab.

1. 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.

Note : Once added, the system will generate the Client ID and Client Secret. Ensure these values are copied and stored securely.

1. 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.

1. Save OAuth Credentials:

• Copy and securely store the following:

  • Client ID

  • Client Secret

  • Authorization URL

  • Token URL

To Register SAP Datasphere:

1. In Environments, go to SAP Datasphere.

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

1. 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.).

1. Click Save to register the environment.

1. The registered environments are displayed.

2. Click on the required environment to view the details.

3. Click the edit icon to edit the registered SAC Environment.

4. Click the delete icon to delete the required environment.

Adding SAP Datasphere to the Project:

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.

   
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.

   

Note: Only the artifacts from the source are synced to ReleaseOwl.

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

1. Click on the Users tab. This tab lists all existing users associated with the project.

2. Click on the edit (lock) icon next to the user for whom you want to manage roles and permissions.

3. This will open the Permissions page for the selected user.

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

1. Scroll down to the Environments section.

2. Check the Deploy checkbox for the relevant environment(s) to enable deploy access.

SAP Datasphere and Deployment

1. Sync Packages:

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

   

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

   
2. View Package Details:

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

   

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

   
3. Release Pipelines:

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

• Enter a Pipeline Name.

• Click Add Stage.

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

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

Note: To remove any stage, click Remove stage button.

• Different tasks that can be added are as follows:

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.

1. Change Management:

• Navigate to the Change Management section.

• Go to User Stories, click on the Create New User Story.

• 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.

• Once the User Story is created, it will appear in the list/grid view.

• Click on the Edit next to the User Story entry.

• Click on the +Add button to add SAC Packages.

• Click on the Save button.

1. Promote User Story:

• Click on Promote to promote the user story.

1. Check Deployment Status:

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

   

• Click on the "Deploy Log" button.

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