CategoryImportFromXML

Import category information contained in an XML file to a specified category. The imported category information is stored as new descendants of the category to which it is imported. If the import XML includes the category IDs, CategoryImportFromXML creates categories with those IDs, rather than generating new ones.

The XML file from which you import the category information must be in HPE category XML format. For more information about this format, refer to the IDOL Server Administration Guide.

You can use this information to import normal, SimpleCat, and Relevance categories.

NOTE:

If you exported the category XML from a Category component where the MultipleParentsAllowed configuration parameter was set to True in the [Category] section of the configuration file, CategoryImportFromXML cannot import a category that has the same ID as an existing category, or that has the same name and parent as an existing category. In this case, the action rejects these categories.

NOTE:

This is an administrative action that can be sent only from AdminClients (which are set in the [Server] section of the configuration file).

Example

http://12.3.4.56:9000/action=CategoryImportFromXML&ImportFileName=MyCategory.xml

This action uses port 9000 to instruct HPE IDOL Server, which is located on a machine with the IP address 12.3.4.56, to import the category information contained in the MyCategory.xml file to the root category.

Parameters

Parameter Description Required
BuildNow Whether to build the category immediately.  
Flat Whether to use a flat XML format.  
ImportFileName The file that contains the data to import. See Comments
ImportXML

XML data to import.

NOTE:

You can use a POST request if you use this parameter.

See Comments
OnConflict How to handle duplicate categories.  
Parent The parent of the new categories.  
UserName The name of the user that sends the action.  

This action accepts the following standard ACI action parameters.

Parameter Description
ActionID A string to use to identify an ACI action.
EncryptResponse Encrypt the output.
FileName The file to write output to.
ForceTemplateRefresh Forces the server to load the template from disk.
Output Writes output to a file.
ResponseFormat The format of the action output.
Template The template to use for the action output.
TemplateParamCSVs A list of variables to use for the specified template.

Comments

You must specify one of the following parameters:


_HP_HTML5_bannerTitle.htm