Nota de SAP ADOBE Document services

04.07.2012 Page 1 of 13

SAP Note 944221 - Troubleshooting if problems occur informs processing

Note Language: English Version: 26 Validity: Valid Since 19.06.2012

Summary

SymptomYou want to activate or output a PDF form and receive an error message. Youcannot print or display forms in the preview or generate or editinteractive forms, or these processes are defective.

Other termsSAP Interactive Forms by Adobe, Adobe document services (ADS), AdobeLiveCycle Designer, Forms Processing

Reason and PrerequisitesCausesPossible causes are that the configuration of Adobe document services isincorrect, there are errors in the form or the printer configuration isincorrect.

PrerequisitesFor the printing or the print preview of PDF-based forms, you requirea PCL-Postscript printer or a ZPL printer and you must use a relevantdevice type (for example, POST2, HPLJ4, HP9500, PDF1, AZPL203, AZPL300).For more information, see SAP Note 685571 and under "Printing PDF-BasedForms" in the SAP Print Handbook (BC-CCM-PRN). See SAP Help Portal under:http://help.sap.com/saphelp_nw70/helpdata/de/25/6fa8fd27837846990a7a6813b06f80/frameset.htmIf you want to use a printer with the device type SAPWIN/SWIN,read SAP Note 1444342.

To generate interactive forms, you require a credential, which you mustregister as described in the Adobe Configuration Guide.

SolutionIn order to find the cause of the error, proceed as follows (depending onthe scenario that you use): Note that you require administrationauthorization for some steps.

Contents

I ABAP:1. Test program FP_TEST_002. Test program FP_PDF_TEST_00, RFC connection to ADS 3. Testing the user and password4. Test destination service5. Interactive forms: Test program FP_TEST_IA_01 (credential test)6. Generated PDF with additional information7. Activating ADS trace on the J2EE Engine

II Web Dynpro for ABAP1. Test program FP_TEST_00

04.07.2012 Page 2 of 13


2. Test program FP_PDF_TEST_00, RFC connection to ADS 3. Testing the user and password4. Test destination service5. Interactive forms: Test program FP_TEST_IA_01 (credential test)6. Generated PDF with additional information7. Activating ADS trace on the J2EE Engine

II Web Dynpro for Java1. Testing the user and password2. Check the Web service destination ConfigPort_Document.3. Check whether the credential is installed and configured.4. Generated PDF with additional information5. Activating ADS trace on the J2EE Engine

I ABAP:

The following test steps are aso described on SAP Help Portal in thechapter "Configuration Check for PDF-Based Forms in ABAP"of the Adobe Document Services Configuration Guide:SAP NetWeaver 7.0, 7.0x:http://help.sap.com/saphelp_nw70/helpdata/en/43/f31e3082221595e10000000a1553f7/frameset.htm

SAP NetWeaver 7.1 and higher:http://help.sap.com/saphelp_nw73/helpdata/en/4b/94e945ea576e82e10000000a421937/frameset.htm

1. Use transaction SA38 to execute the program FP_TEST_00.

- If the FP_TEST_00 form is displayed in the print preview, theADS configuration is correct.

-> If you use scenarios with an interactive PDF, proceed withpoint 5. Otherwise, proceed with the test under point 6.

- If the system displays an error message instead of a form, theconfiguration of ADS is incorrect.

-> Carry out the additional tests from point 2 onwards.

2. Use transaction SA38 to execute the program FP_PDF_TEST_00.

This enables you to check the RFC connection to ADS .

- If the system displays the version number of ADS, theconfiguration of the RFC connection is correct.

04.07.2012 Page 3 of 13


-> Proceed to point 4.

- You receive one of the following error messages:

2.1. If the system displays dialog fields for user and passwordinstead of the version number, the entries for user andpassword in the RFC connection do not match the entries in usermanagement.

-> Check the user and the password. Continue with point 3.

2.2. The system displays a "SYSTEM ERROR" with the followingtext:

"ERROR CODE : 100.101"

"ERROR MESSAGE : SOAP Runtime Exception:CSoapExceptionTransport : HTTP send returned with status code"

or

"ERROR MESSAGE : SOAP Runtime Exception:CSoapExceptionTransport : HTTP receive failed with exceptioncommunication_failure"

-> Contact your system administrator and ask them to check orcorrect the details for target device, service number and pathprefix in the RFC connection (transaction SM59).

