= !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.