Open topic with navigation

# CategoryReplaceFromXML

Allows you to import category information contained in an XML file to a specified category, replacing that category and deleting all previous information below the category. The imported category information is stored as new descendants of the category to which it is imported.

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.

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

Note: This action supports normal, SimpleCat, and Relevance categories.

## Example

    http://12.3.4.56:9000/action=CategoryReplaceFromXML&ImportFileName=MyCategory.xml&OnConflict=Overwrite

This action uses port `9000` to instruct IDOL Category Component, 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, completely replacing the previous content of 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:

- ImportFileName

- ImportXML

© 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close We welcome your comments! To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm