IF Course

Adobe Forms Processing
AGENDA
1. Why Adobe forms History of form processing 2. Prerequisites for Adobe Form Processing 3. Form components SFP 4. Form development : print program and interface 5. Form development : form designer 6. Interactive forms : communication using SOAP and SAP PI 7. Tips and tricks - Q&A
Why Adobe forms History of form processing
Up to release 46 : Sapscript processing

As from release 46C/47 : Smartform processing As from ECC releases : Adobe Form processing available
Underlying technology still identical Smartforms and Adobe Forms : generated function modules Sapscript : element processing ( less generic )
Combining Strengths
Delivering Solutions
DELAWARE Consulting
Why Adobe forms History of form processing
Advantages of Adobe Forms

Graphics and design possibilities PDF format well known and platform independent Free reader Standard SAP objects foreseen for extra functionality Digital signatures available Barcodes printed as an image Possibility to use it interactive More flexible development ( drag and drop ) Spool requests automatically converted to PDF Advantages in commercial aspects Graphical power of Adobe combined with SAP Online and offline use
Combining Strengths
DELAWARE Consulting
AGENDA
Prerequisites for Adobe Form Processing
Server side prerequisites : ADS component

J2EE Stack runs a set of webservices ( ADS component ) ADS provides form rendering : it interpretes the xdp and validates it SAP ECC environment ( SAP WAS 640 and higher ) Strongly dependent from support packages SM59 : RFC ( type HTTP destination ) for connection to ADS
Combining Strengths
DELAWARE Consulting
Prerequisites for Adobe Form Processing
Client side prerequisites : Livecycle Designer 8.0

Designer tool installed locally ( download from SAP Marketplace ) Adobe Reader 8.1 and higher Sufficient work memory on the local machine
Note: 1176858 (LiveCycle 8.1)
Combining Strengths
DELAWARE Consulting
AGENDA
Form components - SFP
Development of Adobe Forms : transaction SFP In general : 2 components, interface and form
Interface : link between ABAP program / WDA and form Form : the form object itself Language and client independent development
Combining Strengths
DELAWARE Consulting
AGENDA
Form development : print program and interface
ABAP Program : fixed sequence of necessary steps

Function 1 : FP_FUNCTION_MODULE_NAME
Retrieves the generated function module for the form assigned
Function 2 : FP_JOB_OPEN
Creates a job with selected output parameters (sfpoutputparams ) Necessary for each form Can be traced with SM37 Sets values for preview, copies, Remark : when testing forms, do not use this function ls_function contains the return of the function in step 1 Function interface should be identical to the interface defined in SFP Imports /1bcdwb/docparams structure ( language,) and Returns /1bcdwb/formoutput, that can contain the entire form, the spool request nr,
Function 3 : Generic function CALL FUNCTION ls_function
Function 4 : FP_JOB_CLOSE
Closes the job started in function 2
Additional : FP_GET_LAST_ADS_ERRSTR
Retrieves error string from call to ADS
Combining Strengths Delivering Solutions
11
DELAWARE Consulting
Programming sample of the Delaware DEV system

ZBC_COURSE_SFP_TEST ( SE38 )
12
Combining Strengths
DELAWARE Consulting
The form interface

Familiar look ( smartforms application ) Used for definition of import parameters Extra routines can be integrated Use of tabletypes TABLES parameter is obsolete !
13
Combining Strengths
DELAWARE Consulting
The form interface

Definition of the interface corresponds with function interface
14
Combining Strengths
DELAWARE Consulting
AGENDA
Form development : form designer
The form designer : an Adobe tool

Tabs properties, context and layout
16
Combining Strengths
DELAWARE Consulting

Tab properties
Interface specification Layout specification
xACF : Active Component Framework : Windows plugins used for rendering S : default ZCI : Zero Client Installation : Everything is handled by the server NOTE: SAP recommands the use of ZCI types
17
Combining Strengths
DELAWARE Consulting

Tab context
The context is that part of the interface data that is available in the form Using drag and drop, data structures are added to the context
18
Combining Strengths
DELAWARE Consulting

Tab context
Possibility to use standard texts / text modules / addresses in forms SAP handles this automatically
19
Combining Strengths
DELAWARE Consulting

Tab layout
Based on the Adobe Livecycle Environment
20
Combining Strengths
DELAWARE Consulting

