IService.EntityMembersCopy(EntityMembersCopyRequest) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Копирует указанные элементы в новые целевые элементы.
public:
Microsoft::MasterDataServices::Services::MessageContracts::EntityMembersCopyResponse ^ EntityMembersCopy(Microsoft::MasterDataServices::Services::MessageContracts::EntityMembersCopyRequest ^ request);
[System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.SkuNotSupportedMessage))]
[System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.EditionExpiredMessage))]
[System.ServiceModel.OperationContract]
public Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyResponse EntityMembersCopy (Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyRequest request);
[<System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.SkuNotSupportedMessage))>]
[<System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.EditionExpiredMessage))>]
[<System.ServiceModel.OperationContract>]
abstract member EntityMembersCopy : Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyRequest -> Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyResponse
Public Function EntityMembersCopy (request As EntityMembersCopyRequest) As EntityMembersCopyResponse
Параметры
- request
- EntityMembersCopyRequest
Запрос.
Возвращаемое значение
- Атрибуты
Комментарии
Операция EntityMembersCopy(EntityMembersCopyRequest) копирует элементы и связанные с ними данные (например, атрибуты и родители иерархии) в новые члены с новыми кодами элементов.
Для ввода используется список членов. Этот список включает исходный и целевой коды элементов. Каждый элемент в списке включает источник (код существующего элемента) и целевой объект (код нового элемента).
Исходные элементы сопоставляются по модели, версии, сущности и коду элемента. Идентификаторы GUID и (или) точные имена используются для идентификации контекста компонента метаданных.
Каждый исходный элемент, который не найден, приводит к ошибке EntityMembersCopyResponseв . Каждый целевой код, который уже существует в сущности и версии, приводит к ошибке. Это происходит потому, что коды ДОЛЖНЫ быть уникальными. Все перечисленные члены выполняются независимо от ошибок отдельных записей. Выходные данные включают список элементов, которые были успешно скопированы.
Чтобы использовать эту операцию, пользователи ДОЛЖНЫ иметь разрешение на создание новых участников и обновление исходных элементов; Если это разрешение не предоставлено, в возвращается ошибка .EntityMembersCopyResponse Общие сведения о членах см. в разделе Member. Все атрибуты и родители иерархии, связанные с исходным элементом, для которого предоставляется разрешение на обновление, назначаются целевому члену.
Все назначения разрешений членов иерархии, которые напрямую присоединены к исходным членам (не наследуются), копируются в целевые члены.