Creating and Editing Interactive Forms by venkatvanga

VIEWS: 449 PAGES: 7

									Link:
http://help.sap.com/saphelp_erp2005vp/helpdata/en/43/1d639b3fce3566e10000000a11466f/f
rameset.htm




Creating and Editing Interactive Forms
Use
To support your form-based business processes, you create and edit interactive forms using the
Adobe LiveCycle Designer (Form Builder). The Adobe LiveCycle Designer is software from the
company Adobe Systems Inc. that is integrated in the SAP environment. For more information
about the Adobe LiveCycle Designer, see the Procedure tab page under More  Help.
The Adobe LiveCycle Designer covers two areas:
  ●   The left side contains a window with the tab page Data View.
      This area contains all form fields that you have defined in the form scenario or that you
      have transferred to the ISR scenario as characteristics using the comparison with the form
      scenario.


             The following fields and structures also appear:
             ISR_LONG_TEXT
             ISR_NEW_LONG_TEXT
             ISR_AUTOMATIC_UPDATE
             GENERAL_DATA
             CONTROL_PARAM
             You should not use these fields or structures in HR Administrative Services since
             their behavior can change at any time.
  ●   The right side contains a window with the tab page Library.
      This area contains all interface elements that you can use to structure the form. Use drag
      and drop to drag the interface elements to the form. SAP provides an own library of
      interface elements under the name ISR Native Controls. This library is specially adjusted
      for use in ISR scenarios.
      SAP has made all interface elements necessary for use within the HR Administrative
      Services framework available in a library contained in SAP Note 973170. Elements in this
      library also contain the scripting necessary for UI attributes.


             If possible, use only interface elements from this Library.
             These interface elements contain special scripting that is adjusted for use in the HR
             Administrative Services ISR environment.
             To view (and edit if necessary) this scripting, in Adobe LiveCycle Designer, choose
             Pallets  Script Editor. In the dialog box that opens, in the dropdown list choose
             Display  Events with Scripts.

Features
The Adobe LiveCycle Designer provides you with the following functions for editing interactive
forms:
  ●   Creation of form fields with data binding
      For detailed information, see Creating Form Fields with Data Binding.
  ●   Entry of agent (processor) notes
      A standard function is provided for entering agent notes in the form. To use this form, the
      automatically generated fields HRASR_PREVIOUS_NOTES and
      HRASR_CURRENT_NOTE must be used. The field HRASR_CURRENT_NOTE enables
      the current agent of the form to enter notes when he runs the process. The field
      HRASR_PREVIOUS_NOTES shows the current agent all notes entered in previous
      processing steps. For detailed information, see Using Form Fields to Enter Agent Notes.
  ●   Creation of dropdown list boxes
      In contrast to the SAP GUI, in an interactive form, it is currently not possible to provide
      input help (F4 help) for an input field. However, it is possible to use dropdown list boxes
      and thus define the set of valid entries uniquely. The prerequisite for this is that, for the field
      in the form scenario, you have either defined a manual value help or configured the value
      help such that it is provided by means of a backend service. For detailed information, see
      Creating Dropdown List Boxes.
  ●   Creation of pushbuttons
      In a form, you can create pushbuttons with which the user can trigger actions at runtime.
      The following actions are supported:
         ○   Initialization of the entire form
             The pushbutton for initializing the entire form resets the form to its initial status. The
             content of all fields is deleted and default values are redetermined (if defined). The
             field Effective Date(EFFECTIVE_DATE) is particularly important here. This field is
             not reset. The current date entered is used to calculate the (time-dependent) default
             values.
         ○   Triggering of a roundtrip to check the data entered and to calculate dependent fields
             For detailed information, see Creating Pushbuttons.

Activities
You access the Adobe LiveCycle Designer (Form Builder) through the Customizing for HR
Administrative Services:
You can access the functions for creating or editing interactive forms under Configuration of
Forms/Processes  Cross-Form Settings  Create ISR Scenario:
  ●   Choose Version in the dialog structure.
      The Change Version view appears.
  ●   Choose Generate to create the form or Change Adobe Form to edit the form.




