Академический Документы
Профессиональный Документы
Культура Документы
Training Guide
Oracle EBS R12 Forms Personalization
Table of Contents
Introduction.......................................................................................................................iv
Installing and Setting Up Forms Personalization...........................................................1
Enabling Form Personalization..................................................................................................1
Turning Form Personalization On and Off...............................................................................13
Page ii
Training Guide
Oracle EBS R12 Forms Personalization
Introduction
The Form Personalization feature allows you to easily alter the behavior of Forms-based screens,
including changing properties, executing built ins, displaying messages, and adding menu entries.
For each function (a form running in a particular context based on parameters passed to it), you
can specify one or more Rules. Each Rule consists of an Event, an optional Condition, the Scope
for which it applies, and one or more Actions to perform. An Event is a trigger point within a
form, such as startup (WHEN-NEW-FORM-INSTANCE), or when focus moves to a new record
(WHEN-NEW-RECORD-INSTANCE). There are standard events that almost every form sends,
and certain forms send additional product-specific events. The Condition is an optional SQL code
fragment that is evaluated when the Event occurs; if it evaluates to TRUE then the Actions are
processed. The Scope is evaluated based on the current runtime context to determine if a Rule
should be processed or not. The Scope can be at the Site, Responsibility, User, or Industry level.
Each Rule can have one or more Scopes associated with it.
Each Action consists of one of the following:
A property, such as required or displayed
A built-in, such as GO_BLOCK, DO_KEY or FND_FUNCTION.EXECUTE
A message, such as an error, warning or confirmation
A special menu entry in one of 45 available slots
Once Rules are defined, when the target function is run then the Rules are automatically applied
as events occur within that form.
Although the Form Personalization feature is declarative, the intended audience is a person
familiar with Oracle Forms including the PL/SQL programming language, and the Oracle
Applications Development Guide. Additionally, any change made could interfere with the base
code of a form (the code that Oracle ships), thus you must fully understand the support
implications of such form personalizations.
Upon completion of this module, you will be able to:
Enable form personalization.
Turn form personalization on or off for a given form or completely at the site-level.
Hide a field on a form.
Disable a field on a form.
Change the prompt of a field on a form.
Change other common properties of a field on a form.
Display a message.
Use a form built-in function.
Create a custom menu.
Use form personalization events.
Use form personalization conditions.
Restrict form personalization execution.
Create a zoom.
Create a record group from a query to implement a modified LOV.
Personalizing forms with SQL and PL/SQL.
Restrict form personalizations.
Debug form personalizations.
Move form personalizations from system to system (e.g. development to production).
Page iii
Procedure
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
1.
Begin from within any Oracle Forms-based responsibility. In the example, the
General Ledger, Vision Operations (USA) responsibility is selected, and the
Navigator page is open.
Click the Help menu.
or
Press [Alt+H].
2.
You should see an entry in the Help menu labeled, Diagnostics. It should be
located just above the Record History entry. But, it doesn't seem to be there.
Without this menu item, you can not create a form personalization.
3.
In order to see the Diagnostics menu item, you are going to have to set a profile
option. To do that, switch responsibilities to System Administrator.
Click the Switch Responsibility... button.
4.
The Responsibilities page allows you to easily switch between the various Oracle
Forms-based responsibilities assigned to you as an E-Business Suite user.
5.
6.
Page 2
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
7.
8.
9.
10.
The Find System Profile Values page is a common "Find" page. It allows you to
specify query criteria for the underlying page, System Profile Values (in this
case).
Step
Action
11.
Enter the desired information into the Profile field. Enter "Hide%".
12.
13.
The System Profile Values page allows you to change the values of system-level
(as opposed to user-level) profile options.
Page 3
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
14.
15.
16.
17.
Page 4
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
18.
19.
20.
21.
22.
23.
Page 5
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
24.
25.
26.
When you selected Personalize, it now asks you for the ORACLE password. The
default password for this is APPS. On most systems, this will have been changed,
and for security reasons, the system administrator(s) will not provide you with the
password.
There is a work-around. There is a profile option that can be set; so that, the
password is not requested.
Click the Cancel button.
or
Press [Alt+C].
27.
28.
29.
Page 6
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
30.
Page 7
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
31.
32.
33.
Page 8
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
34.
Enter the desired information into the Profile field. Enter "Utilities:Diagnostics".
35.
Page 9
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
36.
37.
38.
39.
40.
Page 10
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
41.
42.
43.
44.
45.
46.
Page 11
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
47.
48.
49.
50.
51.
Notice that the form personalization window now opens without requesting the
ORACLE password.
This is the default Form Personalizations page. It is the entry point for making
form personalizations on your page.
52.
Page 12
Training Guide
Oracle EBS R12 Forms Personalization
Procedure
Page 13
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
1.
2.
3.
4.
5.
6.
7.
The Find System Profile Values page is a common "Find" page. It allows you to
specify query criteria for the underlying page, System Profile Values (in this
case).
Page 14
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
8.
Enter the desired information into the Profile field. Enter "Disable%".
9.
10.
The System Profile Values page allows you to change the values of system-level
(as opposed to user-level) profile options.
Page 15
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
11.
12.
13.
14.
15.
The second scenario is commonly used when you are creating personalizations,
and you find that a personalization you have just created is causing an error.
Sometimes that error will be so bad that it prevents you from getting back to the
form to undo your personalization. In that scenario, you can disable form
personalization processing on an ad hoc basis.
Begin at the Navigator page within any Oracle Forms-based page.
Page 16
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
16.
17.
18.
19.
20.
21.
Page 17
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
22.
You have now completed the procedures to turn form personalizations on or off
for your page.
End of Procedure.
Page 18
Hiding a Field
Basic form personalization enables you to hide fields.
In this topic, you will hide a field.
Procedure
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
1.
2.
Step
Action
3.
Page 20
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
4.
5.
6.
7.
This is the default Form Personalizations page. It is the entry point for making
form personalizations on your page.
Page 21
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
8.
Enter the desired information into the Seq field. Enter "1".
9.
Enter the desired information into the Description field. Enter "Hide a field on
the form".
10.
11.
Enter the desired information into the Seq field. Enter "1".
12.
Enter the desired information into the Description field. Enter "Hide a field".
13.
14.
Enter the desired information into the Find field. Enter "Summary%".
15.
16.
Page 22
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
17.
18.
19.
20.
21.
Step
Action
22.
Page 23
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
23.
24.
25.
26.
Note that the Summary Template field is no longer displayed on the form.
27.
Disabling a Field
Another method of protecting a field is disabling it by making it read-only.
I this topic, you will disable a field.
Page 24
Training Guide
Oracle EBS R12 Forms Personalization
Procedure
Step
Action
1.
2.
Note that currently the Summary Template field is shown in WHITE, which
means that you could enter data into that field.
Page 25
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
3.
4.
5.
6.
Page 26
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
7.
Enter the desired information into the Seq field. Enter "1".
8.
Enter the desired information into the Description field. Enter "Disable a field on
a form".
9.
10.
Enter the desired information into the Seq field. Enter "1".
11.
Enter the desired information into the Description field. Enter "Disable a field".
12.
13.
Enter the desired information into the Find field. Enter "Summary%".
14.
15.
Page 27
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
16.
17.
18.
19.
20.
Step
Action
21.
Page 28
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
22.
23.
24.
25.
Note that the Summary Template field is now shown in BLUE, and the user is
prohibited from entering data into the field. If the record had data in it, that data
would be shown.
Note that the Currency field is shown in BLUE as well, but that it shows a
predetermined value of USD.
26.
Page 29
Training Guide
Oracle EBS R12 Forms Personalization
Procedure
Step
Action
1.
2.
Note that currently, the prompt on the Summary Template field is "Summary
Template". In the steps that follow, you will change the prompt.
Page 30
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
3.
4.
5.
6.
Page 31
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
7.
Enter the desired information into the Seq field. Enter "1".
8.
Enter the desired information into the Description field. Enter "Change a field
prompt on a form".
9.
10.
Enter the desired information into the Seq field. Enter "1".
11.
Enter the desired information into the Description field. Enter "Change a
prompt".
12.
13.
Enter the desired information into the Find field. Enter "Summary%".
14.
Page 32
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
15.
16.
Enter the desired information into the Value field. Enter "Account Summary
Template".
17.
18.
19.
20.
Note that the prompt has now change from "Summary Template" to "Account
Summary Template".
21.
You have now completed the procedure to change the prompt of a field on a page.
End of Procedure.
Page 33
Procedure
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
1.
2.
Enter the desired information into the Rule Description field. Enter "Example of
testing for a condition".
3.
Enter the desired information into the Condition field. Enter "sysdate >
to_date('1-1-2008','DD-MM-RRRR')".
4.
This condition uses PL/SQL functions sysdate and to_date with a boolean
expression.
After you enter your condition, you should click the Validate button to test your
condition based on the current values in the form and on the server.
5.
6.
The condition, because it is boolean, will always evaluate as either true or false.
There is one exception, if you have entered an invalid condition, testing will fail
will an error message.
7.
8.
9.
In addition to PL/SQL functions, you can also test for values in the form. The
format for referring to form values is :BLOCK_NAME.FIELD_NAME. In this
sample, you are referring to the USER_RESP block and the
RESPONSIBILITY_ID field in that block.
10.
11.
Page 36
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
or
Press [Alt+O].
12.
Enter the desired information into the Condition Multiline field. Enter
":USER.USER_NAME is not null".
13.
14.
15.
You have now completed your exploration of conditions that can be applied to
personalizations on a page.
End of Procedure.
Procedure
Page 37
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
1.
2.
Enter the desired information into the Rule Description field. Enter
"Personalization Rule".
3.
4.
5.
6.
Page 38
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
7.
8.
9.
If you return to the form, you will note that the form has numerous logical areas,
the USER area, the DIRECT RESPONSIBILITY area, the INDIRECT
RESPONSIBILITY area, and the SECURING ATTRIBUTES area.
Blocks are not directly related to layout, but they most often be discerned from the
layout. A block is actually closely related to a TABLE, and it meant to represent
the interactions with that table.
Page 39
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
10.
When you set an event at the NEW-BLOCK level, you should tell it which block
you want to execute (fire) on. If not specified, it will execute (fire) on all new
blocks.
Click the Trigger Object LOV button.
11.
Note that as noted earlier, the form has four blocks. So, our logical analysis turned
out to be accurate. This won't always be the case, and you will need to explore and
test to fully understand the interactions of the form you are personalizing.
Click the OK button.
or
Press [Alt+O].
12.
Page 40
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
13.
14.
Page 41
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
15.
16.
Note that in the case of this form, the records and the blocks are identical. This is
the most common case, but is not always this way.
Click the OK button.
or
Press [Alt+O].
17.
Page 42
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
18.
19.
Page 43
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
20.
21.
22.
Page 44
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
23.
24.
Page 45
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
25.
26.
Since you are validating a record, the Trigger Object list is the same as the NEWRECORD event.
Click the OK button.
or
Press [Alt+O].
27.
Page 46
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
28.
29.
MENU1 to MENU15 correspond to the Tools menu on the menu bar at the top of
the form. You will also see SPECIAL1 to SPECIAL15. These events are same as
MENU1 to MENU15. SPECIALxx was the older method for referring to these
items.
Likewise SPECIAL16 to SPECIAL30 refer to the Reports menu, and SPECIAL31
to SPECIAL45 refer to the Actions menu. These menu items are less commonly
used, and still use the older nomenclature.
Page 47
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
30.
Page 48
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
31.
32.
33.
34.
Every event can designate whether or not that event is operates when the form is
in Query mode. Query mode is a special mode on a form, and most
personalizations would not operate in that mode. This is why the default setting is
"Not in Enter-Query Mode". Change this as appropriate for your personalization.
35.
36.
Finally, you can enable or disable a given personalization rule by clicking the
Enabled checkbox beside the rule.
Page 49
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
37.
38.
39.
You have now completed your exploration of the events that are personalizable on
a page.
End of Procedure.
Page 50
Training Guide
Oracle EBS R12 Forms Personalization
Procedure
Step
Action
1.
2.
Enter the desired information into the Description field. Enter "Sample for
Context".
3.
Page 51
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
4.
5.
Page 52
When you set the context to Responsibility, you have to tell your personalization
which responsibility is your context. You can also set multiple contexts to select
multiple responsibility, for example.
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
6.
7.
Note that the list of responsibilities on the system is quite large; so, you are asked
to limit the query.
Enter the desired information into the Find field. Enter "System%".
8.
9.
10.
11.
12.
Page 53
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
13.
Page 54
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
14.
Just like for Responsibility contexts, you must set the specific user for a User
context.
Click the Value button.
15.
Enter the desired information into the Find field. Enter "OPER%".
16.
17.
18.
Page 55
Training Guide
Oracle EBS R12 Forms Personalization
Displaying a Message
Forms personalization enables you to display a message to the user as they enter a form. The
message itself is dynamic, and depends upon the state of the server.
In this topic, you will display a message.
Procedure
Step
Action
1.
Page 56
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
2.
3.
4.
5.
Page 57
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
6.
Enter the desired information into the Seq field. Enter "1".
7.
Enter the desired information into the Description field. Enter "Display a
message on the form".
Page 58
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
8.
Page 59
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
9.
Enter the desired information into the Seq field. Enter "1".
10.
Page 60
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
11.
Page 61
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
12.
Enter the desired information into the Action Description field. Enter "Display a
message".
13.
Page 62
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
14.
Page 63
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
15.
Enter the desired information into the Message Text field. Enter "='The date
today is '||sysdate".
16.
Why does the Message Text start with an = (equal sign)? The = (equal sign) is how
you tell form personalization that the value is not just a string. It is a string that
must be calculated. In this case, it is a simple concatenation (||) of a string with the
current date on the server.
Whenever you use a dynamic value, you should test or validate your text to make
certain that it is performing as expected.
17.
18.
When you validate your Message Text, the dynamic value is calculated, and the
current value is displayed for validation.
19.
20.
Page 64
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
21.
22.
Normally, you would see your simple personalization. But, the message that you
just created is only displayed once when the form is newly loaded. So, you must
close the form and reload it to see your message.
Step
Action
23.
Page 65
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
24.
25.
Now, you see your message. Note, the message is displayed before the form is
even loaded.
26.
27.
Procedure
Page 66
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
1.
Page 67
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
2.
3.
4.
5.
Page 68
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
6.
Enter the desired information into the Seq field. Enter "1".
7.
Enter the desired information into the Description field. Enter "Example of a
message and a built-in on a form".
8.
9.
Enter the desired information into the Seq field. Enter "1".
10.
Page 69
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
11.
Page 70
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
12.
Enter the desired information into the Description field. Enter "Warning
message".
13.
Page 71
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
14.
Page 72
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
15.
Enter the desired information into the Message Text field. Enter "Do you want to
query a user?".
16.
At this point, you have only created the message. You need to create a 2nd action
that will be performed after the message is displayed.
Because you want the 2nd action to occur only if the user wants to query a user,
you selected the message type of Warn. Warn messages have two buttons, OK and
Cancel. If the user clicks the OK button, form personalization processing will
continue to the 2nd action. If the user clicks the cancel button, form
personalization will halt at that action for that rule.
17.
Enter the desired information into the Seq field. Enter "2".
Page 73
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
18.
Page 74
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
19.
Page 75
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
20.
Enter the desired information into the Description field. Enter "Enter query
mode".
21.
22.
23.
Page 76
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
24.
Page 77
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
25.
26.
Remember, to see your personalization in action, you need to close and reopen the
form.
Page 78
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
27.
Page 79
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
28.
29.
As a first test, click the OK button to see what happens. In the second test, you
will click the Cancel button to test that response.
30.
Page 80
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
31.
Enter the desired information into the User Name field. Enter "OPERATIONS".
32.
33.
Page 81
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
34.
35.
36.
37.
Note that when the user clicks the Cancel button, the form is opened in its normal,
non-query mode.
38.
You have now completed the procedure to use a form built-in on a page.
End of Procedure.
Creating a Menu
Forms can have menus, made available to the user, if they want to perform some special bit of
processing.
In this topic, you will create a menu.
Page 82
Training Guide
Oracle EBS R12 Forms Personalization
Procedure
Step
Action
1.
Page 83
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
2.
3.
4.
5.
Page 84
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
6.
Enter the desired information into the Seq field. Enter "1".
7.
Enter the desired information into the Description field. Enter "Create a menu
entry".
8.
9.
Enter the desired information into the Seq field. Enter "1".
10.
Page 85
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
11.
Page 86
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
12.
Enter the desired information into the Description field. Enter "Create menu
entry".
13.
Page 87
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
14.
15.
Page 88
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
16.
Enter the desired information into the Menu Label field. Enter "Query User".
17.
Now, you need to set your menu item so that it only operates when the user is in
the USER block of the form. If the user tried to query from any other block, the
query would fail (at least, as intended).
18.
19.
20.
Page 89
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
21.
Page 90
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
22.
Enter the desired information into the Seq field. Enter "2".
23.
Enter the desired information into the Description field. Enter "Respond to menu
selection".
24.
Creating the menu and menu item needed to be done when the form was opened
(WHEN-NEW-FORM-INSTANCE). But, responding to the selection of that menu
item is an event unto itself. And, would only be responded to when selected, not
automatically at the opening of the form.
25.
Page 91
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
26.
27.
Page 92
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
28.
29.
Enter the desired information into the Action Sequence field. Enter "1".
30.
Page 93
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
31.
Page 94
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
32.
Enter the desired information into the Action Description field. Enter "Do the
query".
33.
Page 95
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
34.
Page 96
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
35.
36.
37.
38.
39.
Page 97
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
40.
Page 98
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
41.
42.
Note the Tools menu at the top of the form on the menu bar. It is there, but now it
actually has an entry on the menu.
Page 99
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
43.
44.
45.
46.
Enter the desired information into the User Name field. Enter "OPERATIONS".
47.
48.
Page 100
Creating a Zoom
In old versions of the E-Business Suite, there was a useful feature known as a zoom. It allowed
you to drill-down from one form into another. The old zoom had several limitations, and was
eliminated in the newer versions of the E-Business Suite. But, form personalizations allow you to
implement the functionality of a zoom without the limitations. The biggest limitation that it
overcomes is that you, as the form personalization developer, have complete control over the
form (or forms) that are zoomed to by the personalization.
In this topic, you will create a zoom.
Procedure
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
1.
Step
Action
2.
3.
4.
Page 102
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
or
Press [z].
Step
Action
5.
Enter the desired information into the Seq field. Enter "1".
6.
Enter the desired information into the Description field. Enter "Create the menu
item for the zoom".
Page 103
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
7.
Page 104
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
8.
Enter the desired information into the Seq field. Enter "1".
9.
Page 105
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
10.
Page 106
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
11.
Enter the desired information into the Description field. Enter "Zoom menu
item".
12.
Page 107
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
13.
Page 108
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
14.
Enter the desired information into the Menu Label field. Enter "Zoom to
Responsibility Detail".
15.
16.
17.
Page 109
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
18.
Page 110
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
19.
20.
Enter the desired information into the Seq field. Enter "2".
21.
Enter the desired information into the Description field. Enter "Handle condition
when Responsibility is NULL (not yet entered)".
22.
Page 111
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
23.
Page 112
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
24.
Page 113
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
25.
Page 114
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
26.
Enter the desired information into the Seq field. Enter "1".
27.
Page 115
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
28.
Page 116
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
29.
Enter the desired information into the Description field. Enter "Error message".
30.
Page 117
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
31.
Page 118
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
32.
Enter the desired information into the Message Text field. Enter "You must enter
a Responsibility before drilling down to the details of that res".
33.
34.
35.
Enter the desired information into the Seq field. Enter "3".
36.
Enter the desired information into the Description field. Enter "Handle condition
when Responsibility is not NULL (responsibility is OK)".
37.
Page 119
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
38.
Page 120
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
39.
40.
41.
Enter the desired information into the Seq field. Enter "1".
42.
Enter the desired information into the Action Description field. Enter "Save to a
global variable".
43.
At this point, this is probably an unexpected action. Why is this done? You need to
have a means to communicate with the other form. The means to allow that is a
global variable that will be passed from the starting form to the drill-down form.
44.
Page 121
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
45.
Page 122
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
46.
Enter the desired information into the Target Object field. Enter
"XX_RESPONSIBILITY_ID".
47.
48.
Enter the desired information into the Action Sequence field. Enter "2".
49.
Page 123
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
50.
Page 124
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
51.
Enter the desired information into the Action Description field. Enter "Launch
Responsibility form".
52.
Page 125
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
53.
54.
Just a note about E-Business Suite security. Notice that you don't launch a form,
you launch a Function. An E-Business Suite Function is a specific form with a
specific set of parameters assigned to a particular responsibility. The user then has
the responsibility assigned to them. This insures that user has access to that form
normally. It the user didn't normally have access rights to that function (form), the
drill-down would fail.
Page 126
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
55.
Enter the Function Code of the Function you wish to launch, in this example that
is FND_FNDSCRSP.
Enter the desired information into the field. Enter "FND_FNDSCRSP".
56.
57.
Page 127
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
58.
Page 128
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
59.
Page 129
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
60.
61.
Note that the menu item is grayed out, and not accessible from this block on the
form.
Click the Zoom to Responsibility Detail menu.
62.
63.
64.
65.
Page 130
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
or
Press [Alt+O].
66.
67.
68.
Enter the desired information into the User Name field. Enter "OPERATIONS".
69.
70.
71.
72.
73.
Note that the Responsibilities form is launched, but that it has no data. Why? We
haven't yet handled the passing of the global variable.
To do this, you need to make personalizations to the drill-down form to handle the
global variable.
Page 131
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
74.
75.
76.
77.
Page 132
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
78.
Enter the desired information into the Seq field. Enter "1".
79.
Enter the desired information into the Description field. Enter "Initialize the
global variable".
80.
81.
Enter the desired information into the Seq field. Enter "1".
82.
Enter the desired information into the Description field. Enter "Initialize global
variable".
83.
Page 133
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
84.
Page 134
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
85.
Enter the desired information into the Target Object field. Enter
"XX_RESPONSIBILITY_ID".
86.
87.
The are two settings for a global variable, VALUE and INITIAL VALUE.
VALUE is used to create the variable and set the value. INITIAL VALUE will
create and set the value only if it does not exist. If it already exists, it will leave it
untouched.
88.
89.
This will only set the global variable to null if it doesn't already exist. When would
that occur? Most times, actually. The only time the global variable is set is during
the zoom. If you just use the form normally, the global variable will not be set.
Enter the desired information into the Value field. Enter "=null".
90.
Page 135
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
91.
92.
Enter the desired information into the Seq field. Enter "2".
93.
Enter the desired information into the Description field. Enter "If global variable
is not null, go into Query Mode".
94.
95.
96.
Enter the desired information into the Seq field. Enter "1".
97.
Step
Action
98.
Page 136
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
99.
Enter the desired information into the Description field. Enter "Enter query
mode".
100.
Page 137
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
101.
Page 138
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
102.
103.
104.
105.
106.
Enter the desired information into the Rule Sequence field. Enter "3".
107.
Enter the desired information into the Description field. Enter "If global variable
is not null, execute the query on the new record".
108.
Page 139
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
109.
Page 140
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
110.
111.
112.
Page 141
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
113.
Page 142
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
114.
115.
Enter the desired information into the Seq field. Enter "1".
116.
Enter the desired information into the Description field. Enter "Copy global
variable into form".
117.
Enter the desired information into the Target Object field. Enter
"RESPONSIBILITY.RESPONSIBILITY_ID".
118.
Enter the desired information into the Property Name field. Enter "VALUE".
119.
120.
Enter the desired information into the Seq field. Enter "2".
121.
Page 143
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
122.
Page 144
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
123.
Enter the desired information into the Description field. Enter "Execute query".
124.
125.
126.
127.
Enter the desired information into the Seq field. Enter "4".
128.
Enter the desired information into the Description field. Enter "Reset global
variable to null".
129.
130.
Enter the desired information into the Seq field. Enter "1".
131.
Enter the desired information into the Description field. Enter "Reset global
variable".
132.
Page 145
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
133.
Page 146
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
134.
Enter the desired information into the Target Object field. Enter
"XX_RESPONSIBILITY_ID".
135.
Enter the desired information into the Value field. Enter "=null".
136.
137.
Page 147
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
138.
Page 148
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
139.
When you return to the Users form, retest the Tools menu to zoom to the
Responsibility.
Click the Tools menu.
or
Press [Alt+T].
140.
Page 149
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
141.
Note that it queried the proper responsibility. Also note that you are not locked
into this one responsibility. You can execute a blind query as a test.
Press [Ctrl+F11].
142.
Press [Down].
143.
Page 150
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
144.
Page 151
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
145.
146.
Note that you can enter the Responsibilities form normally, and you will not
encounter any problems.
147.
Procedure
Page 152
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
1.
2.
Enter the desired information into the Description field. Enter "Advanced
Personalization Actions".
3.
4.
5.
Note the variety of properties. This list will vary based on the object type being
selected.
Click the vertical scrollbar.
6.
7.
8.
Page 153
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
9.
10.
Step
Action
11.
Page 154
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
12.
Page 155
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
13.
As noted throughout the Form Personalization module, there are 4 action types,
Property, Message, Builtin, and Menu. Just like Property, each of the other Action
Types have numerous capabilities.
Review the Message type.
Click the Message list item.
Page 156
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
14.
15.
A message has 5 types, Show, Hint, Error, Debug, and Warn. An Error message is
a dialog box with 1 button (OK), and it halts further processing of the form. A
Warn message is a dialog box with 2 buttons, OK and Cancel. A Show message is
a dialog box with 1 button (OK), but it doesn't halt processing like an Error
message. A Hint message appears at the bottom of the form, and is most often seen
during saves. Finally, a Debug message is only displayed with Debug Mode is set
to On.
16.
Page 157
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
17.
Page 158
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
18.
19.
20.
A Function is a form with parameters and applied security within the E-Business
Suite. It is commonly interchangeably used (incorrectly) with form.
21.
A URL can be any URL accessible from the user's browser. So, it can be an EBusiness Suite browser-based, OA Framework page, or it can be any Internet URL
that you can to use.
22.
DO_KEY allows you to perform numerous keyboard actions common to the EBusiness Suite. This topic will return to DO_KEY for more details.
23.
24.
25.
Page 159
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
26.
27.
Call Custom Library allows the CUSTOM library to be called. Despite the
declarative interface of Forms Personalization it is still sometimes necessary to
write PL/SQL code within the CUSTOM library. To facilitate this we have
introduced a new builtin type of Call Custom Library which takes a single
argument of the event name. Within the CUSTOM library, code can then be
written to respond to this event.
Page 160
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
28.
It is possible to change the underlying where clause for query for an LOV. If one
needs to change the columns returned by the query, care must be taken to ensure
that the column names and data types match what was defined for the LOV that is
being changed.
The SQL may reference values from form fields, form parameters and globals. All
SQL statements used for this feature should be tested from SQL*PLUS to ensure
that the SQL is valid and will work as expected. If the SQL for the personalization
has references to bound variables, substitute values that would normally be
expected. To create a personalization to change the record group used by an LOV,
create a new personalization as follows:
Condition
Trigger Event: WHEN-NEW-FORM-INSTANCE level.
Actions
#1
Type: Builtin
Builtin Type: Create Group from Query
Argument: <the SQL statement to be used>
Group Name: <the new record group name>
#2
Type: Property
Object Type: LOV
Target Object: <the LOV to use the new record group>
Property Name: GROUP_NAME
Value: <the record group name created in action step 1>
29.
30.
Any key that can be processed via E-Business Suite can be processed with
DO_KEY via a form personalization.
Click the vertical scrollbar.
31.
32.
Page 161
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
33.
Page 162
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
34.
And finally, just like Rules, individual Actions can be enabled or disabled by
clicking the Enabled checkbox.
Disable the action.
Click the Enabled option.
35.
36.
You have now completed your exploration of the advanced actions that are
possible via personalizations on a page.
End of Procedure.
Page 163
Procedure
Step
Action
1.
2.
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
3.
4.
5.
Page 166
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
6.
7.
8.
9.
Page 167
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
10.
Page 168
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
11.
Page 169
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
12.
Page 170
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
13.
Page 171
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
14.
15.
Page 172
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
16.
17.
Execute a query.
Press [Ctrl+F11].
18.
19.
20.
Press [Down].
21.
Page 173
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
22.
23.
24.
Step
Action
25.
Page 174
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
26.
Page 175
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
27.
28.
Page 176
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
29.
Page 177
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
30.
31.
Page 178
Training Guide
Oracle EBS R12 Forms Personalization
Step
Action
32.
33.
34.
35.
You have now completed the procedures that will enable you to debug a
personalization on a page.
End of Procedure.
Page 179