Page Assembly Database Interaction

2-12 Oracle Fusion Middleware Developers Guide for Oracle Universal Content Management For example:

1. When a user clicks the Administration link in the navigation area, a request for

the GET_ADMIN_PAGE service is sent to the web server. 2. The web server recognizes this request as an Oracle Content Server function, and sends the specific request to Oracle Content Server. 3. When Oracle Content Server has processed the request, it passes the result back to the web server. In the case of the Administration link, the GET_ADMIN_PAGE service: ■ Provides a login prompt if the user is not currently logged in. ■ Verifies that the user has the admin privilege. ■ Assembles the Administration page, using the ADMIN_LINKS template. ■ Returns the assembled web page to the web server. 4. The web server delivers the results of the Oracle Content Server service to the originating web browser client.

2.3.3.3 Search Services

A search request is a special kind of Oracle Content Server service. When Oracle Content Server receives a search request, it sends the request on to the search engine, using a search engine API. This service makes it possible to use different search engines with Oracle Content Server. For example:

1. When a user clicks the Search button on the standard Search page, a request for

the GET_SEARCH_RESULTS service is sent to the web server.

2. The web server recognizes the request as an Oracle Content Server function and

sends the specific request to Oracle Content Server.

3. Oracle Content Server passes the request to the search engine that is configured for

the Oracle Content Server instance.

4. The search engine returns the search results to Oracle Content Server.

5. Based on the user login and security permissions, Oracle Content Server assembles the search results page and returns it to the web server. 6. The web server delivers the results to the originating web browser client.

2.3.4 Page Assembly

Oracle Content Server uses information from the files in the IdcHomeDirresources directory to assemble dynamic web pages. ■ The structure and format of a web page is defined by a particular HTML template file in either the resourcesadmintemplates directory or the resourcescorereports directory. ■ The templates reference resources, which are located in .htm and .idoc files in subdirectories of the resources directory. Resources can include HTML and Idoc Script markup, localized strings, queries to gather information from the database, and special code to conditionally format the information. Oracle UCM Architecture 2-13 As a rule, each web page includes the following resources: ■ A standard page header ■ A standard page beginning ■ A standard page ending Because all of the Oracle Content Server resources are cached in memory at startup, Oracle Content Server has a definition for the standard pieces that appear on the page. Oracle Content Server then combines the standard resources with the unique resources specified in the template to create the web page. For dynamic server pages, the template page and custom resource files are checked into Oracle Content Server. When one of these pages is requested by a web browser, Oracle Content Server recognizes the file extension as a dynamic server page, which enables special processing. At that point, the page assembly process is the essentially the same as the standard process, except that the page can use both the standard resources in the resources directory and the custom resources that are checked in to Oracle Content Server.

2.3.5 Database Interaction

Some databases, such as Oracle Database, return all column names in uppercase characters. Therefore, when Oracle Content Server receives query results from these databases, column names must be mapped from the uppercase characters to the values used in Oracle Content Server. Because of this case mapping issue, custom components created for an Oracle Content Server instance using one database might not work correctly on an Oracle Content Server instance using a different database. To map column names, the IdcHomeDirresourcescoreresourcesupper_clmns_ map.htm file contains a mapping table named ColumnTranslation. Add the query values to this file when you create a component that accesses fields that are not Oracle Content Server database fields for example, if you create a component that accesses a custom table within the Oracle Content Server database. For information about using the upper_clmns_map.htm file, see Section 5, Modifying System Functionality.

2.3.6 Localized String Resolution