Adobe Forms Configuration Steps

SAP Note

944221

Version 29

Dec 5, 2014

Page 1 of 9

Processor Processing Status

new

Implementation Status

Cannot be implemented

Language

E

Short Text

Error analysis for problems in form processing

Component

BC-SRV-FP

Forms Processing

Description Symptom You want to activate or output a PDF form and receive an error message. You cannot print or display forms in the preview or generate o r edit interactive forms, or these processes are defective.

Reason and Prerequisites Causes Possible causes are that the configuration of Adobe document services is incorrect, there are errors in the form or the printer config uration is incorrect. Prerequisites For the printing or the print preview of PDF-based forms, you require a PCL-Postscript printer or a ZPL printer and you must use a rel evant device type (for example, POST2, HPLJ4, HP9500, PDF1, AZPL203, AZPL300). For more information, see SAP Note 685571 and under "Printing PDF-Based Forms" in the SAP Print Handbook (BC-CCM-PRN). See SAP Help Po rtal under: http://help.sap.com/saphelp_nw70/helpdata/de/25/6fa8fd27837846990a7a6813b06f80/frameset.htm If 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 must register as described in the Adobe Configuration Guide.

Solution In order to find the cause of the error, proceed as follows (depending on the scenario that you use): Note that you require administra tion authorization for some steps. Contents I ABAP:

SAP Note 1. 2. 3. 4. 5. 6. 7.

944221

Version 29

Dec 5, 2014

Page 2 of 9

Test program FP_TEST_00 Test program FP_PDF_TEST_00, RFC connection to ADS Test user and password Test destination service Interactive forms: Test program FP_TEST_IA_01 (credential test) Generated PDF with additional information Activating the ADS trace on the J2EE engine

II Web Dynpro for ABAP 1. Test program FP_TEST_00 2. Test program FP_PDF_TEST_00, RFC connection to ADS 3. Test user and password 4. Test destination service 5. Interactive forms: Test program FP_TEST_IA_01 (credential test) 6. Generated PDF with additional information 7. Activating the ADS trace on the J2EE engine

II Web Dynpro for Java 1. Test user and password 2. Check the Web service destination ConfigPort_Document. 3. Check whether the credential is installed and configured 4. Generated PDF with additional information 5. Activating the ADS trace on the J2EE engine

I ABAP:

The following test steps are aso described on SAP Help Portal in the chapter "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. Call transaction SA38 and execute the program FP_TEST_00. If the FP_TEST_00 form is displayed in the print preview, the ADS configuration is correct. -> If you use scenarios with an interactive PDF, proceed with point 5. Otherwise, proceed with the test under point 6. If the system displays an error message instead of a form, the configuration of ADS is incorrect. -> Carry out the additional tests from point 2 onwards. 2. Call transaction SA38 and 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, the configuration of the RFC connection is correct.

SAP Note

944221

Version 29

Dec 5, 2014

Page 3 of 9

-> Proceed to point 4. You receive one of the following error messages: 2.1. If the system displays dialog fields for user and password instead of the version number, the entries for use r and password in the RFC connection do not match the entries in user management. -> Check the user and the password. Continue with point 3. 2.2. The system displays a "SYSTEM ERROR" with the following text: "ERROR CODE : "ERROR MESSAGE : SOAP Runtime Exception: CSoapExceptionTransport : HTTP send returned with status code" or "ERROR MESSAGE : SOAP Runtime Exception: CSoapExceptionTransport : HTTP receive failed with exception communication_failure" -> Contact your system administrator and ask them to check or correct the details for target device, service number and path prefix in the RFC connection (transaction SM59). If all of these entries are correct and the problem still persists, you should check whether the J2EE Engine is started correctly. Rea d SAP Note 1587941 also. 2.3. If the system displays an error message stating that there is no valid HTTP connection, then there is no RFC connection to ADS. -> Contact your system administrator and ask them to correct or create 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 the ADS Prerequisite: To perform this test, you must know the user and password for ADS. If you do not know this information, co ntact your system administrator and ask them to carry out the test. Note: These instructions can be found in the documentation for the Adobe Configuration Guide in the chapter "Checking th e User and Password". For SAP NetWeaver 7.0, 7.01, and higher , proceed as follows: 1. In your Web browser, enter the following URL: http://:/AdobeDocumentServices/Config : are the name and port of the J2EE Engine on which the Adobe Document Services run. Log on as the administrator. 2. The Web page of the Web service Adobe Document Services is displayed. Choose "Test". 3. Choose rpdata(test..) 4. Choose "Send". No further parameter entries are required. 5. Enter "ADSUser" for the user and enter the relevant password. 6. Choose "Submit". As of SAP NetWeaver 7.1 and higher, the test is performed using the Web Service Navigator. To call the Web Service Navigator, enter ht tp://:/wsnavigator. Caution: You require the user and password 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 servic e interface.

