Parameter Management - Managing COO (Change of Ownership) Parameters

Managing COO (Change of Ownership) Parameters

There are two major enhancements with respect to the Change of Ownership of Parameters.Import ModuleDevice Callback FeatureImport Module: This feature auto imports the device details available in .xml or .csv file from a pre-defined folder location instead of manually importing the files from VHQ GUI.The following changes must be made to the .xml import file.Version of .xml file is set to 2.0Hierarchy Section: Rename to HierarchyName.Group Section: Rename to GroupName.Device Section:Hierarchy tag rename to HierarchyPath.HierarchyName is added.Operation and Upgradable Package are added under Package assignment section.Operation tag in Package Assignment section specifies Assign/Unassign/Upgrade the package. The possible values for Operation are A/D/U. (add/delete/modify)Upgradable Package to be upgraded.If value of HierarchyPath is blank, the Import tool uses the value given in the HierarchyName attribute to place the device in the appropriate node in the VHQ hierarchy.The operation fails, if there are multiple nodes in the VHQ hierarchy with the same hierarchy node name.In Update (U) operation for a device, status of device can be updated to Inactive or Deleted.If the device status is set as Inactive or Deleted:Software Assignment and Software Upgrade will fail.The Parameters assigned to the applications cannot be updated.VHQ Import tool generates an Import Status XML output file with the following information about the processing status of the device records in the XML input file:The XML import status file generated on a pre-defined location, with the name <Import_File_Name>_<VHQVHQ user ID of user who initiated the import>_YYYYMMDDHH24MISS.xml, and the status file is accessible from VHQ GUI.Summary ResultsThe summary results include the following information:Total number of device records in XML input file.The number of device records that were successfully processed from XML input file.The number of device records that were rejected from XML input file, along with a breakdown of the error count for each type of error code reported in the output status file.Detailed ResultsFor each of the records that were rejected from the input file, the output status XML file includes the following information:A dump of the device record from the input file.An error code with a descriptive message indicating the reason why the device record was NOT processed by VHQ import tool.The table given below has a list of suggested error codes that VHQ import tool can return when processing a record in the XML input file.
Error Code Description
E_DUPLICATE_TERMINAL Specified device already exists
E_INVALID_HIERARCHY Hierarchy does not exist.
E_DUPLICATE_HIERARCHY Multiple nodes found in hierarchy for value of “HierarchyName”.
E_INVALID_APPLICATION Application does not exist
E_INVALID_MODEL Model does not exist
E_INVALID_PACKAGE Package does not exist
E_INCOMPATIBLE_PACKAGE Package is not compatible with existing packages assigned to device, due to presence of common application.
E_INVALID_PARAMETER Parameter does not exist
E_INVALID_REFERENCE_SET Reference set does not exist
E_INVALID_GROUP Group does not exist
E_LICENSE_EXCEEDED Unable to add device, as the number of devices currently in the VHQ database has exceeded the licensed number of devices.
E_GENERAL_ERROR General Error
The Sample XML file format is given below:The Sample Result XML file format is given below: