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