Setting Up Document Comparisons and Rendering

To use the compare and render features, perform these steps on your Microsoft Windows device:

1. Ensure that PeopleTools is installed on a Microsoft Windows machine.

   The PeopleTools installation on this machine must have the file %PSHOME%/BIN/SERVER/WINX86/ CSDOCUTIL.DLL. This file enables server-side processing of Microsoft Word files.

2. Create an application server domain.

3. If you select the Enable Rendering .doc check box on the Installation Options - Supplier Contract Management Page, then you need to ensure that the same machine has Microsoft Word installed on it.

   The CSDOCUTIL program interacts with Microsoft Word on the machine.

   • If you are using Microsoft Word 2010 or a later version, then you do not need this add-in.

   • If you are using Microsoft Word 2007, then you need to download a Microsoft add-in to save as a PDF or XPS.

     Access this website.

4. If you select the Enable Rendering .pdf check box on the Installation Options - Supplier Contract Management Page, then you need to select Adobe (Word) in the Signature Method field even if you do not plan to implement digital signatures. 

   The system relies on this option to determine whether to use Adobe Acrobat or Microsoft Word to render a PDF. You can then disable digital signatures. Otherwise, if Adobe (Deprecated) is selected as the Signature Method, the system requires Adobe Acrobat to be installed on the Windows machine.

5. Configure the Integration Gateway if it is not already configured for the database.

   The integration gateway is a platform that manages the receipt and delivery of messages that are passed among systems through PeopleSoft Integration Broker. For additional information, see "Managing Integration Gateways," PeopleTools: Integration Broker.

6. Activate the CS_DOC_ACTION service operation.

   This service operation is a synchronous operation and serves as the integration that handles all requests to the Document Utilities library. Using the library, the system converts documents to a .doc format and enables the comparison of documents using the Document Management page.

   To activate the service operation:

   1. Select PeopleTools, and then Integration Broker, and then Integration Setup, and then Service Operations.

   2. Select CS_DOC_ACTION in the Service Operation field.

   3. Click Search.

      The service operation appears in the search results.

   4. Click the Service Operation link.

      The Service Operations page appears with the service operation definition. The definition consists of general information about an operation, such as its name and alias if one has been defined. It also specifies an operation type, which determines how the operation is to be processed, synchronously or asynchronously. The CS_DOC_ACTION operation is processed synchronously, meaning that the system waits for a response to the message. In addition, the service operation definition contains routings, which determine the direction, inbound or outbound, of the service operation. A service operation has one or more handlers, which contain and run the programming logic for sending or receiving the message and manipulating message content.

      See Incoming and Outgoing Request Flows, "Understanding PeopleSoft Integration Broker," and "Managing Service Operations,"PeopleTools: Integration Broker.

   5. Ensure that the Active check box is selected in the Default Service Operation Version group box.

      If the version that you want is not the default version for the service operation, the default version must also be activated.

   6. Select the Handlers tab.

      The page provides summary information about handlers that have been added to an operation. Two individual server processes work together to handle incoming requests. One server process functions as a dispatcher, and the other functions as a handler. You can specify an application class as a handler for a service operation. The CS_DOC_ACTION uses an application class handler. For additional information, see "Sending and Receiving Messages,"PeopleTools: Integration Broker.

   7. Ensure that Active is selected in the Status field on the Handlers tab.

   8. Click the Save button.

7. Complete the fields in the Document Compares & Rendering section on the Installation Options - Supplier Contract Management Page.