Overview#

A modification type describes one of the four ways in which an attribute can have its value set altered in a Modify Request. The defined modification types are:

• add -- One or more values are to be added to the target attribute. If the attribute does not exist in the target entry, then it will be added with the given values; otherwise the provided value(s) will be appended to the set of values already defined for that attribute. An add modification type must always supply at least one value.

• delete -- One or more values are to be removed from the target attribute, or that attribute is to be removed entirely from the target entry. If one or more specific values are given, then only those values are to be removed from the target attribute (and if they represent the entire set of values for that attribute, then that attribute will be removed from the entry). If no values are given, then the entire attribute (regardless of the number of values it contains) is to be removed from the entry.

• replace -- The set of values for the target attribute should be replaced with the given set of values. A replace can have zero or more values, and the behavior is as follows:
  • If the target attribute already exists in the entry with one or more values, and the replace modification does not have any of its own values, then the target attribute will be removed from the entry.
  • If the target attribute already exists in the entry with one or more values, and the replace modification has one or more of its own values, then the existing set of values will be replaced with the new set of values.
  • If the target attribute does not exist in the entry and the replace modification does not have any of its own values, then no action will be taken.
  • If the target attribute does not exist in the entry and the replace modification has one or more of its own values, then the attribute will be created in the entry with the specified set of values.

• increment -- The value of the target attribute should be incremented by the specified amount. The target attribute must exist in the entry with exactly one value, and that value must be an integer. The increment modification must also include exactly one value and that value must be an integer. The existing value is to be incremented by an amount specified by the increment value. If the increment value is negative, then the existing value will be deprecated by an amount equal to the absolute value of the increment value.

More Information#

There might be more information for this subject on one of the following:

• SupportedFeatures