ProjectWise Administrator Help

Configuring File Extension Mappings for a Document Processor

The File Type Associations tab of a document processor's Properties dialog is used to either exclude specified file types from being processed, or include file types that would not normally be processed by mapping them to a recognized extension.

Exclusion list — Each document processor will try to process all document types, whether the processor can process them or not, unless they are part of the exclusion list. This means that a processor may be trying to process a file whose type it cannot actually process. To avoid this problem and improve performance, you can create an exclusion list of the file types that you want each processor to automatically skip at runtime.

Inclusion list — In some cases, you may need to ensure that documents whose files have non-standard extensions are included in the extraction. For example, no configuration is necessary on this tab if you want to extract thumbnail images from MicroStation documents whose files have the extension .DGN. However, if you want to extract thumbnail images from MicroStation sheet files (extension .SHT), you would need to map the extension SHT to the recognized extension DGN, so that all MicroStation sheet files will be extracted and processed accordingly.

Note: To be able to extract text from DWG documents, you must create an extension mapping rule that maps the DWG file extension to the file type DGN.
Note: For file properties extractions, as long as the files being processed are structured COM storages, the files' properties will be extracted successfully, regardless of any non-standard file extensions. For example, a Microsoft Word document having the extension ABC instead of DOC will still be extracted successfully.

Create an Inclusion List of File Types To Process

  1. Open the Properties dialog for a document processor.
  2. Select the File Type Associations tab.
    Note: The file type extensions POD and PTX and the application 'Point Cloud' are already added and set to <do not process>.
  3. Click Add.

    The New File Association dialog opens.

  4. Leave the Application list set to <any>, or select an application if you want to limit the documents to be processed to only those associated to that application.
  5. In the Extension field, type the extension you want to map to another extension.

    Enter the extension without the period, for example: dwg

  6. Select Process the files as if they have the following extension, and then type the extension you want to map the previous extension to.

    Enter the extension without the period, for example: dgn

  7. Click OK.

    The new association is added to the File Type Associations tab. You can click Add again to identify more file types you want to map to other file types. You can also select existing associations and click Modify or Remove to edit or delete a particular mapping, respectively.

  8. In the Properties dialog, click OK.

    This image shows that any documents having the DWG file extension, regardless of the application the document is associated to, will be processed as if they were DGN documents when full text indexing extractions occur.

Create an Exclusion List of File Types Not to Process

  1. Open the Properties dialog for a document processor.
  2. Select the File Type Associations tab.
    Note: The file type extensions POD and PTX and the application 'Point Cloud' are already added and set to <do not process>.
  3. Click Add.

    The New File Association dialog opens.

  4. Leave the Application list set to <Any>, or select an application if you want to limit the documents not to be processed to only those associated to that application.
  5. In the Extension field, type the extension you do not want to be processed.

    Enter the extension without the period, for example: doc

    This table lists the file types that each processor cannot process, and therefore should be added to the processor’s exclusion list. Note that these are not the only file types you can add to the exclusion list. For example, the Full Text Indexing processor can process XLS documents, but if you do not want them to be processed, then you can add XLS to the exclusion list.

    Document Processor Some File Types You Should Add to This Processor’s Exclusion List
    Full Text Indexing AI, AVI, BAK, DAT, DMP, ECW, EXE, FLV, HMR, ISO, MDB, MP2, MP3, MPEG, MPEG4, PSD, PST, RM, RVT, TIF, TIFF, VHD, VMDK, WAV, ZIP
    Thumbnail Extraction AI, AVI, BAK, ECW, EXE, FLV, HMR, ISO, MP2, MP3, MPEG, MPEG4, PSD, PST, RM, VHD, VMDK, WAV, ZIP
    File Property Extraction AI, AVI, BAK, DAT, DMP, ECW, EXE, FLV, HMR, ISO, MDB, MP2, MP3, MPEG, MPEG4, PSD, PST, RM, VHD, VMDK, WAV, ZIP
  6. Select Do not process these documents.
  7. Click OK.

    The new association is added to the File Type Associations tab. You can click Add again to identify more file types you do not want to be processed. You can also select existing extensions and click Modify or Remove to edit or delete them as needed.

  8. In the Properties dialog, click OK.

    This image shows that documents associated to the Microsoft Excel application and having the XLS extension, and documents associated to the Microsoft Word application and having the DOC extension, will not be processed when thumbnail extractions occur. The result being that documents of those types will not have thumbnail images displayed in the interface.