added a note on Compatibility of POI-generated .xlsx files with MS Office 2008 for Mac SP2

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@799264 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Yegor Kozlov 2009-07-30 13:49:25 +00:00
parent 37db132d93
commit 54b958b1a9
2 changed files with 33 additions and 1 deletions

View File

@ -66,5 +66,36 @@
can also generate spreadsheets this way.
</p>
</section>
<section>
<title>Compatibility of POI-generated .xlsx files with MS Office 2008 for Mac SP2</title>
<p>
Office 2008 for Mac SP2 version 12.2.0 has a serious bug causing some Open XML files to fail to open.
This bug is affecting Open XML files from a variety of sources including the Apache POI project.
The Apache POI project adjusted the XSSF module to produce "MS-compatible OOXML" by setting the Application extended property to "Microsoft Excel". This will allow users of future versions of Apache POI to produce OOXML documents that will work with Office 2008 for Mac SP2.
Please see <link href="https://issues.apache.org/bugzilla/show_bug.cgi?id=47559">Bugzilla 47559</link> for more information.
</p>
<p>
Users are advised to patch existing .xlsx files by the following code:
</p>
<source>
XSSFWorkbook wb = new XSSFWorkbook(path);
POIXMLProperties.ExtendedProperties ext = wb.getProperties().getExtendedProperties();
expProps.getUnderlyingProperties().setApplication("Microsoft Excel");
FileOutputStream out = new FileOutputStream(path);
wb.write(out);
out.close();
</source>
<p>To unset the Application property use the following code:</p>
<source>
POIXMLProperties.ExtendedProperties ext = workbook.getProperties().getExtendedProperties();
expProps.getUnderlyingProperties().unsetApplication();
</source>
<warning>
This is an effective workaround for a short-term bug which is likely to be removed in future versions of POI,
when Microsoft returns to compliance with the standard. The proper value for Apache POI created documents would to be "Apache POI" and not "Microsoft Excel".
</warning>
</section>
</body>
</document>

View File

@ -37,7 +37,8 @@
<action dev="POI-DEVELOPERS" type="fix">47571 - Fixed XWPFWordExtractor to extract inserted/deleted text</action>
<action dev="POI-DEVELOPERS" type="fix">47548 - Fixed RecordFactoryInputStream to properly read continued DrawingRecords</action>
<action dev="POI-DEVELOPERS" type="fix">46419 - Fixed compatibility issue with OpenOffice 3.0</action>
<action dev="POI-DEVELOPERS" type="fix">47559 - Fixed compatibility issue with Excel 2008 Mac sp2</action>
<action dev="POI-DEVELOPERS" type="fix">47559 - Fixed compatibility issue with Excel 2008 Mac sp2. Please see
<link href="./spreadsheet/index.html"> the HSSF+XSSF project page</link> for more information. </action>
<action dev="POI-DEVELOPERS" type="fix">47540 - Fix for saving custom and extended OOXML properties</action>
<action dev="POI-DEVELOPERS" type="fix">47535 - Fixed WordExtractor to tolerate files with empty footnote block</action>
<action dev="POI-DEVELOPERS" type="fix">47517 - Fixed ExtractorFactory to support .xltx and .dotx files</action>