If all of these entries are correct and the problem stillpersists, you should check whether the J2EE Engine is startedcorrectly. Read SAP Note 1587941 also.

2.3. If the system displays an error message stating that thereis no valid HTTP connection, then there is no RFC connection toADS.

-> Contact your system administrator and ask them to correct orcreate the RFC connection (transaction SM59).

2.4 The system does not respond.

-> Follow the instrcutions in SAP Notes 783185 and 1587941.

3. Check the user and password of ADS

Prerequisite: To perform this test, you must know the user andpassword for ADS. If you do not know this information, contact yoursystem administrator and ask them to carry out the test.

Note the following: These instructions can be found in thedocumentation for the Adobe Configuration Guide in the chapter"Checking the User and Password".

For SAP NetWeaver 7.0, 7.01, and higher , proceed as follows:

04.07.2012 Page 4 of 13


1. In your Web browser, enter the following URL:

http://<server>:<port>/AdobeDocumentServices/Config

<server>:<port> are the name and port of the J2EE Engine onwhich the Adobe Document Services run.

Log on as the administrator.

2. The Web page of the Web service Adobe Document Services isdisplayed. Choose "Test".

3. Choose rpdata(test..)

4. Choose "Send". No further parameter entries are required.

5. Enter "ADSUser" for the user and enter the relevantpassword.

6. Choose "Submit".

As of SAP NetWeaver 7.1 and higher, the test occurs via the WebService Navigator, which you call withhttp://<server>:<port>/wsnavigator. Caution: You require the user andpassword for the WS Navigator.

In Netweaver 7.10, you filter according to the service"com.adobe/AdobeDocumentServices_com.adobe_AdobeDocumentServicesVi"and execute the operation rpData similar to as described above.

As of NetWeaver 7.11 and higher, enter "Provider System" and"Local AS Java" as the search type to search for the serviceinterface.

Choose "AdobeDocumentServicesVi" from the list of service interfaces.Choose "Continue" - no further parameter entries are required - untilthe system displays the dialog box for the user and password. Thenenter "ADSUser" and the relevant password.

Result of the test for user and password:

- If the system displays the version number of ADS, theconfiguration of the user and password is correct.

-> Proceed to the next point (4).

- If the system does not display a version number (the page inthe Web browser does not change, and submit continues to bedisplayed), the configuration of ADS is incorrect.

-> Contact your system administrator and ask them to correctthe configuration for the user and password.

4. Check the settings for the destination service

To use the destination service on AS Java, settings are required on AS

04.07.2012 Page 5 of 13


ABAP and AS Java. Therefore, this test contains several steps.

4.1 In your ABAP system (transaction SA38), execute the followingprograms in succession:

1. FP_CHECK_DESTINATION_SERVICE

2. FP_CHECK_HTTP_DATA_TRANSFER (this program only if you bundleyour forms).

a) First of all, execute the program without selecting the option"With Destination Service".

The system processes a test form in the background and displays thesize of the generated PDF. It does not use the destination servicein the process.

Caution: If the system issues an error message here, read SAP Note1587941.

b) Now select the option "With Destination Service" and execute theprogram again. The system processes the test form, using thedestination service.

- If the system displays the same message (file size of generatedPDF) as it does in a), the configuration of the destinationservice is correct.

-> If you use scenarios with an interactive PDF, proceed withpoint 5. For print forms, proceed with point 6.

- If the system issues an error message, the configuration of thedestination service is incorrect.

-> If an error message is issued when you executeFP_CHECK_DESTINATION_SERVICE, execute the following tests 4.2to 4.4.

-> If an error message is issued when you executeFP_CHECK_HTTP_DATA_TRANSFER, you require the ADS runtimeinformation (trace files) for further troubleshooting. You canfind out how to determine this runtime information under point6. After you have made the settings, call the program again.The system saves the runtime information locally on yourfront-end PC.

Create a customer message under the component BC-SRV-FP,describe the problem, and attach the trace file with theruntime information to the message.

4.2 Check whether the following ICF services are active (transactionSICF):

- /default_host/sap/bc/fp

- /default_host/sap/bc/fpads

04.07.2012 Page 6 of 13


If this service is not active, activate it. Note: You requre the ICFservice fpads as of NW7.0 Support Package Stack 12 for bundling formsin distributed systems.

4.3 Check the settings for the ICF service "fp".

a) Enter the following URL in your Web browser:

http://<server>:<port>/sap/bc/fp/form/layout/fp_test_00.xdp

<server> is the AS ABAP, <port> is the HTTP port of the ASABAP. (you can determine this information using transactionSICF).

b) In the dialog box for the user, enter ADS_AGENT and the relevantpassword.

- If the ICF service settings are correct, the browser displaysthe layout information of the FP_TEST_00 form in XML format.

-> Proceed with point 4.4.

- If the browser displays an error message instead of theaforementioned XML file, a configuration error occurred.

-> Check whether the user ADS_AGENT exists on the AS ABAP, andif the user has the required authorizations and roles(SAP_BC_FP_ICF or SAP_BC_FPADS_ICF). Note the following:Make sure that the relevant traffic lights for the status ofthe the profile comparison are green.

4.4. Check the settings for the destination service on AS Java (J2EEEngine)

a) Up to SAP NetWeaver 7.0x: Call the Visual Administrator andnavigate to Services -> Destinations -> HTTPSAP NetWeaver 7.10 and higher: Open the SAP NetWeaverAdministrator (http://<JEE-Server>:<HTTP-Port>/nwa). ChooseConfiguration Management -> Security -> Destinations.

Check whether the entry FP_ICF_DATA_<SID> exists and is enteredcorrectly.

Destination Type: HTTP destination

Enhance the entry in the field URL under Connection Settings(SAP NetWeaver 7.0x) or Connection and Transport (SAPNetWeaver 7.10 and higher) to:http://<server>:<port>/sap/bc/fp/form/layout/fp_test_00.xdp

The existing entries <server> and <port> refer to the AS ABAP. TheABAP HTTP port is provided in transaction SMICM; choose Goto ->Services.

b) Up to SAP NetWeaver 7.0x, choose 'Save and Test'; as of SAP

04.07.2012 Page 7 of 13


NetWeaver 7.10, choose 'Ping Destination'.

c) The system calls the ABAP system that stores the form templates.

- If the settings are correct, the system issues the message:"HTTP GET response code 200 Content Type text/xml."

-> If you use scenarios with an interactive PDF, proceed withpoint 5. For print forms, proceed with point 6.

- If the system issues an error message, the configuration of thedestination service is incorrect.

-> Contact your system administrator and ask them to correctthe settings for the destination service.

d) Do not forget to change the URL back tohttp://<server>:<port>.

5. Check whether the credential is configured.

You must perform this step only if you use interactive scenarios. Ifyou only use print scenarios, proceed with point 6.

Use transaction SA38 to execute the program FP_TEST_IA_01.

- If the system displays the form, the ReaderRights credential isinstalled and configured.

-> Proceed with point 6.

- If you receive an error message, for example,

ADS: com.adobe.ProcessingException: com.adobe.Processin(200101)

-> Check whether you have installed and registered a credential. SeeNote 736902 and the Adobe Configuration Guide at:

SAP NetWeaver 7.0

http://help.sap.com/saphelp_nw70/helpdata/en/56/f2c94a069f44a785b85748e11f82a0/frameset.htm

SAP NetWeaver 7.1 and higher

http://help.sap.com/saphelp_nwpi711/helpdata/en/56/f2c94a069f44a785b85748e11f82a0/frameset.htm

6. Generated PDF with additional information

Call your form and save the generated PDF with additional informationlocally. You receive a PDF with attachments, which enable you toanalyze the problem in detail.

04.07.2012 Page 8 of 13


Information about the PDF with additional information is available inthe problem analysis guide (PAG) for SAP NetWeaver (TM) at:

http://help.sap.com/saphelp_nw70/helpdata/en/71/7ffb3f6c78ee28e10000000a1550b0/frameset.htm ->Usage Type Application ServerJava -> Problem Analysis Scenario for Adobe Document Services-> Adobe Rendering Error

The following information about the procedure when setting thisfunction can also be found in the documentation on SAP InteractiveForms by Adobe on the Help Portal under:

http://help.sap.com/saphelp_nw70/helpdata/de/f7/a04aee0cb94978a011401311efe603/frameset.htm (German)

http://help.sap.com/saphelp_nw70/helpdata/en/f7/a04aee0cb94978a011401311efe603/frameset.htm (English)

You have the following options:

Setting using transaction SFP

1. Call the Form Builder (transaction SFP).

2. Choose "Utilities -> Settings".

3. In the dialog box, choose the option "Very Detailed Trace"for "Trace Level" under "Runtime Information".

