2022.1

Parameters
Name
Name of the field to add. The name must adhere to this syntax rules: start with a letter,
followed by zero or more letters, numbers, underscore or dash. The name is not case-
sensitive.
Value
Value of the element. There is no restriction on the content, although binary is discouraged.
Flags
Additional flags for the method. This determines how the method behaves when the specified
name already exists.
afReplace 0 Overwrites the previous value with the new
afAppend 1 Appends the new value at the end of the previous one
afDuplicate 2 Creates a new field with the same name
afFail 3 Raise an error
Note
In an Active Script environment, such as the Run Script task, you must use the numerical
value, since the TAddFlags type is not defined in an Active Script environment.
Index (optional)
Instance of the field to modify. This must be a numeric value equal to 0 or greater and can
only be used with the afReplace flag.
Exceptions
l EOleException The name is empty or invalid.
l EOleException The flags value is invalid.
l EOleException The name already exists and the afFail flag was specified.
Page 236