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