Dynamics Connector 12.12

# `collection` element

The `collection` element specifies a starting point for the connector. The connector creates one document for each member of the collection.

Attribute | Description | Required
--- | --- | ---
`name` | The name of the collection to crawl. The connector creates one document for each member of the collection. For example, if you specify `name="accounts"`, the connector will create one document for each account in the Dynamics repository. | Yes
`filter` | A filter to retrieve only some of the members of the collection. The syntax to use to construct the filter is described by the Microsoft developer documentation. | No

## Example

The following example creates a document for each account in the repository:

    <?xml version="1.0" encoding="utf-8"?>
    <spec>
      <collection name="accounts">
        <item name="accountid" />
        <item name="name" />
        <item name="description" />
      </collection>
    </spec>

An example of a document produced by this specification appears below:

    <DOCUMENT>
      <DREREFERENCE>http://host/Dynamics/api/data/v8.1/accounts(34b8ffd0-4232-e611-80c5-0050569248a7)</DREREFERENCE>
      <accountid>34b8ffd0-4232-e611-80c5-0050569248a7</accountid>
      <description>This is the description</description>
      <name>Hewlett Packard Enterprise</name>
    </DOCUMENT>

If you wanted to retrieve only some of the accounts, you could add a filter, for example:

    <?xml version="1.0" encoding="utf-8"?>
    <spec>
      <collection name="accounts" filter="revenue gt 10000">
        <item name="accountid" />
        <item name="name" />
        <item name="description" />
      </collection>
    </spec>

You can configure the connector to retrieve all of the items from more than one collection:

    <?xml version="1.0" encoding="utf-8"?>
    <spec>
      <collection name="accounts" filter="revenue gt 10000">
        <item name="accountid" />
        <item name="name" />
        <item name="description" />
      </collection>

      <collection name="...">
        ...
      </collection>
    </spec>

This might be useful if you want to index information in different documents. For example, you might want to index a document for each of your accounts but separate documents for each support query logged for those accounts.

© 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 Dynamics Connector 12.12

Topic Title: collection element