# Office Suite

## PDF Generator

| ### Agile PLM Office Suite PDF Service
| The enhanced PDF Generator is set up as a service and does not need to be set up on a special client!
| The PDF Generator can be installed with the Windows Installer tool. After the PDF Generator is installed, an extra service is added to the services list. Agile PLM Office Suite PDF (Control Panel > Administrative Tools > Services).
| The Agile PLM Office Suite PDF service is a MS Windows service and does not need any GUI.
| Once the service is running, it should not be stopped via the Windows Service Manager. To stop the service, select shutdown in the no-select menu of the PDF job list!
| This operation sets the Office Suite configuration parameter GDM_PDF_BATCH to STOP. The LogiView procedure GdmBatch/Spooler checks the parameter and shuts down. During the shutdown of the spooler, the Office Suite configuration parameter GDM_PDF_BATCH is set to RUN again.
| ### Setup the Agile PLM Office Suite PDF Service
| This needs to be done manually at the moment!
| The Agile PLM Office Suite PDF service does require some information about the local environment, e.g. the exchange file between the PDF printer and Agile e6.
| The configuration file of the Agile PLM Office Suite PDF Service has corresponding settings within the Agile e6 Office Suite configuration (System > Office Suite > Configuration).
| Example Agile server settings:
Description | Value
PLM Host | plmhost
PLM ECI Port | 20001
PLM Environment | plmref
| Example Agile PLM Office Suite PDF service:
Description | Value
Installation directory | C:\Program Files\Agile_e6\Office Suite PDF
PDF service name | pdfsrv
Working directory | C:\officesuite\pdf_generation
| Example configuration table:
Description | Configuration File | Configuration Setting
GDM_PDF_BATCH | RUN | STOP
| ### Setup the PDF Generator
| To set up the PDF printer (Manager > Office Suite > PDF Printer), select the PDF printer from the printer list.
| As soon as the PDF printer is selected, the following Office Suite configuration parameters are added to the configuration file OfsPdf.properties (%EP_ROOT%/Office Suite PDF/pdf):
| GDM_PDF_BATCH GDM_PDF_DIRECTORY (The value of this configuration parameter has to be the same as the value for TEMP in the OfsPdf.properties file. Add "\*.pdf" at the end of it). GDM_PRINTER GDM_PRINTER_DRIVER GDM_PRINTER_PORT
| GDM_PRINTER, GDM_PRINT_DRIVER, GDM_PRINTER_PORT are set automatically!
| This is a section of the OfsPdf.properties file:
| host=<PLM host name> port0=<PLM eci port> env=<PLM environment name> varenv.ep_root=<PDF service root> varenv.axalant_root=<PDF service binary root> varenv.EP_MACH=intel-ms-nt5.0 varenv.CLI_HWS=intel-ms-nt5.0 varenv.CLI_HST=<Client host name> varenv.CLI_SRV=<PLM host name> varenv.$TMP=<PDF file exchange folder> client1=<Connect information>
| The value for the Office Suite configuration parameter GDM_ARC_NOD has to be the same as the value for varenv.CLI_HST in the Ofs.Pdf.properties file.
| In the Ofs.Pdf.properties file the following has to be set as well:
| host (e.g. plmhost) port (e.g. 20001) env (e.g. plmref)
| In the Ofs.Pdf.properties file the correct user has to be entered under "client1".
| The PDF Generato has to be linked to the respective transition states for the STD-DOC lifecycle (e.g. for Released with Change Management activated and for Released without Change Management activated).
| Thus, when an Office Suite document reaches this state, a PDF is created automatically.
| Add "GdmBatch/Archiv" to the respective states in the Lifecycle mask.
| After updating the lifecycle states, the client needs to be restarted!
| For every file type for which a PDF should be created, the Creative archive format checkbox has to be selected in the File type mask.
| The PDF generation can only be used for file types of the storage type "Single"!

###

> ###

###