SAP Note

944221

Version 29

Dec 5, 2014

Page 4 of 9

Choose "AdobeDocumentServicesVi" from the list of service interfaces. Choose "Continue" - no further parameter entries are required until the system displays the dialog box for the user and password. Then enter "ADSUser" and the relevant password. Result of the test for user and password: If the system displays the version number of ADS, the configuration of the user and password is correct. -> Proceed to the next point (4). If the system does not display a version number (the page in the Web browser does not change, and submit continues to be displayed), the configuration of ADS is incorrect. -> Contact your system administrator and ask them to correct the 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 ABAP and AS Java. Therefore, this test contains several steps. 4. 1 In your ABAP system (transaction SA38), execute the following programs in succession: 1. FP_CHECK_DESTINATION_SERVICE 2. FP_CHECK_HTTP_DATA_TRANSFER (this program only if you bundle your 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 the size of the generated PDF. It does not use the destination service in the process. Caution: If the system issues an error message here, read SAP Note 1587941. b) Now select the option "With Destination Service" and execute the program again. The system processes the test form, using the desti nation service. If the system displays the same message (file size of generated PDF) as it does in a), the configuration of the destination service i s correct. -> If you use scenarios with an interactive PDF, proceed with point 5. For print forms, proceed with point 6. If the system issues an error message, the configuration of the destination service is incorrect. -> If an error message is issued when you execute FP_CHECK_DESTINATION_SERVICE, execute the following tests 4.2 to 4.4. -> If an error message is issued when you execute FP_CHECK_HTTP_DATA_TRANSFER, you require the ADS runtime information (trace files) f or further troubleshooting. You can find out how to determine this runtime information under point 6. After you have made the settings , call the program again. The system saves the runtime information locally on your front-end PC. Create a customer message under the component BC-SRV-FP, describe the problem, and attach the trace file with the runtime information to the message. 4. 2 Check whether the following ICF services are active (transaction SICF): /default_host/sap/bc/fp /default_host/sap/bc/fpads If this service is not active, activate it. Note: You requre the ICF service fpads as of NW7.0 Support Package Stack 12 for bundling f orms in distributed systems.

SAP Note

944221

Version 29

Dec 5, 2014

Page 5 of 9

