For the Relocation process, the employee needs a form in which their changed address details can be entered. This interactive form is created using the Form Builder.
For basic information about working with
Adobe LiveCycle Designer
, see the
Layout
tab in the menu, under
Help
→
Adobe Designer Help
For specific information about creating an interactive form, see Creating and Editing Interactive Forms .
You perform the following steps:
You add the
ISR-Form-Wide Scripts Control Element
to the form. This element hides Adobe menu bars and ensures that the form fields cannot be edited once the form has been checked after processing.
You check you are using the correct libraries.
The
ISR Native Control
library should be available but it might be necessary to add a new library. Libraries are visible on the right-hand side of the screen. For more information, see
Creating and Editing Interactive Forms.
You add a header to the form.
You add fields to the form that are bound to fields in the back-end service.
You add fields to the form for displaying and processing agent notes (“Comments”.
You add a date field.
You add the
Update Data
pushbutton that updates the data in the form according to the selected date.
You bind the form fields to the form scenario.
You activate the form.
You display a preview of the form.
Use the following template to create the form for this tutorial:
When you save your form scenario, a form is automatically created.
Open your form scenario in
Design Time for Processes and Forms
In the object hierarchy area, double-click
Form
Choose
Change Form
From the
Utilities
menu, choose
Insert Web Dynpro Script
. In the object hierarchy area, you can now see a new element,
Container Foundation_JS
.
To add a new library:
In the object hierarchy area, choose
Data View
to return to the form layout.
Right-click on an existing tab in the
Library
window.
From the context menu, choose
Add Group
.
Enter a name for the library to be included (this name appears on the tab).
Browse to the folder in which the library is stored and choose
OK
to see the library elements appear in your new tab.
For this tutorial, return to the
ISR Native Library
tab.
Add the Header to the Form:
In the library, select the
ISR Header
field and drag and drop it on to the form.
Enter the following text:Request Relocation Benefit.
Save your entries.
Add some general information about this form for the employee:
Drag and drop an
ISR Static Text
field on to the form.
Enter the following text:With this form, you may request a removal bonus. In addition, you may enter your new address details.
The employee requires information telling them exactly what to do:
Drag and dropan
ISR Static Text
field on to the form and enter the following:Please enter your new address.
Now add the data fields in the following table. Some fields are display-only fields, other fields are used to collect information from the employee. For each of the form fields, complete the following steps:
From the library tab, drag and drop the appropriate ISR Control Element on to the form.
Label the control element according to the following table.
Duplicate a control element, once it is on the form, by selecting it and pressingCTRL+D. Delete a control element from a form by selecting it and pressingDEL
Country
requires an
ISR Text Display
control element because the employee does not enter data here.
Even though you did not transfer the
Comments
fields to your form scenario, they have been automatically added to the
Data View
tab.
A Hidden Bound Text Field is used to monitor an unbound form data node when it is modified during scripting.
Form Fields and Related ISR Control Elements
Field Name (Data View tab) |
Label |
ISR Control Element |
---|---|---|
I0001_PERNR |
Personnel Number |
ISR Text Display |
I0001_EMPLOYEE_NAME |
Name |
ISR Text Display |
I0001_POSITION |
Position |
ISR Text Display |
I0001_PERSA_TEXT |
Personnel Area |
ISR Text Display |
I0006_STREET |
Street and House Number |
ISR Text Edit |
I0006_POST_CODE |
Postal Code |
ISR Text Edit |
I0006_CITY |
City |
ISR Text Edit |
I0006_COUNTRY |
Country |
ISR Text Display |
HRASR_CURRENT_NOTE |
Current Comments |
ISR Multiple Line (Edit) |
HRASR_PREVIOUS_NOTE |
Previous Comments |
ISR Multiple Line (Edit) |
<Blank> |
<Blank> |
Hidden Bound Text Field |
The form requires a field for
Effective Date
.
Drag and drop an
ISR DateField
control element on to the form.
Label itEffective Date
It is possible that the employee may add a future date in the
Effective Date
field. Data and default values might then be no longer valid for this date. To allow the user to update the displayed data, as it is stored in the Infotype at the effective date, you can add a pushbutton.The pushbutton for initializing the entire form resets the form to its initial status. The field
Effective Date
is not reset.
The script behind the pushbutton should be changed.
A pushbutton is required for the
Effective Date
field.
Drag and drop an
ISR On-Form Event
button on to the form.
Label itUpdate Data
From the
Pallets
menu, choose
Script Editor
.
The script relating to the pushbutton is now selected:
$record.CONTROL_PARAM.ISR_EVENT = “CUSTOM_EVENT”
ReplaceCUSTOM_EVENTwithUSER_EVENT_INITIALIZE
Close the
Script Editor
.
Save your entries.
The fields on the form must now be bound to the fields in the form scenario (and therefore automatically to the ISR scenario):
Choose the
Data View
tab to display the form scenario fields.Each field has a
DATA
element and a
FIELD
element.
Drag and drop the
FIELD
element of each field on to the corresponding field on the form. In the
Data View
tab, an icon appears to the right of the
FIELD
element to show that it has been bound to a field on the form.
Choose
Don´t update any related properties
in the
Binding Properties
dialog box.
Palettes offer an alternative method of binding form fields to the form scenario.
Choose
Palettes
on the
Layout
menu bar and select
Object
. A new
Object
tab appears in the bottom right window.
Choose the
Binding
tab. The
Binding
tab shows whether the field is bound to a form scenario field. To bind the field, click the arrow of the
Default Binding
text box and select the appropriate form scenario, field name and field element.
Select a field on the form.
Choose
Don´t update any related properties
in the
Binding Properties
dialog box.
You must now activate the form. This creates or updates the form object and the interface that is created for the form.
Choose the
Activate Form
button on the
Form Builder
menu bar.
In the
Inactive
Objects
dialog box, select both objects (Form and ISR) for transfer.
Choose
Continue
to activate the form and form scenario.
Preview the form by clicking the
PDF Preview
tab.
If you then need to amend your form, return to the
Body Pages
tab.
You have created the form with all the necessary fields for entering the change of address. Once you have activated the form and the interface, the form can be processed further.