![]() | |
Sun Java System Portal Server 6 2005Q4 Technical Reference Guide |
Chapter 49
Robot Application Functions - Sources and DestinationsThis chapter contains the following sections:
IntroductionMost of the Robot Application Functions (RAFs) require sources of information and generate data that goes to destinations. The sources are defined within the robot itself and are not necessarily related to the fields in the resource description it ultimately generates. Destinations, on the other hand, are generally the names of fields in the resource description, as defined by the resource description server’s schema.
For details on using the administration console to determine the database schema, see Sun Java System Portal Server Administration Guide.
The following sections describe the different stages of the filtering process, and the sources available at those stages.
Setup Stage
At the Setup stage, the filter is set up and cannot yet get information about the resource’s URL or content.
MetaData Filtering StageAt the MetaData stage, the robot encounters a URL for a resource, but it has not downloaded the resource’s content, thus information is available about the URL as well as data that is derived from other sources such as the filter.conf file. At this stage, however, information is not available about the content of the resource.
Table 49-1 lists the sources available to the RAFs at the MetaData phase. The table contains three columns. The first column lists the source, the second column provides a description, and the third column provides an example.
Data StageAt the Data stage, the robot has downloaded the content of the resource at the URL, and can access data about the content, such as the description, the author, and so on.
If the resource is an HTML file, the Robot parses the <META> tags in the HTML headers. Consequently, any data contained in <META> tags is available at the Data stage.
During the data phase, the following sources (shown in Table 49-2) are available to RAFs, in addition to those available during the MetaData phase. The table contains three columns. The first column lists the source, the second column provides a description, and the third column provides an example.
Enumeration, Generation, and Shutdown Stages
At the Enumeration and Generation stages, the same data sources are available as the Data stage.
At the Shutdown stage, the filter completes its filtering and is shuts down. Although functions written for this stage can use the same data sources as those available at the Data stage, the shutdown functions typically restrict their operations to shutdown and cleanup activities.