Document Converter Run Command
For your custom document to function properly within Microsoft Office SharePoint Server 2007, it must be able to be called using the following command line command:
documentConverterName.exe
–in "Path To File" –settings "Path To Settings File"
–out "Directory For Output Files" –log "Path To Log File"
The DocConversionLauncherService service uses this command to call each document converter.
Important
Office SharePoint Server 2007 passes each parameter of the run command to the document converter, even if that parameter is null. Any null or empty string passed to the converter as a parameter is interpreted by the converter as the path to a file that does not exist. Converters must be able to handle this possibility. For example, a call to Microsoft.SharePoint.SPFile.Convert that specifies null or an empty string for the configuration information results in a call to the converter where the –config parameter points to a file that does not exist. The converter must be able to distinguish between null or empty file paths, which denote that no file exists for this parameter, and file paths that are specified but invalid.
For more information about the DocConversionLauncherService service, see Services Necessary for Document Conversion.
Following are the parameters and their definitions.
-in
Required String. Represents the full path to the original file from which a converted copy is to be generated.
-settings
Optional String. Represents the full path to a file containing custom configuration settings for the document converter. The DocConversionLauncherService service writes the contents of the configInfo argument to disk, and then uses this parameter to point to that file.
-out
Required String. Represents the full path to the location where the converted copy should be placed.
-log
Optional String. Represents the full path to a log file which the document converter can use to communicate errors and other general information about the conversion of this particular file.