Create Action Project for simple CAP Service in Lobby

The OpenAPI spec was generated as part of the previous tutorial Create simple CAP Service with Node.js using the SAP Business Application Studio. This definition will be used to create the Action Project in SAP Build and needs some manual changes.

1. In the subfolder docs folder, open the file sap_build_cap_sample_library.openapi3.json

   

2. Update the following paths definitions, add the missing quotes (just replace the lines in the generated file)

   JSON

   Copy

   "/toInteger(value='{value}')": {
   

   JSON

   Copy

   "/toNumber(value='{value}')": {
   

   JSON

   Copy

   "/addQuotes(value='{value}')": {    
   

3. Update the paths and schema definition for getListOfTodos (just replace the lines in the generated file)

   The output for this action must be set as required, this needs two modifications

   • remove allOf for the paths definition

     JSON

     Copy

     "/getListOfTodos()": {
     "get": {
         "summary": "get list of Todos",
         "tags": [
         "Service Operations"
         ],
         "parameters": [],
         "responses": {
         "200": {
             "description": "Success",
             "content": {
             "application/json": {
                 "schema": {
                     "$ref": "#/components/schemas/sap_build_cap_sample_library.DataListArray"
                 }
             }
             }
         },
         "4XX": {
     

   • add required: true for components/schemas schema definition of DataListArray

     JSON

     Copy

     "sap_build_cap_sample_library.DataListArray": {
     "title": "DataListArray",
     "type": "object",
     "properties": {
         "responseArray": {
         "type": "array",
         "required": true,
         "items": {
             "$ref": "#/components/schemas/sap_build_cap_sample_library.DataList"
         }
     

4. Update the responses > schema definition

   To get correct output information for the actions just replace the lines in the generated file in each of the following sections

   • /toInteger(value='{value}'): {

     JSON

     Copy

     "200": {
     "description": "Success",
     "content": {
         "application/json": {
         "schema": {
                 "$ref": "#/components/schemas/sap_build_cap_sample_library.DataInteger"
         }
         }
     }
     },
     "4XX": {    
     

   • /toNumber(value='{value}'): {

     JSON

     Copy

     "200": {
     "description": "Success",
     "content": {
         "application/json": {
         "schema": {
                 "$ref": "#/components/schemas/sap_build_cap_sample_library.DataNumber"
         }
         }
     }
     },
     "4XX": {    
     

   • /toStr(value={value}): { and

   • /addQuotes(value='{value}'): { and

   • /listToString: {

     JSON

     Copy

     "200": {
     "description": "Success",
     "content": {
         "application/json": {
         "schema": {
                 "$ref": "#/components/schemas/sap_build_cap_sample_library.DataString"
         }
         }
     }
     },
     "4XX": {
     

5. Select the file content Ctrl-a in the editor and copy to your clipboard Ctrl-c

6. Create a new file called demo.json in a local folder of your desktop

7. Open the file, paste the content and save the file. You will use the file later to create the Action Project.

   Here a screenshot with parts how the file will look like:

   

1. From the Lobby of SAP Build click Create

   

2. In the popup, choose Build an Automated Process and then select type Actions.

   

3. Specify the name CAP Sample Actions and upload the API spec demo.json, click Create

   

4. Once the action project is created, the action editor will automatically open. In the popup select all actions from the list, click Add

   

Your Action Project will contain the actions for the CAP service

 

You can test the execution of your action in the Action Editor.

1. Select listToString from the list, the action has input parameters

2. Select Tab Test

   • Choose Destination Demo_CAP_Sample_Library

   • enter id 1

   • enter title task1

   • enter field id

   • Click Test

   

   In the Test you can specify only one value for a list. In the Response View you can see that the values are converted to a string (with more than one value they will be comma separated). You can also try title as field and check the result.

3. Select get list of Todos from the list, click Output tab to check that the array is marked as required with red asterix

   

4. Select Test tab and click Test

   

5. You can test the other actions (optional)

   • Select toInteger from the list, enter value 10 and click Test

   • Select toNumber from the list, enter value 10.9 and click Test

   • Select adQuotes from the list, enter value abc and click Test

To be able to use the Actions in a Process, you have to release and publish the Action Project.

1. Click Release

   

2. Enter release information, click Release

   

3. Click Publish to Library