MAIL


Mapping MIME types to file extensions
IBM® Lotus® Domino™ uses File identification documents in the Domino Directory to associate file types and their file name extensions with MIME types and subtypes. For example, a File identification document for JPEG files classifies files with the extension JPG as having the MIME type image and MIME subtype jpeg. Domino servers and IBM® Lotus® Notes® clients use the information in the File Identification documents to map file types to file extensions and vice versa on inbound and outbound mail.

This ensures that the contents of attached files are correctly interpreted by the recipient's mail client. Upon opening the message in a MIME-aware mail program, the recipient can open the attached document from within the message, provided that the mail program recognizes the MIME type and the associated application is installed on the recipient's computer.

You can add, modify, or delete File Identification documents from the Domino Directory. Add new documents to support additional file types. When adding a new File Identification document, you must know the MIME type for the application and the file extension associated with the application. Modify a File Identification document in the event that a default mapping is incorrect or later standards dictate a change. You might also edit a File Identification document to specify which of multiple MIME types and subtypes Notes and Domino assign to files with a given file extension when sending outbound mail.

How Domino uses File Identification documents when processing inbound mail
When receiving an inbound MIME message that includes a file attachment, Domino reads the MIME headers to determine the name and type of the attached file. If, however, the MIME headers do not specify the name of the attached file, Domino must assign a name to the file that is both unique within the document and includes the appropriate file extension. To determine the file extension to use in creating the file name, Domino refers to the File Identification documents in the Domino Directory.

For example, if Domino receives a message that has a MIME header indicating that it contains a Microsoft Word attachment (MIME type/subtype of application/ms-word), but neither the content-type header or content-disposition header specify a file name, the server has to provide a name for the attachment. To ensure that Domino creates a name using the correct file extension for a file of this type, the server checks the Domino Directory for a File Identification document for this file type and subtype, and then checks the "Extension" field of the matching document. Because, by default, the only document that matches files with the MIME type application/ms-word indicates that the file uses the extension DOC, Domino creates a file name using this extension.

By default, the File Identifications view of the Domino Directory lists multiple documents for a given MIME type/subtype alphabetically, by file extension. For example, by default, Domino includes several File Identification documents for the MIME type/subtype application/vnd.lotus-1-2-3, and the default view lists these from top to bottom, beginning with the document that specifies the extension 123 and proceeding through those that specify the extensions unknown, WK2, WK3, WK4, and WKS. This list order determines how Domino names files when receiving a message containing an unnamed file attachment with one of these MIME types. When creating the file name, the server uses the information in the first document that appears alphabetically in the view. Thus, when a server receives an inbound message that includes an unnamed file attachment with the MIME type/subtype application/vnd.lotus-1-2-3, Domino names the file using the extension 123, because the File Identification view lists the document specifying this extension before the other documents that describe the same MIME type/subtype.

How Domino uses File Identification documents when processing outbound mail
Domino servers and IBM® Lotus® Notes® clients both use File Identification documents when sending MIME messages that include file attachments. In both cases, information in the document is used to specify the MIME content type of the message attachment.

Domino servers use File Identification documents when converting messages that include file attachments from Notes rich-text format to MIME format for sending over SMTP. When converting an outbound message that includes a file attachment, Domino first searches for a File Identification document that corresponds to the file extension of the attachment. After locating the correct document, Domino uses the MIME type and subtype information from the document to construct the MIME Content-type header for the message part that describes the attachment.

When a Notes client attaches a file to a message it sends in MIME format (for example, when sending to Internet recipients or to Notes mail recipients whose mail storage preference is set to MIME), the client first checks the operating system to determine what file associations are defined. Clients running on Microsoft® Windows® check the Windows registry, while clients running on the Macintosh check Internet Config. If the client cannot locate MIME type information from these sources, it then checks the Domino Directory for a File Identification document that applies to files with the same extension as the attached file. After locating the correct document, the client places the MIME type and subtype information from the document in the MIME header describing the attachment.

In the case of both servers and client, if more than one File Identification document applies to a given file extension, the setting in the "Outbound" field of the documents determines which MIME type and subtype to assign to file attachments with this extension when sending mail.

To create or modify a File Identification document

1. From the Domino Administrator, click the Configuration tab and expand the Messaging view.

2. Click File Identifications.

3. To add a new File Identification document, click Add File Identification.


4. Complete the following fields:
FieldDescription
MIME typeGeneral MIME category used to describe files of this content type or media; for example, application, audio, image, or video. When sending attachments in MIME messages, the information in this field is placed in the MIME Content-type header.

Each MIME type/subtype combination can be mapped to zero or more file extensions.

MIME subtypeThe specific MIME category that uniquely identifies the application that created files of this content type, for example, X-Lotus-NSF. When sending attachments in MIME messages, the information in this field is placed in the MIME Content-type header.

Each MIME type/subtype combination can be mapped to zero or more file extensions.

File extensionThe Microsoft® Windows® or UNIX® file name extension associated with files of this type; for example, JPG, BMP, or NSF.

The Domino Directory can contain multiple File identification documents for a given file extension.

If the MIME headers of an inbound message do not specify the name of an attached file, Domino creates a file name for the attachment using this extension.

DescriptionUse this field to specify the type of file or the name of the application used to create and open the file.
OutboundIf the Domino Directory contains multiple File Identification documents for files with this file extension, this setting determines which MIME type and subtype Notes and Domino use to send file attachments with this extension.

Note Notes clients also use settings in the Microsoft® Windows® registry or the Macintosh Internet Config object to determine the MIME type and subtype to associate with a given file extension.

Choose one:

  • Send - When sending outbound messages in MIME format, Domino assigns this MIME type and subtype specified in this document to attachments that have this file extension. If there are multiple File Identification documents for a given file extension, select this option for one document only. If the value in this field is set to Send in multiple File Identification documents for a given file extension, Domino uses the first document listed in the File Identifications view to set the MIME information for attachments with the extension.
  • Do not send - When sending outbound messages to MIME format, Domino does not assign the MIME type and subtype specified in this document to attachments that have this file extension. If there are multiple documents for a given file extension, specify this option in the Outbound field in all but one of the documents.
See also