4. 3 Check the settings for the ICF service "fp". a) Enter the following URL in your Web browser: http://:/sap/bc/fp/form/layout/fp_test_00.xdp is the AS ABAP, is the HTTP port of the AS ABAP. (you can determine this information using transaction SICF). b) In the dialog box for the user, enter ADS_AGENT and the relevant password. If the ICF service settings are correct, the browser displays the layout information of the FP_TEST_00 form in XML format. Caution: As of SAP NetWeaver 7.2, the browser tries to start the Adobe Reader. The system issues the following error message: 'Unable to locate the form, because the XFA data lacks.a reference...'. If the system issues this message, the ICF settings are correct. -> Proceed with point 4.4. If the browser displays an error message instead of the aforementioned XML file, a configuration error occurred. -> Check whether the user ADS_AGENT exists on the AS ABAP, and if the user has the required authorizations and roles (SAP_BC_FP_ICF or SAP_BC_FPADS_ICF). Note: Make sure that the relevant traffic lights for the status of the the profile comparison are green. 4.4. Check the settings for the destination service on AS Java (J2EE Engine) a) Up to SAP NetWeaver 7.0x: Call the Visual Administrator and navigate to Services -> Destinations -> HTTP SAP NetWeaver 7.10 and higher: Open the SAP NetWeaver Administrator (http://:/nwa). Choose Configuration Manage ment -> Security -> Destinations. Check whether the entry FP_ICF_DATA_ exists and is entered correctly. Destination Type: HTTP destination Enhance the entry in the field URL under Connection Settings (SAP NetWeaver 7.0x) or Connection and Transport (SAP NetWeaver 7.10 and higher) to: http://:/sap/bc/fp/form/layout/fp_test_00.xdp The existing entries and refer to the AS ABAP. The ABAP HTTP port is provided in transaction SMICM; choose Goto -> Ser vices. b) Up to SAP NetWeaver 7.0x, choose 'Save and Test'; as of SAP 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 with point 5. For print forms, proceed with point 6. If the system issues an error message, the configuration of the destination service is incorrect. -> Contact your system administrator and ask them to correct the settings for the destination service. d) Do not forget to change the URL back to http://:. 5. Check whether the credential is configured. You must perform this step only if you use interactive scenarios. If you 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 is installed and configured. -> Proceed with point 6. If you receive an error message, for example,

SAP Note

944221

Version 29

Dec 5, 2014

Page 6 of 9

ADS: com.adobe.ProcessingException: com.adobe.Processin(200101) -> Check whether you have installed and registered a credential. See Note 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 information locally. You receive a PDF with attachments, which enable you to analyze the problem in detail. Information about the PDF with additional information is available in the problem analysis guide (PAG) for SAP NetWeaver (TM) at: http://help.sap.com/saphelp_nw70/helpdata/en/71/7ffb3f6c78ee28e10000000a1550b0/frameset.htm ->Usage Type Application Server Java -> Pr oblem Analysis Scenario for Adobe Document Services -> Adobe Rendering Error The following information about the procedure when setting this function can also be found in the documentation on SAP Interactive For ms 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 to be saved locally as a trace file on your front-end PC. This file is useful for subsequent troubleshooting. 5. Set the indicator "PDF with Additional Information" and specify a file name if a PDF display or preview is not possible in your application. With this option, the generated PDF with additional information is then saved locally to your front-end PC. Setting using user settings You can also use the user settings to activate the function "PDF with Additional Information". Proceed as follows: 1. Call transaction SU3 ('Maintain User Profile') or SU01 ('User Maintenance'). Note that you require the relevant authorization for the user maintenance of other users. 2. Choose the tab page 'Parameters', and enter the required parameters and values: FPTRACELEVEL = 04 Setting the trace to the value required for the local saving of runtime information and for the generation of the PDF that contains ad ditional information. FPTRACEFILE = \ File for the local saving of runtime information This specification is optional. FPSAVEERRORPDF = X The system generates a PDF that contains additional information. FPERRORPDFFILE = \

SAP Note

944221

Version 29

Dec 5, 2014

Page 7 of 9

File for locally saving the PDF that contains additional information Caution: Local saving is possible only for applications that have a GUI connection, and therefore, this is not su pported for Web Dynpro ABAP. 3. These values then have a fixed assignment to the user. You must reset these settings after troubleshooting is completed. After you have made these settings, call your application for creating forms. The displayed PDF now contains the additional informatio n that can be used for further troubleshooting. Save the displayed PDF. Attach these files (PDF with attachment) to a message under the component BC-SRV-FP with a precise description of the problem. If you cannot generate a PDF, save the trace files and attach them to your problem message as described above. 7. Activating ADS trace on the J2EE Engine If you cannot determine the cause of the problem with the aforementioned steps or cannot create a PDF with additional information, we recommend that you activate the ADS trace on the J2EE Engine. Reproduce the problem. All actions relating to the Adobe Document Servic es are then logged on the J2EE Engine. Create a customer message under the component BC-SRV-FP with an exact description of the problem and attach the trace files to the mes sage. 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 Web Dynpro for ABAP, you will find detailed information in SAP Not e 999998. To determine whether the ADS configuration is correct, execute steps 1 to 5 that are described under I ABAP: 1. 2. 3. 4. 5.

