IService.EntityMembersCopy(EntityMembersCopyRequest) Método

Referência

Definição

Namespace:: Microsoft.MasterDataServices.Services.ServiceContracts

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

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

EntityMembersCopyResponse

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. 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.

Aplica-se a