Show TOC

 1.1.1 Creating a Form and Editing the Layout

Use

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 .

Activities

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:

Procedure

Creating a Form

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

Adding the ISR Form-Wide Scripts Control Element

From the Utilities menu, choose Insert Web Dynpro Script . In the object hierarchy area, you can now see a new element, Container Foundation_JS .

Adding Libraries (Optional Step)

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.

Adding Fields to the Form

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

Adding an Effective Date 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.

Creating a Pushbutton for Updating Data

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.

Binding the Form Fields to the Form Scenario

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 – An Alternative Method of Binding Fields

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.

Activating the Form

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.

Displaying a Form Preview

Preview the form by clicking the PDF Preview tab. If you then need to amend your form, return to the Body Pages tab.

Result

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.