4. Enter a file name under which the runtime information is tobe saved locally as a trace file on your front-end PC. Thisfile is useful for subsequent troubleshooting.

5. Set the indicator "PDF with Additional Information" andspecify a file name if a PDF display or preview is not possiblein your application. With this option, the generated PDF withadditional information is then saved locally to your front-endPC.

Setting using user settings

You can also use the user settings to activate the function "PDF withAdditional Information". Proceed as follows:

1. Call transaction SU3 ('Maintain User Profile') or SU01('User Maintenance').

Note that you require the relevant authorization for the usermaintenance of other users.

2. Choose the tab page 'Parameters', and enter the requiredparameters and values:

FPTRACELEVEL = 04Setting the trace to the value required for the local saving ofruntime information and for the generation of the PDF thatcontains additional information.

04.07.2012 Page 9 of 13


FPTRACEFILE = <directory>\<file name>File for the local saving of runtime information Thisspecification is optional.

FPSAVEERRORPDF = XThe system generates a PDF that contains additionalinformation.

FPERRORPDFFILE = <directory>\<file name>File for locally saving the PDF that contains additionalinformation

Caution: Local saving is possible only for applications thathave a GUI connection, and therefore, this is not supported forWeb Dynpro ABAP.

3. These values then have a fixed assignment to the user.

You must reset these settings after troubleshootingis completed.

After you have made these settings, call your application for creatingforms. The displayed PDF now contains the additional information thatcan be used for further troubleshooting. Save the displayed PDF.

Attach these files (PDF with attachment) to a message under thecomponent BC-SRV-FP with a precise description of the problem.

If you cannot generate a PDF, save the trace files and attach them toyour problem message as described above.

7. Activating ADS trace on the J2EE Engine

If you cannot determine the cause of the problem with theaforementioned steps or cannot create a PDF with additionalinformation, we recommend that you activate the ADS trace on the J2EEEngine. Reproduce the problem. All actions relating to the AdobeDocument Services are then logged on the J2EE Engine.

Create a customer message under the component BC-SRV-FP with an exactdescription of the problem and attach the trace files to the message.

You can find out how to activate the ADS trace in SAP Note 846610.

II Web Dynpro for ABAP

To analyze problems with interactive forms, which are integrated in WebDynpro for ABAP, you will find detailed information in SAP Note 999998.

To determine whether the ADS configuration is correct, execute steps 1 to 5that are described under I ABAP:

1. Test program FP_TEST_002. Test program FP_PDF_TEST_00, RFC connection to ADS

04.07.2012 Page 10 of 13


3. Test user and password4. Test destination service (only FP_CHECK_DESTINATION_SERVICE)5. Interactive forms: Test program FP_TEST_IA_01, credential test


Call your form in the Web Dynpro application and save the PDF withadditional information that is generated by Adobe Reader. If thetoolbar does not contain the save icon, use the F8 key to display it.You receive a PDF with attachments, which enable you to analyze theproblem in detail.

Setting using user settings

You can only use the user settings to activate the function "PDF withAdditional Information". Proceed as follows:

1. Logon to the corresponding ABAP system.

2. Call transaction SU3 ('Maintain User Profile') or SU01('User Maintenance').

Note that you require the relevant authorization for the usermaintenance of other users.

3. Choose the 'Parameters' tab page and enter the requiredparameter and value:

FPTRACELEVEL = 04Sets the trace to the necessary value for generating the PDFwith additional information.

4. The assignment of the value to the user is now fixed.

5. Exit the Web Dynpro application and logon again so that theuser parameter configured previously takes affect.

Reset these values after troubleshooting iscompleted.

-> Attach these files (PDF with attachment) to a message with thecomponent BC-SRV-FP, including a precise description of the problem.


See descrption under I ABAP and SAP Note 846610.

II Web Dynpro for Java

1. Check the user and password of ADS

The procedure is the same as in chapter I ABAP "3. Test user andpassword".

04.07.2012 Page 11 of 13


This information can also be found in the Adobe Document ServicesConfiguration Guide in the Help Portal under:

http://help.sap.com/saphelp_nw70/helpdata/en/37/504b8cbc2848a494facfdc09a359b1/frameset.htm -> Adobe Document Services ConfigurationGuide -> Configuring the Web Service -> Securing Access to the WebService ->Configuration Check -> Configuration Check forInteractive Forms in Web Dynpro for Java

2. Check the Web service destination ConfigPort_Document.

