Integration Advisor

Prerequisites : Before proceeding with Integration Advisor , ensure the following are in place:

1. Integration Suite Created: The Integration Suite must be set up within SAP Business Technology Platform (SAP BTP).

2. API Instance Created: An API Instance must be created to provide the credentials required for configuration in the CPI Environment.

3. SAP CPI Environment Configured in ReleaseOwl

Steps to Create a Custom Type System

1. Navigate to Integration Suite.

2. Click on the Actions button (...) to open the application.

3. Click on the Design section.

4. Under Design, select Custom Type Systems.

5. Choose the type of system you want to create:

   • Custom Codelists

   • Custom IDocs

   • Custom Messages

   • Custom SOA Messages

6. Enter the required details and save the configuration.

Creating MIG and MAG in Integration Advisor

The following integration artifacts are created within the Integration Advisor service in SAP Business Technology Platform (SAP BTP):

• MIG (Message Implementation Guideline)

• MAG (Mapping Guideline)

Creating the project

1. Go to the Administration page.

2. Under the Projects section, click on the Create New Project button (top-right corner).

3. Fill in the Project Details:

   • A popup form titled Create Project will appear.

   • Enter the required details in the form.

4. Click Save to create the project.

Environment Section

1. The newly created project will be listed in the Projects table.

2. Click on Switch to Project and go to the Project Settings.

3. In the Project Settings page, navigate to the Environments tab.

4. This section displays all environments already associated with the project.

5. Click on the + Add button in the top-right corner of the Environments table.

6. If this environment will serve as the source for deployments or synchronization, check the Source checkbox.

7. The newly added environment will appear in the Environments table with its Name, Type, and Host URL.

Managing User Permissions

1. Click on the Users tab.

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

1. The Permissions page for the selected user will open.

2. Scroll down to the Environments section.

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

Synchronization with ReleaseOwl

1. Go to the Build section and click on Integration Advisor.

2. Click on the Synchronize button to sync the integration artifacts.

1. The Sync History provides details of previous synchronizations, including:

• Synced On – Timestamp of synchronization.

• Synced By – User who performed the synchronization.

1. By clicking the Action button, you can view:

• Versions: Displays previous versions, allowing you to roll back changes if needed.

• Details: Provides additional information about the artifact.

Creating and Managing a Release Pipeline

1. Creating a New Release Pipeline

1. Navigate to the Release section.

2. Click on Release Pipeline and select Create New Release Pipeline.

3. Enter a name for the release pipeline.

4. Click +Add Stage to create a new stage.

2. Configuring Deployment Tasks

1. Under the Tasks section, click Add to create a task.

2. Select the deployment option for the deployment process.

3. Fill in the required details:

   • Name: Enter the task name.

   • Deploy Type: Choose either CPI or API.

   • Select Environment: Choose the target environment for deployment.

   • Deployment Action:

     • Upload and Deploy: Uploads and immediately deploys the package.

     • Upload Only: Uploads the package without deployment.

   • Rollback Settings: Enable rollback if needed for deployment recovery.

4. Once all required details are entered, save the pipeline.

5. (Optional) Configure Notification Emails to notify relevant users.

3. Setting Up Approval Tasks

1. Under the Tasks section, click Add to create a task and select Approval Task.

2. Fill in the necessary details:

   • Name: Assign a name to the approval task.

   • Assign To: Select who should approve the task:

     • User: Assign a specific user.

     • Role: Assign based on user roles.

     • Custom: Assign based on a custom rule.

     • Story Assignee: Assign to the person responsible for the user story.

3. Once configured, save the pipeline.

4. Assigning Artifacts to User Stories

1. Navigate to Change Management and click on User Stories.

2. Click Create New User Story, fill in the required details, and save it.

3. Click on the Action button, select Edit, and add the integration artifacts.

1. Click Save to update the user story.

2. Click Promote to check the deployment status of the user story.

3. Click Deploy Logs to view deployment details.

1. In the Info Section, you can see artifact details:

• For MAG: You can see the details of Message type and administrative data.

• For MIG: You can see the details of Source MIG, Target MIG, and administrative data.