[mapserver-commits] r7971 - trunk/mapserver/rfc

[svn at osgeo.org]

Author: pramsey
Date: 2008-10-09 13:51:02 -0400 (Thu, 09 Oct 2008)
New Revision: 7971

Added:
   trunk/mapserver/rfc/ms-rfc-47.txt
Log:
RFC for ignoring missing data.


Added: trunk/mapserver/rfc/ms-rfc-47.txt
===================================================================
--- trunk/mapserver/rfc/ms-rfc-47.txt	                        (rev 0)
+++ trunk/mapserver/rfc/ms-rfc-47.txt	2008-10-09 17:51:02 UTC (rev 7971)
@@ -0,0 +1,75 @@
+=======================================================================
+MS RFC 47: Move IGNORE_MISSING_DATA to run-time configuration
+=======================================================================
+
+:Date: 2008/10/09
+:Author: Paul Ramsey
+:Contact: pramsey at cleverelephant.ca
+:Last Edited: 2008/10/00
+:Status: Proposed
+:Version: MapServer 5.4
+
+Overview 
+--------
+
+Making the options for ignoring missing data in tile-indexed layers and WMS client layers more flexible, and configurable at run-time via the map file.
+
+Technical Solution
+------------------
+
+Currently Mapserver has only compile-time control of behavior when files referenced in tile indexes are missing, via the IGNORE_MISSING_DATA define, and that behavior is applied globally.
+
+Under this RFC, the missing data behavior will be defined:
+
+ * at run time
+ * on a per-layer basis
+
+As well, the option to "fail on a missing layer" will be added to the WMS client code, which currently defaults to "ignore on a missing layer".
+
+All changes will preserve the current default behavior in cases where new behavior is not requested by the user: missing data in tileindexes will continue to cause failure and missing WMS layers will continue to be ignored.
+
+A map-level and layer-level configuration option will be added, "ON_MISSING_DATA", with the following valid values: "IGNORE", "LOG", "FAIL".  The default map-level behavior will be "FAIL", unless Mapserver is compiled with --ignore-missing-data, in which case it will be "LOG".  Thus will preserve the current behavior for all legacy mapfiles and compile set-ups.
+
+At the same time, this ticket (#2722) can probably be tracked down and resolved.
+
+Mapscript Implications
+----------------------
+
+This option may be altered via Mapscript, presumably.
+
+Files Affected
+--------------
+
+::
+
+ mapshape.c
+ mapogr.c
+ mapraster.c
+ maprasterquery.c
+ mapfile.c
+ maplexer.l
+
+* Documentation will be updated to reflect the new feature
+
+  * Mapserver Mapfile Reference
+
+Backwards Compatibility Issues
+------------------------------
+
+None. Legacy mapfiles and compile setups should retain existing behavior in the presence of this new code.
+
+Bug ID
+------
+
+* http://trac.osgeo.org/mapserver/ticket/2785
+
+Voting History
+--------------
+
+N/A
+
+References
+----------
+
+N/A
+