excel.rst 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. .. _excel_extension:
  2. Excel WFS Output Format
  3. =======================
  4. The GeoServer Excel plugin adds the ability to output WFS responses in either Excel 97-2003 (``.xls``) or Excel 2007 (``.xlsx``) formats.
  5. Installation
  6. ------------
  7. #. From the :website:`website download <download>` page, locate your release, and download: :download_extension:`excel`
  8. #. Unzip the archive into the :file:`WEB-INF/lib` directory of the GeoServer installation.
  9. #. Restart GeoServer.
  10. Usage
  11. -----
  12. When making a WFS request, set the ``outputFormat`` to ``excel`` (for Excel 97-2003) or ``excel2007`` (for Excel 2007).
  13. Examples
  14. --------
  15. Excel 97-2003 GET:
  16. http://localhost:8080/geoserver/wfs?request=GetFeature&version=1.1.0&typeName=topp:states&outputFormat=excel
  17. Excel 2007 GET:
  18. http://localhost:8080/geoserver/wfs?request=GetFeature&version=1.1.0&typeName=topp:states&outputFormat=excel2007
  19. **Excel 97-2003 POST**::
  20. <wfs:GetFeature service="WFS" version="1.1.0"
  21. outputFormat="excel"
  22. xmlns:topp="http://www.openplans.org/topp"
  23. xmlns:wfs="http://www.opengis.net/wfs"
  24. xmlns:ogc="http://www.opengis.net/ogc"
  25. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  26. xsi:schemaLocation="http://www.opengis.net/wfs
  27. http://schemas.opengis.net/wfs/1.1.0/wfs.xsd">
  28. <wfs:Query typeName="topp:states" />
  29. </wfs:GetFeature>
  30. Limitations
  31. -----------
  32. Excel 97-2003 files are stored in a binary format and are thus space-efficient, but have inherent size limitations (65,526 rows per sheet; 256 columns per sheet).
  33. Excel 2007 files are XML-based, and have much higher limits (1,048,576 rows per sheet; 16,384 columns per sheet).
  34. However, because they are text files Excel 2007 files are usually larger than Excel 97-2003 files.
  35. If the number of rows in a sheet or characters in a cell exceeds the limits of the chosen Excel file format, warning text is inserted to indicate the truncation.