Install ADS and Credentials in SAP NW ABAP and JAVA AS - SAP Blogs

1/12/23, 6:12 PM Install ADS and Credentials in SAP NW ABAP and JAVA AS | SAP Blogs
Community
Ask a Question Write a Blog Post Login
Former Member
March 31, 2012 | 10 minute read
Install ADS and Credentials in SAP NW

ABAP and JAVA AS
 4  6  18,529
Follow
Applies to:
 Like
As of SAP NetWeaver 7.0/ERP 6.0 (ABAP AS & JAVA AS)
 RSS Feed Summary
This document will guide you to install Adobe Document Services (ADS) and
Credentials in SAP applications (ABAP AS & JAVA AS) to take advantage of the full
Cred
range of capabilities in Adobe Document Professional, Adobe Acrobat Standard and
Adobe Reader.
Author(s): Siva Kumar Arivinti
Company: Deloitte Consulting India Pvt Ltd.
Created on: 30 March 2012
Author Bio
https://blogs.sap.com/2012/03/31/install-ads-and-credentials-in-sap-nw-abap-and-java-as/ 1/14
Siva Kumar Arivinti is currently working with Deloitte Consulting India Pvt Ltd., as
Consultant in AMS service line.
SAP NetWeaver Consultant with around 5 years of experience in SAP Basis and DB2
DBA Administration.
Expertise in Production support, Installations and Software Life Cycle Management

including EHP/Release Upgrades.
Benefits
Adobe document services create and deploy interactive forms that look exactly like
their paper counter parts. It generates dynamic PDF documents from data contained
in the SAP system. It captures data using forms and imports that data directly into
SAP System.
Pre-requisites
It is necessary to go through the following SAP Notes before we start the installation of ADS.
736902 – Adobe Cred

Credentials
944221 – Troubleshooting if problems occur in forms processing
894009 – ADS: Configuration Guide (NW 7.0)
685571 – Printing pdf based forms
Installation
I. Configuration in ABAP AS and JAVA AS (non-dual stack)
1. Create user ADSUSER in JAVA AS in either Visual Administrator or IRJ Portal, if it
does not exist already. Usually ADSUSER will be created during the installation in
JAVA AS system as of release NW 7.0
Visual Admin: server<x> –> services –> Security Provider.
IRJ Portal: http://<fully qualified name>:5<XX>00/irj/portal
Note: User type must be TECHNICAL USER as follows.
2. Assign security role in Java Stack.
a. Go to Visual Admin
b. On the Cluster tab, choose Server <x> → Services → Security Provider.
c. On the User Management tab, choose the Tree tab in the left panel.
d. In the User Tree, ensure that the user you created in ABAP appears under
the ADSCALLERS group.

e. On the Policy Configurations tab, in the Components area, select
com.adobe/AdobeDocumentServices*AdobeDocumentServicesAssembly.jar.
f. On the Security Roles tab, select ADSCALLER from the Security Roles list.
g. In the Mappings area, choose Add, which is assigned to Users. A dialog

Choose Users or Groups is displayed.
h. Choose the Tree tab.
i. In the User Tree, under the ADSCALLERS group, select the ADSUSER you
just created and choose OK. This assigns the new user to the ADSCALLERS
security role.

3. Create Service User ADS_AGENT in ABAP (SU01), if it does not exist.
a. User type must be “System”
b. Assign the role SAP_BC_FPADS_ICF and SAP_BC_FP_ICF or the

equivalent customizing roles.

4. Create ABAP RFC Connection (SM59)
a. Go to SM59 and create destination called ADS under “HTTP Connections

to External Server” and connection type “G”.
b. Provide Target Host in “Technical Settings” tab. If you are configuring in dual
stack (ABAP & JAVA) system like CRM, targethost must be ABAP host name
and specify the Service No. (5<XX>00).
Note: Patch Prefix must be /AdobeDocumentServices/Config?style=rpc

