IService.EntityMembersCopy(EntityMembersCopyRequest) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Copia membros especificados para novos membros de destino.
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
- request
- EntityMembersCopyRequest
A solicitação.
Retornos
- Atributos
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. Essa lista inclui códigos de membro de origem e de destino. Cada item na lista inclui uma origem (código de um membro existente) e um destino (código de um novo membro).
Os membros de origem são correspondidos por modelo, versão, entidade e código membro. GUIDs e/ou nomes exatos são usados para identificar o contexto do componente de metadados.
Cada membro de origem 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 exclusivos. Todos os membros listados são tentados independentemente de erros de registro individuais. A saída inclui uma lista dos membros que foram copiados com êxito.
Para usar essa operação, os usuários DEVEM ter permissão para criar novos membros e atualizar os membros de origem; quando essa permissão não é concedida, um erro é retornado no EntityMembersCopyResponse. Para obter informações gerais sobre membros, consulte Member. Todos os atributos e pais de hierarquia associados ao membro de origem para o qual a permissão de atualização é concedida são atribuídos ao membro de destino.
Todas as atribuições de permissão de membro de hierarquia diretamente anexadas aos membros de origem (não herdadas) são copiadas para membros de destino.