IService.EntityMembersCopy(EntityMembersCopyRequest) Method

Reference

Definition

Namespace:: Microsoft.MasterDataServices.Services.ServiceContracts

Assembly:: Microsoft.MasterDataServices.Services.Contracts.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Copies specified members to new target members.

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

Parameters

request: EntityMembersCopyRequest

The request.

Returns

EntityMembersCopyResponse

Attributes: FaultContractAttribute OperationContractAttribute

Remarks

The EntityMembersCopy(EntityMembersCopyRequest) operation copies members and their associated data (for example, attributes and hierarchy parents) to new members with new member codes.

A members list is used for input. This list includes source and target member codes. Each item in the list includes a source (code of an existing member) and a target (code of a new member).

Source members are matched by model, version, entity, and member code. GUIDs and/or exact names are used to identify metadata component context.

Each source member that is not found results in an error in the EntityMembersCopyResponse. Each target code that already exists within the entity and version results in an error. This occurs because codes MUST be unique. All listed members are attempted regardless of individual record errors. The output includes a list of the members that were successfully copied.

To use this operation, users MUST have permission to create new members and to update the source members; when this permission is not granted, an error is returned in the EntityMembersCopyResponse. For general information about members, see Member. Any attributes and hierarchy parents that are associated with the source member for which update permission is granted are assigned to the target member.

Any hierarchy member permission assignments that are directly attached to source members (not inherited) are copied to target members.

Applies to