IDOL Server 12.12

# Create a Cluster Map

You can use the `ClusterMapFromResults` action to create a map of the clusters that you generate from your query.

You provide XML-formatted cluster information to `ClusterMapFromResults` as the value of the `ImportXML` parameter, and the action returns a 2-D cluster map as binary image data. The file is by default in JPEG format, but (as in the case of the `ClusterServe2DMap` action) you can specify another format by setting the `PictureFormat` configuration parameter in the `[Cluster]` section of the IDOL Content component configuration file.

`ClusterMapFromResults` also creates and stores a new set of cluster results that includes the map coordinates of the clusters. If your application uses these cluster results to support mouse-over effects when displaying the cluster map, you can retrieve the results by using the `ClusterResults` action. In this case, use the `TargetJobName` from the `ClusterMapFromResults` action as the `SourceJobName` in the `ClusterResults` action.

When you use the `ImportXML` parameter to send data to `ClusterMapFromResults`, you must use the following format:

    <?xml version='1.0' encoding='UTF-8' ?>
    <autn:clusters xmlns:autn='http://schemas.autonomy.com/aci/'>
        <autn:numclusters>5</autn:numclusters>
        <autn:cluster>
            <autn:title>MyClusterTitle</autn:title>
            <autn:score>5.63</autn:score>
            <autn:term>CAT~[85]</autn:term>
            <autn:term>DOG~[76]</autn:term>
            <autn:term>RABBIT~[65]</autn:term>
            <autn:term>HAMST~[64]</autn:term>
            <!-- more terms -->
            <autn:docs>
                <autn:numdocs>3</autn:numdocs>
                <autn:doc>
                    <autn:title>MyDocTitle</autn:title>
                    <autn:ref>http://foo.com</autn:ref>
                    <autn:score>5</autn:score>
                <autn:doc>
            <!-- more docs-->
            </autn:docs>
        </autn:cluster>
        <!-- more clusters-->
    </autn:clusters>

This XML format is similar to the format of the XML results of a `Query` action. If you pass this data to the `ClusterMapFromResults` action in the `ImportXML` parameter, you must first percent-encode it.

NOTE: As an alternative to providing XML data to `ClusterMapFromResults`, you can provide it with a job name from a previous `ClusterCluster` action.

Related Topics

- Generate a Cluster Map after You Cluster

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.12 | Last updated June 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Server 12.12

Topic Title: Create a Cluster Map