As of SAP NetWeaver 7.10, the Web service destinationConfigPort_Document must be configured.

Use Note 1443819 to check the configuration.

3. Check whether the credential is configured.

Check whether you have installed and registered a credential. See Note736902 and the Adobe Configuration Guide at:

SAP NetWeaver 7.0

http://help.sap.com/saphelp_nw70/helpdata/en/56/f2c94a069f44a785b85748e11f82a0/frameset.htm

SAP NetWeaver 7.1 and higher

http://help.sap.com/saphelp_nwpi711/helpdata/en/56/f2c94a069f44a785b85748e11f82a0/frameset.htm


As of SAP NetWeaver 7.0 Support Package 06, you can generate a PDFwith attachments that enable detailed troubleshooting. The proceduredepends on the Support Package level of SAP NetWeaver 7.0.

SAP NetWeaver 7.0 Support Package 06/07/08

o Extend your application URL with the "sap-wd-adsTrace=4" addition.

Note that there will then only be a display if the system cancreate a PDF. If this is not the case, follow the instructions thatare contained in Notes 742674 and 846712.

SAP NetWeaver 7.0 Support Package 09 and higher

o Set the Trace Level for Web Dynpro to 'ALL'. You can find detailedinformation about setting the Trace Level in Note 742674.

o Call your form and save the generated PDF with additionalinformation locally. This PDF with attachments is required laterfor detailed error analysis. Attach these files to a message withthe component BC-WD-JAV, including a precise description of the

04.07.2012 Page 12 of 13


problem.

o Reset the Web Dynpro Trace level.

SAP NetWeaver '04

o In these versions, the system does not display any PDFs withadditional information, however, the trace files contain the notesthat you require regarding the cause of the problem. Set the TraceLevel for Web Dynpro to 'ALL'. You can find detailed informationabout setting the Trace Level in Note 742674.

o Call your form and save the trace files locally. These are requiredlater for detailed error analysis. Attach these trace files to amessage with the component BC-WD-JAV, including a precisedescription of the problem.

o Reset the Web Dynpro Trace level.

Information about the PDF with additional information is available inthe SAP NetWeaver Problem Analysis Guide (PAG) at:

http://help.sap.com/saphelp_nw70/helpdata/en/71/7ffb3f6c78ee28e10000000a1550b0/frameset.htm ->Usage Type Application ServerJava -> Problem Analysis Scenario for Adobe Document Services-> Adobe Rendering Error


See descrption under I ABAP and SAP Note 846610.

Header Data

Release Status: Released for CustomerReleased on: 20.06.2012 09:51:07Master Language: GermanPriority: Recommendations/additional infoCategory: Help for error analysisPrimary Component: BC-SRV-FP Forms Processing

Secondary Components:BC-WD-JAV Web Dynpro Java

The Note is release-independent

04.07.2012 Page 13 of 13


Related Notes

Number Short Text

1587941 ADS does not respond or error "CSoapExceptionTransport.."

1530646 Survey function in GRC 10.0

1444342 Device type-independent printing of ADS forms

1317925 Maintaining backward compatibility with Designer

1261193 Composite SAP Note : HCM Authorizations Documentation

1258649 Composite SAP Note : HCM Forms Documentation

1156407 SAP ERP Enhan.Pk.4 SP Stack 01(11/2008) - Release Info. Note

1128476 How to activate ADS trace in NW7.10 and higher

1097565 Reporting issues on Interactive Form in Web Dynpro for Java

1069027 Exception in method rpData from WebServiceNavigator

1052659 Requirements for customer messages concerning export to PDF

1022238 Form FP_TEST_42 for simple test of several fonts

1007116 Form output in incorrect language

1004321 ADS error: Incorrect content type found 'text/html'

959462 ISR/Adobe/Web Dynpro Java: Configuration problems

934378 SIBUIN: Broken layout in ERP2004 Unicode environment

915399 com.adobe.ProcessingError: File not found on: URL location:

894009 Adobe Document Services: Configuration Guide (SAP NW 7.0)

846712 Analysis when Adobe Forms does not show values

846610 How to activate ADS trace

842878 Switch on traces for Web Dynpro session management in NW04

836174 ISR/Adobe/Web Dynpro Java: Support for troubleshooting

742674 Required information for web dynpro problem reporting

736902 Adobe Credentials

685571 Printing PDF-based forms

Documents

Nota de SAP ADOBE Document services