| 45 | |
| 46 | === ExecuteLoadProcedure === |
| 47 | |
| 48 | Implemented in ServerConnectionBase, automatically inherited by HttpServerConnection and LocalNativeConnetion |
| 49 | |
| 50 | Description: Executes the Load Procedure specified by the resource ID. |
| 51 | |
| 52 | Parameters: |
| 53 | |
| 54 | * resourceID: The resource ID of the Load Procedure |
| 55 | * ignoreUnsupportedFeatures: If false, will throw an exception if the specified load procedure has features which are not supported for execution. |
| 56 | * callback: An optional callback to indicate progress. |
| 57 | |
| 58 | Returns: |
| 59 | |
| 60 | * An array of resource IDs that have been created or updated by the execution of this load procedure. |
| 61 | |
| 62 | Notes: |
| 63 | |
| 64 | The Load Procedure support in Maestro is very basic. The following load procedure types are supported: |
| 65 | |
| 66 | * SDF |
| 67 | * SHP |
| 68 | |
| 69 | The following Load Procedure types '''may be supported''' in future releases, if it is determined we can support these types with a portable implementation: |
| 70 | |
| 71 | * DWF |
| 72 | * SQLite |
| 73 | * Raster |
| 74 | |
| 75 | The following Load Procedure types will '''NEVER''' be supported: |
| 76 | |
| 77 | * DWG |
| 78 | |
| 79 | Of the supported load procedure types, the following features are not supported, and will throw an exception if ignoreUnsupportedFeatures = false |
| 80 | |
| 81 | * Generalization of data (will throw exception if value < 100%) |
| 82 | * Convert to SDF (will throw exception if value = true) |
| 83 | |
| 84 | Of the supported load procedure types, the following features are not supported. No exception is thrown regardless of the value of ignoreUnsupportedFeatures |
| 85 | |
| 86 | * SDF2 to SDF3 conversion (there's no pure .net way to detect if the input files are SDF2 files) |
| 87 | * SDF duplicate record (there's no portable .net API available to inspect the contents of a local SDF file) |
| 88 | |
| 89 | The general use case for Load Procedures is the quick and dirty loading of a group of SDF/SHP files into a given repository location, each referenced by a matching layer with default (monochromatic) styles. As long as you stick to this general usage scenario, the API will work as expected. These unsupported features are disabled on the user interface side. |