c. Go to “Logon & Security” tab; choose ‘Basic Authentication’ under Logon
Procedure. In Logon security Tab, enter ADSUSER and its password.
d. Other fields can be left as defaults.
e. Test the connection. You should be successful.
5. Activate ICF Services
a. Log on to your SAP Web AS ABAP system
b. Choose transaction SICF.
c. Choose default_host → sap → bc → fp in the tree.
d. Choose Service/Virt.Host → Activate
Note: If AS ABAP and AS Java (with ADS) are installed in different systems,
and you want to bundle your forms to improve performance, you also have to
activate the fpads ICF service.
6. Create following Destination Service FP_ICF_DATA_<SID> (Visual Admin)
a. Fill the fields URL (http://<hostname>:<HTTP_port>), System ID, Client (if
required to be set to specific client), Authentication and user name
& password of ADS_AGENT (which was created in ABAP stack) with respect to your
target system.
Note: You can get the HTTP_Port number from transaction SICF
b. Client on tab Save and Test
Note: If you choose Save and Test, you can ignore the message Error
during ping operation:
Received HTTP response 404.
7. Set up Basic Authentication in JAVA Environment
a. Log on to the Visual Administrator.
b. On the Cluster tab, choose Server <x> → Services → Web Services

Security.
c. Choose Web Service Clients → sap.com > tc~wd~pdfobject →
com.sap.tc.webdynpro.adsproxy.AdsProxy*ConfigPort_Document.
d. From the Authentication list, select BASIC.

e. In the User and Password boxes, enter as Username ADSUSER and a
Password.
f. Choose Save.

g. The authentication data must be activated. For doing this navigate to
Services → Deploy.
h. Choose the button Application.
i. Choose sap.com/tc~wd~pdfobject in the tree.
j. Choose Start Application.
II. Configuration in ABAP & JAVA AS (Dual Stack Systems)
a. In dual stack systems, we need to create both users ADSUSER and
ADS_AGNET in ABAP Stack via tcode SU01.
b. User type must be “System”
c. Create role ADSCALLERS and assign it to ADSUSER along with the
below shown SAP_BC* roles.

Note: The ADSCALLERS role in SAP NW AS ABAP appears automatically

as ADSCALLERS group in the J2EE Engine.
d. Perform the steps from 2 to 7 from the above.
III. Install Credentials

Cred for Adobe Document Service (ADS) Interactive forms.
1. Place cred

credential file *.pfx in
/sapmnt/<SID>/global/AdobeDocumentServices/TrustManagerService/trust/cred
cred
entials.
Note: You have to get the Adobe credentials

cred from SAP. Please go through the
note 736902 for more details. This cred
credential is unique for a customer/client
and this is one-time request.
2. Perform the below steps:
a. Log on to the Visual Administrator
b. On the Cluster tab, choose Server <x> –> Services –> Document Services
Configuration
c. From the Type field, select the type of credential

cred you are configuring (P12
Record)
d. In the Alias field, enter the alias of the cred

credential you installed
(ReaderRights)
e. For a P12 Record, choose Browse to search for the name of the cred
credential
and then select.
f. In Password field, enter the password you received together with the
credential you installed.
cred
g. Confirm the password again and then click Add.
The page refreshes and the list of registered cred

credentials at the top of the page
includes the cred
credential you just added.
3. Restart Java Engine.
4. Execute report FP_TEST_IA_01 via SA38. After giving output device, click
on Print preview.
You should see the page in PDF form which means it is working fine.
IV. Configuration Check
A.
➢ Go to SA38
➢ Test program FP_TEST_00
➢ If the FP_TEST_00 form is displayed in the print preview, the ADS

configuration is correct.
If the system displays an error message instead of a form, the

configuration of ADS is incorrect. Then carry out additional tests. Go
for STEP II
B.
➢ Now check RFC connection to ADS by Program FP_PDF_TEST_00 in

SA38
➢ If the system displays the version number of ADS, the configuration of

