File Format Names for New
OASIS OpenDocumentXML Format and OOo Extensions

OpenOffice 2.0/StarOffice 8

Document - ID	Specification Owner	Last Change	Status
	Frank Loehmann	23.08.06	Final
Conforms to	
Applies to	All modules
Task ID(s)	20153, 30705, 117223, 118415, 80206
Category	Feature

Abstract

OpenOffice.org (OOo) 1.1 and StarOffice (SO) 8 are using the new OASIS OpenDocument XML Format as their default file format.

The OASIS OpenDocument XML Format has been developed and standardized by the OASIS OpenDocument XML Format Technical Committee (TC). Support of the OASIS OASIS OpenDocument XML Format has also been announced by Koffice.

New extensions are used to be able to divide the new from the old format and to prevent loading file with new format in an earlier released OOo 1.1. The new file names are the same regardless of the product vendor. So OOo and SO files are called the same.

i-Team Members (The specification owner is part of the i-Team)

	Name	E-mail Address
User Experience	Frank Loehmann	frank.loehmann@sun.com
Development	Michael Brauer	michael.brauer@sun.com
Quality Assurance	Thorsten Martens Joerg Sievers	thorsten.martens@sun.com joerg.sievers@sun.com
Documentation	Uwe Fischer	uwe.fischer@sun.com

Approved for Implementation

	Approved by	Date
User Experience	Frank Loehmann	11/11/04
Development	Michael Brauer	07/26/04
Quality Assurance	Joerg Sievers	08/02/04
Documentation	Uwe Fischer	07/20/04
String Review	Elizabeth Matthis	07/30/04

Document Change History

Rev. Level	Change	Initials	Date
1.0	Initial Draft of Spec.	FL	06/23/04
1.1	Finalize Specification	FL	07/20/04
1.2	Add new mime type	FL	08/02/04
1.3	Moved mime type to future section	FL	08/11/04
1.4	Add extension for Chart	FL	28. Sept. 2004
1.5	Change Extension and Format Name	FL	29. Oct. 2004
1.6	Change Name and Extension to OpenDocument	FL	11.11.04
1.7	Add Section 7.3 Application Group Filter	FL	11/26/04
1.8	Change mime type for Drawing (into graphic)	FL	11/30/04
1.9	Add section for Add Templates dialog to templateorganizer	FL	12/07/04
2.0	Change base mime type	FL	04.05.05
2.1	Added .oxt extension for OOo 2.0.4	FL	23.08.06
2.2	Correct OpenOffice -> OpenOffice.org for .oxt	FL	24.09.07
2.3	Add flat odf filters	FL	24.09.07

Contents

Glossary	1

1	Motivation	1

2	User Scenarios	1

3	Goals	1

4	Requirements and Dependencies	2

4.1	Requirements	2

4.2	Technical Dependencies	2

5	Competitive Analyses	2

5.1	Extension Check	2

5.2	Microsoft Office XML Format	3

6	Detailed Specification	4

6.1	New Extensions for OOo 2.0 and SO 8	4

6.2	Non Default Format Warning	5

6.3	Export in OpenOffice 1.0-1.1.x / StarOffice 6.0-7 Format	6

Export Filter	6

Position of the Export Filters in Save / Open Dialog	6

6.4	G11n	6

6.5	Error Conditions	6

6.6	Migration	6

Document Samples and Templates	6

AutoText	6

7	Future Tasks	7

