This method is deprecated and was replaced with insertReference.
Inserts a reference in the specified field in an item in a collection.
A reference in options.dataItemReference specifies a referring item's ID, the field in which to insert the reference, and the ID of the referenced item.
This method may require higher-level permissions than the caller has, based on their identity and roles and permissions. In these cases, you can ensure the method is called with the required level of authorization by using one of the following:
Options for inserting a reference.
This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.