Tab layout : different components
Hierarchy view : Form elements on the form design Data view : Elements linked in the interface
21
Combining Strengths
DELAWARE Consulting

Design
Different tabs : design and master pages, xml/xdp source and preview in Adobe Reader
22
Combining Strengths
DELAWARE Consulting

Master pages
A master page is the frame of the form. It is repeated on every body page Multiple master pages can exist
Body pages
The body page contains all the form elements that are variable Body pages can be set to flowed or positioned Body pages grow dynamically, the system handles page breaks itself
Dynamic Form <> Static Form

Dynamic forms grow automatically and resize whenever necessary Static forms have a fixed design, elements cannot be enlarged automatically This is a setting controlled in the parameters of the generic function
23
Combining Strengths
DELAWARE Consulting

Palettes for control of elements, library,
24
Combining Strengths
DELAWARE Consulting

Scripting bar for extra coding, Javascript or Formcalc
Eg. Alternating colors on row can be added by coding in a table initialize event
Menu structure to add/remove palettes, set options,
25
Combining Strengths
DELAWARE Consulting

Special attention : data binding on the object tab
In the data binding tab, the context is linked to the exact form field
This binding is automatically set if one drags and drops elements from the
data view tab
Combining Strengths Delivering Solutions
26
DELAWARE Consulting

Scripting in the forms : additional features
Extra possibilities with scripting more important with interactive forms
Error handling Checks Calculations
Two languages : FormCalc and Javascript

FormCalc is an Adobe specific scripting language Javascript is well known is the scripting world Can be used mixed References in API
Autocompletion is available
27
Combining Strengths
DELAWARE Consulting

Demo on the development system
Demoform ZBC_TEST_COURSE in transaction SFP
28
Combining Strengths
DELAWARE Consulting

Demo on the development system
Use of dynamic form element Use of subforms Masterpage Content area Preview Data binding General overview tool Dynamic properties Language independent Scripting samples
Use of the templates in Designer

Use the form properties to generate sample xml data to test offline
Excercise
29
Combining Strengths
DELAWARE Consulting
AGENDA
Interactive forms : Communication using SOAP and SAP PI
Interactive forms : requirements and setup

Special key in ADS necessary ( additional license ) Fillable flag in docparam parameter needs to be set to X ( ABAP ) Enabled flag needs to be set to true ( WDA )
What are reader rights ?

Reader rights allow a user to do more then just read operations
Data can be saved Attachments can be added Interaction will become possible Actions can be triggered
Once applied during form rendering, no additional needs client side ( Adobe Reader )
Rights are embedded in the form xdp
31
Combining Strengths
DELAWARE Consulting
SAP - Adobe Alliance

Usage Rights/Reader Rights are not free
Using an SAP environment, the rights can be granted automatically, as soon as the key was entered in the ADS configuration
It is not possible to generate a form with rights using the standalone Livecycle Designer without having access to a Adobe Acrobat Professional
SAP is using the Adobe Designer environment which is called from the frontend
32
Combining Strengths
DELAWARE Consulting
Some important possibilities using the Interactive Forms

Dropdownlists, populated using a datatab, passed from the rendering application
A value description internal table can be built and passed to the form Using minor scripting or predefined Designer elements it can be filled See sample
Buttons can be added with multiple actions behind it

Perform checks, calculations Trigger mail using the local mail client Call a webservice or enterprise service See sample
Digital signatures can be used ( not yet in final phase )

33
Combining Strengths
DELAWARE Consulting

The instance manager can be used to add/remove instances
Building tables using subforms has more advantages then fixed tables ( see before ) When using the subform table, we can define each row as an instance
The top subform is set to flowed, so that it can grow when adding rows
Under this node, a header and an item part are created, both positioned The item part is repeating and bounded to a table node
34
Combining Strengths
DELAWARE Consulting

The instance manager can be used to add/remove instances
Now, table rows are called instances
Using buttons with simple Javascript coding can add or remove instances to the repeating structure
35
Combining Strengths
DELAWARE Consulting

A word about digital signatures
New methods to certify documents Free available in the library Digital signatures can be created using Adobe tools Remark : Dynamic form content not yet fully certified Certifying documents can be done client side or server side
36
Combining Strengths
DELAWARE Consulting
How to pass data from the form to the backend