7.1	Mime Types (##FL: This issue will be addressed within system integration task i32277 and i32276)	7

7.2	XSLT Filter Dialog (Task ID: 118610)	8

7.3	Add new OASIS Default Format Filter to Application Group in File Open Dialog (fix after Beta release) (Issue i37961)	9

7.4	Add New Template Extensions to Import Templates Dialog (Task ID: 37958)	9

8	Notes	11

9	References	11

Glossary

Term	Description
OASIS	OASIS (Organization for the Advancement of Structured Information Standards) is a not-for-profit, international consortium that drives the development, convergence, and adoption of e-business standards. The consortium produces more Web services standards than any other organization along with standards for security, e-business, and standardization efforts in the public sector and for application-specific markets. Founded in 1993, OASIS has more than 3,000 participants representing over 600 organizations and individual members in 100 countries. http://www.oasis-open.org/who/
XML namespaces	XML namespaces provide a simple method for qualifying element and attribute names used in Extensible Markup Language documents by associating them with namespaces identified by URI references.

Motivation

The OASIS OpenDocument XML Format TC uses the OOo format that is used by OOo 1.0 / OOo 1.1.x / SO 6.0 / SO 7 as basis for its work. OASIS OpenDocument XML will be very similar to that format.

The OOo and the OASIS OpenDocument XML formats are not compatible because the XML namespace URLs used in both formats to uniquely identify the files as either OOo or as OASIS Open Office files obviously have to be different. This for itself has the consequence that application prepared to read OOo file won't read OASIS Open Office file and vice versa.

Due this incompatibility SO 8 and OOo 2.0 will use new file extensions and file names in the UI for the default file format which and offers an export into the previous OOo 1.0, OOo 1.1.x / SO 6.0 / SO 7 format. Furthermore a patch for OOo 1.x and SO 7 will be provided to add reading support for the new file format.

For detailed information about the file format transition, please see the following specification (internal):

http://staroffice-doc.germany.sun.com:8080/Teams/StarOffice_Applications/Technical_Architect/documents/Q/transition.sxw

User Scenarios

Round trip scenario: OOo 1.1 -> OOo 2.0 -> kOffice - OOo 1.1

Differ old and new OOo formats in file system

File exchange with old OOo/SO versions

Product independent brand name

Goals

Provide new file extensions and names for the OASIS OpenDocument XML File Format in OOo 2.0 to ensure that the old and the new file format could be distinguished also in the file view on Windows systems and to prevent new files being loaded in an earlier version (< OOo 2.0).

Requirements and Dependencies

Requirements

none

Technical Dependencies

XSLT Filter

For detailed information about the file format transition, please see the following specification:

http://staroffice-doc.germany.sun.com:8080/Teams/StarOffice_Applications/Technical_Architect/documents/Q/transition.sxw

OLE Objects Names

Not related to filter names because application names are used in the Insert - Object - OLE Object and Edit - Paste Special dialogs.

Document Migration

Show Alien warning if saved in old format and document will be closed

Documentation

Loading new Open Office format in OOo < 2.0

Due to the new extension and mim-type the new files could not be opened by an unpatched OOo version < 2.0. This is important, because the old version could not read new documents and would show up an empty document.

Please also note the following related specification:

http://specs.openoffice.org/appwide/menus/desktop_menu_integration.sxw

Competitive Analyses

Extension Check

The new file extension have been checked for current usage on 07/20/04 on http://filext.com/

Extension	Result	Status
odt	no result	✓
ott	Nokia Phone Ring Tone (Nokia)	✓
odm	Opendisc Software (Opendisc)	✓
omt	no result	✓
html	...	✓
oth	Origin Graph Properties File Power Toys Other Folder Explorer Tool	✓
ods	NCompass Labs Internet Script	✓
ots	OtsJuke Sound File	✓
odc	Office Data Connection	✓
otg	no result	✓
odg	no result	✓
odp	OOP Packer Archive	✓
otp	Origin Graphic Template File	✓
odf	Open Document Interchange (ODIF), Star Trek Armada Ship / Structure Information	✓
odb	ArcView Object Database ASCII File	✓
oxt	No Entry Found in Database!	✓

Microsoft Office XML Format

Microsoft uses their XML Format not as the default file format. In Save as dialog, the user can choose "XML Document (*.xml) right below the applications native binary format.

Detailed Specification

Unfortunately we have to change the previously (in September 2004) defined extensions and mime types. Existing documents using these extensions / mime types (i.e. .oot extension for Writer) could not be read with the most current version of OOo. Changing the extension does not solve the problem, because the file's internal mime type will not be recognized and thus the loaded document would be empty . Workaround tis to export those files with an older EA version of OOo into the old XML or binary format.

New Extensions for OOo 2.0 and SO 8

The following table shows the old (OOo 1.1) and the new file names and extensions.

The new file extensions are shown in brackets behind the filename like in OOo 1.1 (i.e. "OpenDocument (.odt)").

Application	New ODF Names	New File Extension File / Template
Writer	ODF Text Document	odt ott
Writer (Master)	ODF Master Document ---	odm ---
Writer/WEB	HTML Document Template	oth
Calc	ODF Spreadsheet ODF Spreadsheet Template	ods ots
Draw	ODF Drawing ODF Drawing Template	odg otg
Impress	ODF Presentation ODF Presentation Template	odp otp
Math	ODF Formula ---	odf ---
Chart	ODF Chart	odc
Database	ODF Database	odb
Database Report	ODF Database Report	orp
Office	$PRODUCTNAME Extension	oxt
	Flat ODF Text Document	fodt
	Flat ODF Spreadsheet	fods
	Flat ODF Presentation	fodp
	Flat ODF Drawing	fodg

Note: Blue highlighted parts have to be localized.

String list for translation

	English	Comments
List box item	ODF Text Document	
List box item	ODF Text Document Template	
List box entry	ODF Master Document	
List box item	HTML Document Template	
List box entry	ODF Spreadsheet	
List box item	ODF Spreadsheet Template	
List box entry	ODF Drawing	
List box item	ODF Drawing Template	
List box item	ODF Drawing (Impress)	
List box entry	ODF Presentation	
List box item	ODF Presentation Template	
List box entry	ODF Formula	
List box entry	ODF Chart	no stand alone filter, not available in the UI
List box entry	ODF Database	
List box entry	ODF Database Report	
String	$PRODUCTNAME Extension	Not visible in File-Open dialog
List box entry	Flat ODF Text Document	Not installed by default
List box entry	Flat ODF Spreadsheet	Not installed by default
List box entry	Flat ODF Presentation	Not installed by default
List box entry	Flat ODF Drawing	Not installed by default

Note: Blue highlighted parts have to be localized.

Note: The database name and extension will be changed with CWS insight02. The database file format is going to be standardized by OASIS as well. The new names are only kept, if this standardization has taken place until release of OOo.

Non Default Format Warning

The warning dialog ("Alien Warning") is shown, if the file will not be saved in the current default format. This includes "old" OOo 1.1 (and below) formats.

Illustration 1 "Alien Warning" if save in none-standard format

Export in OpenOffice 1.0-1.1.x / StarOffice 6.0-7 Format

Export Filter

Export filters are available for the following applications, to write OOo 1.1/StarOffice 6.0-7 compatible document files and templates:

Writer

Calc

Draw

Impress

Math

Therefore the current OOo 1.1 file format and template format names are used.

Position of the Export Filters in Save / Open Dialog

The old file format export filter names are placed between the Rich Text Format filter and the StarWriter 5.0 (.sdw) filter.

Illustration 2 Save Ass... Dialog illustrating the position of the new export filters

G11n

The blue highlighted part of the new filenames has to be translated.

Error Conditions

none

Migration

Document Samples and Templates

Already existing documents and templates keep their file format. If an old template is used, the created document is saved in the current standard format anyway. If an old document is changed the alien warning is shown to force the user saving the document in the current default file format.

AutoText

AutoText files will be converted/saved into the new Open Office format if an AutoText is modified.

Future Tasks

Mime Types (##FL: This issue will be addressed within system integration task i32277 and i32276)

The following Mime types are used on UNIX based systems to distinguish the different OOo file types. The new mime types can be found in sot/source/base/exchange.cxx:

Note: Those mime types could be found in ".mailcap" and ".mime.types" after installation.

Application	Mime Type
Writer	application/vnd.oasis.opendocument.text
Writer/WEB	application/vnd.oasis.opendocument.text-web
Writer/Master	application/vnd.oasis.opendocument.text-master
Draw	application/vnd.oasis.opendocument.graphics
Impress	application/vnd.oasis.opendocument.presentation
Calc	application/vnd.oasis.opendocument.spreadsheet
Chart	application/vnd.oasis.opendocument.chart
Math	application/vnd.oasis.opendocument.formula
Base	application/vnd.sun.xml.base
Image	application/vnd.oasis.opendocument.image

Show an extension "(default)" behind the current default filter name in the file open and save dialog

Maybe only shown if the default format has been changed in Tools-Options-Load&Save

XSLT Filter Dialog (Task ID: 118610)

The XML filter dialog uses a list box called Application to select the target application for the transformation. Therefore additional entries have been added to choose between old (i.e. sxw) and new (oot) format.

Illustration 3 XML Filter: New Filter Dialog

Please find the original specification here:

http://ui.openoffice.org/proposals/XMLFilterSpec.sxw

String list for translation

Note: The currently present strings will be kept in addition and get the old file format extension [i.e. (.sxw)] in brackets so that they can be decided from the new ones defined below.

Item	English	German	Comments
"Application" List box item	%PRODUCTNAME Writer (.odt)	%PRODUCTNAME Writer (.odt)	
"Application" List box item	%PRODUCTNAME Calc (.ods)	%PRODUCTNAME Calc (.ods)	
"Application" List box item	%PRODUCTNAME Draw (.odg)	%PRODUCTNAME Draw (.odg)	
"Application" List box item	%PRODUCTNAME Impress (.odp)	%PRODUCTNAME Impress (.odp)	

Add new OASIS Default Format Filter to Application Group in File Open Dialog (fix after Beta release) (Issue i37961)

The new OASIS file format of an application is added to the previously defined list of file types shown, if a application group filter (i.e. Text Document) is selected (see illustration below).

Illustration 4 Application Group Filter

Add New Template Extensions to Import Templates Dialog (Task ID: 37958)

The new file extensions have to be added to the Import Template Dialog.

Illustration 5 Template Management Dialog

The list of extensions changes as follows and the string in front of the brackets is kept unchanged:

Current	NEW
(*.vor;*.stw;*.stc;*.std;*.sti)	(*.ott;*.ots;*.otg;*.otp;*.oth;*.stw;*.stc;*.std;*.sti;*.vor)

The entry all files is kept unchanged.

Illustration 6 The "Import Template..." entry of the Command button menu calls an Open dialog showing only OOo templates (old and new) by default

Notes

References

none

extensions are used instead of mime types

future OOo builds will show a message box on loading instead of an empty document

no stand alone filter, not available in the UI today

this file format is currently not standardized. Work in progress.

Not part of office product. Only provided by flat XML extension.

Not part of office product. Only provided by flat XML extension.

Not part of office product. Only provided by flat XML extension.

Not part of office product. Only provided by flat XML extension.

Will be fixed after beta has been released. Filter box is shown on loading drawing documents created with beta version. Correct file format filter is preselected, user has to confirm only b clicking OK. If this excption would be automatically assumed, we would have the problem when this exception in the code could be removed.

no stand alone filter, not available in the UI today

Base mime type may be change to vnd.oasis.opendocument.base if it is standardized by OASIS too.

no stand alone filter, not available in the UI today

File Format Names for New Oasis Open Office Format

Page 11

http://specs.openoffice.org/appwide/fileIO/FileFormatNames.sxw

sdf

2004-06-21T13:50:14