Autodesk FDO Bulk Copy Utility API Reference

FDO Utility Bulk Copy API

API Reference Autodesk FDO Bulk Copy Utility

define_pages.h

Go to the documentation of this file.
00001 /*! \mainpage Introduction
00002 <div class="mainpage">
00003 <!-- This is the index.html page that the user first sees. -->
00004 
00005 <p>The Bulk Copy Utility is an API used to copy data from one
00006 FDO data store to another FDO data store.
00007 </p>
00008 
00009 <p>You can either copy a subset or the complete source data store. The data to be copied can be filtered based on:
00010 </p>
00011 <ul>
00012   <li> schema (for example, Acad)
00013   <li> class (for example, AcDbPolyline)
00014   <li> property (for example, layer)
00015   <li> filter (for example, layer = “road”)
00016 </ul>
00017 
00018 <p>The Bulk Copy API has the following characteristics:
00019 </p>
00020 <ul>
00021   <li> Schema is created if it does not exist in the target
00022     datastore.
00023   <li> Default values can also be set for a target property if
00024     the source property does not exist.
00025   <li> Schema names, class names, and property names from
00026     the source data store do not need to match the names in the
00027     target data store.
00028   <li> An XML mapping file is used to setup the mapping between
00029     the source and target data store.
00030   <li> Methods to serialize and deserialize the
00031     mapping to an XML mapping file are available.
00032 </ul>
00033 
00034 <p>The Bulk Copy API supports all types of properties (association, object,
00035     geometric, data) except for the raster property. The same property type 
00036     as the source data store is retained 
00037     when copying to the target data store. Note that not all
00038     providers support all property types so if the property type
00039     is not supported by the target data store, and if an
00040     unsupported property is encountered, there is an option to
00041     either ignore and continue or stop processing.
00042 </p>
00043     
00044 <p>The geometric property is copied as is, except when an
00045     unsupported arc type is encountered in the target data store,
00046     which is results in the the arc converted to a line. Note
00047     that if another unsupported geometry type/component type is
00048     encountered, there is an option to either ignore and continue or stop processing.
00049 </p>
00050 
00051 <p>All datatypes are supported and the same datatype is
00052     retained from the source data store to the target data store,
00053     except for numeric datatypes.
00054 </p>
00055 
00056 <p>Bulk Copy attempts to retain the same datatype, except
00057     unsupported types. For example, if the source datatype has a
00058     type of FdoDataType_Byte and the target is a Shape data
00059     store, then the target datatype created is a
00060     FdoDataType_Int32 since the FdoDataType_Byte type is not
00061     supported in the Shape provider.
00062 <p>
00063 
00064 <p>For more information on the FDO API and providers, see 
00065 the FDO API Help and individual provider API Help.
00066 </p>
00067 
00068 
00069 <br>
00070 </div>
00071 
00072 <br>
00073 
00074 */
00075 
00076 
00077 
00078 

Comments?