SRW.SET_BOOKMARK
built-in procedureThis procedure associates a bookmark with the object and specifies a string that will appear in a bookmark frame of the master HTML document or the PDF document. If you open the bookmark area and click the bookmark, the object appears at the top of the window.
SRW.SET_BOOKMARK('bookmark');
Parameter |
Description |
|
Is one of the following:
|
You can also define this attribute using the Reports Builder user interface:
Property Inspector |
Set the Bookmark property. |
If the same outline number is used multiple times, all entries appear but the order is defined by when the objects are rendered by the report.
If there are gaps in the numbers, one of two things will happen. If the gap is between peer level numbers, there will be no visible effect (for example, 1.3.1 and 1.3.3, given there is no 1.3.2, will appear next to each other and at the same indentation level). If the gap is between a higher level number and a lower level number, intermediate levels will be generated as required (for example, 1.0 followed by 2.1.1 will cause dummy 2 and 2.1 entries to be defined, whose titles will be the same as the subsequent real entry).
SRW.SET_BOOKMARK
should only be set in a format
trigger.
The format trigger below defines a bookmark for the boilerplate object B_2. Notice the use of explicit ordering information (1#) in this example. If you did not want the ordering information, you could omit 1#.
function B_2FormatTrigger return boolean is
begin
srw.set_bookmark('1#Expense Summary Section');
return
(TRUE);
end;
The format trigger below defines a bookmark for the boilerplate object B_2. Notice that the name of the bookmark is dynamic. CATEGORY is a column value that is concatenated with the string Expense Summary Section for each execution of the format trigger. In this case, CATEGORY could contain ordering information (for example, 1#) or perhaps a string that makes the bookmark unique within the report.
function B_2FormatTrigger return boolean is
begin
SRW.SET_BOOKMARK(:category ||
' Expense Summary Section');
return (TRUE);
end;
About the
Reports Builder built-in package (SRW
)
Copyright © 1984, 2005, Oracle. All rights reserved.