# `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 2019 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm