Return values, Errors, and Exceptions

During import and export the methods can provide error information to the sync engine. These errors can be returned on an object level or as a fatal error.

Depending on the error the step run result or WMI return message will be different.

Fatal errors: stopped-

Other errors: competed-export-errors, completed--warnings

Errors can be categorized into the following:

• Export Errors

• Special action. An error where the sync engine should take an action to correct the problem. These will not be visible in the UI.

• Object level error visible in the UI

• Import Errors

• Discovery error which tell the sync engine to not commit the watermark but continue the run.

• Discovery error which is a fatal import error and stops the run.

• Connection errors

• Connectivity issues which will stop the run.

• Error from the Sync Engine to the MA.

Export Errors, Special Actions

The following list can be returned on an object level during ExportEntries. These also have a corresponding object level error when the sync engine is not supposed to take a special action.

All these errors will put the object into the next export pass.

Error	Notes
(cd-missing-object-sa) convert-update-to-add	Change object from update to add.
(cd-existing-object-sa) convert-add-to-update	Change object from add to update.
(dn-attribute-failure-sa) next-pass-retry	Put the object in a second export pass.
(non-existing-parent-sa) provision-parent	Re-provision parent hierarchy

Export Errors, Object level errors

The following list can be returned on an object during ExportEntries.

Error	Notes
cd-error	This error is returned when the connected data source has a specialized error type. This error is accompanied by the <cd-error> element, and the information contained there should aid in troubleshooting.
cd-missing-object	This error is returned when a modify of an object is exported to the connected data source, but the object cannot be found in the connected data source.
cd-existing-object	This error is returned when an add is exported to the connected data source, but the object is already present in the connected data source.
dn-attributes-failure	This error is returned when exporting an add or modify sets a reference value for which there is no corresponding connected data source object. If you see this error, use the connector space object viewer to determine which changes to reference attributes were not successfully exported.
Non-existent-parent	This error is returned by the management agent for LDAP when either the export of an add or a rename fails because the parent object does not exist in the connected data source.

Discovery errors, continue run

The following list can be returned on an object level during ImportEntries. These will be reported as errors in the UI. When the first object with a discovery error is returned the watermark will not be persisted for the remainder of the run.

Error	Notes
missing-dn	It indicates that the management agent could read the element and parse it, but there was no domain name value for the object.
dn-not-ldap-conformant	This error is returned when a management agent reports a domain name value that does not conform to the LDAP specification.
invalid-dn	This error is returned when a management agent reports that a domain name does not meet an FIM constraint.

Most discovery errors will be detected by the Sync Engine when it is trying to persist the connector space object. These will be visible in the UI but they are not available for the MA to consume.

Discovery errors, fatal

The following list can be returned on an object level during ImportEntries. These errors indicate a corrupted delta change log and that a full import is needed to correct. These errors will also terminate the run (EndImport will be called).

Error	Notes
parse-error	This error is returned in delta mode when it cannot parse an entry.
read-error	This error is returned by call-based management agents when there is a generic error reading a particular object.

Connection errors, fatal

Connection errors can appear in import, export, and password management.

The EndImport/EndExport method will be called after an exception is thrown.

Error	Notes
stopped-server-down	The run step stopped because the data source server is down.
stopped-bad-server-credentials	The run step stopped because the extensible management agent reported that the credentials are invalid.
stopped-extensible-extension-error	The run step stopped because the extensible management agent returned an ExtensibleExtensionException exception.
stopped-entry-point-not-implemented	The run step stopped because the extensible management agent does not implement the entry point.
stopped-unexpected-data	The run step stopped because the extensible management agent encountered unexpected data.
stopped-extension-dll-exception	The run step stopped because the extension DLL threw an exception.

Exceptions

The following is a list of exceptions that can be thrown by the Extensible Connectivity 2.2 Management Agent.

Exception Type	Condition
AccessDeniedException	This is thrown when the password set is denied.
BadServerCredentialsException	The credentials that are used to connect to the connected directory are not valid. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-bad-server-credentials. This exception does not generate an event log entry.
ClosePasswordConnectionException	Thrown when an error occurred while closing the connection.
EntryPointNotImplementedException	The rules extension does not implement this method. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-entry-point-not-implemented. This exception does not generate an event log entry.
ExtensibleExtensionException	An unexpected error occurred in the extension. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-extensible-extension-error. This exception generates an event log entry.
ObjectNotFoundException	Thrown when a specified object cannot be found.
ObjectTypeNotSupportedException	Thrown when the object type does not support password set.
PasswordExtensionException	An unexpected error occurred in the extension. This exception generates an event log entry.
PasswordIllFormedException	Thrown when the password specified was ill formed.
PasswordPolicyViolationException	Thrown when the password specified violates the password policy.
ServerDownException	The connected directory extension cannot establish a connection to the connected directory. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-server-down. This exception does not generate an event log entry.
UnexpectedDataException	The method received unexpected data. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-unexpected-data. This exception generates an event log entry.