File Content Extraction 26.3
Filter SDK Java Programming Guide

# Default File Names for Extracted Subfiles

When a file name is not specified in the call to `extExtractSubFile`, in some cases, a default file name is applied to the extracted subfile.

## Default File Name for Mail Formats

To avoid naming conflicts and problems with long file names, File Content Extraction applies its own names to the extracted mail folders and mail items when a name is not supplied in the call to `extExtractSubFile`. A non-mail attachment retains its original file name and extension.

When the contents of a mail store or the message body of a mail message are extracted, the extracted file names might include the following:

- The first valid eight characters of the original folder name or "Subject" line of the mail message. If the "Subject" line is empty, the characters `kv` `ext` are used, where `ext` is the format’s extension. For example, the characters would be "`kvmsg`" for MSG, and "`kvnsf`" for NSF.

  The following special characters are considered invalid and are ignored:

  any non-printing character with a value less than `0x1F`
  angle brackets (< >) | double quotation mark (")
  asterisk (*) | forward slash (/)
  back slash (\) | pipe (|)
  colon (:) | question mark (?)

  For notes, the file name is derived from the first 24 characters of the note text. For contact entries, the file name is derived from the full name of the contact.

- The characters `_kv` `n`, where `n` is an integer incremented from 0 for each extracted item.

- One of the following extensions:

  Type | File Extension
  email message | `.mail`
  calendar appointment | `.cal`
  contact entry | `.cont`
  task entry | `.task`
  note | `.note`
  journal entry | `.jrnl`
  distribution list | `.dist`
  posting note | `.post`

  If the type cannot be determined for an MSG or PST file, the file is given a `.mail` extension.

  If the type cannot be determined for an NSF file, the file is given a `.tmp` extension.

For example, an MSG mail message with the subject line "`RE: Product roadmap`" that contains the Microsoft Excel attachment `release_schedule.xls` is extracted as

    RE produ_kv0.mail

    release_schedule.xls

If an extracted message contains an embedded OLE object or any attachment that does not have a name, the object or attachment is extracted as `_kv``#``.tmp`.

## Default File Name for Embedded OLE Objects

File Content Extraction can apply a default name to an extracted embedded OLE object when a name is not supplied in the call to `extExtractSubFile`. When an embedded OLE object is extracted, the extracted file name might include the following:

- The first valid eight characters of the main file. The following special characters are considered invalid and are ignored:

  any non-printing character with a value less than `0x1F`
  angle brackets (< >) | double quotation mark (")
  asterisk (*) | forward slash (/)
  back slash (\) | pipe (|)
  colon (:) | question mark (?)

- The characters `_kv` `n`, where `n` is an integer incremented from 0 for each extracted object.

- If File Content Extraction can determine the embedded OLE is a Microsoft Office document, the original extension is used. If the file type cannot be determined, the file is given a `.tmp` extension.

For example, let us say a Microsoft Word document (`sales_quarterly.doc`) contains two embedded OLE objects: a Microsoft Excel file called `west_region.xls`, and a bitmap created in the Word document. The embedded objects would be extracted as

    sales_qu_kv0.xls

    sales_qu_kv1.tmp

Copyright 1997-2026 Open Text
Version 26.3 | Last updated July 2026

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: File Content Extraction 26.3

Topic Title: Default File Names for Extracted Subfiles