Changes between Version 10 and Version 11 of FdoEnhancedVersionSupport

Timestamp:

Oct 18, 2007, 10:07:48 AM (17 years ago)

Author:

gregboone

Comment:

--

FdoEnhancedVersionSupport

@@ -269 +269 @@
 Other – the construct is ignored[[br]] 
 
+==== Feature Schemas ====
+
+The fdo:version and fdo:minimumVersion elements will also be allowed on the <xs:schema> element. Both attributes are optional.
+When the FDO XML Schema writer writes a single schema, it does not wrap the schema in an <fdo:Datastore> element. This is done to maximize compatibility with external applications. In this case, the document root element is <xs:schema>. Therefore, the schema writer will add the versioning attributes to the <xs:schema> element, in this case.
+
+In order to support the required schema override change, the !FdoFeatureSchema class will be modified to include a !GetFeatureDataObjectsVersion function as well as a !GetMinimumFeatureDataObjectsVersion function.
+
+
+{{{
+class FdoFeatureSchema : 
+    public FdoSchemaElement,
+    public FdoXmlSerializable
+{
+public:
+    /// \brief
+    /// Gets the version of FDO that created the Feature Schema
+    /// 
+    /// \return
+    /// Returns the Feature Data Objects version as an FdoString.
+    /// The FDO version must conform to the format:
+    /// "[VersionMajor].[VersionMinor].[BuildMajor].[BuildMinor]".
+    /// 
+    FDO_API virtual FdoString* GetFeatureDataObjectsVersion();
+
+    /// \brief
+    /// Gets the earliest version of FDO that can possibly 
+    /// read the Schema Mapping
+    /// 
+    /// \return
+    /// Returns the Feature Data Objects version as an FdoString.
+    /// The FDO version must conform to the format:
+    /// "[VersionMajor].[VersionMinor].[BuildMajor].[BuildMinor]".
+    /// 
+    FDO_API virtual FdoString* GetMinimumFeatureDataObjectsVersion();
+…
+…
+};
+}}}
+
+==== Schema Overrides ====
+
+The Schema Overrides version is already stored in the provider attribute of the <!SchemaMapping> tag. The following new attribute (for the <!SchemaMapping> tag ) will be defined:
+
+        minimumVersion
+
+Its behaviour is identical to that of the general fdo:minimumVersion.
+
+The following updated !FdoOverride.xsd definitions reflect the proposed changes above.
+
+
+{{{
+<xs:schema>
+...
+...
+    <xs:complexType name="PhysicalSchemaMappingType" abstract="true">
+        <xs:complexContent>
+            <xs:extension base="SchemaMappingElement">
+                <xs:attribute name="provider" type="ProviderType" use="required"/>
+                <xs:attribute ref="fdo:minimumVersion" use="optional"/>
+            </xs:extension>
+        </xs:complexContent>
+    </xs:complexType>
+...
+...
+</xs:schema>
+}}}
+
+
+In order to support the required schema override change, the !FdoPhysicalSchemaMapping and !FdoXmlSchemaMapping classes will be modified to include a !GetMinimumProviderVersion function.
+
+
+{{{
+class FdoPhysicalSchemaMapping :
+        public FdoPhysicalElementMapping,
+        public FdoXmlSerializable
+{
+public:
+    /// \brief
+    /// Gets the earliest version of Provider that can possibly 
+    /// read the Schema Mapping
+    /// 
+    /// \return
+    /// Returns the version as a constant wchar_t*.
+    /// The version must conform to the format:
+    /// "[VersionMajor].[VersionMinor].[BuildMajor].[BuildMinor]".
+    /// 
+    FDO_API virtual FdoString* GetMinimumProviderVersion () = 0;
+…
+…
+};
+
+/// \brief
+/// FdoXmlSchemaMapping specifies overrides for translating a feature schema 
+/// between FDO and GML.
+class FdoXmlSchemaMapping :
+        public FdoPhysicalSchemaMapping
+{
+public:
+    /// \brief
+    /// Gets the earliest version of Provider that can possibly 
+    /// read the Schema Mapping
+    /// 
+    /// \return
+    /// Returns the version as a constant wchar_t*.
+    /// The version must conform to the format:
+    /// "[VersionMajor].[VersionMinor].[BuildMajor].[BuildMinor]".
+    /// 
+    FDO_API FdoString* GetMinimumProviderVersion ();
+…
+…
+};
+}}}
+
+
+