WebFOCUS
Online Help > Managed Reporting Developer > Creating Reporting Objects > Creating an Application Object
Creating an Application Object
Application Objects are pre-built, sort and verb object
code created to enable users to easily create complex requests.
An Application Object can be a sort field including any sorting
options, or a verb object or list of verb objects, including data
fields and computes.
Note: Application Objects are not supported in the HTML
Graph Assistant or Power Painter.
Procedure: How to Create an Application Object (Sort)
-
Open
the Reporting Object in which you want to add the Application Object.
-
In the
browser, select Application Objects and, in
the Reporting Object window, click Open.
In Developer Studio, right-click Application
Object and select Open.
The
Application Object dialog box opens.
-
Click New
Sort.
The Application Object (Sort) dialog box opens.
-
Select
the sort type: By, Across, or Ranked.
-
In the
Enter Sort Phrase text box, type the field name to sort by.
You can use any sort phrase options when you are creating
an Application Object, such as: HIGHEST, LOWEST, IN-GROUPS-OF, TILES.
For complete details on sorting options, see the Creating Reports With WebFOCUS Language manual.
Note:
- You can have
only one sort field per Application Object.
- ON TABLE commands
are not supported in Application Objects.
-
Type
a description.
This is the description that the user sees when they are
using the Reporting Object. It is beneficial to be as specific as
possible.
-
Click Validate.
If there are:
- No errors in
your syntax, the Check dialog box appears indicating that no errors
were found.
- Errors in your
syntax, the Check dialog box lists the error(s). For details on reporting
syntax, see the Creating Reports With WebFOCUS Language manual.
-
When
your syntax is validated, click OK to exit the
Application Object (Sort) dialog box.
The object appears in the Sort Objects (Sort) list.
-
Click OK to
exit the Application Object (Sort) dialog box.
Procedure: How to Create an Application Object (Verb)
-
Open
the Reporting Object in which you want to add the Application Object.
-
In the
browser, select Application Object and, in
the Reporting Object window, click Open.
In Developer Studio, right-click Application
Object and select Open.
The
Application Object dialog box opens.
-
Click New
Verb Object.
The Application Object (Verb) dialog box opens.
-
In the
Enter a space-delimited list of fields or amper variables field,
type your syntax. See Application Objects (Verb) Usage Notes.
-
Type
a description.
This is the description that the user sees when they are
using the Reporting Object. It is recommended to be as specific
as possible.
-
Click Validate.
If there are:
- No syntax errors,
the Check dialog box appears indicating no errors were found.
- Errors in your
syntax, the Check dialog box lists the error(s). For details on reporting
syntax, see the Creating Reports With WebFOCUS Language manual.
-
When
your syntax is validated, click OK to exit the
Application Object (Verb) dialog box.
The object appears in the Verb Objects list.
-
Click OK to
exit the Application Object (Verb) dialog box.
Reference: Application Objects (Verb) Usage Notes
- You can reference
any data field or temporary field, including defined fields. Any
verb syntax can be included such as COMPUTE, SEG.fieldname, AS phrases,
and prefix operators. For complete details on verb syntax, see the Creating Reports With WebFOCUS Language manual.
- When you add
a COMPUTE, validation fails if you do not include the ending semicolon.
Be sure to include the semicolon since the user will not be able
to use the Application Object without it.
- A BY phrase
cannot be included in an Application Object (Verb) that uses a WITHIN phrase.
The Validate function returns an error if the BY phrase is included.
Procedure: How to Edit an Application Object
-
Open
the Reporting Object and double-click Application Objects.
The Application Objects dialog box opens.
-
From
the Sort Objects or Verb Objects list, click the object.
-
Click Edit and
make any necessary modifications.
-
If you
have made syntax edits, click Validate to validate
your syntax.
-
Click OK.
-
To save
your changes, click Done in the Application
Objects dialog box, click Done in the Reporting Object
dialog box, and click Yes to save changes.
Procedure: How to Delete an Application Object
-
Open
the Reporting Object and double-click Application Objects.
The Application Objects dialog box opens.
-
From
the Sort Objects or Verb Objects list, click the object.
-
Click Delete.
-
Click OK.
-
To save
your changes, click Done in the Application
Objects dialog box, click Done in the Reporting Object
dialog box, and click Yes to save changes.