Handling Errors
When you write an extension, be aware that there are several exceptions that can be returned from the extension DLL and that must be considered. When these exceptions are thrown, a description string is specified in some cases. This string will be visible only for object errors and not for run errors, except where logged.
The following table contains useful information on common exceptions that must be handled.
| Method | Exception | Step run result | Action | Object error | Log |
|---|---|---|---|---|---|
| GenerateImportFile | ServerDownException | stopped-server-down | Stop Run | N | |
| BadServerCredentialsException | stopped-bad-server-credentials | Stop Run | N | ||
| ExtensibleExtensionException | stopped-extensible-extension-error | Stop Run | Y | ||
| EntryPointNotImplementedException | stopped-entry-point-not-implemented | Stop Run | N | ||
| UnexpectedDataException | stopped-unexpected-data | Stop Run | Y | ||
| OtherException | stopped-extension-dll-exception | Stop Run | Y | ||
| BeginExport | ServerDownException | stopped-server-down | Stop Run | N | |
| BadServerCredentialsException | stopped-bad-server-credentials | Stop Run | N | ||
| ExtensibleExtensionException | stopped-extensible-extension-error | Stop Run | Y | ||
| EntryPointNotImplementedException | stopped-entry-point-not-implemented | Stop Run | N | ||
| UnexpectedDataException | stopped-unexpected-data | Stop Run | Y | ||
| OtherException | stopped-extension-dll-exception | Stop Run | Y | ||
| ExportEntry | ServerDownException | completed-export-errors | Continue Run | server-down | N |
| ExtensibleExtensionException | completed--warnings | Continue Run | extensible-extension-error | Y | |
| EntryPointNotImplementedException | stopped-entry-point-not-implemented | Stop Run | N | ||
| UnexpectedDataException | completed-export-errors | Continue Run | extension-unexpected-attribute-value | Y | |
| EntryExportException | completed--warnings | Continue Run | entry-export-error | N | |
| FatalEntryExportException | stopped-entry-export-error | Stop Run | N | ||
| OtherException | completed-export-errors | Continue Run | ma-extension-error | Y | |
| EndExport | ServerDownException | stopped-server-down | Stop Run | N | |
| ExtensibleExtensionException | stopped-extensible-extension-error | Stop Run | Y | ||
| EntryPointNotImplementedException | stopped-entry-point-not-implemented | Stop Run | N | ||
| UnexpectedDataException | stopped-unexpected-data | Stop Run | Y | ||
| OtherException | stopped-extension-dll-exception | Stop Run | Y | ||
| DeliverExportFile | ServerDownException | stopped-server-down | Stop Run | N | |
| BadServerCredentialsException | stopped-bad-server-credentials | Stop Run | N | ||
| ExtensibleExtensionException | stopped-extensible-extension-error | Stop Run | Y | ||
| EntryPointNotImplementedException | stopped-entry-point-not-implemented | Stop Run | N | ||
| UnexpectedDataException | stopped-unexpected-data | Stop Run | Y | ||
| OtherException | stopped-extension-dll-exception | Stop Run | Y |
Note the logging is in addition to any logging the controller may also do.
Send comments about this topic to Microsoft
Build date: 2/16/2009