Autodesk FDO Bulk Copy Utility API Reference

FDO Utility Bulk Copy API

API Reference Autodesk FDO Bulk Copy Utility

Introduction

The Bulk Copy Utility is an API used to copy data from one FDO data store to another FDO data store.

You can either copy a subset or the complete source data store. The data to be copied can be filtered based on:
  • schema (for example, Acad)
  • class (for example, AcDbPolyline)
  • property (for example, layer)
  • filter (for example, layer = “road”)

The Bulk Copy API has the following characteristics:
  • Schema is created if it does not exist in the target datastore.
  • Default values can also be set for a target property if the source property does not exist.
  • Schema names, class names, and property names from the source data store do not need to match the names in the target data store.
  • An XML mapping file is used to setup the mapping between the source and target data store.
  • Methods to serialize and deserialize the mapping to an XML mapping file are available.

The Bulk Copy API supports all types of properties (association, object, geometric, data) except for the raster property. The same property type as the source data store is retained when copying to the target data store. Note that not all providers support all property types so if the property type is not supported by the target data store, and if an unsupported property is encountered, there is an option to either ignore and continue or stop processing.

The geometric property is copied as is, except when an unsupported arc type is encountered in the target data store, which is results in the the arc converted to a line. Note that if another unsupported geometry type/component type is encountered, there is an option to either ignore and continue or stop processing.

All datatypes are supported and the same datatype is retained from the source data store to the target data store, except for numeric datatypes.

Bulk Copy attempts to retain the same datatype, except unsupported types. For example, if the source datatype has a type of FdoDataType_Byte and the target is a Shape data store, then the target datatype created is a FdoDataType_Int32 since the FdoDataType_Byte type is not supported in the Shape provider.

For more information on the FDO API and providers, see the FDO API Help and individual provider API Help.



Comments?