PDF based forms in EHSM

March, 2012
Agenda

Architecture
Big Picture
How everything fits together
Components
IMG Configuration
Form Layout
Data Provider
Inbound Persister
How to put new fields to the Form Change Layout
How to include a new Form to the Application

2011 SAP AG. All rights reserved. 2

Architecture
Architecture Big Picture

Create Form
Extract Data
UI SAP Workflow Get Attachments

Solution specific
implementation
Configuration Adobe Form Controller
Adapter

Interactive Adobe
Print Forms Forms Document
Form Service (ADS)
Configuration

OSHA 300 Questionnaire

Report
for witness

Form (Report and Questionnaire) Generation Service

2011 SAP AG. All rights reserved. 4

Architecture How everything fits together

SAP Business Workflow

Adobe Form Controller

Adobe
Document
Service (ADS)

Form
Configuration

2011 SAP AG. All rights reserved. 5

Components
Components IMG Configuration

All Forms that are

available in EHSM
are configured
here

Forms are
grouped logically
(e.g. Incident
Inquiry Forms)

2011 SAP AG. All rights reserved. 7

Components IMG Configuration

Form Name: Logical Name of a Form

Form Title: Description that is shown on UI
Form Type: SAP Interactive Form (use only this one)
Form Category:
Report
Questionnaire
Dynamic Questionnaire
Questionnaire for Offline Recording
Dynamic Questionnaire for Offline Recording
Report (Enabled for Electronic Report Shipment)
E-Mail for Response: Form is sent back to this address
Form Controller: Use always the standard one No change needed
Data Provider: Reads data from BO and pushs it into the Form context
Name of Form Object: Link to Form Repository (transaction SFP)
Inbound Persister: Stores the Form data into the BO (e.g. Inquiry Forms)
Fallback Language: If no translation exists, this language is used as default
Form Popup Name: Some Forms need further parameter
Configuration for Accepting Data: WebDynpro configuration for Data Take Over Dialog
2011 SAP AG. All rights reserved. 8
Components IMG Configuration

Form Group: Logical Name of the Group

EHS Management Component: HSS / PRC
Form Group Description: Description of the Group

Subnode Assign Form to Form Group: Assign Form to the Group

2011 SAP AG. All rights reserved. 9

 Components IMG Configuration for Inc. Mgmt

Which Forms are

related to which
Regulation

Which Inquiry Forms Generate the

are used for which Form for NM and
Reference Category SO Offline
Recording from
here

Configure the
SO50 exit for the
Here you can used Email
disable the Implement the addresses
generation of the logic for electronic
initial report report shippment
here

2011 SAP AG. All rights reserved. 10

Components IMG Configuration for Risk Assessment

Configure the
SO50 exit for the
used Email
addresses

Configure here
which Forms can
be generated by
RAS type

2011 SAP AG. All rights reserved. 11

Form Layout

Forms are stored in Form Repository. Access it using transaction SFP

You need the Adobe Lifecycle Designer on your local machine to change
the layout

A Form needs a layout and an interface:

Layout: What you see
Interface: Which data is used

2011 SAP AG. All rights reserved. 12

Form Layout

Drag and Drop after you

changed the interface
structure (e.g. Append)

Data that is
available in the
DDIC structure form
from Interface

2011 SAP AG. All rights reserved. 13

Form Layout

UI Elements in
the Form

Binding: Link to
Form Context

2011 SAP AG. All rights reserved. 14

Data Provider

Reads data from BO (e.g. Incident; Risk Assessment)

Called while Form generation

Fills DDIC Structure of the Form (DDIC Structure that is defined at Form
Interface)

Always Form specific (specific for each Interface Structure)

Must implement interface IF_EHFND_FW_ADS_DATA_PROV

Note: Never lock data when reading from BOPF in Data Providers!

2011 SAP AG. All rights reserved. 15

Inbound Persister

Stores data from Form into the BO (e.g. Witness Statement)

Used by Inquiries (form to collect data)

Always Form specific (specific

for each Interface Structure)

Must implement interface

IF_EHFND_FW_ADS_INBD_PER

Note: You need write access here. You have to set an

Lock the data if you have to Inbound Handler at
overwrite something! the form for Inbound
Support
2011 SAP AG. All rights reserved. 16
How to put new fields to the
Form Change Layout
Step 1: Copy the Form

1. Go to Transaction SFP

2. Enter the Form you want to copy

3. Press Copy button and set new name

4. Press Change

2011 SAP AG. All rights reserved. 18

Step 2: Ensure all fields are in Form Context

1. Select the component INTERFACE_STRUCTURE on Context side and

remove it

2. Drag and drop from Interface the component INTERFACE_STRUCURE

to Context

2011 SAP AG. All rights reserved. 19

Step 3: Open and Change Layout

1. Press Layout button and add new field to the Form

2. Set the Binding of the new field to the Form Context

3. Save

4. Activate

2011 SAP AG. All rights reserved. 20

Step 4: Update IMG

1. Change Data Provider if needed

2. Change Name of Form Object to your created copy

Thats it

2011 SAP AG. All rights reserved. 21

Hints

If you do an Append to an existing BOPF structure, the Interface Structure is

automatically updated. No change needed in Data Provider if it already reads
the data.

If you implemented a new node in the BO, you have to do the following steps:
Create Z-structure containing data of new node
Append new Z-structure to Interface Structure
Copy Data Provider and fill the data of new node

2011 SAP AG. All rights reserved. 22

How to include a new Form
to the Application
Create new Form

1. We recommend to copy an existing one

2. Change layout

3. Configure it in IMG (see previous slides)

2011 SAP AG. All rights reserved. 24

Thank You!

Contact information:

F name MI. L name

Title
Address
Phone number