the RFC connection is correct. Then Proceed with III
Otherwise you will receive one of the following error messages:
1. If the system displays dialog fields for user and password instead of
the version number, the entries for user and password in the RFC
connection do not match the entries in user management.
-> Check the user and the password. Continue with point
2. The system displays a “SYSTEM ERROR” with the following text:
ERROR MESSAGE: SOAP Runtime Exception:

CSoapExceptionTransport : HTTP send returned with status code”
-> Check or correct the details for target device, service number and
path prefix in the RFC connection (transaction SM59).
3. If the system displays an error message stating that there is no valid

HTTP connection, then there is no RFC connection to ADS.
__MCE_ITEM____MCE_ITEM__è Correct or create the RFC connection

(transaction SM59).
C. Check the Setting for Destination Service
In SA38 call FP_CHECK_DESTINATION_SERVICE and

FP_CHECK_HTTP_DATA_TRANSFER
a) First of all, execute the program without selecting the option “With
Destination Service”.
b) Now select the option “With Destination Service” and execute the
program again. The system processes the test form, using the
destination service.
If the system displays the same message (file size of generated PDF) as
it does in a), the configuration of the destination service is correct.
If the System issues error message carry out following steps:
1. Enter the following URL in your Web browser:
http://<server>:<port>/sap/bc/fp/form/layout/fp_test_00.xdp
2. In the dialog box for the user, enter ADS_AGENT and the relevant
password.
If the browser displays an error message instead of the XML file,
a) Call Visual Administrator and navigate to Services -> Destinations
b) Extend the setting in field URLunder Connection Settings to:
http://<server>:<port>/sap/bc/fp/form/layout/fp_test_00.xdp
c) Choose ‘Save and Test’
If the settings are correct, the system issues the message: “HTTP GET
response code 200 Content Type/xml.”.
Note: Do not forget to change the URL back to http://<server>:<port>
3. If you get the error FPRUNX004 while executing any of the above tests
do the following:
a. Go to transaction SE37
b. Execute the function module FP_GET_LAST_ADS_ERRSTR
After you have called the FP_GET_LAST_ADS_ERRSTR function

module, the system will delete the text internally. A second call will,
therefore, not return any results.
Related Content
http://help.sap.com/erp2005_ehp_05/helpdata/EN/d2/02bfb9af5a400f8bf53486
07cab554/frameset.htm
http://help.sap.com/erp2005_ehp_05/helpdata/EN/ce/66d3cc1a384736bf324954
4941c8cb/frameset.htm
http://help.sap.com/erp2005_ehp_05/helpdata/EN/ce/66d3cc1a384736bf324954
4941c8cb/frameset.htm
Alert Moderator
Assigned Tags
NW AS Java Administrator (NWA)
SAP ERP
SAP NetWeaver
sap erp
SAP Netweaver 7.0
Similar Blog Posts 

Configuration of Adobe Document Services
By Tobias Hofmann Feb 10, 2014
ADS Installation and Configuration in NW7.3 or higher

By Former Member Mar 12, 2014
Solving ADS related issues

By Tobias Hofmann Feb 10, 2014
Related Questions 
ADS configuration
By Former Member Mar 07, 2014
ADS - Cred
Credentials setup
By Former Member Sep 29, 2015
Issue in configuring ADS on NW 7.3 portal

