SAP Interactive Forms by Adobe

Purpose
As of SAP NetWeaver ’04 (in SAP Web Application Server), you can use a new solution to create interactive forms and print forms for the optimization of your form-based business processes. This solution uses Portable Document Format (PDF) and software from Adobe Systems Inc. that has been integrated into the SAP environment. You can create interactive forms in PDF format that allow users to fill out the form on the screen and save their entries in XML format in the form. When the SAP system receives the PDF form, it extracts the data saved in the form, and can process it further. You can also merge a form template with current system data to generate a PDF document that can then be printed or sent by e-mail. SAP Interactive Forms by Adobe offer you the following business advantages: ● Interactive functions automate the creation of data for SAP systems ● Full integration into the SAP development environments for Java and ABAP ● User-friendly tools reduce the time and costs associated with creating form layouts. ● The usage of the PDF format means that forms retain their appearance regardless of the environment they are used in. In certain circumstances, you require a license for interactive forms. For more detailed information, read SAP Note 750784 on SAP Service Marketplace at service.sap.com/notes.

Implementation Considerations
SAP Interactive Forms by Adobe are particularly well suited to business processes in which employees enter data in a form-based solution and then want to transfer this data automatically to the SAP system. In the simplest cases, you only require the free Adobe Reader to display or fill out PDF forms on your front end.

Integration
SAP Interactive Forms by Adobe is included in SAP Web Application Server and can be used by any applications that are based on SAP NetWeaver ’04 or later. The following Adobe software is included in the form solution: ● Adobe LiveCycle Designer A graphical tool for designing form layouts; it is integrated into SAP NetWeaver Developer Studio and ABAP Workbench. ● Adobe Document Services Web services used to generate the PDF forms at runtime; in interactive scenarios, they extract the XML data from the form and send it to the system. Adobe Document Services run on SAP J2EE Engine. This means that you must install the Java Stack of SAP Web Application Server, regardless of the development language of your application (ABAP or Java).

Features
SAP Interactive Forms by Adobe offer the following basic functions: ● Create form templates for the layout that include logos or pictures

● ● ● ● ● ● ●

Generate documents by merging form templates and current system data Edit forms online or offline Forms can be filled in advance automatically with specific data from SAP applications and then sent to the correct recipients using secure methods Automatic consistency checks for forms Activate enhanced functions such as comments Digital signatures and form certification Send completed forms to the SAP application with automatic updates of the business data

There are two basic types of forms: Interactive Forms For business processes that require close cooperation between employees, you can design interactive forms as a part of a Web Dynpro application. You can use the following development environments: ● Interactive Forms in Web Dynpro for Java in SAP NetWeaver Developer Studio ● Interactive Forms in Web Dynpro for ABAP in ABAP Workbench These forms can contain dropdown menus, pushbuttons, text fields, and other elements that enable users to enter data. The form is generated in PDF format, which, for example, can be displayed by the user in a browser. The user uses Adobe Reader or Adobe Acrobat to fill out the form and saves the changes made to the form in XML format. The SAP system extracts the data from the form and saves it to the database, where it can be processed further. You can use these forms in two basic scenarios: ● Online The user is logged on to the SAP system when he or she fills out the form. ● Offline The user is not logged on to the SAP system when he or she fills out the form. Once the form has been filled out, the user sends it to the issuer of the form, for example by e-mail. The SAP system of the issuer then extracts the data from the form. Forms for Printing, E-Mail, or Fax You can use the Form Builder (integrated into ABAP Workbench) to create PDF-based print forms that you can then print or send by e-mail or fax. When you create these print forms, you can rely on the tried and trusted principle of separate data retrieval and form layout processes. This enables you to make changes to either one of the processes, without affecting the other.

PDF-Based Print Forms
Purpose
PDF-based print forms are part of the SAP Interactive Forms by Adobe solution and are used for printing in SAP systems. As well as standard output on printers, and the option of archiving documents, you can also use your application to send a PDF to the Business Communication Services (BCS). Here, you have the option of faxing or e-mailing your documents. The following gives you an overview of how a PDF-based print form is structured, and also tells you how to create a PDF-based print form in the development environment of the ABAP Workbench. The integrated Adobe LiveCycle Designer™ software supports you when you do this. This software must be installed on your front end before you can create a layout. To see a print

preview of your form, you first need to install Adobe Reader or a complete version of Adobe Acrobat. This documentation does not discuss how documents are printed and controlled on printers. Instead, it discusses the whole process up to when a file is sent to output management functions, such as the spool system in SAP systems. Note that, for printing and previewing PDF-based forms, you need to use a PCL, Postscript, or ZPL printer and an appropriate device type (such as POST2, HPLJ4, HP9500, PDF1, AZPL203, or AZPL300). You cannot use a printer with the device type SAPWIN/SWIN. More information is available in the SAP Printing Guide (BC-CCM-PRN), under Printing PDF-Based Forms.

Integration
An activated PDF-based print form corresponds to a callable function module in the SAP system. The complete logic of the form is represented by this function module. When a form is printed, it is called by an application program, which collects the relevant application data. The application program uses the function module interface to send the data. Therefore, the data collection process is split from the logic of the form. This means that you only need to adjust the form when you modify the logic or layout. There are several ways of creating interactive forms. For more information, see Interactive Forms.

Features
To develop a PDF-based print form, you use Form Builder, integrated with ABAP Workbench. This tool enables you to create a complete form description, even if you do not have extensive programming skills. The tool supports you in the following tasks: ● Creating layouts Here, you use the Adobe LiveCycle Designer to design pages or create the layout. ● Specifying the data used in the form In the form context, you specify which data, tables, texts, and graphics are sent to the form. ● Migration of Smart Forms By migrating Smart Forms, you can reuse them as PDF-based print forms. You can find the Smart Form migration tool in transaction SMARTFORMS.

Smart Forms are still supported; you can continue to forms created in Smart Forms without making any changes. ● Importing existing PDF files or forms This tool is integrated into Adobe LiveCycle Designer and enables you to use your own templates for your form. ● Scripting Adobe LiveCycle Designer uses the script languages JavaScript and FormCalc. FormCalc is a simple Adobe script language for typical form calculations, including mathematical and logical functions, and date and character string functions. For more information about FormCalc, and a FormCalc language reference, see the online help of Adobe LiveCycle Designer. To achieve the best level of performance when processing forms, use as little scripting as possible in the form. If possible, perform all calculations and data analysis in the application program, before the form is called. Printing and archiving the PDF-based print form:

For example. These parameters are not viewed in Form Builder. you define how the output data is positioned. PDF-Based Print Form Definition A PDF-based print form is a form designed for mass printing in SAP systems. A form context that contains the form logic. such as quality forms in the automotive industry Structure A PDF-base print form has the following attributes: • • A form interface that sends the application data to the form. This logic controls the dynamic formatting of the form. and it can specify that invoice items can be processed repeatedly in a table. its appearance in graphics. and so adapt the output to your requirements. . you control them with function modules that you integrate in your application program. A layout.You can use output parameters to specify print and archive settings. Instead. In the layout. Use PDF-based print forms can be used for the following: • • • • • • • • Order confirmations Invoices Account statements Checks Salary statements Delivery notes Customs forms Industry-specific forms. It has the standard Portable Document Format (PDF). it specifies that certain texts appear only under certain conditions (one text for a first warning and a different text for a second warning). it enables variable fields to be displayed. and the design of the pages. • Architecture The following graphics show you the architecture that is implemented when you create and print a PDF-based form.

you generally need to insert application data in the form. if they use the same data. You can assign multiple forms to the same interface. The architecture of PDF-based forms is designed to separate the collection of the application data from the definition of the actual form: .Creating a Form The form interface is created separately from the form. Form Output − Runtime If you use an application to create a form. The form description includes the complete form design as a complex description in XML. Form interfaces and forms are stored as separate development objects in the repository. you must assign it to a form interface. When you create a form. which consists of the form context and layout.

Page Concept and Elements of a Form Definition You specify the page layout for a form in Adobe Designer. These services create the actual form: ● As a PDF to be processed later by the application or for the preview in Adobe Reader ● As a PCL. Use You can create any number of pages for your form. and determine the order of the pages that have differing structures. This can be. table data selected previously in the application program.When you activate the PDF-based form. it uses its interface (corresponds to the form interface) to send it the application data. or ZPL to be sent to the spool A function module is available for more precise control of the output. tables. a function module is generated that encapsulates all properties of the form. for example. and various other types of objects can be displayed in the output range of a form page. When the generated function module is called. Structures Adobe Designer includes two different types of pages that you can use to structure your form layout: . When the application program calls the function module. the form description and application data is sent to Adobe document services. data. PostScript. Texts.

you define where the data comes from that you want to display in the form. You activate the interface. rectangles. you use the Form Builder that is integrated with the ABAP Workbench. . 3. • Choose Help → Help Topics under Layout. Designing Forms with the Form Builder Purpose You can use this process to create or edit a PDF-based form. These elements are available in a library in Adobe Designer. graphics. Process Flow To create a form. date and time fields. you call the interface function in the Form Builder. 2. 2. • Standard objects • • • • • Static objects such as texts. circles. Prerequisites You have installed Adobe Designer on your front end. Adobe Designer is installed with the SAP front end. You can also edit a migrated Smart Form.. 3. see the online help in Adobe Designer. 1. You create a form object. text fields.. and lines  Dynamic objects.• • Master pages Body pages You can position various elements on these pages. such as option and list fields. and the different types of page elements. 1. 1. and password fields  Special date objects Your own user-defined objects Bar codes For more information about the page concept. In the interface. call the Form Builder: • • • You are on the screen Form Builder: Change Form <Form Name> or Form Builder: Display Form . To do this. To access the online help for Adobe Designer. numeric fields.

Enter the name of the form in the Create Form dialog box. You can use an application program that collects the relevant data to call this function module. To create a form with a context and layout. Enter the name of the interface that you want the form to use. 5. enter the name of the interface and select an interface type. 4. Select a package. . Before you can start to edit these objects in the Form Builder. c. 11. You activate form. and drag and drop data from the form context you have defined. 8.. 5. In the layout function in the Form Builder. 1.4. 3. Result You have created a function module that encapsulates the form description. 6. 10. . In the context in the Form Builder. You have two options here: Creating a Form Object in the Repository Browser 7. choose Create →Form Object → Form. a. 3. You can also insert texts. choose Create ® Form Object ® Interface. 5. 2. In the context menu of the package. 12. b. 2. To create a form interface. The Create Object Directory Entry dialog box appears. You are in the Repository Browser of the ABAP Workbench. b. You then have a PDF-based document for mass printing in SAP systems. 5. you must create them. 6.. You use this graphical tool to design the printed appearance of the form. graphics. 2. c. In the context menu of the package. 7. you drag and drop the required parameters from the interface you have defined. Creating a Form Object Use Form interfaces and form contexts with layouts are known as form objects. Proceed as described under 5. and addresses. 6. 6. 9. a. proceed as follows: 4. For more information about the different interface types. below. proceed as follows: 1. see Interface in the Form Builder. In the Create Interface dialog box. Enter your data and save the object. 13. Choose Save. 4. you create the layout.

22.. Creating or Changing Documentation 18. 5. The documentation is not included in the form output and is only available in Form Builder. 2. This documentation is used as F1 help and contains information for support team members or form developers who need to examine the form. You can start to edit the interface or form. 1. A form object is assigned to precisely one piece of documentation. renamed.. 25. 16. Choose Back. The documentation is displayed. deleted. Enter the name of the interface or form. 3. 20. Under Form Builder: Entry Point. Under Form Builder: Entry Point. .. 17. Result The Form Builder starts. Creating and Displaying Form Documentation Use You can create documentation for each of your forms or form interfaces (form objects). If you want to create a form. If you want to create an interface. Save your changes. Prerequisites You require SAP NetWeaver SPS 8 or higher. 4.. Displaying Documentation 23. Note. Call transaction SFP. 3. . 15. 4. the documentation object is copied. . however. 1. follow the procedure shown above under 3a. The creation of form documentation is integrated into the standard documentation environment (transaction SE61). and transported automatically with its accompanying form object. . that the documentation is ignored by the functions Upload Form Object and Download Form Object. follow the procedure show above under 4a. 2. 2. 4.. 21. 19. 1. 14. specify a form or interface. Choose Goto → Documentation ® Change.Creating a Form Object from a Transaction 3. Choose Goto ® Documentation ® Display. 24. 5. 3. specify a form or interface. The system calls the SE61 editor and you can create your documentation. Choose Create..

