| Oracle® Application Express Application Builder User's Guide Release 3.2 E11947-03 |
|
|
PDF · Mobi · ePub |
| Oracle® Application Express Application Builder User's Guide Release 3.2 E11947-03 |
|
|
PDF · Mobi · ePub |
You may need to translate messages if your application:
Includes PL/SQL regions or PL/SQL processes or calls PL/SQL package, procedures, or function. If it does, you may need to translate the generated HTML.
Uses a language that is not one of the ten languages into which Oracle Application Express is translated. If it does, you may need to translate messages used in reports.
Topics in this section include:
If your application includes PL/SQL regions or PL/SQL processes or calls PL/SQL package, procedures, or functions, you may need to translate generated HTML. First, you define each message on the Translatable Messages page. Second, you use the APEX_LANG.MESSAGE API to translate the messages from PL/SQL stored procedures, functions, triggers, or packaged procedures and functions.
You create translatable messages on the Translate Messages page.
To define a new translation message:
Navigate to the Translate Application page:
On the Workspace home page, click the Application Builder icon.
Select an application.
Click Shared Components.
Under Globalization, click Text Messages.
On the Translate Messages page, click Create.
On Identify Text Message, specify the following:
Name - Enter a name to identify the message.
Language - Select the language for which the message would be used.
Text - Enter the text to be returned when the text message is called.
For example, you could define the message GREETING_MSG in English as:
Good morning %0
Or, you could define the message GREETING_MSG in German as:
Guten Tag %0
Click Create.
Use the APEX_LANG.MESSAGE API to translate text strings (or messages) generated from PL/SQL stored procedures, functions, triggers, packaged procedures, and functions.
APEX_LANG.MESSAGE (
p_name IN VARCHAR2 DEFAULT NULL,
p0 IN VARCHAR2 DEFAULT NULL,
p1 IN VARCHAR2 DEFAULT NULL,
p2 IN VARCHAR2 DEFAULT NULL,
...
p9 IN VARCHAR2 DEFAULT NULL,
p_lang IN VARCHAR2 DEFAULT NULL)
RETURN VARCHAR2;
Table 16-2 describes the parameters available in the APEX_LANG.MESSAGE API.
Table 16-2 APEX_LANG.MESSAGE Parameters
| Parameter | Description |
|---|---|
|
|
Name of the message as defined in Oracle Application Express. |
|
...
|
Dynamic substitution value: |
|
|
Language code for the message to be retrieved. If not specified, Oracle Application Express uses the current language for the user as defined in the Application Language Derived From attribute. See Also: "Specifying the Primary Language for an Application" |
The following example assumes you have defined a message called GREETING_MSG in your application in English as Good morning%0 and in German as Guten Tag%1. The following example demonstrates how you could invoke this message from PL/SQL:
BEGIN
--
-- Print the greeting
--
APEX_LANG.MESSAGE('GREETING_MSG', V('APP_USER'));
END;
How the p_lang attribute is defined depends on how the Application Express engine derives the Application Primary Language. For example, if you are running the application in German and the previous call is made to the APEX_LANG.MESSAGE API, the Application Express engine first looks for a message called GREETING_MSG with a LANG_CODE of de. If it does not find anything, then it will revert to the Application Primary Language attribute. If it still does not find anything, the Application Express engine looks for a message by this name with a language code of en-us.
See Also:
"Specifying the Primary Language for an Application" for information about the Application Primary Language attributeOracle Application Express is translated into German, Spanish, French, Italian, Japanese, Korean, Brazilian Portuguese, Simplified Chinese, and Traditional Chinese. If your application uses a language that is not among the ten languages into which Oracle Application Express is translated, you must translate messages displayed by the Application Express reporting engine.
For example, if you develop a Russian application and want to include report messages, such as pagination, in Russian, you must translate the strings used in messages displayed in reports.
To translate messages:
Navigate to the Translate Application page:
On the Workspace home page, click the Application Builder icon.
Select an application.
Click Shared Components.
Under Globalization, click Text Messages.
On the Translate Messages page, click Create.
On Identify Text Message, specify the following:
Name - Enter the name of each message that needs to be translated. See Table 16-3.
Language - Select the language for which the message would be used.
Text - Enter the text to be returned when the text message is called. If the English text message contains positional substitution values (for example, %0, %1), ensure that your defined message also contains the same named and number of positional substitution values.
Click Create.
Table 16-3 lists the internal messages that require translation.
Table 16-3 Internal Messages Requiring Translation
| Message Name | English Text |
|---|---|
|
|
1 error has occurred |
|
|
%0 errors have occurred |
|
|
Invalid Login Credentials |
|
|
Invalid set of rows requested, the source data of the report has been modified |
|
|
Next |
|
|
Next Set |
|
|
Previous |
|
|
Previous Set |
|
|
report total |
|
|
reset pagination |
|
|
%0 days ago |
|
|
%0 hours ago |
|
|
%0 minutes ago |
|
|
%0 months ago |
|
|
%0 seconds ago |
|
|
%0 weeks ago |
|
|
%0 years ago |
|
|
Total |
|
|
Calendar |
|
|
Close |
|
|
Ok |
|
|
Minimum row requested: %0, rows found but not displayed: %1 |
|
|
Sort by this column |
|
|
row(s) %0 - %1 of more than %2 |
|
|
row(s)%0 - %1 of %2 |
|
|
%0 - %1 of %2 |
Table 16-4 lists the internal messages that require translation.
Table 16-4 Interactive Report Messages Requiring Translation
| Message Name | English Text |
|---|---|
|
|
3D |
|
|
Actions Menu |
|
|
Add |
|
|
Aggregate |
|
|
Aggregates are displayed after each control break and at the end of the report. |
|
|
Aggregation |
|
|
Average |
|
|
Count |
|
|
Maximum |
|
|
Median |
|
|
Minimum |
|
|
Mode |
|
|
Sum |
|
|
All |
|
|
All Columns |
|
|
and |
|
|
Apply |
|
|
Ascending |
|
|
As of %0 |
|
|
between |
|
|
Background Color |
|
|
blue |
|
|
Bottom |
|
|
Calendar |
|
|
Cancel |
|
|
Category |
|
|
Cell |
|
|
Chart |
|
|
Initializing... |
|
|
Chart Type |
|
|
Choose report download format |
|
|
clear |
|
|
Column |
|
|
Columns |
|
|
Column Heading |
|
|
Column Heading Menu |
|
|
Column Information |
|
|
contains |
|
|
does not contain |
|
|
in |
|
|
is not in the last |
|
|
is not in the next |
|
|
is in the last |
|
|
is in the next |
|
|
is not null |
|
|
is null |
|
|
like |
|
|
not in |
|
|
not like |
|
|
matches regular expression |
|
|
Computation |
|
|
Create a computation using column aliases. |
|
|
(B+C)*100 |
|
|
INITCAP(B)||', '||INITCAP(C) |
|
|
CASE WHEN A = 10 THEN B + C ELSE B END |
|
|
Compute |
|
|
Control Break |
|
|
Control Breaks |
|
|
Report data as of %0 minutes ago. |
|
|
Date |
|
|
Default |
|
|
Delete |
|
|
Delete Checked |
|
|
Would you like to delete these report settings? |
|
|
Would you like to perform this delete action? |
|
|
Delete Report |
|
|
Descending |
|
|
Description |
|
|
Single Row View |
|
|
Direction |
|
|
Disable |
|
|
Disabled |
|
|
Display |
|
|
Displayed |
|
|
Displayed Columns |
|
|
Display in Report |
|
|
Down |
|
|
Download |
|
|
- Do not aggregate - |
|
|
Do Not Display |
|
|
Edit Chart Settings |
|
|
Edit Chart |
|
|
Edit Filter |
|
|
Edit Highlight |
|
|
Enable |
|
|
Enabled |
|
|
Enable/Disable |
|
|
Error |
|
|
Examples |
|
|
Examples: |
|
|
Exclude Null Values |
|
|
Expand/Collapse |
|
|
Expression |
|
|
Filter |
|
|
Filters |
|
|
Select columns to search |
|
|
Flashback |
|
|
A flashback query enables you to view the data as it existed at a previous point in time. |
|
|
Unable to perform flashback request |
|
|
Format Mask |
|
|
Function |
|
|
Functions |
|
|
Go |
|
|
green |
|
|
Horizontal Column |
|
|
Help |
|
|
An Interactive Report displays a predetermined set of columns. The report may be further customized with an initial filter clause, a default sort order, control breaks, highlighting, computations, aggregates and a chart. Each Interactive Report can then be further customized and the results can be viewed, or downloaded, and the report definition can be stored for later use. <p/> An Interactive Report can be customized in three ways: the search bar, actions menu and column heading menu. |
|
|
The actions menu is used to customize the display of your Interactive Report. |
|
|
Aggregates are mathematical computations performed against a column. Aggregates are displayed after each control break and at the end of the report within the column they are defined. <p/> <ul><li><b>Aggregation</b> allows you to select a previously defined aggregation to edit.</li> <li><b>Function</b> is the function to be performed (e.g. SUM, MIN).</li> <li><b>Column</b> is used to select the column to apply the mathematical function to. Only numeric columns will be displayed.</li></ul> |
|
|
Aggregates are mathematical computations performed against a column. Aggregates are displayed after each control break and at the end of the report within the column they are defined.<p/> <p/> <ul><li><b>Aggregation</b> allows you to select a previously defined aggregation to edit.</li> <li><b>Function</b> is the function to be performed (e.g. SUM, MIN).</li> <li><b>Column</b> is used to select the column to apply the mathematical function to. Only numeric columns will be displayed.</li></ul> |
|
|
You can include one chart per Interactive Report. Once defined, you can switch between the chart and report views using links below the search bar. <p/> <ul><li><b>Chart Type</b> identifies the chart type to include. Select from horizontal bar, vertical bar, pie or line.</li> <li><b>Label</b> allows you to select the column to be used as the label.</li> <li><b>Axis Title for Label</b> is the title that will display on the axis associated with the column selected for Label. This is not available for pie chart.</li> <li><b>Value</b> allows you to select the column to be used as the value. If your function is a COUNT, a Value does not need to be selected.</li> <li><b>Axis Title for Value</b> is the title that will display on the axis associated with the column selected for Value. This is not available for pie chart.</li> <li><b>Function</b> is an optional function to be performed on the column selected for Value.</li></ul> |
|
|
Clicking on any column heading exposes a column heading menu. <p/> <ul><li><b>Sort Ascending icon</b> sorts the report by the column in ascending order.</li> <li><b>Sort Descending icon</b> sorts the report by the column in descending order.</li> <li><b>Hide Column</b> hides the column.</li> <li><b>Break Column</b> creates a break group on the column. This pulls the column out of the report as a master record.</li> <li><b>Column Information</b> displays help text about the column, if available.</li> <li><b>Text Area</b> is used to enter case insensitive search criteria (no need for wild cards). Entering a value will reduce the list of values at the bottom of the menu. You can then select a value from the bottom and the selected value will be created as a filter using '=' (e.g. column = 'ABC'). Alternatively, you can click the flashlight icon and the entered value will be created as a filter with the 'LIKE' modifier (e.g. column LIKE '%ABC%').<li><b>List of Unique Values</b> contains the first 500 unique values that meet your filters. If the column is a date, a list of date ranges is displayed instead. If you select a value, a filter will be created using '=' (e.g. column = 'ABC').</li></ul> |
|
|
Computations allow you to add computed columns to your report. These can be mathematical computations (e.g. NBR_HOURS/24) or standard Oracle functions applied to existing columns (some have been displayed for example, others, like TO_DATE, can also be used). <p/> <ul><li><b>Computation</b> allows you to select a previously defined computation to edit.</li> <li><b>Column Heading</b> is the column heading for the new column.</li> <li><b>Format Mask</b> is an Oracle format mask to be applied against the column (e.g. S9999).</li> <li><b>Format Mask</b> is an Oracle format mask to be applied against the column (e.g. S9999).</li> <li><b>Computation</b> is the computation to be performed. Within the computation, columns are referenced using the aliases displayed.</li> </ul> <p/> Below computation, the columns in your query are displayed with their associated alias. Clicking on the column name or alias will write them into the Computation. Next to Columns is a Keypad. These are simply shortcuts of commonly used keys. On the far right are Functions. <p/> An example computation to display Total Compensation is: <p/> <pre>CASE WHEN A = 'SALES' THEN B + C ELSE B END</pre> (where A is ORGANIZATION, B is SALARY and C is COMMISSION) |
|
|
Used to create a break group on one or several columns. This pulls the columns out of the Interactive Report and displays them as a master record. |
|
|
To view the details of a single row at a time, click the single row view icon on the row you want to view. If available, the single row view will always be the first column. Depending on the customization of the Interactive Report, the single row view may be the standard view or a custom page that may allow update. |
|
|
Allows the current result set to be downloaded. The download formats will differ depending upon your installation and report definition but may include CSV, XLS, PDF, or RTF. |
|
|
Used to add or modify the where clause on the query. You first select a column (it does not need to be one that is displayed), select from a list of standard Oracle operators (=, !=, not in, between), and enter an expression to compare against. The expression is case sensitive and you can use % as a wild card (for example, STATE_NAME like A%). |
|
|
Performs a flashback query to allow you to view the data as it existed at a previous point in time. The default amount of time that you can flashback is 3 hours (or 180 minutes) but the actual amount will differ per database. |
|
|
Highlighting allows you to define a filter. The rows that meet the filter are highlighted using the characteristics associated with the filter. <p/> <ul><li><b>Name</b> is used only for display.</li> <li><b>Sequence</b> identifies the sequence in which the rules will be evaluated.</li> <li><b>Enabled</b> identifies if the rule is enabled or disabled.</li> <li><b>Highlight Type</b> identifies whether the Row or Cell should be highlighted. If Cell is selected, the column referenced in the Highlight Condition is highlighted.</li> <li><b>Background Color</b> is the new color for the background of the highlighted area.</li> <li><b>Text Color</b> is the new color for the text in the highlighted area.</li> <li><b>Highlight Condition</b> defines your filter condition.</li></ul> |
|
|
If you have customized your Interactive Report, the report settings will be displayed below the Search Bar and above the report. If you have saved customized reports, they will be shown as tabs. You can access your alternate views by clicking the tabs. Below the tabs are the report settings for the current report. This area can be collapsed and expanded using the icon on the left. <p/> For each report setting, you can: <ul><li><b>Edit</b> by clicking the name.</li> <li><b>Disable/Enable</b> by unchecking or checking the Enable/Disable check box. This is used to temporarily turn off and on the setting.</li> <li><b>Remove</b> by click the Remove icon. This permanently removes the setting.</li></ul> <p/> If you have created a chart, you can toggle between the report and chart using the Report View and Chart View links shown on the right. If you are viewing the chart, you can also use the Edit Chart link to edit the chart settings. |
|
|
Resets the report back to the default settings, removing any customizations that you have made. |
|
|
Saves the customized report for future use. You provide a name and an optional description. |
|
|
At the top of each report page is a search region. The region provides the following features: <p/> <ul><li><b>Select columns icon</b> allows you to identify which column to search (or all).</li> <li><b>Text area</b> allows for case insensitive search criteria (no need for wild cards).</li> <li><b>Rows</b> selects the number of records to display per page.</li> <li><b>[Go] button</b> executes the search.</li> <li><b>Actions Menu icon</b> displays the actions menu (discussed next).</li></ul> <p/> Please note that all features may not be available for each report. |
|
|
Used to modify the columns displayed. The columns on the right are displayed. The columns on the left are hidden. You can reorder the displayed columns using the arrows on the far right. Computed columns are prefixed with <b>**</b>. |
|
|
Used to change the column(s) to sort on and whether to sort ascending or descending. You can also specify how to handle nulls (use the default setting, always display them last or always display them first). The resulting sorting is displayed to the right of column headings in the report. |
|
|
Hide Column |
|
|
Highlight |
|
|
Highlights |
|
|
Highlight Condition |
|
|
Highlight Type |
|
|
Highlight When |
|
|
Interactive Report Help |
|
|
Invalid |
|
|
Invalid computation expression. %0 |
|
|
Keypad |
|
|
Label |
|
|
Axis Title for Label |
|
|
Last Day |
|
|
Last Hour |
|
|
Last Month |
|
|
Last Week |
|
|
Last %0 Days |
|
|
Last %0 Hours |
|
|
Last %0 Years |
|
|
Last Year |
|
|
Line |
|
|
The query is estimated to exceed the maximum allowed resources. Please modify your report settings and try again. |
|
|
This query returns more then %0 rows, please filter your data to ensure complete results. |
|
|
%0 minutes ago |
|
|
More Data |
|
|
Move |
|
|
Move All |
|
|
Name |
|
|
New Aggregation |
|
|
- New Category - |
|
|
New Computation |
|
|
> |
|
|
Next Day |
|
|
Next Hour |
|
|
Next Month |
|
|
Next Week |
|
|
Next %0 Days |
|
|
Next %0 Hours |
|
|
Next %0 Years |
|
|
Next Year |
|
|
No |
|
|
- None - |
|
|
No aggregation defined. |
|
|
No column information available. |
|
|
No computation defined. |
|
|
Nulls Always First |
|
|
Nulls Always First |
|
|
Nulls Always Last |
|
|
Null Sorting |
|
|
Flashback time must be numeric. |
|
|
Sequence must be numeric. |
|
|
Operator |
|
|
orange |
|
|
Other |
|
|
Pie |
|
|
< |
|
|
Public |
|
|
red |
|
|
Remove |
|
|
Remove Aggregate |
|
|
Remove All |
|
|
Remove Control Break |
|
|
Remove Filter |
|
|
Remove Flashback |
|
|
Remove Highlight |
|
|
Rename Report |
|
|
Report |
|
|
Report Settings |
|
|
< Report View |
|
|
Reset |
|
|
Restore report to the default settings. |
|
|
Row |
|
|
Rows |
|
|
Row %0 of %1 |
|
|
Row Order |
|
|
Row text contains |
|
|
Save |
|
|
Saved Report |
|
|
Saved Report = "%0" |
|
|
Save as Default |
|
|
The current report settings will be used as the default for all users. |
|
|
Save Report |
|
|
Search Bar |
|
|
- Select Category - |
|
|
- Select Column - |
|
|
Select Columns |
|
|
Computed columns are prefixed with **. |
|
|
- Select Function - |
|
|
Select Value |
|
|
Sequence |
|
|
Sort |
|
|
Sort Ascending |
|
|
Sort Descending |
|
|
space |
|
|
Status |
|
|
Text Color |
|
|
days |
|
|
hours |
|
|
minutes |
|
|
months |
|
|
weeks |
|
|
years |
|
|
Top |
|
|
Unauthorized |
|
|
Column Heading must be unique. |
|
|
Highlight Name must be unique. |
|
|
unsupported data type |
|
|
Up |
|
|
Please enter a valid color. |
|
|
Please enter a valid format mask. |
|
|
Value |
|
|
Axis Title for Value |
|
|
Value Required |
|
|
Vertical Column |
|
|
View Chart |
|
|
View Report |
|
|
Working Report |
|
|
yellow |
|
|
Yes |
|
 Copyright © 2003, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|