Add the Converter Interface
Copy
You can implement the following two interfaces for the converter class. This example uses the VaultFileConverter interface:
- IConverter: Used in cases where the code should download the necessary files rather than automatically download these files from the Aras Innovator vault. The main Convert function is as follows in this interface:
public IList<FileConversionResult> Convert(ConversionContext context)
- VaultFileConverter: Used in cases where all the files that are required for the conversion are located within the Aras Innovator vault. The main Convert function is as follows in this interface:
protected override IList<FileInfo> Convert(IDictionary<string, System.IO.FileInfo> filePaths)
You need to edit the MyWordConverter class in the example project to implement the desired interface:
…
namespace MyWordConverter
{
public class MyWordConverter : VaultFileConverter
{
#region Overrided Protected Methods
…
The primary method used for the conversion is the Convert method. This method should take in the past data for the conversion and return a list of the converted files in the format ‘List<FileInfo>‘.
The basic design of the Convert method is as follows:
- Create a list of IDs of the File Items that must be downloaded from Aras Innovator. This is done by the VaultFileConverter interface.
- Download all files within the list defined in 1. This is done by the VaultFileConverter interface.
- Pass the downloaded file(s) as well as other parameters to the third-party conversion tool.
- Read the result from the third-party conversion tool.
- Generate a list of the resulting converted files that contain the ID and the ‘kind’ of each uploaded File Item. The ‘kind’ is used in the onAfterConvert event of the Conversion Task to identify where to use each uploaded file.
- Upload the new files to the Aras Innovator vault, creating new File Items for each file. This is done by the VaultFileConverter interface.
This example uses the VaultFileConverter interface. In addition to adding code to the Convert method, we need to override the Dispose and GetFileKind methods of the VaultFileConverter.
For this example, the Dispose method can be left empty.
The GetFileKind method must return a string that represents the resulting file’s type. This string sets in the Results tab of the Conversion Task Item.
The full sample code is available in Appendix B.
namespace MyWordConverter
{
public class MyWordConverter : VaultFileConverter
{
#region Overrided Protected Methods
protected override void Dispose(bool disposing)
{
}
protected override string GetFileKind(FileInfo file)
{
if (file == null)
{
throw new ArgumentNullException("file");
}
switch (file.Extension.ToUpperInvariant())
{
case ".PDF":
return "pdf";
default:
return String.Empty;
}
}
protected override IList<FileInfo> Convert(IDictionary<string, FileInfo> filePaths)
{
// Do the actual conversion ...
List<FileInfo> returnList = new List<FileInfo> { };
Application wordApplication = new Application();
Document wordDocument = null;
object paramSourceDocPath = filePaths[Context.ConversionTask.FileID].FullName;
string fileExt = filePaths[Context.ConversionTask.FileID].Extension;
object paramMissing = Type.Missing;
// Retrieve the settings from the ConversionServerConfig xml file
MyWordConverterConfig configuration = (MyWordConverterConfig)ConversionConfigurationManager.GetInstance().GetConverterConfiguration().GetSection("ConverterSettings/MyWordConverter");
string pdfSuffix = configuration.Settings.PdfSuffix;
string paramExportFilePath = filePaths[Context.ConversionTask.FileID].FullName.Replace(fileExt, pdfSuffix + ".pdf");
FileInfo returnItem = new FileInfo(paramExportFilePath);
WdExportFormat paramExportFormat = WdExportFormat.wdExportFormatPDF;
bool paramOpenAfterExport = false;
WdExportOptimizeFor paramExportOptimizeFor = WdExportOptimizeFor.wdExportOptimizeForPrint;
WdExportRange paramExportRange = WdExportRange.wdExportAllDocument;
int paramStartPage = 0;
int paramEndPage = 0;
WdExportItem paramExportItem = WdExportItem.wdExportDocumentContent;
bool paramIncludeDocProps = true;
bool paramKeepIRM = true;
WdExportCreateBookmarks paramCreateBookmarks = WdExportCreateBookmarks.wdExportCreateHeadingBookmarks;
bool paramDocStructureTags = false;
bool paramBitmapMissingFonts = true;
bool paramUseISO19005_1 = false;
object objMissing = System.Reflection.Missing.Value;
object objConfirmConversions = false;
object objReadOnly = true;
object objAddToRecentFiles = false;
object objPasswordDocument = objMissing;
object objPasswordTemplate = objMissing;
object objRevert = true;
object objWritePasswordDocument = objMissing;
object objWritePasswordTemplate = objMissing;
object objFormat = WdOpenFormat.wdOpenFormatAuto;
object objEncoding = 20127;
object objVisible = false;
object objOpenConflictDocument = false;
object objOpenAndRepair = false;
object objDocumentDirection = WdDocumentDirection.wdLeftToRight;
object objNoEncodingDialog = true;
object objXmlTransform = objMissing;
object ofalse = false;
wordDocument = wordApplication.Documents.Open(ref paramSourceDocPath,
ref objConfirmConversions, ref objReadOnly, ref objAddToRecentFiles,
ref objPasswordDocument, ref objPasswordTemplate, ref objRevert,
ref objWritePasswordDocument, ref objWritePasswordTemplate,
ref objFormat, ref objEncoding, ref objVisible, ref objOpenAndRepair,
ref objDocumentDirection, ref objNoEncodingDialog, ref objXmlTransform);
// Export it in the specified format.
if (wordDocument != null)
wordDocument.ExportAsFixedFormat(paramExportFilePath,
paramExportFormat, paramOpenAfterExport,
paramExportOptimizeFor, paramExportRange, paramStartPage,
paramEndPage, paramExportItem, paramIncludeDocProps,
paramKeepIRM, paramCreateBookmarks, paramDocStructureTags,
paramBitmapMissingFonts, paramUseISO19005_1,
ref paramMissing);
// Quit Word and release the ApplicationClass object.
if (wordApplication != null)
{
wordApplication.Quit(ref paramMissing, ref paramMissing,
ref paramMissing);
wordApplication = null;
}
returnList.Add(returnItem);
return returnList;
}
#endregion
…