By Former Member May 02, 2012
4 Comments
You must be Logged on to comment or reply to a post.
Former Member
January 7, 2013 at 9:31 pm
Hi Siva,
Thanks for the article. Just have a quick question for ADS in EHP 6. We are on ECC 6, EHP 6. When we access
Employee Process through MSS, it gives error message for connection of ADS. Do we required configuration in
EHP 6 for Adobe Forms?
Thanks,
Ashish
Like 0 | Share
Former Member
April 22, 2013 at 7:15 am
Hi Siva,
Based on your document we have successfully installed in Developement Server.
To Install in Quality and Production ,i wan't to remove development client and paste quality client . If i do like
this ads will work in any one server only. It has to work in all the three servers. Please guide me to do this.
If you are having any documents based on this please mail me.
Mail ID: <content removed by SAP Community moderator>
Like 0 | Share
Antonio Steinhäuser
January 22, 2014 at 3:38 pm
Hi,
thanks. Do we have this also for NW 7.3 with NW Adminstrator Webpage?
Gruß
Toni
Like 0 | Share
Roopak Mattoo
February 9, 2015 at 6:33 pm
Hi Siva,
I have multiple abap application server in my production,How can I set the logon group in HTTP connection of
ADS or do I need to use the dedicated Application server for this
Like 0 | Share
Find us on
Privacy Terms of Use
Legal Disclosure Copyright
Trademark Cookie Preferences
Newsletter Support

Install ADS and Credentials in SAP NW ABAP and JAVA AS - SAP Blogs

Uploaded by

Copyright:

Available Formats

Install ADS and Credentials in SAP NW ABAP and JAVA AS - SAP Blogs

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Install ADS and Credentials in SAP NW ABAP and JAVA AS - SAP Blogs

Uploaded by

Copyright:

Available Formats

1/12/23, 6:12 PM Install ADS and Credentials in SAP NW ABAP and JAVA AS | SAP Blogs

Ask a Question Write a Blog Post Login

Install ADS and Credentials in SAP NW

 RSS Feed Summary

Author(s): Siva Kumar Arivinti

Company: Deloitte Consulting India Pvt Ltd.

Created on: 30 March 2012

Expertise in Production support, Installations and Software Life Cycle Management

736902 – Adobe Cred

I. Configuration in ABAP AS and JAVA AS (non-dual stack)

Visual Admin: server<x> –> services –> Security Provider.

IRJ Portal: http://<fully qualified name>:5<XX>00/irj/portal

Note: User type must be TECHNICAL USER as follows.

2. Assign security role in Java Stack.

a. Go to Visual Admin

e. On the Policy Configurations tab, in the Components area, select

g. In the Mappings area, choose Add, which is assigned to Users. A dialog

h. Choose the Tree tab.

a. User type must be “System”

b. Assign the role SAP_BC_FPADS_ICF and SAP_BC_FP_ICF or the

4. Create ABAP RFC Connection (SM59)

a. Go to SM59 and create destination called ADS under “HTTP Connections

and specify the Service No. (5<XX>00).

Note: Patch Prefix must be /AdobeDocumentServices/Config?style=rpc

d. Other fields can be left as defaults.

e. Test the connection. You should be successful.

5. Activate ICF Services

a. Log on to your SAP Web AS ABAP system

b. Choose transaction SICF.

c. Choose default_host → sap → bc → fp in the tree.

d. Choose Service/Virt.Host → Activate

6. Create following Destination Service FP_ICF_DATA_<SID> (Visual Admin)

b. Client on tab Save and Test

Received HTTP response 404.

7. Set up Basic Authentication in JAVA Environment

a. Log on to the Visual Administrator.

b. On the Cluster tab, choose Server <x> → Services → Web Services

c. Choose Web Service Clients → sap.com > tc~wd~pdfobject →

d. From the Authentication list, select BASIC.

f. Choose Save.

h. Choose the button Application.

i. Choose sap.com/tc~wd~pdfobject in the tree.

j. Choose Start Application.

II. Configuration in ABAP & JAVA AS (Dual Stack Systems)

b. User type must be “System”

Note: The ADSCALLERS role in SAP NW AS ABAP appears automatically

d. Perform the steps from 2 to 7 from the above.

III. Install Credentials

1. Place cred

Note: You have to get the Adobe credentials

2. Perform the below steps:

a. Log on to the Visual Administrator

c. From the Type field, select the type of credential

d. In the Alias field, enter the alias of the cred

g. Confirm the password again and then click Add.

The page refreshes and the list of registered cred

3. Restart Java Engine.

IV. Configuration Check

➢ Test program FP_TEST_00