Internal Service Requests External Service Requests Request Parameters

2-2 Oracle Fusion Middleware Services Reference Guide for Oracle Universal Content Management

2.1.1.1 Internal Service Requests

Although any service can be called internally, typically only administrative services are called internally. Internal service requests are made from within the Oracle UCM system itself, and results are returned only to the Oracle UCM system. For example, you can use the START_SEARCH_INDEX service to update or rebuild the search index automatically in a background thread.

2.1.1.2 External Service Requests

Any external program or HTML page can call any Oracle UCM service to request information from the Oracle UCM system or perform a specified function, such as full-text and metadata searching, library services, workflow services, subscription notifications, and content conversion capabilities. Typically, only client services are called externally administrative services are typically called internally. For example, when you click a Search link on an Oracle Content Server web page, the standard search page is delivered to your web browser by the GET_DOC_PAGE service using the following URL segment: IdcService=GET_DOC_PAGEAction=GetTemplatePagePage=STANDARD_QUERY_PAGE External requests are sent from a client for example, a web browser to the Web server using one of many protocols. The service call must include any parameters that the service requires. The Web server routes the service request to the Oracle UCM system, along with any required and optional parameters. The Oracle UCM system then executes the service using the provided parameters. In the case of search services, this involves sending a search request to the search engine. The Oracle UCM system then returns the results to the Web server, and the Web server returns the results to the web browser client. Figure 2–1 External Requests and Responses Between Content Management System Elements Using Services 2-3

2.1.1.3 Request Parameters

A service request must include every parameter that the service requires. For example, when calling the DOC_INFO service to obtain information about a content item, the service call must provide the dID generated content item revision identifier to the service. The following segment shows how this would be done through a persistent URL: http:cs.example.comcsidcplg? IdcService=DOC_INFOdID=194

2.1.1.4 Date and Time Formatting