Open Introduction

Purpose

This playbook details how to create a new Business Objects for use in the Cruise Accelerator. The end result is you will have a SAP REST API that you can easily interact with.

Audience

This guide should be used by the Neptune development team. It is assumed that the developer has knowledge of ABAP and Neptune DXP platform.

Prerequisites

Please ensure you have the following on your system:

• Neptune Software SAP & Open Edition have been installed
• The SAP system has been configured as a remote system in Open edition and an authentication mechanism has been added
• Cruise Accelerator has been installed in the SAP Edition (most likely via ABAPGit)
• You have development rights on the SAP system

Main Steps

1. MetaData gathering
2. Create Mappings
3. Generate Artifacts
4. Import APIs
5. Configure Connectors

Open Metadata

Metadata Analysis

The purpose of this step is to define the data access that you require in your external systems - and exposing this information in a business friendly way.

Here is an overview of what needs to be collated:

Background information

The data that you need to expose from SAP is likely stored in the SAP standard tables, and you can use you favourite search tool to get the information you need. SAP themselves provide a great resource which can provide you with the business friendly names that make working with Cruise such a pleasure.

Key resources:

• SAP Business Accelerator Hub
• LeanX table browser
• CDS View Search

Capturing in Excel

While it is possible to configure objects manually in Cruise, the simplest way to build new objects is by creating am Excel sh

Open Build Object Definition

Create Objects

Now that you collated all your information in previous step, time to create your new Object and upload it.

In the Cruise Admin Launchpad, open the maintain mapping parameters app:

Create a new Cruise Key

In the application, select "Maintain Keys" and create a new Cruise Key.

Provide the following details:

1. CDS View Name - the name of the view you want to create
2. The main table where the information is stored in SAP
3. The name of the ABAP Class e.g. ZCL_CRUISE_OBJECTNAME
4. Application log object name
5. Application log sub-object name
6. Whether you would like logging to be active

Below is the example of a company code mapping for reference: ![Cruise Key Overview.png](https://ebooks.vmglabs.com/u/cruise

Open Add Field Mappings

Add Field Mappings

The simplest way to create the field mappings is to upload the Excel sheet that was created during the metadata gathering phase.

In order to upload the mappings, open the Maintain mapping parameters application and navigate to the relevant Cruise object. Open the detail page and select "Upload Excel":

If your Excel is valid, a mapping table confirmation screen will be shown for you to confirm, and if necessary adjust before saving:

Review

It is now possible to review and adjust any of the mapping details before proceeding to the object generation step.

It is also possible to review and adjust the mapping table directly in SAP using the view cluster, the core tables are: ZCRUISE_MAP_KEY, ZCRUISE_MAP_HEAD, ZCRUISE_MAP_DET ![ZCRUISE_MAP_DET.png](https://ebooks.vmglabs.com/u/zcruise_map_det-bsRtBZ.p

Open Generate Mappings

AI Generated Mappings

We are using a pre-trained Anthropic model to autogenerate mapping proposals.

The CSV can be copied directly into an Excel and uploaded into our modelling tool.

We recommend reviewing the proposals before uploading them into the system

Seeing is believing

Please contact us for a demo on how quickly we can build an RESTful microservice for you.

Open Generate Artifacts

Autogenerate Assets

Now that we have provided the configuration for the entity you want to create, we provide a set of generation tools to create the single ABAP development class and associated objects for use within Neptune DXP.

All generation is done from the the mapping application. The generation of objects should only be done in your sandbox or development system, the objects should then be transported via the normal lifecycle management tools into your test and production enviroments.

The following sequential objects can be generated:

1. ABAP Package
2. ABAP Structure Definition
3. ABAP Table type
4. Data Provider Class
5. REST API Defintion in Neptune DXP

Creating objects

To generate the objects just click the create button, when available. As part of this process you will be asked to select a relevant transport request.

![Auto object generation.gif](https://ebooks.vmgl