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.