.NET API Reference for Oracle Identity Connector Framework 11.1.2
E41516-01
Update the object specified by the ObjectClass and Uid, replacing the current values of each attribute with the values provided.

Namespace: Org.IdentityConnectors.Framework.Spi.Operations
Assembly: Framework (in Framework.dll) Version: 1.4.0.0 (1.4.0.0)

Syntax

C#
Uid Update(
	ObjectClass objclass,
	Uid uid,
	ICollection<ConnectorAttribute> replaceAttributes,
	OperationOptions options
)

Parameters

objclass
Type: Org.IdentityConnectors.Framework.Common.Objects..::..ObjectClass
the type of object to modify. Will never be null.
uid
Type: Org.IdentityConnectors.Framework.Common.Objects..::..Uid
the uid of the object to modify. Will never be null.
replaceAttributes
Type: System.Collections.Generic..::..ICollection<(Of <(<'ConnectorAttribute>)>)>
set of new ConnectorAttribute. the values in this set represent the new, merged values to be applied to the object. This set may also include OperationalAttributes. Will never be null.
options
Type: Org.IdentityConnectors.Framework.Common.Objects..::..OperationOptions
additional options that impact the way this operation is run. Will never be null.

Return Value

Type: Uid
the Uid of the updated object in case the update changes the formation of the unique identifier.

Remarks

For each input attribute, replace all of the current values of that attribute in the target object with the values of that attribute.

If the target object does not currently contain an attribute that the input set contains, then add this attribute (along with the provided values) to the target object.

If the value of an attribute in the input set is

 Copy imageCopy
null
, then do one of the following, depending on which is most appropriate for the target:
  • If possible, remove that attribute from the target object entirely.
  • Otherwise, replace all of the current values of that attribute in the target object with a single value of
     Copy imageCopy
    null
    .

Exceptions

ExceptionCondition
Org.IdentityConnectors.Framework.Common.Exceptions..::..UnknownUidExceptioniff the Uid does not exist on the resource.

See Also