IService.EntityMembersCopy(EntityMembersCopyRequest) Método

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

Parâmetros

Retornos

Atributos

FaultContractAttribute OperationContractAttribute

Comentários

A EntityMembersCopy(EntityMembersCopyRequest) operação copia membros e seus dados associados (por exemplo, atributos e pais de hierarquia) para novos membros com novos códigos de membro.

Uma lista de membros é usada para entrada. Esta lista inclui códigos de membro fonte e alvo. Cada item da lista inclui uma fonte (código de um membro existente) e um alvo (código de um novo membro).

Os membros fonte são combinados por modelo, versão, entidade e código de membro. GUIDs e/ou nomes exatos são usados para identificar o contexto dos componentes de metadados.

Cada membro fonte que não é encontrado resulta em um erro no EntityMembersCopyResponse. Cada código de destino que já existe dentro da entidade e da versão resulta em um erro. Isso ocorre porque os códigos DEVEM ser únicos. Todos os membros listados são tentados independentemente de erros individuais no recorde. A saída inclui uma lista dos membros que foram copiados com sucesso.

Para usar essa operação, os usuários DEVEM ter permissão para criar novos membros e atualizar os membros fonte; quando essa permissão não é concedida, um erro é retornado no EntityMembersCopyResponsearquivo . Para informações gerais sobre os membros, veja Member. Quaisquer atributos e pais de hierarquia associados ao membro fonte para o qual a permissão de atualização é concedida são atribuídos ao membro alvo.

Quaisquer atribuições de permissão de membros hierarquicos que estejam diretamente anexadas aos membros fonte (não herdadas) são copiadas para os membros-alvo.