Uploading a Application building block

Prerequisites

Procedure

There are two types of building blocks:

  • Private : Only visible to users within the same account

  • Public : Visible to all users who open the Neptune DXP Marketplace

Step 1. Build the solution

  1. Define a Development Package and give it a meaningful name

  2. Place all artifacts in the Development Package that need to be included into the application building block

Optional: Add documentation

Step 2. GitHub Repository

  1. Create a public repository with a README file on your gitHub account

  2. Name it just like the Development Package that was defined before

Step 3. GitHub Authorization Token

  1. On GitHub, in the upper-right corner of any page, click your profile photo, then click Settings

  2. In the left sidebar, click <> Developer settings

  3. In the left sidebar, under Personal access tokens, click Token (classic)

  4. Click Generate new token and choose For general use

  5. Select Expiration period and click all the boxes

  6. Click Generate Token located at the bottom and save the token key somewhere safe

Step 4. Pushing Development Package to the repository

  1. In GitHub, head to your repository, and copy its URL

  2. In the Neptune Cockpit, on your Development Package, enable Git and CI/CD and paste the URL

  3. Click Configure Authentication on the Git tab and, choose GitHub and paste the token

  4. Press on Commit Message and enter a meaningful message

Step 5. Uploading to Neptune DXP Marketplace

  1. Head to Neptune DXP Marketplace and click upload

  2. Select Public for making it visible to users within the same account or, select Private for making it visible to all users who open the Neptune DXP Marketplace. It that case, it will be sent first for approval

  3. At Type select Application Building Blocks, add a Title and an Intro.

  4. Add a meaningful description and instructions if you there is no documentation in the package or in the application

  5. Under Description select the Type

    Type: An Application Building Block can be available for both the SAP and Open Edition, or just the Open Edition. If you do select Neptune DXP - Open Edition Git Installation & Neptune DXP - SAP Edition Components, you will encounter an extra step. In that step, select the type of SAP Object you are uploading, enter the names and paste the raw XML
  6. At GitHub URL, add the repo’s URL

  7. Include Tags, an Icon and Images

  8. Click Create

Result

You have successfully uploaded a building block in the Neptune DXP Marketplace