# CategoryImportFromCluster

Allows you to import clusters to categories. IDOL Category Component creates one category for each cluster. By default, IDOL Category Component stores the imported category information as new descendants of the root category.

NOTE: This is an administrative action that can be sent only by users that belong to an authorization role that allows the `Admin` standard role, or which enables the action explicitly. See Authorization Roles Configuration Parameters.

## Example

    http://12.3.4.56:9020/action=CategoryImportFromCluster&SourceJobName=Job1&Parent=1234567898765432

This action imports all the clusters in `Job1` to categories. The new categories are descendants of the category with the ID `1234567898765432`.

## Required Parameters

The following action parameters are required.

Parameter | Description
--- | ---
SourceJobName | The name of the cluster source job to import to categories.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
BuildNow | Whether to build the category immediately.
Cluster | The clusters to import to categories.
NumResults | The number of cluster results to use to build a category.
Parent | The parent of the new category.
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.

_FT_HTML5_bannerTitle.htm