Several possibilities
Using Webservices Using HTTP post Using functions to process the XML data
Using Enterprise Service Repository
37
Combining Strengths
DELAWARE Consulting
Scenario 1 : Using webservices and SAP PI

This scenario can be used via SAP PI, so that monitoring can be done easily
The form performs a SOAP call, and can capture a response of the
service
Setup necessary
Definition of Webservice Perform steps in design integration builder Perform steps in configuration integration builder Insert logic in scripting in the form
38
Combining Strengths
DELAWARE Consulting
Scenario 1 : Setup prerequisites in SAP PI

Create a datatype, message type and message interface in PI
Datatype should contain the input that will provided by the form Datatype should contain the return values that can be captured in the form
39
Combining Strengths
DELAWARE Consulting

40
Combining Strengths
DELAWARE Consulting

Synchronous call : return value can be captured Output and input message can be identical Output Message = Incoming from the form Input Message = Outgoing to the form
41
Combining Strengths
DELAWARE Consulting

Import RFC function from the backend
42
Combining Strengths
DELAWARE Consulting

Define message mapping / interface mapping
Double message mapping : request and response Both message mappings are linked in the interface mapping
43
Combining Strengths
DELAWARE Consulting

Define message mapping / interface mapping
44
Combining Strengths
DELAWARE Consulting

Create a WSDL File
Create the URL for the Webservice Fixed part, followed by the business system and communication channel of the sender
http://<<host:port>>/XISOAPAdapter/MessageServlet?channel=:BS_ADOBE:CC_Adobe
This URL is needed to create the WSDL file in PI ( Configuration )
45
Combining Strengths
DELAWARE Consulting

Create a WSDL File
Enter the URL from the previous step Enter the message interface that forms the basis for the WS ( Interface and sender identical )
46
Combining Strengths
DELAWARE Consulting

Create a communication channel for the Adobe Business System
47
Combining Strengths
DELAWARE Consulting

Create a communication channel for the ERP Business System
48
Combining Strengths
DELAWARE Consulting

Define receiver determination
Enter the sender BS
Enter the receiver BS
49
Combining Strengths
DELAWARE Consulting

Enter the sender BS
Enter the receiver BS
50
Combining Strengths
DELAWARE Consulting

Create the receiver agreement using new specific
51
Combining Strengths
DELAWARE Consulting

Define interface determination
Create the interface determination
52
Combining Strengths
DELAWARE Consulting

Define interface determination
53
Combining Strengths
DELAWARE Consulting

Define sender agreement
54
Combining Strengths
DELAWARE Consulting

Coding in the form ( Javascript )
Use authentication Set up a SOAP call using coding Fill the parameters used in the message type
55
Combining Strengths
DELAWARE Consulting

Elements of a SOAP call in Javascript
Request
Authentication object to logon to SAP PI (embedded) Request object with parameters SOAP URL : Location tag in the WSDL file
Action parameter : Target namespace
Response
The SOAP request is stored in a variable Returned variables can be captured
56
Combining Strengths
DELAWARE Consulting
Scenario 2 : Using HTTP post

No response can be captured, no logging available
Basically the setup is identical to the WS Setup, but no return is available Only an output message must be set in the message interface
57
Combining Strengths
DELAWARE Consulting
Scenario 2 : Using HTTP post

