This method is deprecated and was replaced with replaceReferences.
Replaces references in a specified field of a specified data item.
This function replaces the existing reference or references contained in the field specified in options.referringItemFieldName within the data item specified in options.referringItemId.
The function removes existing references and in their place it adds references to the items specified in options.newReferencedItemIds.
Note: If you pass an empty array in options.newReferencedItemIds, all existing references are removed.
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 replacing references.
This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.