From 26598e3179bceb53b368e28d9b013485fa4bb33d Mon Sep 17 00:00:00 2001 From: Nick Burch Date: Mon, 14 Jun 2010 15:20:19 +0000 Subject: [PATCH] Notes on ooxml-schemas 1.1 and 1.0 git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@954511 13f79535-47bb-0310-9956-ffa450edef68 --- src/documentation/content/xdocs/faq.xml | 12 +++++++++--- src/documentation/content/xdocs/overview.xml | 8 +++++--- src/documentation/content/xdocs/status.xml | 1 + 3 files changed, 15 insertions(+), 6 deletions(-) diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml index 829caa5f2..8afe510b7 100644 --- a/src/documentation/content/xdocs/faq.xml +++ b/src/documentation/content/xdocs/faq.xml @@ -63,7 +63,7 @@ System.out.println("Core POI came from " + path); org.openxmlformats.schemas namespace.

There are two jar files available, as described in the components overview section. - The full jar of all of the schemas is ooxml-schemas-1.0.jar, + The full jar of all of the schemas is ooxml-schemas-1.1.jar, and it is currently around 15mb. The smaller poi-ooxml-schemas jar is only about 4mb. This latter jar file only contains the typically used parts though.

@@ -72,11 +72,11 @@ System.out.println("Core POI came from " + path); classes that are typically used, as identified by the unit tests. Every so often, you may try to use part of the file format which isn't included in the minimal poi-ooxml-schemas jar. In this case, - you should switch to the full ooxml-schemas-1.0.jar. Longer term, + you should switch to the full ooxml-schemas-1.1.jar. Longer term, you may also wish to submit a new unit test which uses the extra parts of the XSDs, so that a future poi-ooxml-schemas jar will include them.

-

There are a number of ways to get the full ooxml-schemas-1.0.jar. +

There are a number of ways to get the full ooxml-schemas-1.1.jar. If you are a maven user, see the the components overview section for the artifact details to have maven download it for you. @@ -88,6 +88,12 @@ System.out.println("Core POI came from " + path); look at this). Finally, you can download the jar by hand from the POI Maven Repository.

+

Note that for POI 3.5 and 3.6, the full ooxml schemas jar was + named ooxml-schemas-1.0.jar. For POI 3.7, the filename was bumped + to ooxml-schemas-1.1.jar when generics support was added. You can + use ooxml-schemas-1.1.jar with POI 3.5 and 3.6 if you wish, but + POI 3.7 won't wokr with ooxml-schemas-1.0.jar (it needs thew newer + one).

diff --git a/src/documentation/content/xdocs/overview.xml b/src/documentation/content/xdocs/overview.xml index bb8e0d2ae..35ae35f38 100644 --- a/src/documentation/content/xdocs/overview.xml +++ b/src/documentation/content/xdocs/overview.xml @@ -247,15 +247,17 @@ ooxml-schemas xmlbeans - ooxml-schemas-1.0.jar + ooxml-schemas-1.1.jar

(*) starting with 3.6-beta1-20091124.

- poi-ooxml requires poi-ooxml-schemas. This is a substantially smaller version of the ooxml-schemas-1.0.jar. - The larger ooxml-schemas jar is only required for development. + poi-ooxml requires poi-ooxml-schemas. This is a substantially smaller + version of the ooxml-schemas jar (ooxml-schemas-1.1.jar for POI 3.7 or later, ooxml-scheams-1.0.jar for POI 3.5 and 3.6). + The larger ooxml-schemas jar is normally + only required for development

Examples diff --git a/src/documentation/content/xdocs/status.xml b/src/documentation/content/xdocs/status.xml index 0529403be..99c896ee8 100644 --- a/src/documentation/content/xdocs/status.xml +++ b/src/documentation/content/xdocs/status.xml @@ -118,6 +118,7 @@ 48339 - fixed ExternalNameRecord to properly distinguish DDE data from OLE data items 47920 - allow editing workbooks embedded into PowerPoint files 48343 - added implementation of SUBTOTAL function + Switch to compiling the OOXML Schemas for Java 1.5 48332 - fixed XSSFSheet autoSizeColumn() to tolerate empty RichTextString