Элемент Association в элементе MethodInstances (схемы BDCMetadata)
Дата последнего изменения: 17 июня 2010 г.
Применимо к: SharePoint Server 2010
Пространство имен: https://schemas.microsoft.com/windows/2007/BusinessDataCatalog
Схема: BDCMetadata
Элемент Association связывает связанные внешние типы контента с системой. Например, в системе AdventureWorks клиент связан с заказом на продажу следующим образом: клиент осуществляет заказ на продажу. В элементе Association хранятся указатели на исходный и целевой внешние типы контента, а также указатель на бизнес-логику (объект MethodInstance), которая позволяет клиенту получить целевой внешний тип контента из исходного. Для обхода элемента Association вызывается метод внешней системы.
В модели подключения к бизнес-данным логика элемента Association (объект MethodInstance) может применяться к любому внешнему типу контента (целевому, исходному или несвязанному) при условии, что целевой внешний тип контента принадлежит объекту LobSystem, который содержит экземпляр метода Association.
.gif "Предупреждающая заметка") Внимание! |
|---|
Обратите внимание, что при использовании SharePoint Designer 2010 необходимо создать операцию Association для целевого внешнего типа контента. Это обязательное для SharePoint Designer требование. Применение других методов моделирования (для исходного или другого внешнего типа контента) невозможно. |
Служба подключения к бизнес-данным также поддерживает сценарии с несколькими исходными и одним целевым внешним типом контента.
Экземпляр метода Association содержит позиции для значений идентификатора экземпляра SourceEntity, а также позицию для значений идентификатора экземпляра DestinationEntity. Таким образом, необходимо предоставить достаточное число входных объектов TypeDescriptor с идентификаторами, соответствующими каждому идентификатору для каждого внешнего типа контента, который является исходным для элемента Association в методе Association. Атрибут IdentifierName для входного объекта TypeDescriptor сигнализирует службе подключения к бизнес-данным о вставке значения идентификатора EntityInstance, релевантного до выполнения метода. Например, в AssociationMethodInstance пользователь может предоставлять значения идентификатора для исходного экземпляра EntityInstance, который требуется извлечь. Служба подключения к бизнес-данным вставляет это значение в соответствующую позицию после полного создания экземпляра этого параметра с использованием всех установленных по умолчанию значений.
Служба подключения к бизнес-данным также поддерживает псевдосвязи внешнего ключа, которые не являются связями первого класса. Рассмотрим веб-метод, возвращающий объект клиента, одно из полей которого является ключевым для объекта адреса клиента. Также присутствует другой веб-метод, возвращающий адрес по заданному ключу. Разработчик метаданных может использовать этот метод в качестве метода для связывания клиента и адреса (возможно, с использованием специального средства поиска адреса). Псевдосвязь внешнего ключа видит, что целевым объектом этого метода является объект адреса, извлекает ключ объекта адреса из возвращенного объекта клиента и затем вызывается метод связывания, который автоматически возвращает адрес.
| Внимание! |
|---|
Обратите внимание, что псевдосвязи поддерживаются в модели подключения к бизнес-данным (BDC), но не в приложении SharePoint Designer 2010, которое не поддерживает разработку связей такого типа. |
Элемент Association принимает следующее свойство.
| Важно! |
|---|
В свойствах учитывается регистр. |
Свойства
Свойство |
Тип |
Описание |
Обязательный атрибут |
Значение по умолчанию |
Ограничения/Приемлемые значения |
|---|---|---|---|---|---|
HideOnProfilePage |
System.Boolean |
Задает необходимость добавления связанного внешнего типа контента на страницу профиля главного внешнего типа контента. |
Необязательный |
<Association Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Association>
Атрибуты и элементы
В следующих разделах приводится описание атрибутов, дочерних и родительских элементов.
Атрибуты
Атрибут |
Описание |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Тип |
Обязательный атрибут. Атрибут MethodInstanceType, задающий тип элемента Association. В следующей таблице приведен список возможных значений этого атрибута.
|
||||||||||||
Default |
Необязательный атрибут. Указывает, является ли элемент Association установленным по умолчанию среди всех элементов Association соответствующего типа в содержащем их внешнем типе контента. Если присвоено значение true, элемент Association установлен по умолчанию. Если присвоено значение false, элемент Association не является установленным по умолчанию. Значение по умолчанию: false Тип атрибута: Boolean |
||||||||||||
ReturnParameterName |
Необязательный атрибут. Имя параметра, содержащего атрибут ReturnTypeDescriptor элемента Association. Атрибут Direction этого параметра должен содержать значение "Out", "InOut" или "Return”. Тип атрибута: String |
||||||||||||
ReturnTypeDescriptorName |
Необязательный атрибут. Этот метод устарел. Используйте метод ReturnTypeDescriptorPath. Тип атрибута: String |
||||||||||||
ReturnTypeDescriptorLevel |
Необязательный атрибут. Этот метод устарел. Используйте метод ReturnTypeDescriptorPath. Тип атрибута: Integer |
||||||||||||
ReturnTypeDescriptorPath |
Необязательный атрибут. Выделенный пунктиром путь атрибута TypeDescriptor элемента Association. Тип атрибута: String |
||||||||||||
Имя |
Обязательный атрибут. Имя элемента Association. Тип атрибута: String |
||||||||||||
DefaultDisplayName |
Необязательный атрибут. Установленное по умолчанию отображаемое имя элемента Association. Тип атрибута: String |
||||||||||||
IsCached |
Необязательный атрибут. Указывает на частое использование элемента Association. Значение по умолчанию: true Тип атрибута: Boolean |
Дочерние элементы
Элемент |
Описание |
|---|---|
Элемент LocalizedDisplayNames в MetadataObject (схема BDCMetadata) |
Элемент LocalizedDisplayNames задает список локализованных имен для элемента Association. |
Элемент Properties в элементе MetadataObject (схема BDCMetadata) |
Элемент Properties задает свойства элемента Association. |
Элемент AccessControlList задает набор прав доступа для элемента Association. |
|
Элемент SourceEntity в элементе Association (схема BDCMetadata) |
Элемент SourceEntity задает исходный внешний тип контента для элемента Association. |
Элемент DestinationEntity в элементе Association (схема BDCMetadata) |
Элемент DestinationEntity задает целевой внешний тип контента для элемента Association. |
Родительские элементы
Элемент |
Описание |
|---|---|
Элемент MethodInstances, содержащий элемент Association. |