Can be added without a real coding effort
Just use a submit button of the type execute Enter the HTTP post string as URL
URL is created with fixed part, and variable parameters ( Message interface and sender business system http://<<host:port>>/sap/xi/adapter_plain? namespace=http%3A//delaware.be/xi/XI/Adobe &interface = MI_AdobePDF &qos=EO&service =BS_ADOBE &sap-user=delaware &sap-password=CONSULTI &sap-client=001
58
Combining Strengths
DELAWARE Consulting
Scenario 3 : Read from fileserver and process

PDFs are stored on a fileserver, and a periodic job processes the pdfs in background using functions
1. Read the fileserver directory with datasets ( Binary ) 2. Convert the binary files to XSTRING files
3. Use the FP object to extract data from the XSTRING object

4. Use function SMUM_XML_PARSE to convert the data to a certain XML format 5. Use custom programming to process data 6. Sample coding
59
Combining Strengths
DELAWARE Consulting
Scenario 3 : Read from fileserver and process

CALL FUNCTION 'SCMS_BINARY_TO_XSTRING' lo_fp = cl_fp=>get_reference( ).
TRY.
l_fp = cl_fp=>get_reference( ). * Get a reference to the PDF Object class. l_pdfobj = l_fp->create_pdf_object( ). * Set the pdf in the PDF Object. l_pdfobj->set_document( pdfdata = pdf_data ). * Set the PDF Object to extract data the Form data. l_pdfobj->set_extractdata( ). * Execute call to ADS l_pdfobj->execute( ). * Get the PDF Form data. l_pdfobj->get_data( IMPORTING formdata = pdf_form_data ).
REFRESH: result_xml, return.

CALL FUNCTION 'SMUM_XML_PARSE' EXPORTING xml_input = pdf_form_data TABLES xml_table = result_xml
60
Combining Strengths
DELAWARE Consulting
Scenario 4 : Using ESR

Predefined Webservices, can be integrated immeditaly based on the WSDL file
Use transaction SOAMANAGER ( as from Netweaver 2004s )
61
Combining Strengths
DELAWARE Consulting

Only step necessary is the endpoint creation
62
Combining Strengths
DELAWARE Consulting

In SE80, more information can be found on the predefined services
Refer to OSS/SDN for more information on ESR, and detailed explanation on the parameters used
63
Combining Strengths
DELAWARE Consulting

Integration in form designer
64
Combining Strengths
DELAWARE Consulting

Integration in form designer
Dataview contains elements for drag and drop on the layout Button foreseen to trigger the webservice immediately
65
Combining Strengths
DELAWARE Consulting
AGENDA
Tips and tricks Q & A
Form properties and preferences

Set defaults Use XML sample data file for quick testing Store global variables
67
Combining Strengths
DELAWARE Consulting
Tips and tricks Q & A
Use the templates in Designer

Stored locally Complete samples with all possibilities Scripting Tables
Use the forums

sdn.sap.com www.adobelabs.be
Full API references available for Javascript and Formcalc ! Nice to have SAP notes : 938748, 858325, 1101340
68
Combining Strengths
DELAWARE Consulting
Contacts
Decostere Filip, NetWeaver Solution Manager
decosteref@delaware.be
Lenaerts Steven, NetWeaver Architect SAP WAS JAVA SAP PI

lenaertss@delaware.be
Coessens Yoeri, NetWeaver Architect
SAP WAS ABAP Adobe IFS

coessensy@delaware.be DELAWARE Consulting President Kennedypark 4 8500 Kortrijk phone +32 (0)56 27 44 44 fax +32 (0)56 27 44 48 http://www.delaware.be

IF Course

Hochgeladen von

Dokumentinformationen

Originalbeschreibung:

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

IF Course

Hochgeladen von

Copyright:

Verfügbare Formate

Adobe Forms Processing

Why Adobe forms History of form processing

Up to release 46 : Sapscript processing

Why Adobe forms History of form processing

Advantages of Adobe Forms

Prerequisites for Adobe Form Processing

Server side prerequisites : ADS component

Prerequisites for Adobe Form Processing

Client side prerequisites : Livecycle Designer 8.0

Note: 1176858 (LiveCycle 8.1)

Form components - SFP

Form development : print program and interface

ABAP Program : fixed sequence of necessary steps

Function 3 : Generic function CALL FUNCTION ls_function

Form development : print program and interface

Programming sample of the Delaware DEV system

Form development : print program and interface

The form interface

Form development : print program and interface

The form interface

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Dynamic Form <> Static Form

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Menu structure to add/remove palettes, set options,

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Two languages : FormCalc and Javascript

Form development : form designer

The form designer : an Adobe tool

Form development : form designer

The form designer : an Adobe tool

Use of the templates in Designer

Interactive forms : Communication using SOAP and SAP PI

Interactive forms : requirements and setup

What are reader rights ?

Interactive forms : Communication using SOAP and SAP PI

SAP - Adobe Alliance

Interactive forms : Communication using SOAP and SAP PI

Some important possibilities using the Interactive Forms

Buttons can be added with multiple actions behind it

Digital signatures can be used ( not yet in final phase )

Interactive forms : Communication using SOAP and SAP PI

Some important possibilities using the Interactive Forms