Subscribe to News feed

Fine tuning the PDF Converter for SharePoint using STSADM commands

Posted at: 18:15 on 15 August 2012 by Muhimbi

Command Line

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 meta-data 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 meta-data 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 meta-data. For example the following command will make sure that the Title and User fields are never copied (unless explicitly listed in the Copy Meta-Data 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

Labels: , ,


Post a Comment

Subscribe to Post Comments [Atom]

Links to this post:

Create a Link

Need support from experts?

Access our Forum

Download Free Trials