Test program FP_TEST_00 Test program FP_PDF_TEST_00, RFC connection to ADS Test user and password Test destination service (only FP_CHECK_DESTINATION_SERVICE) Interactive forms: Test program FP_TEST_IA_01, credential test

6. Generated PDF with additional information Call your form in the Web Dynpro application and save the PDF with additional information that is generated by Adobe Reader. If the to olbar does not contain the save icon, use the F8 key to display it. You receive a PDF with attachments, which enable you to analyze th e problem in detail. Setting using user settings You can only use the user settings to activate the function "PDF with Additional 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 user maintenance of other users. 3. Choose the 'Parameters' tab page and enter the required parameter and value: FPTRACELEVEL = 04 Sets the trace to the necessary value for generating the PDF with 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 the user parameter configured previously

SAP Note

944221

Version 29

Dec 5, 2014

Page 8 of 9

takes affect. Reset these values after troubleshooting is completed. -> Attach these files (PDF with attachment) to a message with the component BC-SRV-FP, including a precise description of the problem.

7. Activating ADS trace on the J2EE Engine See descrption under I ABAP and SAP Note 846610.

III Web Dynpro for Java

1. Check the user and password of the ADS The procedure is the same as in chapter I ABAP "3. Test user and password". This information can also be found in the Adobe Document Services Configuration Guide in the Help Portal under: http://help.sap. com/saphelp_nw70/helpdata/de/37/504b8cbc2848a494facfdc09a359b1/frameset.htm -> Adobe Document Services Con figuration Guide -> Configuring the Web Service -> Securing Access to the Web Service ->Configuration Check -> Configuration Check for Interactive Forms in Web Dynpro for Java 2. Check the Web service destination ConfigPort_Document. As of SAP NetWeaver 7.10, the Web service destination ConfigPort_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 Note 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 4. Generated PDF with additional information As of SAP NetWeaver 7.0 Support Package 06, you can generate a PDF with attachments that enable detailed troubleshooting. The procedur e depends on the Support Package level of SAP NetWeaver 7.0. SAP NetWeaver 7.0 Support Package 06/07/08 Extend your application URL with the "sap-wd-adsTrace=4" addition. Note that there will then only be a display if the system can create a PDF. If this is not the case, follow the instructions that are contained in Notes 742674 and 846712. SAP NetWeaver 7.0 Support Package 09 and higher Set the Trace Level for Web Dynpro to 'ALL'. You can find detailed information about setting the Trace Level in Note 742674. Call your form and save the generated PDF with additional information locally. This PDF with attachments is required later for detail ed error analysis. Attach these files to a message with the component BC-WD-JAV, including a precise description of the problem. Reset the Web Dynpro Trace level.

SAP Note

944221

Version 29

Dec 5, 2014

Page 9 of 9

SAP NetWeaver '04 In these versions, the system does not display any PDFs with additional information, however, the trace files contain the notes that you require regarding the cause of the problem. Set the Trace Level for Web Dynpro to 'ALL'. You can find detailed information about s etting the Trace Level in Note 742674. Call your form and save the trace files locally. These are required later for detailed error analysis. Attach these trace files to a message with the component BC-WD-JAV, including a precise description of the problem. Reset the Web Dynpro Trace level. Information about the PDF with additional information is available in the SAP NetWeaver Problem Analysis Guide (PAG) at: http://help.sap.com/saphelp_nw70/helpdata/en/71/7ffb3f6c78ee28e10000000a1550b0/frameset.htm ->Usage Type Application Server Java -> Pr oblem Analysis Scenario for Adobe Document Services -> Adobe Rendering Error 5. Activating ADS trace on the J2EE Engine See descrption under I ABAP and SAP Note 846610.

Other terms SAP Interactive Forms by Adobe, Adobe document services (ADS), Adobe LiveCycle Designer, Forms Processing