MapGuide RFC 27 - New DWG Load Procedure Schema

This page contains an change request (RFC) for the MapGuide Open Source project. More MapGuide RFCs can be found on the RFCs page.

Status

RFC Template Version	1.0
Submission Date	Aug 13, 2007
Last Modified	Bill Kellner Timestamp
Author	Bill Kellner
RFC Status	adopted
Implementation Status	under development
Proposed Milestone	2.0
Assigned PSC guide(s)	Tom
Voting History	Sept 4/2007
+1	Tom, Andy, Haris, Bob, Bruce
+0	Jason, Paul
-0
-1

Overview

This change adds a new version of the DWG Load Procedure resource schema.

Motivation

A new DWG load procedure XML document is required to support some third-party tools. Because the DWG load procedure document is stored in the repository the schema must be made available to the server.

Proposed Solution

Add a new file, LoadProcedure-1.1.0.xsd to the Common/Schema folder. The contents of this file will be the same as LoadProcedure-1.0.0.xsd except that the version will be 1.1.0, and the DWG load procedure portion of the file will be modified. This is enough to get the server to store DWG load procedures in the new format in the repository. The new DWG related schema is shown below.

     <xs:complexType name="DwgLoadProcedureType">
       <xs:annotation>
         <xs:documentation>Extension of LoadProcedure for DWGs and DXFs</xs:documentation>
       </xs:annotation>
       <xs:complexContent>
         <xs:extension base="LoadProcedureType">
           <xs:sequence>
             <xs:element name="FileComponents">
               <xs:annotation>
                 <xs:documentation>List of DWG files and their layers to be extracted, whether selected or not.</xs:documentation>
               </xs:annotation>
               <xs:complexType>
                 <xs:sequence>
                   <xs:element name="FileComponent" type="DwgFileComponentType" maxOccurs="unbounded">
                     <xs:annotation>
                       <xs:documentation>One DWG file and its layers</xs:documentation>
                     </xs:annotation>
                   </xs:element>
                 </xs:sequence>
               </xs:complexType>
             </xs:element>
             <xs:element name="CombineComponents" type="xs:boolean">
               <xs:annotation>
                 <xs:documentation>Indicate whether to combine components into one resource or create a separate resource for each component</xs:documentation>
               </xs:annotation>
             </xs:element>
             <xs:element name="Generalization" type="PercentageType">
               <xs:annotation>
                 <xs:documentation>Reduces the point (or vertex) count of each map feature to the specified percentage of the original count</xs:documentation>
               </xs:annotation>
             </xs:element>
             <xs:element name="ClosedPolylinesToPolygons" type="xs:boolean">
               <xs:annotation>
                 <xs:documentation>Indicates whether to convert closed polyline features to polygons</xs:documentation>
               </xs:annotation>
             </xs:element>
           </xs:sequence>
         </xs:extension>
       </xs:complexContent>
     </xs:complexType>
     <xs:complexType name="DwgFileComponentType">
       <xs:annotation>
         <xs:documentation>Specifies a DWG file and its list of layers</xs:documentation>
       </xs:annotation>
       <xs:sequence>
         <xs:element name="Name" type="xs:string">
           <xs:annotation>
             <xs:documentation>The name of the DWG file</xs:documentation>
           </xs:annotation>
         </xs:element>
         <xs:element name="LayerComponents">
           <xs:annotation>
             <xs:documentation>List of DWG layers</xs:documentation>
           </xs:annotation>
           <xs:complexType>
             <xs:sequence>
               <xs:element name="LayerComponent" type="DwgLayerComponentType" maxOccurs="unbounded">
                 <xs:annotation>
                   <xs:documentation>One DWG layer</xs:documentation>
                 </xs:annotation>
               </xs:element>
             </xs:sequence>
           </xs:complexType>
         </xs:element>
       </xs:sequence>
     </xs:complexType>
     <xs:complexType name="DwgLayerComponentType">
       <xs:annotation>
         <xs:documentation>Specifies a layer and a flag to indicate if it should be extracted</xs:documentation>
       </xs:annotation>
       <xs:sequence>
         <xs:element name="Name" type="xs:string">
           <xs:annotation>
           <xs:documentation>The name of the layer</xs:documentation>
           </xs:annotation>
         </xs:element>
         <xs:element name="Selected" type="xs:boolean">
           <xs:annotation>
             <xs:documentation>Indicates whether this layer is to be extracted when executing the Load Procedure</xs:documentation>
           </xs:annotation>
         </xs:element>
       </xs:sequence>
     </xs:complexType>
   </xs:schema>

Implications

None.

Test Plan

There were no unit tests to test the dwg load procedure. No new unit tests are planned.

Funding/Resources

Supplied by Autodesk.