Association element in Associations

(Subscription Schema)

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Represents a subscription association.

Namespace: http://schemas.microsoft.com/office/2006/03/BusinessDataCatalog

Schema: Subscription

<Association RefreshIntervalInMinutes = "Long" MethodInstanceName = "String" LobSystemInstanceName = "String" TargetSubscriptionName = "String" TargetView = "String" Enabled = "Boolean" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Association>

Elements and attributes

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

**RefreshIntervalInMinutes**

Required.

The time interval at which to refresh the cache. This value cannot be less than 10 minutes. If the value is set to less than 10 minutes, Microsoft Business Connectivity Services (BCS) ignores this value and uses the default value of 60 minutes.

Attribute type: **Long**

**MethodInstanceName**

Required.

The **Association** method instance name that returns the related external items.

Attribute type: **String**

**LobSystemInstanceName**

Required.

The external system name of the **Association** method instance.

Attribute type: **String**

**TargetSubscriptionName**

Optional.

The name of the target subscription that should contain these related external items. This subscription also must exist in the solution package.

Attribute type: **String**

**TargetView**

Required.

The **SpecificFinder** view for the related external items.

Attribute type: String

**Enabled**

Optional.

Specifies whether this subscription association is enabled. If not enabled, the **Association** method instance is not run and the cache is not populated with the related external items. If not specified, the association is enabled.

Attribute type: **Boolean**

**Name**

Required.

The name of the subscription association.

Attribute type: **String**

**DefaultDisplayName**

Optional.

The default display name of the subscription association.

Attribute type: **String**

**IsCached**

Optional.

This value is ignored by Business Connectivity Services in the current release.

Attribute type: **Boolean**

Child elements

Element Description
LocalizedDisplayNames element in MetadataObject (Subscription Schema) The list of the localized display names of this subscription association.
Properties element in MetadataObject (Subscription Schema) Not used by Business Connectivity Services in this release.
FilterValues element in Association (Subscription Schema) The list of the filter values for the Association method instance execution.

Parent elements

Element Description
Associations element in Subscription (Subscription Schema) The Associations element that contains this subscription association.