Fine tuning the PDF Converter for SharePoint using STSADM commands

Related Products

PDF Converter

PDF Converter


Wherever possible the PDF Converter for SharePoint uses a fancy SharePoint User Interface for specifying settings. However, some settings are so infrequently used that creating special screens for them just leads to confusion.

Instead we provide a number of ‘ stsadm’ commands to tweak these settings. This post lists all available settings. They all use the standard ‘ STSADM – o setproperty’ syntax. Please note that the value can be deleted by specifying nothing after the ‘-pv’ switch.

Please note that all these settings are global and apply to all Web Applications and Site Collections.

Alternative Check-in Behaviour (version

The default behaviour of the PDF Converter’s SharePoint front end is to always check-in files on document libraries that don’t explicitly require a check-out to be performed first, even when mandatory data is missing. If this is not desirable and you wish files with missing metadata to remain checked out then issue the following command on one of your farm’s SharePoint servers:

stsadm.exe -o setproperty -pn Muhimbi.SharePoint.DocumentConverter.PDF.CheckOutWhenRequiredFieldsEmpty -pv true

Skip certain fields when copying meta-data (version

The PDF Converter for SharePoint provides a number of facilities to copy metadata between files. Although we automatically skip certain fields, including calculated fields, some custom fields you may never want to copy. This very much depends on your own requirements, but suffice to say that you can specify a list of fields to ignore when copying metadata. For example the following command will make sure that the Title and User fields are never copied (unless explicitly listed in the Copy Metadata workflow activity, requires 7.0).

stsadm.exe -o setproperty -pn Muhimbi.SharePoint.DocumentConverter.PDF.SkipMetaDataFieldNames -pv Title;User

Always send PDF files to the Conversion Service (version

By default Muhimbi’s SharePoint front end software does not send any files that are already in PDF format to the conversion server. If you have written a custom converter that requires PDF files to be sent to the conversion server then execute the following command:

stsadm.exe -o setproperty -pn Muhimbi.SharePoint.DocumentConverter.PDF.SkipPDFFiles -pv false

Specify HTML Conversion delay for Personal Actions menu (version 8.4+)

Due to the way SharePoint internally renders web pages, the Muhimbi Web Page to PDF Converter waits 2 seconds between loading the page and converting it to PDF. This value can be tweaked using the following stsadm command (Values in milliseconds, so specify 5000 for 5 seconds).

stsadm.exe -o setproperty -pn Muhimbi.SharePoint.DocumentConverter.PDF.WebPageConversionDelay -pv 5000

Labels: Articles, PDF Converter

Have a Question?
We’re Always Happy to Help.

© Muhimbi Ltd. 2008 - 2023
This website uses cookies to ensure you get the best experience. Learn more