Creating Form Fields with Data Binding
Use
In Adobe LiveCycle Designer (Form Builder), you specify the layout of an interactive
form. In a library, you select the UI elements that you use to specify how a field is
displayed in the form. You link the UI element to one of the form fields that you defined
in the associated form scenario. In this way, the form field is automatically filled with
data at the process runtime.
Procedure
          1. ...
You access the Adobe LiveCycle Designer (Form Builder) through the Customizing
for HR Administrative Services:
     ●   Choose Configuration of Forms/Processes  Configuration of Forms  Create ISR
         Scenario.
     ●   Choose Version in the dialog structure.
         The Change Version view appears.
     ●   Choose Generate to create the form or Change Adobe Form to edit an existing form.
Proceed as follows:
1.    1. Select a suitable UI element from the Library and move it to the form using
   drag and drop.
2.    2. Select the UI element and change the properties such as size, position,
   description, and so on.
3.    3. In the area on the left of the Adobe LiveCycle Designer, choose the Data
   Overview tab page.
4.    4. Select the desired form field and expand it down to the FIELD subelement.
5.    5. Select the FIELD element and use drag and drop to place it exactly on the UI
   element in the form.
6.    6. In the next dialog screen, select the Do Not Update Related Properties
   option.
         In this way, the UI element is automatically linked to the form field and is filled with data
         automatically at the process runtime.
7.   7. If necessary, check that the link to the form field is correct by choosing the
   Object tab page.
8.   8. Select the Binding tab page and check the value entered for Standard
   Binding. This value must have the format $record.<Field Name>.DATA[*].FIELD,
   where <Field Name> is the name of the form field.



Using Form Fields to Enter Agent Notes
Use
A standard function is available to enter agent notes in the form. To use this function, you
must use the following automatically generated fields:
     ●   HRASR_CURRENT_NOTE
         In this field, the current agent (processor) of a form can enter any number of notes at the
         process runtime.
     ●   HRASR_PREVIOUS_NOTES
      In this field, all notes entered in previous processing steps are displayed to the current
      agent.

Procedure
          2. ...
You access the Adobe LiveCycle Designer (Form Builder) through the Customizing
for HR Administrative Services:
  ●   Choose Configuration of Forms/Processes  Configuration of Forms  Create ISR
      Scenario.
  ●   Choose Version in the dialog structure.
      The Change Version view appears.
  ●   Choose Generate to create the form or Change Adobe Form to edit an existing form.
Proceed as follows:
9.    1. Select the element with the name HR Admin – Comments from the Library
   and move it to the form using drag and drop.
10. 2. Change the field names in accordance with your requirements.
11. 3. Leave the technical settings and data binding unchanged.



Creating a Dropdown List Box
Use
For an input field on an interactive form, you can create a dropdown list box that contains the
range of valid input values for this field.

Prerequisites
For the field in the form scenario, you have either defined a manual value help or
configured the value help such that it is provided by means of a backend service.
Procedure
You access the Adobe LiveCycle Designer (Form Builder) through the Customizing
for HR Administrative Services:
  ●   Choose Configuration of Forms/Processes  Configuration of Forms  Create ISR
      Scenario.
  ●   Choose Version in the dialog structure.
      The Change Version view appears.
  ●   Choose Generate to create the form or Change Adobe Form to edit an existing form.
Proceed as follows:
           3. ...
12. 1. Select the element with the name HR Admin – Drop Down List Box from the
   library and move the element to the form using drag and drop.
13. 2. Link the subelement FIELD to the dropdown list box. To do this, proceed as
   described in Creating Form Fields with Data Binding.
14.   3. Choose the Binding tab page and then Element Values.
      The Dynamic Properties dialog box is opened.
15.   4. Enter the following value in the Objects field: $record.sap-vhlist.<Field
   name>\.DATA\.FIELD.item[*], whereby <Field name> is the name of the form field.
