Configuring SAP BTP Cloud Foundry and Adobe Forms Service API for Subaccount and Form Template Upload

This article explains how to configure the SAP BTP Cloud Foundry environment subaccount and the Forms Service by Adobe for API testing with Postman. It requires a subaccount with Forms Service entitlement. Users should use Microsoft Edge and follow steps to create ADS subscription instances, generate API keys, create an XDP template file, and upload it to ADS. Testing the Adobe rest API is done using Postman, with authentication via OAuth 2.0 and a custom URL.

The SAP Business Technology Platform (BTP) Cloud Foundry environment offers a range of services that enable developers to extend and personalize SAP applications. One such service is the Forms Service by Adobe, which can be utilized for API testing with popular tools like Postman. In this article, we will guide you through the process of setting up the SAP BTP Cloud Foundry environment subaccount and configuring the Adobe Forms Service for API testing using Postman.

Before we begin, ensure you have a subaccount with Forms Service entitlement. You can learn more about extending and personalizing SAP applications and setting up the Forms Service by Adobe in the SAP technology blog [1]. This comprehensive resource provides valuable insights into the capabilities of the Forms Service and how to use it effectively in the ABAP environment.

To configure the SAP BTP Cloud Foundry environment for API testing with Adobe Forms Service and Postman, follow these steps:

1. Create ADS subscription instances:
First, you need to create an ADS (Adobe Document Services) subscription instance. Log in to your SAP BTP Cloud Foundry environment and navigate to the "Destination Services" tab. Create a new destination of type "http" with the following properties:

* Host: your-ads-instance.scn.sap-nw.com
* Port: 443
* Path: /bcs/v2/service/adobe/forms
* Authentication: OAuth 2.0

Once the destination is created, use the OAuth client ID and secret from the destination settings to obtain an access token from the ADS authentication endpoint.

1. Generate API keys:
Next, log in to your Adobe Forms Service account and navigate to the "Admin Console" "Security" "API Access" "Keys." Click the "Generate Key" button to create a new API key. Note down the key ID and secret.

1. Create an XDP template file:
Design your XDP (XML Paper Specification) template file in Adobe Acrobat Pro DC. Once you have designed the template, save it as a .xdp file and upload it to your ADS subscription instance. You can do this by using the "AEM Forms - Forms" service in your ABAP environment.

1. Upload the template to ADS:
To upload the XDP template file to ADS, use the following API endpoint:

your-ads-instance.scn.sap-nw.com/bcs/v2/service/adobe/forms/templates

Use the OAuth access token obtained in step 2 to authenticate the request. Send a POST request with the XDP file in the request body.

1. Test the Adobe REST API:
Now that your XDP template is uploaded to ADS, you can test the Adobe REST API using Postman. Use the following API endpoint to submit a form for processing:

your-ads-instance.scn.sap-nw.com/bcs/v2/service/adobe/forms/submissions

Use the OAuth access token obtained in step 2 to authenticate the request. Send a POST request with the form data (e.g., name, email, etc.) and the XDP template ID in the request body.

In conclusion, configuring the SAP BTP Cloud Foundry environment for API testing with Adobe Forms Service and Postman is a straightforward process that enables developers to extend and personalize SAP applications more effectively. By following the steps outlined in this article and leveraging the resources provided in the SAP technology blog [1], you can create a working scenario out of the box and start testing your API integrations today.

[1] SAP Technology Blog. (2023, February 21). SAP Forms Service by Adobe in SAP BTP ABAP Environment.