Appendix: Data Source Index Mask

After you specify a data source index's Primary Key, you can create a Mask based on that key. This mask will be used to generate a partial URL for each item returned when your index is queried.

The default mask is shown below:

/{1}={0}

Each time this mask generates a URL, the {1} will be replaced by the name of the index's primary key field, and the {0} will be replaced by the value of that field for the corresponding item.

The contents of the partial URL will differ depending on whether the index type is Local Preview or Service. For local preview, if your model is named TestModel and your index's primary field is named FieldID, the URL for an item whose FieldID is 10 will look like this:

/Model.aspx?ProductName=TestModel&refresh=true&FieldID=10

On the other hand, the results of querying a service index are considerably shorter, as shown below:

/FieldID=10

This result comes from the same query as the previous one, but it only contains the key value pair representing the primary key field and whatever value the corresponding item has in that field.

You can modify the mask by adding static text to it, and you can remove the field name and field value markers if they are not needed. For example, if you would rather the partial URL use a generic keyword in place of the name of your primary key, you can do so by re-writing the mask as follows:

/Record={0}

Each URL generated by this new mask will still include the primary key value of the corresponding item, but this value will be paired with the key Record instead of FieldID, as shown below:

/Record=10