16. 5. Decide if the dropdown list box is to trigger a roundtrip at runtime when you
   select an entry.
      A roundtrip must be triggered if there are other fields or other dropdown list boxes whose
      values are dependent on the selected value and therefore must be recalculated
      accordingly.


                If you have a dropdown list box for both Personnel Area and Personnel Subarea,
                the possible entries for the Personnel Subarea are dependent on the entry you
                select for Personnel Area. This means that the dropdown list box for the Personnel
                Area must trigger a roundtrip so that the possible entries for the Personnel Subarea
                can be redetermined. In contrast, the dropdown list box for the Personnel Subarea
                does not have to trigger a roundtrip.
           ○    If the dropdown list box is not to trigger a roundtrip, the processing is completed.

           ○    If the dropdown list box is to trigger a roundtrip, you must adjust the coding of the
                dropdown list box as follows:

              ■ Select the dropdown list box on the form and choose Pallets  Script
               Editor in the Adobe LiveCycle Designer.
              ■ In the next window that appears, select the *exit entry in the Display
               dropdown list. Find the following coding:
               // xfa.record.CONTROL_PARAM.ISR_EVENT.value =
               "CHECK";
               // app.eval("event.target.SAPSubmit(false);");
               With the prefixed comment signs "//", the coding is deactivated.

              ■   Remove the comment signs "//".
              ■ Replace the CHECK string with USER EVENT CHECK.
               The coding must then be as follows:
               xfa.record.CONTROL_PARAM.ISR_EVENT.value = "USER_EVENT_CHECK";
               ContainerFoundation_JS.SendMessageToContainer(event.target, "submit",
               "", "", "", "");

               The coding is now activated and triggers a roundtrip at runtime so that
               dependent fields and dropdown list boxes can be calculated.
Creating Pushbuttons
Use
In an interactive form, you can create pushbuttons with which the user can trigger actions
at the process runtime.
The following actions are supported:
  ●    Initialization of the entire form

  ●    Partial initialization of the form

  ●    Triggering of a roundtrip to check the data entered and to calculate dependent fields
For more information, see Creation and Editing of an Interactive Form.
Creating Pushbuttons to Initialize Forms
When the form is initialized, the system provides default values and input helps based on
the field contents of the form fields.
To set up a pushbutton to initialize the form, proceed as follows:
You access the Adobe LiveCycle Designer (Form Builder) through the Customizing
for HR Administrative Services:
            4. ...
17. 1. Choose Configuration of Forms/Processes  Configuration of Forms 
    Create ISR Scenario.
18. 2. Choose Version in the dialog structure.
       The Change Version view appears.
19.   3. Choose Generate to create the form or Change Adobe Form to edit an
   existing form.
20. 4. Select the HR Admin – Button element and move it to the form using drag
   and drop.
21. 5. Select the pushbutton and change the size and description to suit your
   requirements.
22. 6. Choose Pallets  Script Editor.
23. 7. In the next dialog screen, select the *mouseDown entry in the Display
   dropdown box.
24. 8. Find the following coding:
       $record.CONTROL_PARAM.ISR_EVENT = "CUSTOM_EVENT"
25.     9. Replace the "CUSTOM_EVENT" string with
      "USER_EVENT_INITIALIZE".
Creating Pushbuttons to Partially Initialize Forms
If you have defined several areas in a form that each correspond to one field group with
several fields, you can offer a pushbutton in each of these areas that will trigger an
operation. The operation checks, for example, the field contents of the area and
simultaneously initializes the fields of the subsequent area.
During the initialization, based on the field contents of the previous area(s), the system
provides information for the subsequent area, such as default values and input help.
You define the operations for the subsets of form fields in Customizing under
Configuration of Forms/Processes  Configuration of Forms  Create
Operations for Groups of Form Fields.
To set up a pushbutton to partially initialize the form, proceed as follows:
            5. ...
26. 1. Perform steps 1 to 8 as described in the “Creating a pushbutton to initialize the
    form” section.
27.     2. Replace the “CUSTOM_EVENT“ string with an operation defined in the IMG
      under Configuration of Forms/Processes  Configuration of Forms  Create
      Operations for Groups of Form Fields.
Creating Pushbuttons to Trigger Roundtrips
If you want to create a pushbutton to check the entered data and calculate derived data,
proceed as follows:
           6. ...
28. 1. Perform steps 1 to 8 as described in the “Creating a pushbutton to initialize the
    form” section.
29. 2. Replace the "CUSTOM_EVENT" string with "USER_EVENT_CHECK".
n the “Creating a pushbutton to initialize the
    form” section.
29. 2. Replace the "CUSTOM_EVENT" string with "USER_EVENT_CHECK".

								
To top