3.1.4.24 EntityMembersCopy

The EntityMembersCopy 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 section 2.2.4.132. 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.

The following is the WSDL definition of the EntityMembersCopy operation.

Applies to MDS 2008R2

     <wsdl:operation name="EntityMembersCopy">
       <wsdl:input wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/EntityMembersCopy" name="EntityMembersCopyRequest" message="tns:EntityMembersCopyRequest" />
       <wsdl:output wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/EntityMembersCopyResponse" name="EntityMembersCopyResponse" message="tns:EntityMembersCopyResponse" />
    </wsdl:operation>

Applies to MDS 2012

     <wsdl:operation name="EntityMembersCopy">
       <wsdl:input wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/EntityMembersCopy" name="EntityMembersCopyRequest" message="tns:EntityMembersCopyRequest"/>
       <wsdl:output wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/EntityMembersCopyResponse" name="EntityMembersCopyResponse" message="tns:EntityMembersCopyResponse"/>
       <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/EntityMembersCopySkuNotSupportedMessageFault" name="SkuNotSupportedMessageFault" message="tns:IService_EntityMembersCopy_SkuNotSupportedMessageFault_FaultMessage"/>
       <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/EntityMembersCopyEditionExpiredMessageFault" name="EditionExpiredMessageFault" message="tns:IService_EntityMembersCopy_EditionExpiredMessageFault_FaultMessage"/>
    </wsdl:operation>