you can create program code to modify global definition data before the form is processed. in an appropriate editor on your front end. You use fields inserted as placeholders in the form to specify the appearance and location of the data in the form. such as totals for tables For all three of these data types. You can use form routines that are defined in ABAP Editor. you define your own fields. you do not need to create the form context here. The system fields contain data with a predefined meaning (such as the date). You create the XML schema as a local XSD-type file. This can include the following data: ● ● ● Data selected from the database tables of your application. You use the form interface to specify this data. Unlike ABAP Dictionary-based interfaces and Smart Forms-compatible interfaces. the system shows the available system fields automatically in the interface. This interface is an XML schema. which is sent directly to the data view in Adobe LiveCycle Designer. You cannot edit it within Form Builder. such as dates Data that you have calculated or implemented in a form yourself. the data is not specified or inserted in the form until runtime. The XML schema already contains the form context. you specify the data that is exchanged with the application program (such as tables). The XML schema-based interface consists of the following: . Data provided by the SAP system or by the PDF-based print forms solution.Interface in Form Builder Use You want to include data in your form that was not specified when the form was created. You cannot enter system fields directly. Features You can choose from the following three interface types: ● ● ● ABAP Dictionary-based interface Smart Forms-compatible interface XML-based interface ABAP Dictionary-Based or Smart-Forms-Compatible Interface These two interface types have different standard parameters in the form interface. Under Code Initialization. When you call the context in Form Builder. Both interface types give you the following options for including data in PDF-based print forms: ● ● ● In the form interface. These fields are replaced by the current data at runtime. You can then drag and drop the required fields to the context. Under Global Definitions. which must be constructed in accordance with the W3C standard. ● ● XML Schema-Based Interface You use this interface type if you create your forms in Form Builder in Web Dynpro for ABAP. You can assign currency and quantity fields. You load the finished interface into Form Builder.

Therefore. 5. 27. Activities There are two ways of calling Form Builder for the interface: From the ABAP Workbench (Transaction SE80) Choose Form Objects → Interfaces and select an interface. 4. Change. Enter the name of the interface. From Transaction SFP 26. Choose Create. The form interface of a form is structured in the same way as the interface of a function module in the system. ● The application program provides the data that you want to insert in the form. You can start to edit the interface. or Display. Prerequisites ● You have created an Interface form object. you already know the types of the corresponding variables. switch to the Properties tab page. Call transaction SFP. The XML schema The loaded XML schema is displayed here. Form Builder starts. 1. form interfaces do not support Changing parameters. To select the interface type. Defining a Form Interface Use You define a form interface to send data from your application to a form. 6. 2. 3.● ● The form interface with the parameters that specify the data The runtime data from the application program is specified in the import parameter /1BCDWB/DOCXML (type XSTRING). However. 29. See also: Getting Information about Interface Parameters Overview of Function Modules (in ABAP Workbench: Tools) . 28. Integration The form interface is a part of the Interface form object and is defined in the Form Builder. The semantics of the valid parameter types match the semantics of a function module. Choose Interface.. You cannot make changes if you have chosen Display.. 30. .

6. Activate the interface. 4. . When you double-click Export. double-click Exceptions.Creating Function Modules (in ABAP Programming (BC-ABA)) Procedure 7. Enter the parameter names of the data you want to import. Migrated Smart Forms Interface or New Smart Forms-Compatible Interface When you edit the interface of a migrated Smart Form or a new interface that is compatible with Smart Forms. To display this structure in the ABAP Dictionary. 35. 34. the Tables option gives you extra parameters. This has the advantage that an application program can work with several different forms. you see the standard parameter /1BCDWB/FORMOUTPUT of the generated function module. . When you set the Import. 7. However. These names are valid for the whole form and do not have to match the variable names in the data collection program.. it is also possible that the application program provides parameters that the form does not need. the application program must provide the parameters. Under Form Interface. 33. You do not need to mention these parameters in the form. 2. The Interface tab is displayed. This screen also shows the standard parameter /1BCDWB/DOCPARAMS. At runtime. TYPE can be selected under Type Assignment. You use this parameter in your application program. 3. they can also be specified in a different order from the code of the application program. You cannot change this parameter. choose Insert Line ( ). You see a screen for entering import parameters. 37. 31. and Exceptions parameters. XML schema-based interface • ○ The standard parameter /1BCDWB/DOCXML with the type XSTRING is used for sending data from the application program. to make the generated form available as a PDF for further processing. then the output of the form ends with the program crashing (hex dump). double-click the SFPDOCPARAMS type. If a parameter has been defined in the form. the system also lets you use the standard parameters from the Smart Forms. • 36. ABAP-based or Smart-Forms-compatible interface ○ To insert a new line. Export. To display the exceptions used by the generated function module. 32. double-click the Import node. but is not defined when the application program is called. 5. You use this parameter in your application program. to specify the value for the language setting. 1. for example. All data types are valid.. You cannot change this parameter. Open the required interface in the Repository Browser of the ABAP Workbench. for example.

