Michael_Lowry

overwriteLinks parameter of ImportObject class is named & documented incorrectly

Discussion created by Michael_Lowry on Apr 6, 2017
Latest reply on Jun 7, 2017 by Michael_Lowry
The overwriteLinks method of the ImportObject AE Java API class does not work as documented:
overwriteLinks - If true Folderlinks will not be kept
In fact, it works oppositely to the way described.

Value of overwriteLinksBehavior
false
For objects that are replaced, the home folder locations of these objects are determined by the import location and any locations described in the FOLDER_STRUCT portion of the XML file. (The relative folder structure from the source AE system.) Any links to these objects are removed.
true
For objects that are replaced, the home folder locations of these objects are not changed. If  the objects’ home folders are different than the target import folder, then links to the replaced objects will be created in the target folder.
In other words, the value of the overwriteLinks parameter corresponds directly to the state of the Keep existing folder links check box in the XML import UI dialog box.
15xy6a7hlz1m.pngt0jw86c5rfq5.png
XML import dialog box (JUI)
XML import dialog box (AWI)

Note that the language in the UI is exactly opposite to the language in the API.

I suggest that Automic take one of the following courses of action:
  • Change the name of the parameter (e.g., topreserveLinks), or
  • Swap the behaviors oftrueandfalse.

Outcomes