to convert selected application data. You can also select additional data without having to make changes in the application program. to display totals). but which has not been provided by the form interface (for example.If you have a Smart Forms-compatible interface. . Field Symbols You can use field symbols as pointers when you extract data from internal tables. See also: Initialization Initialization Use SAP customers can use this function to execute ABAP program code before a form is processed. Types Here. for example.) Result You have defined the form interface and you can use the specified parameter names in the form context. (See also Switching Runtime in Migrating Smart Forms. for example. if the ABAP Dictionary does not provide a type. We recommend that you use Global Datain the initialization. to convert selected application data. you define any data needed by the form. You can include subroutines (Form Routines) when you do this. you create data types as free ABAP code. Here. You can initialize global data before you start to process the form. Features Global Data Here. you can use the existing application program of this Smart Form without making any modifications. Activities Double-click the node that you want to edit. you have the option of defining your own fields to be used anywhere in the form. Functions You use the ABAP Editor to write the program code (Code Initialization) that is executed before the form is processed. Global Definitions Use Global definitions belong to the interface in the Form Builder. You can initialize the global data.

to ensure that the value field is formatted correctly.. VALTAB). CURTAB) to a value field in another table (for example. if this is the value field of VALTAB that you want to display. which is the currency field of CURTAB. In the second case. you can assign a currency or quantity field to a table field. and formats the value field according to the currency or unit in the assigned field. you must indicate this reference to the system in the form. the system recognizes the reference automatically. 39. Reference Field: CURTAB-CURRENCY. Create the reference to the currency field by entering the following values: 1. the system formats the value field VALTABVALUE according to the assigned value in the currency or quantity field of the global variable CURTAB-CURRENCY. Context in Form Builder Use In the context (also known as the form context). 8. If the value field is in a different table from the currency or quantity field. Result In the output of the PDF-based print form. In the output of these fields. you also decide the form logic by specifying conditions for processing the nodes. Field Name: VALTAB-VALUE.See also: Global Definitions Specifying a Currency or Quantity Reference Use In the ABAP Dictionary. Under Data Type. You include this data as a node in a hierarchy structure. the system cannot recognize this reference automatically.. Procedure You want to assign a currency or quantity field in one table (for example. In this hierarchy. specify whether the data type is a currency or quantity. you specify which data is copied from the interface to the form. . 38. 2. the system can then insert the relevant currency or unit: If the value field is in the same table as the corresponding currency or quantity field. .

The system sends the form context to the layout function of Form Builder automatically. Activities There are two ways of calling Form Builder for the context: From ABAP Workbench (Transaction SE80) From the object list. 44. Integration The context function in Form Builder is the link that binds the interface to the layout. Change.Prerequisites You have created the form objects Interface and Form.. Choose Form. and the form context itself appears as a hierarchy under Data View. you use the Data View nodes to include the data in the form. 4. graphics) are included in the output Whether the data of a node is Active or Inactive Whether a specified node or an alternative node is processed 9. choose the Context tab page. 3. From Transaction SFP 40. you can hide any items. In this way. Create or edit the context. You cannot edit if you have chosen Display. Define the layout type of the form. Call transaction SFP. that you do not need. 41. 45. If the condition is not met. if this is supported by the selected node. choose Form Objects → Forms and select a form. You can specify conditions. 42. You construct the form context from the existing interface. 43. When you create the layout. 1. . then the node is skipped. expand all nodes. 2. 6. You can also specify WHERE conditions for the selection of data from tables. 5. choose the Properties tab page. Only active nodes are forwarded to Form Builder to be processed in the layout. as well as all its subnodes. If the condition is met. a properties window is displayed under the context. To do this. For each node. To view the entire form logic. Features You use the form logic of the context to control which rules are used to send the hierarchy nodes to the layout. or Display. The form logic determines the following: ● ● ● Whether the content of the node (text. then the node is processed. Form Builder starts. Editing the Form Context You can edit the form context in the following ways: ● Create nodes .. such as table fields. addresses. Enter the name of the form. To do this. Choose Create. The layout function calls Adobe Designer. and how they are processed.

Screen Display in the Context of the Form Builder The following graphic shows you the structure of the screen that appears when you select the Context tab in the Form Builder. choose the Properties tab and double-click the name of the interface. To edit the layout.● ● ● Move and copy nodes Set node as active or inactive Update nodes For an overview of the graphical user interface. see Screen Display in the Context of Form Builder. but cannot be changed here. choose the Layout tab. The interface on which the form is based is displayed. . To edit the interface.

the address data is extracted directly from database tables and formatted for printing. Folder Condition . Node Types Nodes Without Subnodes Symbol Node Type Text Graphic Address Meaning Text module. All nodes. You can use conditions to specify whether the data in the form is included and displayed at runtime. TRUE and FALSE. include text. Some nodes represent the data in the form. data nodes are generated automatically. Other Nodes Symbol Node Type Data node Structure Meaning Elementary data field Structure Possible Direct Subnodes None All nodes. Displayed directly after the node that is processed depending on this condition. depending on conditions Groups subnodes for clarity Not a separate node.Nodes in the Context Definition Nodes in the context are organized in a hierarchy. The first node in the context is a folder node and has the name of the form. data nodes are generated automatically. or dynamic text Graphic Address. others represent the form logic. can have any node as a direct subnode Any nodes None Table/loop Dynamic table Alternative Alternatives.

3. select the node under which you want to insert the new or copied node. 1. Click a node in the context with the secondary mouse button to display the context menu for this node. To display the context menu of the node. In the context. As well as the data defined in the interface. you can create nodes for text. 10. .. In the context of this node. 2. Double-click a field in the interface to display a dialog box with detailed information about the properties and type of the field. drag it as above.. click the secondary mouse button. graphics. Only active nodes are sent to the layout in the Form Builder. 48. cut. delete. Depending on the data type. 2. In the context. drag the required fields from the interface on the left of the screen to the context. 3. Double-click the node to display more details about the node in a screen under the context. 49. •  You can create a new node. 52. choose Paste. Moving or Copying Nodes Moving or Copying Nodes with Drag&Drop • • To move a node. 4. use Drag&Drop to drag it to the required place in the form context.. and paste nodes. but press the Ctrl key at the same time. . you can do the following: •  Enter and change properties •  Enter and change conditions Result You have created nodes in the context. select a node that you want to move or copy. you have the following options: •  You can set the node as Active or Inactive. To copy a node. Depending on the node type. Moving or Copying Nodes with the Context Menu 11.. and addresses. . Now perform the following: •  To move a node. 1. •  You can copy.Creating Nodes 46. choose Cut in the context menu of the node. 51. 50. •  To copy a node. choose Copy. 47. To create one or more nodes.

To copy only the FLDATE and PASSNAME data nodes to the layout. set these nodes as inactive. Setting Nodes as Active or Inactive Use To hide one or more nodes in the form context. you can see all its data nodes (MANDT. Select one or more nodes. Click the secondary mouse button and choose Set to Active or Set to Inactive in the context menu. 53. FLDATE. At runtime. CONNID. only the active nodes are included in the form. move. A node with a condition always appears in the data view of Adobe Designer. When you expand the table node and its subnodes. Example You have created a BOOKINGS table node in the form context. Updating Nodes Use If you have already started to edit the form context and you have made changes to the field definition of nodes. Unlike the active or inactive setting. Accordingly. conditions are not implemented until runtime. CARRID. as long as it is active. or copy generated nodes (flagged with ) in structures and tables.. select all the other data nodes in the table and set them as inactive. In this way. You can set also set individual nodes as active or inactive in the Properties window. which makes it easier to use. Only active nodes are sent to the layout and can be used by Adobe Designer in the data view.. 1. when you choose the Layout tab page. . Activities 12. These nodes are flagged as generated ( ). 54. then you can use this function to update the context. However. . you see the BOOKINGS node with the row node and FLDATE and PASSNAME in the data view of Adobe Designer. and so on). The form context shows both generated and non-generated nodes. PASSNAME. 2.You cannot delete. you only see the data that you actually need for the form. when sending them to the layout in the Form Builder. Only these two data nodes in the table will be included in the form at runtime. you can set them as Active or Inactive in the context menu.

com/notes. To update a node together with all of its subnodes (generated and nongenerated nodes). or move generated nodes. Activities 57. A node can have active or inactive status. Choose the node that you want to update. and used in the form output. for example. These nodes are not flagged with . see SAP Note 808116 at service. single record nodes. These nodes are not generated. You cannot change this. In this way. Only active nodes are sent to the layout in the Form Builder.Generated nodes (flagged with ) are the fields of structures or tables that you have inserted in the context from the interface. For an explanation. Properties Use Properties describe the content or meaning of a node. For more information about converting older PDF-based print forms. 1. Non-generated nodes are. 14. on the right of the screen above the context. 2. 2. choose the icon. 58. see the description of the node. as well as the general properties. you can nest tables inside each other. For more information. or data nodes that have a reference to the ABAP Dictionary. Double-click the node to open the properties screen. You can now change general properties of the node. 13. you can set any nodes that you do not need in your form as inactive. Activities 55. see Setting Nodes as Active or Inactive. 56.sap.. . . You cannot delete. with the text Update. structure nodes. If you use loop nodes. You can choose non-generated nodes only. This has the advantage that these texts do not need to be saved in the form. 59. 1. and Status. Description. . the system copies the short text of the type from the ABAP Dictionary under Description. and reduces the need for translations. the top nodes of structures or tables that you have inserted in the context from the interface.. the system also displays additional nodespecific properties (which you can change).. You can change the appearance of structures and tables by adding more data nodes or tables.. Depending on the chosen node. for example. such as Name. 3. However. copy.

use the alternative node. 4. 7. You can choose both AND and OR relationships. It is not entered in quotation marks: FIELDFORNAME. 6. ■ • Conditions Use You can define conditions for individual nodes. for example. For each line. Prerequisites A node exists for which you want to define conditions. To insert a line. 3. the text module name at runtime. Choose Conditions. Choose Relational Operator to display a screen where you can make a selection of relational operators. for some nodes you can also specify conditions for the form output. you can enter static and dynamic values for the node properties: An example of a static value is a text module. specified in quotation marks. you can enter a condition with two operands. The operand can be a field (variable) or a value. is then only processed if the related condition is met. In the first line. . Features You can define conditions using logical relationships. 61. This field can contain. the Operator field stays empty. Double-click the node for which you want to define a condition. click . Activities 15. • ■ A dynamic field is the name of a field. 64. 65. 2. 62. To select from two alternative subhierarchies in the form output. 63. 5. 60. Choose Operator to link successive lines with each other. The Properties window opens. As well as the properties. or all its subnodes. A node. This node must allow conditions to be defined. It is entered in the format 'TEXTNAME'. or for whole subhierarchies of the context.In many cases. 1. 66.

Inserting a Data Node Using the Context Menu 16.  Under Conditions. • • • • For data nodes that reference the ABAP Dictionary. Select an existing node in the context.  The full field name of the node is displayed under Data. 2. Result You have created a complete data node. . you can set the data node as active or inactive. The system creates a data node under the selected node.  Under Status. the system displays the properties of the inserted data node. the system takes the related short text from the ABAP Dictionary. However. under which you want to create a data node. Use the F4 help to display a list of all data fields used in the interface. choose Create → Data. you can select the Field Label. 4. 3.Inserting Data Use You want to insert elementary data fields ( of the screen. The text chosen here is used in Adobe LiveCycle Designer to display the label of the data field in the layout. In the Create Data dialog box. To display the context menu of the node. 69.. enter the prerequisites that need to be met before the data node is processed at runtime and displayed in the form. click the secondary mouse button. You have two options here: Inserting a Data Node with Drag&Drop ) that are specified in the interface on the left Use Drag&Drop to move the required data field from the interface to an existing node in the context. 67. In the layout in the Form Builder. You cannot change this. you can insert this node in the form. 70. Editing Properties and Conditions • In the window under the context. 1.. 68. Choose Continue. In the context menu of the node. enter a field name. .

75. enter a structure name. click the secondary mouse button. 3. You have Inserting a Structure Node with Drag&Drop Use Drag&Drop to move the required structure from the interface to an existing node in the context. The system creates a structure node under the selected node. or switch it to active or inactive. you can insert the structure node in the form. which means they are flagged with the icon. The node is fully expanded so that you can see the individual fields of the structure.Inserting a Structure Use You want to insert a structure ( two options: ) from the interface on the left of the screen. 5. To display the context menu of the node. 76. These have been generated. choose Create → Structure. In the layout in the Form Builder. Inserting a Structure Node Using the Context Menu 17. the system displays the properties of the node. 74. enter the prerequisites that need to be met before the structure node is processed at runtime and displayed in the form. 72. Select an existing node in the context. Under Conditions. In the Create Structure dialog box. 6. 1. In the window under the context. Result You have created a complete structure node. 4. When you expand the node. You can specify conditions for each data node in the structure. you can see the individual fields of the structure. you can set the structure node as active or inactive. Use the F4 help to display a list of all structures used in the interface. Under Status. In the context menu of the node. 73. 71. . under which you want to create a structure node. Choose Continue. 2.

You can use WHERE conditions to select only parts of the data from the table at runtime. Under Conditions. 8. specify the assignment type under Output Behavior and also the work area of the table. • ○ Under Status. The system creates a table node under the selected node. 78. When you choose this option. You can also specify conditions for individual data nodes in the table. Choose Enter 5. enter the prerequisites that need to be met before the table is processed at runtime and displayed in the form. 3. • ○ If required. below. choose Create → Loop. In the context menu of the node. you can set the table node as active or inactive. You have two options here: Inserting a Table Node with Drag&Drop Use Drag&Drop to move the required table from the interface to an existing node in the context. • ○ If you are using a migrated Smart Form as a form. enter one or more data fields from the table that you want to use to group information in the output. 2.Inserting a Table or Loop Use You want to include a table ( ) from the interface on the left of the screen and define the loop that selects the table data. Proceed as described under 5. Only active nodes are sent to the layout in the Form Builder. Select an existing node in the context. 82. 4. under which you want to create a table/loop node. Use the F4 help to display a list of all tables used in the interface. 7. For more information. the . 83. 80. enter a table name.. under Reading Internal Tables. Inserting a Table Node Using the Context Menu 18. the system displays the properties of this node. In the window under the context. The node is fully expanded so that you can see the individual fields of the table. click the secondary mouse button. . You can set individual data nodes in the table as Active or Inactive in the context menu. Under Control Levels. To display the context menu of the node. 84. 81. 77. see the documentation for Smart Forms. restrict the table range that you want to read by setting the input fields From Row and To Row. 6. 79. 1. In the Create Loop dialog box..

In this case.. 87. However.. the system displays the properties of this node. Procedure 20..context tree is changed. The system creates a single record node under the selected node. Use the F4 help to display a list of all tables used in the interface. 88. Result You have created a complete table node. 89. At runtime. Data nodes that are defined as part of a structure within the table cannot be specified as a control level. the data is selected according to your settings. 3. The grouping is indicated by the selected fields being placed before all other fields of the table. Choose Continue. Select an existing node in the context. In the layout in the Form Builder. .. You specify a search key. 4. you can set the single record node as active or inactive. you can see the individual fields of the table. • ○ Under Status. 85. You enter the row number. You can choose between ascending and descending sorting. which means they are flagged with the icon. You can extract a single row (record) of a table in two ways: 19. . 1. In the context menu of the node. When you specify a search key. 1. 5. the table row is read by the ABAP statement READ TABLE itab WITH KEY k1 = f1 . 90. When you expand the node. choose Create → Single Record. For more information about this statement. 91... 2. . the return code SYSUBRC is inserted in the system field SFPSY-SUBRC. 86. These have been generated. this is only active if you do not set the Already Sorted flag under Properties. The node is fully expanded so that you can see the individual fields of the table. enter a table name. 2. In the window under the context. In the Create Single Record dialog box. see Reading Rows of Tables. kn = fn result. you can insert the table node in the form. If multiple records are accessed. Inserting a Single Record Node Use You can use the single record node ( ) to extract single data records from internal tables. under which you want to create a single record node. this system field contains the SY-SUBRC value of the last access.

select a data node. and you want to perform a binary search. You can also specify conditions for individual data nodes in the table. Grouping Tables by Data Fields Use You can create control levels to group tables by data fields. you can. you can see the individual fields of the table. see Inserting a Table or Loop. 6. These have been generated and cannot be deleted. For more information. You can choose from various text types: ● Text modules . To do this. • ○ Select the Binary Search option only if you want to use a search key to display the table row. which means they are flagged with the icon. enter the row number of the internal table that you want to extract. At runtime. Note that you cannot enter any information under Row. The properties and conditions that are displayed refer to the data node. Procedure You enter the required information in the table node. Prerequisites You have created a table node or a loop node. When you expand the node. 7. you can insert the single record node in the form. In this way. You can also use a search key to extract rows from the internal table.You can set individual data nodes in the table as Active or Inactive in the context menu. Only active nodes are sent to the layout in Form Builder. 92. enter the prerequisites that need to be met before the table row is processed at runtime and displayed in the form. define a nested output for a flat internal table. ○ Under Row. Under Conditions. the data is selected according to your settings. In the layout in Form Builder. • Result You have created a complete single record node. Enter this key under With-Key Conditions. Inserting a Text Use You can use a text node to insert texts in the output of a form. for example. 93.

4. 99. Under Conditions. You can find a list of restrictions under: • • ■ ■ Entering Text Module Properties Entering Include Text Properties Procedure 21. Only active nodes are sent to the layout in Form Builder. 96. The system modifies the Properties window according to your selection. Text modules also exist in the system. the text and its name are not known until the output of the form is created. 5. . Select an existing node in the context. Prerequisites The text module or include text that you want to insert must exist in the system. In the context menu of the node. You can set a text node as Active or Inactive in the context menu. 98. enter the prerequisites that need to be met before the text node is processed at runtime and displayed in the form. 97. They are crossclient texts and are linked to the Change and Transport System and translation tools. Include Text. To display the context menu of the node. Remember the restrictions that apply when processing forms with inserted texts. 6. choose Create → Text. 7. under which you want to create a text node. enter the required information about the text type. 1. The text name is specified by the content of a variable field. Entering Text Module Properties Prerequisites You have created a text node in the context and selected the text type Text Module. In the Properties window under the form context. 94. 2. Entering Include Text Properties) 100. The system creates a text node under the selected node. you create and edit them in transaction SMARTFORMS. choose Text Module. Under Properties. For dynamic texts. or Dynamic Text. The text module exists in the system. 95. None of these text types are inserted until the form is printed.● ● Include texts Dynamic texts Include texts are SAPscript texts that already exist in the system. (See: Entering Text Module Properties. Save and confirm your changes in the next dialog box. click the secondary mouse button. 3.

and status. see Maintenance of Text Modules in the Smart Forms documentation. Choose F4 to see a selection of languages. Choose F4 to see a selection of all text modules in the system. bar codes Special characters System fields. Result You have created a text node. 104.. 106. even if the inserted text module does not exist in the system. you can specify a different style. such as the name. Procedure 101. 4. 103. next paragraph on same page Character formats: Superscript and subscript.. Under Text Name. such as SFSY-DATE Hyperlinks The following are supported with restrictions: 22. 3.Restrictions The following components are not supported in text modules and are ignored when the form is processed: ● ● ● ● ● ● Outline paragraphs Paragraph properties: Page protection. the form is not printed. . but not for aligning fields within texts SAP characters. ● ● Tabulators. 5. for example More information about these restrictions is available in the SAP Notes 894389 and 863893. For more information about creating and changing text modules. Set the flag No error if text not available if you still want the form to be printed. The corresponding text is not inserted until the form is processed. Enter the text language in which you want the text module to be inserted. . Specify the general properties of the text module. and an error message appears. Under Style. 6. 2. If you do not set this flag. 1. 102. but not SAP icons. description. Set the flag Copy Style from Text Module if you want to keep the style from the text module. enter the name under which the text module is stored in the system. 105.

description. The include text. 2. but not for aligning fields within texts SAP characters. enter the name under which the include text is stored in the system. Prerequisites You have created a text node in the context and selected the text type Include Text. 1. Choose F4 to see a selection of the texts in the system. In this way. 3. exists in the system. Procedure 107. 109. Under Text Name. for example The following are supported with restrictions: More information about these restrictions is available in the SAP Notes 894389 and 863893. next paragraph on same page Character formats: Superscript and subscript. The TEXT . you can manage application-specific form texts. such as the name. TEXT indicates a standard SAPscript text. bar codes Special characters System icons. and status. which has been created with SAPscript Editor.Entering Include Text Properties Use You want to display a SAPscript text in the form. we recommend that you use text modules. Specify the general properties of the include text. You use transaction SE75 to define separate text objects with their own text IDs for applications. 108. If you do not have to use SAPscript texts. This text type has the same function as the SAPscript command INCLUDE. such as ULINE Standard icons Hyperlinks Tabulators. Specify the text object. They are cross-client texts and are linked to Change and Transport System and the translation tools. Restrictions The following components are not supported in SAPscript texts and are ignored when the form is processed: ● ● ● ● ● ● ● ● ● ● ● SAPscript styles Outline paragraphs Control statements Paragraph properties: Page protection. but not SAP icons.

you either specify the URL address of an image or the name of a field in which the image content is specified in binary code at runtime. The usual ID of a standard SAPscript text is ST. such as a company logo. 9. Specify the text ID. even if the inserted include text does not exist in the system. If you specify a paragraph format in the Standard Paragraph field. Enter the text language in which you want the include text to be inserted. For more information about creating and editing SAPscript texts. the system copies the values for Text Object. you can insert graphics. 114. you can set a paragraph format for the first paragraph of the include text. You use the graphic node to specify where the content of the image comes from at runtime. 112. If you leave the Standard Paragraph field empty. Enter constant values in quotation marks. If you do not set this flag. 111. see the online help in Adobe LiveCycle Designer under Defining Object Properties ® Image Fields ® About Image Fields. 6. the form is not printed. 5. 8. and an error message appears. you bind graphic nodes to an object of the type Image Field. to be used in the form output. To do this. 7. Inserting a Graphic Use Under the graphic node. Under First Paragraph. This overrides the setting in the style. The style assigned to the text node contains formatting for standard paragraphs (‘*’). Set the flag No error if text not available if you still want the form to be printed. Result You have created a text node with the text type Include Text. Specify the style that you want to use for the include text. . and Text Language already stored for this text in the SAP system. all standard paragraphs in the include text are also formatted with this paragraph format. Text ID. In Adobe LiveCycle Designer.text object with the text ID ST is used for general standard texts that you create with the standard text editor (transaction SO10). you override the format of all standard paragraphs in the include text with this format. 115. 113. see the SAPscript Editor documentation. If specified. The corresponding text is not inserted until the form is processed. For information about the supported image file formats. 110. 4.

choose Create → Graphic. or whether the graphic is embedded in the form. 118. Graphics stored in MIME Repository cannot be accessed through a URL. under which you want to create a graphic node. enter the URL of the graphic. For more information about graphics used in Smart Forms. Procedure 23. 117. The URL can point to a Web server or to a file system. • ○ If you have chosen Graphic Reference as your graphic type. Select an existing node in the context. For more information. In Adobe LiveCycle Designer. you can choose whether the system gets the graphic at runtime.. such as ’image/bmp’. Enter the required data about the graphic in the Properties window under the form context. enter the prerequisites that need to be met before the graphic node is processed at runtime and displayed in the form. This means that you may have to configure appropriate access rights for Adobe Document Services (ADS). 5. The entries you need to make depend on whether you chose Graphic Reference or Graphic Content in the last step. ○ Graphic Content Choose this option if you want to specify graphic content using a field. enter a field name from the interface. In the context menu of the node. see the online help in Adobe Designer. You must be able to access the graphic at the specified URL. To use these graphics. The graphics must be in MIME Repository. you must do the following: • ■ In Field. 120. The system creates a graphic node under the selected node. . 2.Prerequisites Any graphics that you want to display with the Graphic Content option must be stored in MIME Repository. • 119. 4. 1. 3. Under Conditions. This field contains all image information at runtime. • Result You have created a complete graphic node.. . You can insert this node in the layout in Form Builder. 116. choose Graphic Content. ○ If you have specified Graphic Content as your graphic type. • ■ Enter a valid MIME type. The field must have the type STRING (graphical data is Base64-coded) or XSTRING (for binarycoded graphical data). You can choose from the following graphic types: • ○ Graphic Reference Choose this option if you want to insert a graphic from its address (URL). see Migrating BDS Graphics into MIME Repository.

anycompany. You have chosen Graphic Reference as your graphic type. the following URL is entered for the graphic object: http://www.gif 2. it contains the name of the graphic that you want to load. The addresses are stored in a database.com/images’ GRAPHIC_NAME ’. Specifying the URL by Using Fields Graphic URL ‘http://www. otherwise. The example shows you two ways of specifying the URL. . Procedure 24. 1. 1. Specifying a URL with Fixed Values Graphic URL ’http://www.Example You want to insert a graphic from the Website of the fictitious company AnyCompany in your form.anycompany. Prerequisites Your application must manage addresses in the BAS. In the context menu of the node. 122. choose Create → Address.com/images/logo. 2. under which you want to create an address node. Select an existing node in the context. Inserting an Address Use Many applications use the Business Address Services (BAS) to manage addresses. The graphic is unknown when the layout is created. where they are identified by numbers. which is why no URL appears in Adobe LiveCycle Designer. you must insert your addresses using text nodesor insert them directly in the layoutas text. At runtime.anycompany.gif’ Delimiter / GRAPHIC_NAME is a field from the interface that is entered as an import parameter. 121.gif’ Delimiter If you have inserted the graphic node in Adobe LiveCycle Designer.com/images/logo.

click the secondary mouse button. 3. 1. 127. 128. You can use Drag&Drop to assign any existing node as a subnode. with the two subnodes TRUE and FALSE.To display the context menu of the node. This node has two successors. In the context menu of the node. Double-click the subnodes to enter their properties as well. otherwise. The system creates an address node under the selected node. 2. specify the conditions for a node to be processed. enter the prerequisites that need to be met before the address node is processed at runtime and displayed in the form. Select an existing node in the context. To display the context menu of the node. choose Create → Alternative. you use the alternative node. . 123. The system creates an alternative node under the selected node. 4. The information required for the address node is similar to that in Smart Forms. 3. To do this. 124. click the secondary mouse button. under which you want to create an alternative node. Result You have created an alternative node. choose Create → … to create nodes for the alternative options. In the context menu of the TRUE and FALSE nodes. See also: Inserting Addresses (from the Smart Forms documentation) Inserting an Alternative Use You want to present an alternative option in a form. Under Conditions. Enter the required data in the Properties window under the form context. One difference here is that you need to specify the sending country under Additional Specifications. the second successor node (FALSE) is processed. Enter the required data about the address in the Properties window under the form context. You want one of two nodes (and its subnodes) to be processed. 126. The first successor node (TRUE) is processed only if the condition is met. The window in which you define the alternative conditions is the same as the window used for defining the conditions for nodes. Procedure 125. Under Alternative Conditions. 4.

This string contains a range of system fields that the system replaces with values when a form is processed. under which you want to create a folder node. The system creates a folder node under the selected node. In the context menu of the node. choose Create → Folder. In the Properties window under the form context. Select an existing node in the context. 1. it is a good idea to group these text nodes in a specific folder. 133. you can enter a name for the folder node. In the context menu of the folder node. 129. 130. choose Create → .Inserting a Folder Use The more detailed a form becomes. the more difficult it is to get a clear overview of the hierarchy of nodes.. Result You have created a folder node. 2. To make the hierarchy easier to understand. System Fields The interface of a form contains the field string SFPSY. For example. depending on which deadline has been missed. 5. You can use Drag&Drop to assign any existing node as a subnode. you can organize nodes under folder nodes. To display the context menu of the node. To do this. You then use conditions to display just one of these nodes at runtime. The following general rules apply to system fields: • You can display the value of any system field in the form. The field content is either taken from the SAP system or is created while the form is being processed. . 3. 4. Migrated forms use the system fields from Smart Forms. you can use the system field SFPSY-DATE to display today’s date on your form. 131. to create subnodes. Procedure 25. 132.. click the secondary mouse button. enter the prerequisites that need to be met before the folder node is processed at runtime (together with its subnodes) and displayed in the form. You want to begin a reminder with a different text. Here. you create a text node with a different reminder text for each level of reminder. Under Conditions.

icon. current time of the application server Logon name for user in the SAP system If single record nodes are used. It is displayed below the interface. on the left of the . Reloading an Interface Use You have already started to edit the form context and you have made changes to the interface. If the field has a type from the ABAP Dictionary. current date of the application server Date and time.• • You cannot assign a value to a system field. with the text Reload Interface. You can use this function to update the display of the form interface in the context without having to exit the Form Builder for the context. In general. you can query system fields (for example. for example. See Screen Display in the Context of the Form Builder Activities Double-click a field in the interface to display information on the properties and type of this field in the lower screen area of the interface. you can double-click the type name to go to its entry in the ABAP Dictionary. in conditions) for any fields. in another session. contains content of the SY-SUBRC field in the ABAP statement READ TABLE Field List Use The field list shows you detailed information about the individual fields (such as structure and tables) of the form interface. choose the screen above the interface. System Fields Field Name SFPSY-DATE SFPSY-TIME SFPSY-USERNAME SFPSY-SUBRC Meaning Date and time. Activities To reload the interface.

To select a layout type. Adobe LiveCycle Designer starts on this tab. For more information about editing layouts.Layout in the Form Builder Use When you create a layout in the Form Builder. you define the graphical design of the PDF form. Layout Types Layout Type Unknown layout type Meaning The form has not yet been classified. This includes the positioning of the data and the design of tables. The layout type you define must match the script code in the layout. Activities There are two ways of editing the layout: • • You choose the Layout tab page. see the online help in Adobe LiveCycle Designer. you can use a wide range of functions to design your form. an integrated graphical software tool for creating forms. Otherwise runtime errors can occur. You still have to classify the form. To do this. choose the Properties tab page in Form Builder: Change Form. and define the order of the pages. In the application toolbar. You can also specify background pictures for the form. you use the form context you have created previously or an XML schema displayed as a tree structure under Data View in Adobe LiveCycle Designer. Integration The Layout function in the Form Builder calls Adobe LiveCycle Designer. You can use Drag&Drop to insert data fields from the Data View section in the page layout. This is the case if you are creating a new form or editing a form created with an older version of SAP NetWeaver. Features Under Layout in the Form Builder. Prerequisites You have created a form context or loaded an XML schema-based interface. you first have to close the tool. Layout Type You use the layout type to define the runtime environment where the form is used. Adobe LiveCycle Designer starts in fullscreen mode. you choose Layout (quick info Fullscreen Layout). To access the menu bar and application toolbar. .

Standard layout Use this layout type for PDF-based print forms. however. These objects contain special functions and can be found in the Designer’s library. see the Designer’s online help under Working with Objects → Using Custom Objects → Custom Objects for the SAP Environment. Also included are some objects developed specially for the SAP development environment. Note that you can make this setting only if the layout type of your form was previously Unknown. You can still. Adobe LiveCycle Designer provides you with the following date objects: • • Localized Full Date Localized Long Date . ActiveX must be enabled in the browser. see Creating Forms for Integration with Web Dynpro and ZCI and Check and Update Functions for Zero Client Installation (ZCI). If your form is already set to Standard or ZCI. access your old form using version management. You specify this setting when you create new forms. you cannot choose xACF. or for interactive forms used in an offline scenario and not integrated in a Web Dynpro environment at runtime. xACF layout ZCI layout Zero Client Installation (ZCI) technology is used to integrate the form at runtime in Web Dynpro applications. The system enters this value automatically when you migrate old forms to ZCI. For more detailed information. For more information. Date Objects in Adobe LiveCycle Designer Definition Under Library ® Form Builder. Objects in Adobe LiveCycle Designer Definition Adobe LiveCycle Designer provides you with objects that you can use to create your form. The Active Components Framework technology is used to integrate the form at runtime in Web Dynpro applications.

The dates are formatted according to the parameter values entered for language and country in the application program.2004 17. 17.2004 Montag. Mai 2004 17.05.. Example You want to display the date objects on the form in US format or in German format. [. * German format * FP_DOCPARAMS-LANGU = 'D'.05.• • Localized Medium Date Localized Short Date Use You use these date objects to format dates locally when you call the form. Mai 2004 17. * Call the generated function module CALL FUNCTION FM_NAME EXPORTING /1BCDWB/DOCPARAMS = FP_DOCPARAMS Date Display as Specified by Date Objects Date Object Standard Date/Time Field Localized Default Date Localized Full Date Localized Long Date Localized Medium Date Localized Short Date US Date May 17. DATA FP_DOCPARAMS TYPE SFPDOCPARAMS. These values are sent to the generated function module that contains the form description. * FP_DOCPARAMS-COUNTRY = 'DE'. FormCalc Language Reference Your local Adobe Designer installation includes a FormCalc language reference in a PDF file that you can print out. 2004 Monday. 2004 May 17. . FP_DOCPARAMS-COUNTRY = 'US'.05. 2004 5/17/04 German Date 17.2004 17. 2004 May 17.] * US format FP_DOCPARAMS-LANGU = 'EN'.. May 17. 2004 May 17.04 For more information. see Example: Calling Forms in the Application Program.05.

you can use a range of check options. Features The system enables you to check your form in the following ways: ● Check the interface ● ● ● ● ● The system runs a syntax check on the interface. You can run checks on the form and test it in the print preview. The system also runs automatic checks when you activate the form. and that its layout meets your requirements. you must have installed Adobe Reader or Adobe Acrobat (both with Version 7.pdf You enter EN for <country> if you have an English installation. These checks also run each time you start to edit the layout. Links to the interface can be lost when the interface is modified. These checks test the data links between the context and the layout. You can send test data to this function module. DE if you have a German installation. Check the form The system runs a syntax check in the context. The system also checks whether the assigned interface is active. Checking and Testing a PDF-Based Print Form Use To guarantee that your form is free from errors. which then inserts this data in a print preview of the form. Check the layout The system checks whether all fields from the context have been inserted in the layout. and also whether all fields in the layout have a data link to the context. it checks to see whether all necessary field properties have been entered.If you have installed Adobe Designer on your C: drive. Form preview with and without inserted data The form is displayed in PDF format in Adobe Reader or Adobe Acrobat. Activation checks The system checks the form each time it is activated. Test the form The system generates a function module that contains the form description. You can run additional checks in the layout of the Form Builder. for example.0 or later) on your front end. and whether all the fields in the context have a link to the interface. Prerequisites To check the layout and display the preview. For example. the FormCalc language reference is in the following location: C:\Program Files\Adobe\Designer 7. .1\Documentation\<country>\FormCalc.

or if errors occur. If the form does not appear how you want it to. 6. However. These messages are just warnings. 1. For more information. 136. 3.. The system checks the layout and displays any errors in a list. The screen Test Function Module: Initial Screen appears. Choose Test (F8) in the application toolbar. Print Preview with Inserted Data or Form 31.. Choose Layout in the application toolbar.. You are in the context in the Form Builder or in the layout in the Form Builder. Double-click a message to locate the error in the context.Activities Checking an Interface 26. The system checks the interface and displays any errors or warnings in a list.. 2. 143. 28. Enter your data and choose Print Preview.. 2. activate the function Saving Runtime Information and a Generated PDF Locally and repeat the test. . . 138. You are in the context in the Form Builder or in the layout in the Form Builder. 3. 140. You are in the layout in the Form Builder. 3. 1. . 3. 5. You cannot navigate to the fields from this list. 148. The system starts Adobe Acrobat or Adobe Reader and displays the PDF form with your data inserted.. .. . 142. Checking a Layout 29. Enter the test data for the import parameters and choose Execute. 146. 137. Choose Check (Ctrl+F2) in the application toolbar. . 1. Choose Check (Ctrl+F2) in the application toolbar. You are in the interface of the Form Builder. 134. 2.. 4.. 145. 1. 149. you can still activate the layout later. The printer settings dialog box appears. Checking a Form 27. 4. 30. The system checks the interface and displays any errors or warnings in a list. 135. 2. see the online help in Adobe LiveCycle Designer. Preview Without Data You use the preview function in Adobe LiveCycle Designer to display the form in PDF format while you are creating the layout. this function does not insert any data. 141. . 147. 144. Double-click a message to locate the error in the interface.. 139.

Calling Forms in an Application Program
Purpose
To print or archive a form, you use function modules to call it in an application program. An initial function module determines the name of the generated function module that describes the PDF-based form. Two further function modules control the output of the form, and specify whether it is printed or archived. The form is then called in the application program after the necessary data has been selected. If you want to send your form as a fax or e-mail, you must forward the PDF to the Business Communication Services after the form has been called. You use the function module FP_JOB_OPEN to control how the form is sent back to the application program as a PDF. You get the PDF itself from the generated function module. The following process describes how a PDF-based form with a non-Smart Formscompatible interface is called.
If you migrated the PDF-based form from a Smart Form, or if the interface is Smart Forms-compatible, the form is called in the application program in the same way as a Smart Form. For more information, see the following Smart Forms documentation: Integrating the Smart Form into the Application Migrating Smart Forms (under Switching Runtime)

Prerequisites
You have created and activated a PDF-based form. You have experience of programming with ABAP and handling function modules.

Process Flow
150. 1. In the application program, you define a variable of the type RS38L_FNAM for the name of the generated function module: 151. 2. You call the function module FP_JOB_OPEN. You use this function module to specify settings for the form output. You specify whether you want the form to be printed, archived, or sent back to the application program as a PDF. The form output is controlled using the parameters (IE_OUTPUTPARAMS) with the type SFPOUTPUTPARAMS.
For the individual fields of the structure SFPOUTPUTPARAMS and their meaning, see the ABAP Dictionary (transaction SE11).

152. 3. You determine the name of the generated function module by calling FP_FUNCTION_MODULE_NAME.
The name of the generated function module is unique only in one system. This is why you must first call the function module that gets the current name of the generated function module from the name of the form.

153. 4. You call the generated function module and send the parameters to the form interface.
The structure SFPDOCPARAMS exists as an additional import parameter for the generated function module (for example, for setting the language); the structure FPFORMOUTPUT exists as an export parameter. For more information, see Parameters of the Generated Function Module.

154. 5. You call the function module FP_JOB_CLOSE to complete the processing of the form.

Result
The system creates the form with the integrated application data in PDL (Printer Definition Language) form and forwards it to the spool processing tools. A PDF is created only if the appropriate parameters are sent to FP_JOB_OPEN when archiving, returning a PDF, or using print preview. As long as you do not modify the form interface, you can continue to edit the form without modifying the application program. However, if you modify the form interface, you must also modify the interface in the application program accordingly. See also: Example: Calling Forms in an Application Program

Parameters of the Generated Function Module
You can use the parameters of the generated function module to define the way the form is displayed and its properties when it is called by the application program. The following lists these parameters: From the perspective of the function module interface: ● The parameters of the structure SFPDOCPARAMS are import parameters (/1BCDWB/DOCPARAMS). ● The parameters of the structure FPFORMOUTPUT are export parameters (/1BCDWB/FORMOUTPUT). Parameters of the Structure SFPDOCPARAMS Parameter Name LANGU REPLANGU1 REPLANGU2 REPLANGU3 COUNTRY Type LANGU LANGU LANGU LANGU LAND1 Meaning Language in which the form is displayed If the form does not exist in the language specified in LANGU, the system evaluates these fields in the given sequence instead. Country key for date and

number formatting No setting is required if the SET COUNTRY command is used in the application program before the generated function module is called, and the same country is specified there. FILLABLE FPINTERACTIVE
FILLABLE = X generates an

interactive form. This form can be displayed and edited in Adobe Acrobat or Adobe Reader. Usage rights are allocated to the form; these rights enable data to be entered and saved in Adobe Reader. FILLABLE = N generates an interactive form without usage rights. DYNAMIC FPDYNAMIC
DYNAMIC = X generates an

interactive, dynamic form to be displayed and edited in Adobe Acrobat or Adobe Reader versions higher than 7.0. This parameter is valid only if the FILLABLE parameter is also set. DARATAB TFPDARA If you want to archive the generated form, you must make at least one entry in this table (with archiving indexes).

Parameters of the Structure FPFORMOUTPUT Parameter Name PDF Type FPCONTENT Meaning Contains the generated PDF. A PDF is generated only on demand by the GETPDF parameter of the function module FP_JOB_OPEN in the application program, or by the print preview function. PDL PAGES FPCONTENT FPPAGECOUNT Contains the generated PDL. Contains the number of

FP_FUNCTION_MODULE_NAME gets the form name. 32. TY_BOOKINGS. where they must already be defined. 2. TYPE TYPE TYPE TYPE TYPE TYPE SCUSTOM. TY_CONNECTIONS.generated pages in the form. BOOKINGS. the parameters CUSTOMER. Generated function module of the form 158. 157. LANGU LANGU Language key The parameters that control the output options are in the structure SFPOUTPUTPARAMS and are specified as import parameters when the function module FP_JOB_OPEN is called.. 3. 156. 1.. . SFPDOCPARAMS. . FP_JOB_CLOSE closes the spool job. and CONNECTIONS are sent to the form interface. SFPOUTPUTPARAMS. RS38L_FNAM. 155. For more information. In this example. see Form Output. Example: Calling Forms in an Application Program The following is a program excerpt showing how the function modules are called. DATA: CUSTOMER BOOKINGS CONNECTIONS FM_NAME FP_DOCPARAMS FP_OUTPUTPARAMS * GETTING THE DATA <data selection> * PRINT: * Sets the output parameters and opens the spool job CALL FUNCTION 'FP_JOB_OPEN' CHANGING IE_OUTPUTPARAMS = FP_OUTPUTPARAMS EXCEPTIONS CANCEL = 1 USAGE_ERROR = 2 SYSTEM_ERROR = 3 INTERNAL_ERROR = 4 OTHERS = 5. FP_JOB_OPEN opens the spool job. 4.

IF SY-SUBRC <> 0. * Get the name of the generated function module CALL FUNCTION 'FP_FUNCTION_MODULE_NAME' EXPORTING I_NAME = ‘<form name>’ IMPORTING E_FUNCNAME = FM_NAME. <error handling> ENDIF. <error handling> ENDIF. * Language and country setting (here US as an example) fp_docparams-langu = 'E'. fp_docparams-country = 'US'. = = = = = = 1 = 2 FP_DOCPARAMS CUSTOMER BOOKINGS CONNECTIONS = 3. * Call the generated function module CALL FUNCTION FM_NAME EXPORTING /1BCDWB/DOCPARAMS CUSTOMER BOOKINGS CONNECTIONS * IMPORTING * /1BCDWB/FORMOUTPUT EXCEPTIONS USAGE_ERROR SYSTEM_ERROR INTERNAL_ERROR IF SY-SUBRC <> 0. * Close the spool job CALL FUNCTION 'FP_JOB_CLOSE' * IMPORTING * E_RESULT = EXCEPTIONS USAGE_ERROR = 1 SYSTEM_ERROR = 2 INTERNAL_ERROR = 3 OTHERS = 4. . IF SY-SUBRC <> 0. IF SY-SUBRC <> 0. <error handling> ENDIF. <error handling> ENDIF.

structures. Now that you know all the types of tables that are used. and then use this data in the form under Global Data. This enables you to optimize the way the data is collected in the application program. Prerequisites You have created a PDF-based form with an interface. You save the data in internal tables. Getting the Used Interface Fields Use You can use the same interface for multiple forms. Customers who want to change the way the data is collected. or variables. and created and activated the form context. The following questions need to be answered about the collection of the data: • • What application data do you want to appear on the form? Which database tables need to be accessed to get this data? Process Flow You write an ABAP program that collects the data or you include an appropriate routine in your application. These routines usually consist of statements that select data from the database.Collecting the Application Data Background To ensure a good level of performance when you print forms. . you can define a form interface to send this data to a form. and do not want to modify the application program. You use the function module FP_FIELD_LIST to get all fields of the interface that are used in the form. Result The data is saved to internal tables in the application program. you must separate the selection of the data from the processing of the form. The performance of the application program improves because it only needs to provide the parameters required by the relevant form. which you then bundle and send to the form. but not all fields of the interface need to be used in every form. can extract data when the interface is initialized.

if any are defined. and graphic nodes. address nodes. Activities You include the function module in the application program that collects the data and calls the form. You can save files that contain the following information to your local client: ● Runtime information (also known as trace information). This includes fields referenced by the data node and fields that are used in conditions. See also: Collecting the Application Data Saving Runtime Information and a Generated PDF Locally Use Form developers and support desk staff can use this function to analyze the causes of any errors that occur when forms are generated. Integration You can also get the runtime information directly in the application program that calls the form. using a function module. You can also see the used field names in the form context by displaying the properties and conditions for each node. see Troubleshooting. Features The function module FP_FIELD_LIST provides you with the following information: • All fields from the interface that are used in active nodes in the form context. Prerequisites You have debugging authorization in the system where you want to use this function.Integration The function module is included in the application program that collects the data and calls the form. You get a table of the used fields (with the type TFPFIELDS) that can then be used for data collection in the application program. You can also see field names under Where Conditions for table nodes. • All fields from the interface that are used in the ABAP code (initialization) of the interface. the system saves this information for all forms that are generated while the user is logged on. . • • You specify the name of the form as an import parameter. created by the system when forms are generated ● PDF with additional information Once a setting is chosen. text nodes. alternatives. For more information.

When you choose F4 for the file name. For a detailed description of the information provided by the system. sent to the form at runtime. You can use these function modules to extract the following information: . If you do not specify an extension for the file name.. the system saves the runtime information automatically with the extension TXT. ● Saving runtime information and a PDF with additional information for multiple forms If multiple forms are called in the application program. ● To activate the function PDF with Additional Information. the information is saved to separate files. or FPRUNX004 when the generated function module is called. A dialog box appears. However. Attached to either of these files are various additional files including. and 004 Use You want to display a PDF-based print form. You can use the troubleshooting options to find out the cause of the error. for example. choose an option under Trace Level and enter the name of the file. and the runtime information mentioned above. Troubleshooting for Runtime Errors FPRUNX001. the system displays the runtime error FPRUNX001. proceed as follows: • • ○ Under Runtime Information → Trace Level.Features ● Saving runtime information The system saves the trace information returned by Adobe document services to your local client. in addition to the existing numbering. see the section Execution in the problem analysis scenario Adobe Rendering Error (in English only).trc on the J2EE Engine. Choose Utilities → Settings. ● Saving the PDF with additional information The PDF with additional information consists of the generated PDF form or. The detailed trace information is located in the file defaultTrace. select the option Very Detailed Trace. application data (in XML format).. in the event of errors. This information is a subset of the trace information stored by the J2EE Engine used as a host system for Adobe document services. . ○ Select PDF with Additional Information and specify a file name. an error file. An extra sequential number is added to each file. ● To specify how the runtime information is saved locally. Activities 33. Features You are provided with various function modules for troubleshooting purposes. 002. you can navigate to your system to choose a file. FPRUNX002.

FP_GET_LAST_ADS_TRACE gives you the trace. ● ● Printer Archiving In this case. set the ADSTRLEVEL field in the IE_OUT_OUTPARAMS parameter (type SFPOUTPUTPARAMS) of the FP_JOB_OPEN function module to values between 01 and 10.sap. 2..com/notes.. Call the function module FP_GET_LAST_ADS_TRACE after the generated function module. for example. 2. This interface allows you to link the form with application data. call the function modules in your application program.• • Texts about the cause of the error (with the FP_GET_LAST_ADS_ERRSTR function module) A trace of the Adobe document services (with the FP_GET_LAST_ADS_TRACE function module) Activities To perform the troubleshooting actions. FP_GET_LAST_ADS_ERRSTR gives you a text that indicates the cause of the error. Troubleshooting Texts 1.. Trace 34. Read the SAP Note 717568 on the SAP Service Marketplace at service. . Form Output Purpose You can send a PDF-based form to various types of output media. 3.. . 1. 2. the form is forwarded to ArchiveLink. . You can choose one of the following options: 35. ArchiveLink is a communication interface that manages archiving systems in the SAP system. To activate the trace output. This note gives you precise and up-to-date information about how to proceed when troubleshooting. Call the function module FP_GET_LAST_ADS_ERRSTR after the generated function module.

specify the archiving mode in the ARCMODE field of the structure mentioned above. see the ArchiveLink documentation under Storing Outgoing Documents. ● Fax and e-mail If you send the form back to the application program as a PDF. The SAP system must be configured to be compatible with each output medium. see Controlling the Spool Dialog. see the ABAP Dictionary (transaction SE11). see Spool Processing and Controlling the Spool Dialog. Output to Printer Forms are sent to a printer by default. If you create the form output with a dialog. Prerequisites The form is sent to the output media through interfaces. To see how function modules are called. For example.. Output to Archive SAP Printing Guide 159. You can modify the print parameters and the spool dialog parameters by setting the fields accordingly. from where it can be sent as a fax or email. 3. Here. • • ○ ○ Archive only: SFPOUTPUTPARAMS-ARCMODE = ’2’ Print and archive: SFPOUTPUTPARAMS-ARCMODE = ’3’ You use the NODIALOG field to display the output of the dialog. see Example: Calling Forms in the Application Program. For more information. the application program can forward it to Business Communication Services. these fields are sent to the function module FP_JOB_OPEN as parameters (IE_OUTPUTPARAMS). 2. For the individual fields of the structure SFPOUTPUTPARAMS and their meaning. You write at least one entry to the table with archive indexes (SFPDOCPARAMS-DARATAB).For more information. For more information. if you want to print your PDF form. The system forwards the form to ArchiveLink. you specify an archiving mode for the document: • ○ Archive only • ○ Print and archive If you create the form output without a dialog. 1. you see the spool dialog. Process Flow To control the output of the form. you use various fields in a structure with the type SFPOUTPUTPARAMS. . When the form is called in the application program. see (BC-CCM-PRN). you must configure a PCL-compatible printer. this is what happens when you use the initial values of the structure when you call FP_JOB_OPEN. For general information about printing and printer setups.

The settings are cross-client settings. 1. When you process forms in another language (referred to here as the target language). . In this case. •  You can define replacement fonts for all forms in the system. set the field SFPOUTPUTPARAMS-GETPDF. You can do this in the following ways: •  You can define replacement fonts for specific forms. enter the form name. Under Name of Form Object.Output as Fax or E-Mail 36. the system replaces these characters automatically with suitable replacement fonts. When you use the appropriate tools to translate forms. 160. see Adobe Document Services − Configuration. Font Replacement Use PDF-based forms are created in an original language. you enter a wildcard character * in the table under Name of Form Object. . Activities To define replacement fonts.. edit the table FPFONTREPL in the Data Browser (transaction SE16). The fonts you want to use must be installed for Adobe document services. In your application program. 2. enter the target language in which the form and the replacement font or fonts are displayed. where it can then be forwarded to the interface of the Business Communication Services. Under Language. enter the name of the form. if a font does not support all characters in the target language. and the layout. 37. you require administrator authorization. the fonts used in the layout are retained. . The system sends the generated PDF form back to the application program. This function also gives you the option of setting a default font or fonts to be used as a replacement in forms. 2. the context. Integration You can specify replacement fonts for forms that have been created and translated in ABAP systems.. For more information.. Prerequisites • • To edit the table FPFONTREPL. However.. all texts are translated from the interface. 1. You make the required settings in the table FPFONTREPL. To do this.

4. When you call the form. To do this. you make the following settings in FPFONTREPL: Font Replacement in Table FPFONTREPL for Form Processing Name of a Form Object FP_name Language J Source Font Times New Roman Target Font MS Mincho Spool Processing Use As a default setting. enter the font that you want to replace the source font with. see the ABAP Dictionary (transaction SE11). Example For the Japanese version of the form FP_name. you want to use the character set MS MINCHO instead of Times New Roman. See also: . For the individual fields of the structure SFPOUTPUTPARAMS and their meaning. Under Source Font. Features You can use parameters in the structure SFPOUTPUTPARAMS to make print and spool dialog settings. you send these parameters (IE_OUTPUTPARAMS) to the function module FP_JOB_OPEN. for example: • • Opening a new spool job Specifying the retention period of a job in the spool Integration The functions related to these settings are no longer part of the process of creating PDFbased forms. the system forwards the generated PDF forms to the spool processing functions and sends parameters to the spool dialog. You can use this spool dialog to control the output. by doing the following. 3. specify the font in the original form. Under Target Font.Remember that the form is only displayed in the target language if this is specified for form calls in the field LANGU of the import parameter /1BCDWB/DOCPARAMS of the generated function module.

or if it is compatible with Smart Forms. If a form is migrated from a Smart Form. or hide the spool dialog completely. Features The following Changing parameters (set with the function module FP_JOB_OPEN) are relevant for controlling the spool dialog: Fields from the Structure SFPOUTPUTPARAMS for Controlling the Spool Dialog Field NODIALOG TITLE NOPREVIEW NOPRINT NOARCHIVE IMMEXIT NOPRIBUTT Component Type Data Type (Length FPNODIALOG CHAR(1) FPTITLE CHAR(50) FPNOPREVIEW CHAR(1) FPNOPRINT CHAR(1) FPNOARCHIVE CHAR(1) FPIMMEXIT CHAR(1) FPNOPRIBUTT CHAR(1) Meaning (when set) Suppress user dialog Title of the dialog box Suppress print preview No print from print preview No archiving from print preview Exit preview immediately after printing No pushbuttons .Controlling the Spool Dialog Printing PDF-Based Forms in the SAP Printing Guide Displaying and Printing PDF-Based Forms in the SAP Printing Guide Controlling the Spool Dialog Use In the application program. the spool dialog is controlled by different parameters. you want to adjust the spool dialog to your requirements when printing a PDF-based form. See also: Controlling the Spool Dialog in the Smart Forms documentation Prerequisites The DEVICE parameter of the structure SFPOUTPUTPARAMS must have the value ’PRINTER’.

See also: Example: Calling Forms in an Application Program Printing Multiple Forms in a Print Request Use You want to print multiple forms in a single print request. HPLJ4. Procedure 38. Result You have placed the selected forms in a print request. Determine the names of the generated function modules with FP_FUNCTION_MODULE_NAME. When you call the form in the application program. Adobe Document Services require this file to create the print files. XDC files are shipped for the following SAP device types: POST2 (generic device type that can be used for every PostScript printer). To set a parameter with the data type CHAR(1). PDF documents can only be printed on printers of SAP device types for which there is an XDC file in the system. to suppress the user dialog). 3. HP9500. AZPL203. and AZPL300.. The XDC scenarios provide you with examples of how you can make specific settings for your printer. 2. . call the function module FP_JOB_OPEN and specify the required parameters. 4. . 1. Then call the generated function module(s) that you want to use in the output. You do not usually need to make any modifications to these XDC files to use them for successful printing.Activities In the application program. See also: Calling Forms in an Application Program XDC Scenarios for Print Control Use An XDC file is a printer description in XML format. NODIALOG = ’X’. first call the function module FP_JOB_OPEN. specify the value ’X’ (for example. The function module FP_JOB_CLOSE is the last function module to be called.

but does not contain any layout information about the form. The XFP output contains all form data in XML format. Prerequisites Since XFP uses spool processing.sap. By default. . see SAP Service Marketplace at Adobe → Media Library → Documentation. In spool administration. at least one printer of device type XFP must be set up in the system.com/spp. Functions The documentation about the XDC scenarios describes the entries in the XDC file. Software partners can receive a certificate from SAP for products that access the XFP interface. we recommend that you set up an XFP output device. Output in XFP Format Use Using the XML interface for PDF-based forms (XFP). Integration XFP output corresponds to XSF output for Smart Forms and RDI output for SAPscript. For up-to-date information about downloading this documentation. see the Software Partner pages at http://www. so enabling you to make the following settings: • • • Printer Paper tray (not defined by default) Paper format (such as A3) Activities For documentation about the XDC scenarios. this output device is used as a virtual device for connecting to the external application. See also: SAP Printing Guide (BC-CCM-PRN). For more information. You can override this default by setting the output parameter IE_OUTPUTPRAMS of the function module FP_JOB_OPEN accordingly (the ABAP Dictionary reference is SFPOUTPUTPARAMS-XFPOUTDEV).Integration You can edit XDC files in a text editor and manage them in the SAP system.sap. see SAP Note 766410 on SAP Service Marketplace at service.com/notes. external applications outside the SAP system can access and process the contents of forms.

• XML data stream without context evaluation The data stream contains the data from the application program. ● Keep scripting to a minimum. Recommendations for Calling Forms and Form Output ● When you create forms for mass printing. together with all its conditions. Performance Aspects The following information is targeted mainly at developers. see the online help of the Designer. This means the form context is already evaluated. Only use those interactive functions (such as dynamic value help that sends queries to the server) that are strictly necessary. ● Deactivate any context nodes that you do not need. Times New Roman. since scripting in a form can have an effect on performance. under Creating Forms for Optimal Performance. which determines all fields used in the interface. design the data retrieval process in the application program and interface in accordance with your individual requirements. Place the context nodes used at the top of the form at the initial position in the context tree. These character sets do not need to be embedded in the form. Unless specified otherwise. design an individual form that uses its own data retrieval methods.Features The XFP output is activated at runtime by the calling application program. Do not implement the condition-driven output of multiple forms from the same form object. Recommendations for Adobe LiveCycle Designer ● For interactive forms. To support you in your work. The XML data can be displayed in two different ways: • XML data stream with context evaluation The data stream describes the structure of the PDF-based form at runtime with the data integrated from the application program. even if the Designer supports others: Courier. ● If possible. For more information. ● Bundle print forms. ● Structure the form context in accordance with the logical flow of data. ● For a detailed description of how to improve performance. which improves performance. Arial. use the Form Caching function in the Designer. . ● Minimize the amount of communication that takes place with the server in interactive forms. these recommendations apply both to interactive forms in Web Dynpro and to PDF-based print forms. Recommendations for Form Builder ● For each business scenario. who can use it to achieve an optimal level of runtime performance when using Interactive Forms based on Adobe software. use the function module FP_FIELD_LIST. use only the following character sets. see the online help for the Designer. but the form context has not been evaluated.

see the description under Problem Analysis Scenarios for Adobe Document Services for detailed troubleshooting information.● Cache forms that you want to process with Adobe document services. Features Utilities in the Form Builder The Form Builder that you use to create PDF-based print forms and interactive forms in Web Dynpro for ABAP offers you a wide range of functions: ● Checking and Testing a PDF-Based Print Form ● Saving Runtime Information and a Generated PDF Locally You activate this function in the Form Builder. Performance Analysis You can obtain precise details about the performance of Adobe document services. and 004 You use this function module to find out the causes of any errors you encounter when displaying forms. 002. . Runtime Errors. it gives you detailed information about the form data and runtime information specified by Adobe document services. see Adobe Performance Analysis (in English only). Handling Errors and Problems Use Interactive Forms based on Adobe software provide you with comprehensive support for detecting and resolving errors and problems when you create. When you call the form. For more information. Utilities in the Application Program that Calls the Form The following function modules provide you with support when you work with PDFbased print forms: ● Getting the Used Interface Fields ● Troubleshooting for Runtime Errors FPRUNX001. display. Communication Errors. and print forms. No Form Output If you encounter any connection errors or configuration errors when you use Adobe document services.

If you want to translate older forms in this way. texts are translated in a splitscreen editor that displays the texts in plain text format. An entry is created in the TADIR (object directory) table for each interface and each form. see Layout in the Form Builder. Translating Texts PDF-based forms are integrated in the same translation process as other development objects. and then link it to the application. The translation-relevant texts in a PDF-based form are as follows: ● Descriptions of the nodes These are translated in the same way as other system short texts. you must first display the layout in edit mode. ● Texts in the layout of the PDF-based form that you created in the Form Builder with Adobe LiveCycle Designer From SAP NetWeaver ´04 SPS 11. see the documentation on transaction SE63 under Translating PDF-Based Forms . You assign a package to an interface or form when you create it. Standard Forms Different applications in the SAP system use different standard PDF forms. The corresponding transport objects are as follows: ● SFPF for the form (R3TR SFPF <name>) ● SFPI for the interface (R3TR SFPI <name>) The system uses the Transport Organizer in the usual way to create the TADIR entries or transport objects and their attributes.) In this way. For the procedure for editing a form in Adobe LiveCycle Designer. copy the standard form. For more information about translation. Original Language When you create a PDF-based form. make your changes to this copy only. Cross-Client Objects The interfaces and forms for PDF-based forms are cross-client objects. The Transport Organizer distributes the interfaces and forms to other systems. If you want to adapt these forms to your own requirements.Delivery and Translation Transport Object The interface and form (context and layout) of a PDF-based form are separate development objects. and then save it again. the system specifies the logon language as the original language. You create the form and all its language-specific parts (such as texts and meanings) in the original language. your customer-specific changes are not lost when an updated version of the standard form is imported in an upgrade. this means that the SFPF and SFPI transport objects are recognized by the translation tools (transaction SE63) and are included in the relevant worklists. (The system does not log any modifications to the standard form. Local objects are not included in this process. .

Tools Associated with Form Development Use When you develop forms. The following gives you an overview of these tools and links to additional information. Business Address . You use the addresses managed in the Business Address Services (BAS). For more information about address management. see the Smart Forms documentation under: Maintenance of Text Modules You can assign a format (also known as a style) to a text module. see the following: Inserting a Text You create and edit text modules in Smart Forms (transaction SMARTFORMS). For more information on inserting a text module. see the following: Maintenance of Styles with the Style Builder Smart Styles Header Data of a Smart Style Paragraph Formats Character Formats Note that the documentation linked to here relates to creating forms in Smart Forms. For more information. This information does not always apply to PDF-based forms. See also: Creating Text Modules Business Address Services Creating Text Modules Use You can insert text modules in a PDF form as text nodes. Business Address Services Use You can insert an address node in a PDF-based form. see the documentation Services (BC-SRV-ADR). For more information. you will also need to make use of functions and components that are not included in the development environment for PDF-based forms.

choose Utilities → Versions → Generate Version. Activities Under Form Builder: Entry Point. depending on your application scenario: ● ● ● ● Web Dynpro for ABAP in SAP NetWeaver AS ABAP Web Dynpro for Java in SAP NetWeaver AS Java Guided Procedures Forms in SAP Business Workflow for various mySAP ERP business packages (in particular. Manager Self-Services) are developed in ABAP Workbench (transaction SFP) and implemented in the Web Dynpro for Java runtime environment. You use one of the following development environments. choose Utilities → Versions → Version See also: Documentation about Version Management Migration of Smart Forms Use You want to migrate a Smart Form to a PDF-based form. and you call it there. ● To save a version of the form or interface in the version management database. enter a form or interface. Management. . • ○ For general information about using forms. ● To access the version management functions.Version Management Use The PDF-based forms solution is integrated with version management tools. Integration This function is integrated into the Smart Forms transaction. See also: Migrating Smart Forms in the Smart Forms documentation Interactive Forms There are several ways of creating an interactive form. You can save different versions of both forms and interfaces. see the mySAP ERP documentation under HCM Processes and Forms and Internal Service Request (ISR).

You can.• ● ○ For information about creating forms in Form Builder. see Creating Forms for Integration with Web Dynpro and ZCI. A user in Adobe Reader cannot enter and save data in an interactive form until these rights are granted. For more information. See also: • • • Concepts of Developer Studio Detailed information about SAP NetWeaver Developer Studio Development of Interactive Adobe Forms for the Web Dynpro UI Explanation of the concepts behind creating forms Example of the Use of an Interactive PDF Form This documentation gives you a short introduction to creating an interface PDF form. see Reader Rights Credential in the Adobe Document Services Configuration Guide. however. ABAP Workbench. and data bindings. See also: • • • Web Dynpro for ABAP General information about the solution Adobe Integration Information about creating a PDF form in Web Dynpro for ABAP InteractiveForm Interface element for creating forms in View Designer Interactive Forms in Web Dynpro for Java You develop interactive forms as part of a Web Dynpro application in SAP NetWeaver Developer Studio. • Web Dynpro InteractiveForm API − IWDInteractiveForm . This development environment is intended mainly for creating print forms. interactive forms require licenses. generate a PDF when you call a form. For more information. and use certain parameters to control which input is allowed. see SAP Note 750784. Reader Rights are configured as part of the installation and configuration process of Adobe Document Services. these steps run automatically in the environments listed above. including information about constructing the view. All of these options require Reader Rights to be granted before you can use interactive forms in Adobe Reader. the context structure. Transaction SFP. Note that you need to program some steps manually when you use ABAP Workbench. In certain circumstances. Interactive Forms in Web Dynpro for ABAP You develop interactive forms as part of a Web Dynpro application in ABAP Workbench.

use the Adobe Designer library Web Dynpro Native.1 (see SAP Note 962763). 162. If you want to use Web Dynpro-specific objects in the design of your form layout. You can see the scripting in the node (Variables)->ContainerFoundation_JS under Hierarchy in Adobe LiveCycle Designer. 5. the forms must contain special scripting. You can use transaction SFP_ZCI_UPDATE to make any interactive forms you created with an older version of SAP NetWeaver ZCI-compliant. 161. They can be used (from SAP NetWeaver SPS 8) at runtime in Web Dynpro for Java based on Zero Client Installation (ZCI).. Switch to the Layout tab page.Interface element in View Designer • Adobe Library Documentation about specific objects in Adobe LiveCycle Designer. The system inserts scripting into the form layout in Adobe LiveCycle Designer. You use Adobe LiveCycle Designer 7. You use SAPGUI Release 6. 163. see Check and Update Functions for Zero Client Installation (ZCI).40 Support Package Level 20 or higher (see SAP Note 940637). To enable this. 2. For more information.. 40. 3.. which you insert when you create new forms in Form Builder. This starts Adobe LiveCycle Designer in SAPGUI. Procedure 39. .. Prerequisites ● ● ● You use SAP NetWeaver 2004s SPS 8 or higher. 165. 164. 1. These include interactive forms in the ISR Framework. . 4. Create a form. on the Web Dynpro tab page Creating Forms for Integration with Web Dynpro and ZCI Use This procedure is only relevant for forms created with Form Builder at design time and that run in a Web Dynpro application at runtime. Select ZCI Layout in the Layout Type field under Properties. . Choose Utilities → Insert Web Dynpro Script. such as forms for Business Package Manager Self-Service.

Check and Update Functions for Zero Client Installation (ZCI) Use You use transaction SFP_ZCI_UPDATE to check forms and update them to ZCI. For more information.. Call transaction SFP_ZCI_UPDATE. Features This transaction calls the report FP_CHK_UPDATE especially for checking and updating forms to ZCI. you must first run the report FP_CHK_UPDATE with the ISR object. It selects the required check and update objects automatically. runs the report for them. Prerequisites ● ● ● If you want to update forms from ISR Framework to ZCI. This transaction calls this report with the required objects. and update it if necessary. 2. Integration This transaction calls the report FP_CHK_UPDATE especially for ZCI. We therefore recommend that you use the transaction SFP_ZCI_UPDATE. Various objects can be selected for both the check function and the update function.. 1. you require a role that is assigned to authorization object S_FP_CHK. You created a layout previously with the integrated Adobe LiveCycle Designer tool. Proceed as described in the documentation for the report FP_CHK_UPDATE. Only those objects used to migrate forms for Zero Client Installation (ZCI) are currently available. 167. For more information. The same prerequisites apply as described in Check and Update Functions with the Report FP_CHK_UPDATE. see SAP Authorization Concept. Prerequisites ● ● To be able to use the update function. and switches the layout type of the migrated forms to ZCI Layout. Note that you do not need to perform step 7 to select the objects. Any forms that you want to check or update have to be active. Check and Update Functions with the Report FP_CHK_REPORT Use The report FP_CHK_REPORT enables you to check the layout of a form. . You can use this transaction to update only those forms that are not in editing. 41. Activities 166. . see SAP Note 956074.

Activities 42.. 4. You can also select forms in the Multiple Selectiondialog box. Select at least one object to be checked or updated from the list of available check and update objects. 3. The system determines the number of forms on which the function is used and displays it in the status bar. Before it changes a form. Features This function allows you to check and update one or more forms in a batch process. read SAP Note 956074. Under Activity. 1. you must know the name of the appropriate RFC connection to ADS. You can determine the scope of the check or update by selecting appropriate objects. Update form layouts This checks the forms and updates them if necessary. Enter the name or names of the forms under Form(s).. If you want to migrate forms for ZCI. by inserting scripting. Under ADS Connection. or Changed On in a dialog box. the system creates a version of it automatically and saves it to version management. 5. A dialog box tells you if no check or update objects are available. Run report FP_CHK_REPORT in transaction SA38. . 6. Detailed results of the check or update are shown in a log. You can also copy form names from a text file or the buffer. The default shown by the system is ADS. You can select forms by attributes such as Name.● ● ● Since Adobe Document Services (ADS) are called for this function. The system also shows you a list of inactive forms that cannot be used with this function (if available). Changed By. The check and update objects must be on the ADS server. specify the RFC connection to Adobe Document Services. You can choose one of the following options: ● ● Check form layouts This only checks the forms and does not modify them. . This guarantees that you always have access to a backup copy of the original form. 7. The link to Change and Transport System guarantees that updated forms are transported further in your landscape. 2. Choose Execute (F8). specify whether you want the system to run a check or an update. Created By.

2. we recommend that you restrict program-driven generation to simple form templates only. For this reason. For any forms assigned to a package. For this object. . without using Adobe Designer. Each interface corresponds to precisely one tag in the XFA specification. This guarantees that your updates are transported. 8. where you can display and analyze them later.You must read SAP Note 956074 before you select an object if you want to run an update before migrating forms for ZCI. You can generate all subsequent XFA elements by using a “create” method of the factory method to instantiate the corresponding object. You create the structure of the XFA document as follows: ● You use “set” methods to set simple attributes and to send the attribute value to the VALUE parameter in quotation marks. Integration To fully understand how to use the API. and to send an object to the VALUE parameter that represents the attribute (and the new element).html. These logs are saved in the application log. This API generates an XFA (XML Forms Architecture) document that can be displayed in Adobe LiveCycle Designer. you must read this description together with the XFA specification. as well as suggestions for the hierarchical structure of the elements.adobe. You can see the results in a log. ● You use “set” methods to set attributes that are themselves elements. This specification contains explanations of all elements and attributes. The check or update runs. It offers only a selection of the XML tags and attributes from the XFA specification. Activities You can use all interfaces from the package SAXFT. The API is based on Adobe XFA Version 2. and may take some time depending on the number of forms selected. This prompt does not appear for forms or packages created as local objects. Adobe Designer itself offers a much wider range of functions. You generate the root node by using CREATE_OBJECT to instantiate an object from the class CL_SXFT_TEMPLATE.com/public/developer/xml/index_arch. Program-Driven Generation of Form Templates Use SAP provides an API (application programming interface) that you can use to generate a form template. you can call the method GET_FACTORY( ) to create a factory object. the system prompts you to enter the appropriate transport request for each transport layer. 9. This enables you to implement the programdriven generation of form templates. To access the Adobe XFA specification. go to the following Internet address: http://partners.

a static text. The interface IF_SXFT_NODE is included in all interfaces that represent XFA elements. H. . Performance Aspects The following information is targeted mainly at developers. Minimize the amount of communication that takes place with the server in interactive forms. under Creating Forms for Optimal Performance. Only use those interactive functions (such as dynamic value help that sends queries to the server) that are strictly necessary. Since no context is generated. Recommendations for Adobe LiveCycle Designer ● For interactive forms. design an individual form that uses its own data retrieval methods. Recommendations for Form Builder ● For each business scenario. This interface is included in all interfaces that represent elements with these attributes. a selection list. which improves performance. and a pushbutton. If possible. Place the context nodes used at the top of the form at the initial position in the context tree. This interface is included in all interfaces that represent elements with these attributes. these attributes do not need to be generated. Y. Grouping interfaces are used for attributes that are used very frequently ● The interface IF_SXFT_ALIGNMENT groups the “set” methods for the attributes VALIGN and HALIGN. These character sets do not need to be embedded in the form. W. who can use it to achieve an optimal level of runtime performance when using Interactive Forms based on Adobe software. since scripting in a form can have an effect on performance. see the online help of the Designer. no data binding is created. see the program RSXFT_XFT_API_DEMOII. Arial. For a detailed description of how to improve performance. Times New Roman. use only the following character sets. even if the Designer supports others: Courier. This program generates a template that includes the following: header and footer. The values can be set directly by using the corresponding “set” method (such as <margin> and <color>). a text input field. and Layout. Example For an example implementation. Keep scripting to a minimum. use the Form Caching function in the Designer.An exception to this are attributes that are themselves elements but only have a few of their own attributes. ● The interface IF_SXFT_MEASUREMENT groups the “set” methods for the attributes X. option fields. For more information. ● You use the method IF_SXFT_NODE~APPEND_CHILD( NEW_CHILD ) to set child elements. ● Structure the form context in accordance with the logical flow of data. ● ● ● ● see the online help for the Designer. Do not implement the condition-driven output of multiple forms from the same form object. Unless specified otherwise. these recommendations apply both to interactive forms in Web Dynpro and to PDF-based print forms.

● Deactivate any context nodes that you do not need. which are used to define the bundling of forms. . This function enables you to optimize communication with ADS by caching the form layout on the server where ADS is installed. There are two types of caching in ADS. you can also cache the processed PDF (for interactive forms). Performance Analysis You can obtain precise details about the performance of Adobe document services. In the latter case. For more information. ● Bundle print forms. you can optimize performance on the ADS server since it retains a ready-made PDF that only needs to be filled with application data at runtime. This setting then applies to all forms in your Web AS ABAP. For more information. Prerequisites To use this function. To support you in your work. CACHING in Table FPCONNECT Value x space Meaning Activate caching Deactivate caching Use the system setting. Caching Forms Use Forms are sent to Adobe document services (ADS) for processing. caching activated The table FPCONNECT also contains other fields. see the documentation Form Caching in the online help of Adobe LiveCycle Designer (mentioned further below). which determines all fields used in the interface. use the function module FP_FIELD_LIST. see Adobe Performance Analysis (in English only). ● Cache forms that you want to process with Adobe document services. Activities You activate this function by setting the field CACHING in the table FPCONNECT in the Data Browser (transaction SE16). Recommendations for Calling Forms and Form Output ● When you create forms for mass printing. As well as caching the form layout. design the data retrieval process in the application program and interface in accordance with your individual requirements. you require SAP NetWeaver Support Package Stack 6 or higher.

The data in the forms can be different. Table FPCONNECT Field DESTINATION DIR_GLOBAL BATCHING Required Setting Connection to ADS X is a prerequisite for bundling X to activate simple bundling . requesting PDFs. which enables the system to exchange data using the global directory Features Form bundling is supported for the following scenarios: ● Print ● Print and archive ● Archive only In all other cases (such as print previews. Prerequisites To use this function. you require the following: ● SAP NetWeaver Support Package Stack 6 or higher ● Adobe document services installed in an SAP NetWeaver AS ABAP + Java system (J2EE Add-In). ● Complex bundling Forms with different form designs and different languages are bundled together. bundling is deactivated automatically by the system. The data in the forms can be different. and output in XFP format). Activities There are two ways of bundling PDF-based print forms: Using a Table to Define Form Bundling To set this function in your system.See also: Form Caching in the online help of Adobe LiveCycle Designer under Creating Forms for Adobe Document Services → Designing Forms for Adobe Document Services → Optimizing and Improving Adobe Document Services. You can choose one of two bundling types: ● Simple bundling Any forms with the same form design (layout and context) and the same language are bundled together. Bundling of PDF-Based Forms Use Forms are sent to Adobe document services (ADS) for processing. make the required settings in the table FPCONNECT in the Data Browser (transaction SE16). The function described here enables you to optimize communication with ADS by bundling forms in a single call.

Using the Application Program to Define Form Bundling You can also use the application program that calls the form to define form bundling. Generation of PDF Forms Without Tags Use Applications that do not require accessible forms can improve runtime performance by creating PDF forms without tags. PDF forms generated in this way need less memory. Check your requirements in advance. . Adobe Acrobat or Adobe Reader tells you whether your PDF document has tags. If bundling has been activated in the system (using the entry in table FPCONNECT). especially the applicable legal requirements. complex bundling is activated. specify space. to use the system setting. set the parameter IE_OUTPUTPARAMS-BUMODE in the function module FP_JOB_OPEN: Parameter IE_OUTPUTPARAMS-BUMODE Value x M space Meaning Simple bundling Complex bundling Setting taken from FPCONNECT No bundling Form bundling is particularly effective at improving performance for small forms. A PDF file with tags. They are a requirement for the generation of accessible PDFs. See Caching Forms. including elements such as headers. and tables. To deactivate a field. You cannot use the function described here if you want your PDF forms to be accessible. uses them to describe and flag the document structure. If both BATCHING and MBATCHING are set in the table. To do this. however. Any gains in performance are also system-dependent. texts. This has the advantage that you can specify which type of form bundling to run depending on your application. it may be a good idea to deactivate it occasionally for very large forms.MBATCHING CACHING X to activate complex bundling Not required for bundling. specify –.

● The PDF is always given tags when archived or returned to the application program. Parameter PDFTAGGED Value x space Meaning Generated PDF form is a PDF with tags. function module FP_JOB_OPEN) to define whether PDF forms are generated with or without tags. Activities Set the PDFTAGGED field to your requirements in your application program and send it to the function module FP_JOB_OPEN. display. The user settings or the scenario decide how to generate the PDF: ● The way the PDF is displayed in the print preview depends on the GUI settings on the front-end PC (accessibility mode). it gives you detailed information about the form data and runtime information specified by Adobe document services. .Features You can use the PDFTAGGED field in the IE_OUTPUTPARAMS parameter (type SFPOUTPUTPARAMS. Features Utilities in the Form Builder The Form Builder that you use to create PDF-based print forms and interactive forms in Web Dynpro for ABAP offers you a wide range of functions: ● Checking and Testing a PDF-Based Print Form ● Saving Runtime Information and a Generated PDF Locally You activate this function in the Form Builder. and print forms. When you call the form. - Handling Errors and Problems Use Interactive Forms based on Adobe software provide you with comprehensive support for detecting and resolving errors and problems when you create. Generated PDF form is a PDF without tags.

see the following: ● Digital Signatures and Certification in Forms Overview of the features that guarantee document security in forms plus a description of individual functions such as setting and checking signatures Detailed explanation of the validity of certifications and signatures ● SAP Interactive Forms by Adobe Security Guide This guide does not replace the daily operations handbook that we recommend customers to create for their specific productive operations. The technology is implemented in . About this Guide This guide is to provide you with an overview of the security aspects and recommendations when using SAP Interactive Forms by Adobe for your applications. Security Aspects of SAP Interactive Forms by Adobe The following documents provide you with information about the security functions available when you develop and exchange SAP Interactive Forms by Adobe. No Form Output If you encounter any connection errors or configuration errors when you use Adobe document services. and 004 You use this function module to find out the causes of any errors you encounter when displaying forms. 002. Communication Errors. and certification For notes for form developers and end users.Utilities in the Application Program that Calls the Form The following function modules provide you with support when you work with PDFbased print forms: ● Getting the Used Interface Fields ● Troubleshooting for Runtime Errors FPRUNX001. Note that these documents are available in English only: ● Interactive Forms based on Adobe Software Security Guide Overview of the architecture and required security-relevant settings in user management and SSL connections Adobe Document Services Configuration Guide Detailed description of each configuration step needed to set up the required users and communication paths Installation and configuration of the certificates for SSL connections. Settings and procedures that are the responsibility of the administrator are described in the following two documents. signatures. Runtime Errors. see the description under Problem Analysis Scenarios for Adobe Document Services for detailed troubleshooting information.

data integrity and confidentiality are required. the Adobe document services offer functions which require keys and certificates associated with your company.com/adobe → Media Library → Documentation Why is Security Necessary? The Adobe document services may deal with confidential data.sap. Related Security Guides Application SAP Web Application Server Guide SAP NetWeaver Application Server ABAP Security Guide SAP NetWeaver Application Server Java Security Guide Referenced documentation For detailed information on the procedure of configuring the security-related settings in your system. Important SAP Notes SAP Note Number 682619 752153 736902 853497 894389 Title Adobe document services: Configuration Guide Adobe: PDF Manipulation Module High Encryption Adobe Credentials Adobe Acrobat Reader creates temporary files Rel. These functions are: ● Creating and verifying digital signatures and certification For these functions the use of SSL is mandatory. Target Groups ● ● Technical consultants System administrators Important SAP Notes The most important SAP Notes that apply to the security of SAP Interactive Forms by Adobe are shown in the table below.Adobe Document Services . Although running within the J2EE Engine. there are security requirements in the SAP Web AS ABAP and in the SAP Web AS Java. also available at: http://service.: SAP NW 2004s . In addition.the Adobe document services. In this case we recommend that you activate SSL on all communication links. see Adobe Document Services Configuration Guide. Restr. because high authentication.

.. . which is stored in the Form Design Repository of the ABAP Engine.Technical System Landscape PDF-based Forms in ABAP Environment and Interactive Forms in Web Dynpro for ABAP PDF-based forms created in the ABAP Workbench and forms created in Web Dynpro for ABAP use the Adobe document services in the J2EE Engine for processing. You must configure SSL on both communication path 1 and path 2. Communication path 2: Before processing the form and creating a PDF file. Thus the Destination Service communicates with the Internet Communication Framework (ICF). it is HTTPS. The Form Processing Runtime sends the application data of the form and a link to the form design (template of the form) to the Adobe document services using SOAP. the Adobe document services calls the form design. respectively HTTPS-Port. The protocol for both communication paths is HTTP using the default HTTP port. In the case of SSL. The figure below gives you an overview of the communication paths. Communication path 1: 43. . through the RFC destination (SM59). if your scenarios use digital signatures and certification.

For more information. The figure below gives you an overview of the communication paths. To configure SSL you have to make settings in the User Management and in Communication Destinations. Communication path 1: Communication between Web Dynpro and the Adobe document services uses a Web Service. You must set the Web Service Client Proxy as an SSL connection. The communication between these parts uses the IIOP service (IIOP port). Interactive Forms in Web Dynpro for Java Interactive forms created with Web Dynpro in the SAP NetWeaver Developer Studio communicate with the Adobe document services in the J2EE Engine for processing. you also have to download and deploy the Binaries SSL2 Library. If you configure IIOP SSL. You have the option of storing the URL of the Adobe document services in the System Landscape Directory (SLD). You may need authorization to receive this library. In case of SSL it is the IIOP SSL port of the J2EE Engine.Communication path 3: The Adobe document services are installed on the J2EE Engine and consist of two parts. . if your scenarios use digital signatures and certification. You only need to configure SSL on this communication path if your scenarios require a high level of security. This library contains strong encryption. see SAP Note 752153 and Configuration of the IIOP SSL in the Adobe Document Services Configuration Guide.

you also have to download and deploy the Binaries SSL2 Library. See the table below. See following topics: User Management In this section. . In case of SSL it is the IIOP SSL port of the J2EE Engine. If you configure IIOP SSL. we provide an overview of the tools for user management and type of users which are necessary. Therefore. see SAP Note 752153 and Configuration of the IIOP SSL in the Adobe Document Services Configuration Guide. You may need authorization to receive this library. This library contains strong encryption. User Administration and Authentication The communication links described in the Technical System Landscape need a user in the SAP Web AS ABAP and in the J2EE Engine. you may use tools in both application platforms. For more information. User Management The Adobe document services uses the authorization provided by the SAP Web Application Server. For more information. 1.Communication path 2: The Adobe document services are installed on the J2EE Engine and consist of two parts. See also: Configuration of the Web Service SSL Connection in the Adobe Document Services Configuration Guide. the recommendations and guidelines for authorizations as described in the SAP Web AS Security Guide ABAP and SAP Web AS Security Guide Java apply here also. User Management Tools Tool SAP Web AS Java user management using the Visual Administrator Detailed Description Use the Security Provider node in the Visual Administrator to maintain a service user on the SAP J2EE Engine. Java and ABAP. The communication between these parts uses the IIOP service (IIOP port). Communication Destinations In this section. we provide an overview of configuring the Web Service Communication between the ABAP and the J2EE environment. You only need to configure SSL on this communication path if your scenarios require a high level of security. For maintaining a user. see SAP J2EE Engine User Management Using the Visual Administrator.

Configuring the User ADSUser for the SSL Connection Authorizations The table below shows the standard roles that are used by the Interactive Forms based on Adobe software. For more information see the Installation Guide on the SAP Service Marketplace at the internet address http://sap. Thus also a role ADSCallers in the SAP Web AS ABAP was created. see Users and Roles (BC-SEC-USR). Each user has a security role assigned to it. that is described under Technical System Landscape. Standard User As of NetWeaver 2004s the standard users that are needed for communication. Standard Roles Role ADSCaller (in J2EE Engine) Description Security role that allows the ADSuser to access the Adobe document services. Communication Destinations 2. The service user ADS_AGENT in the SAP Web AS ABAP is required for the communication between the SAP Web AS ABAP and the Adobe document services when you use PDF-based printforms in the ABAP environment. For more information. It is in the SAP Web AS ABAP when the UME is configured against the SAP Web AS ABAP backend. . Created when system was installed. The ADSCallers role in SAP Web AS ABAP appears automatically as the ADSCallers group in the J2EE Engine. PFCG) Use transaction SU01 to maintain a service user on the ABAP engine for the Adobe document services.SAP Web AS ABAP user management and role maintenance (Transactions SU01. User System J2EE Engine or ABAP Engine ABAP Engine Grou/Role ADSCallers User ADSuser System user ADS_AGENT Service user SAP_BC_FP_ICF Type Service user ADSCaller Security Role See also: 1. are created during installation of SAP NetWeaver. which has been predefined in the system.com/instguidesNW2004s.service. This user was created in the J2EE Engine or in the SAP Web AS ABAP depending on the J2EE installation settings for the SAP User Management Engine (UME). The ADSuser is required for the communication between the J2EE Engine and the Adobe document services. The ADSuser is assigned to this role.

. The ADSCallers role in SAP Web AS ABAP appears automatically as the ADSCallers group in the J2EE Engine. See User Management. Only if ADSuser is located in the SAP Web AS ABAP (Transaction PFCG). See Technical System Landscape.SAP_BC_FP_ICF (in ABAP Engine) ADSCallers (in ABAP Engine) Role that allows the ADS_AGENT to access the ICF service in the SAP Web AS ABAP.

Sign up to vote on this title
UsefulNot useful