IService.EntityMembersCopy(EntityMembersCopyRequest) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Copia i membri specificati nei nuovi membri di destinazione.
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
Parametri
- request
- EntityMembersCopyRequest
Richiesta.
Restituisce
- Attributi
Commenti
EntityMembersCopy(EntityMembersCopyRequest)Tramite l'operazione vengono copiati i membri e i relativi dati associati (ad esempio, attributi e elementi padre della gerarchia) ai nuovi membri con nuovi codici di membro.
Per l'input viene usato un elenco di membri. Questo elenco include i codici dei membri di origine e di destinazione. Ogni elemento nell'elenco include un'origine (codice di un membro esistente) e una destinazione (codice di un nuovo membro).
I membri di origine vengono confrontati in base al codice del modello, della versione, dell'entità e del membro. I GUID e/o i nomi esatti vengono usati per identificare il contesto del componente dei metadati.
Ogni membro di origine non trovato genera un errore in EntityMembersCopyResponse . Ogni codice di destinazione già esistente all'interno dell'entità e della versione genera un errore. Questo problema si verifica perché i codici devono essere univoci. Tutti i membri elencati vengono tentati indipendentemente dagli errori dei singoli record. L'output include un elenco dei membri che sono stati copiati correttamente.
Per utilizzare questa operazione, è necessario che gli utenti dispongano dell'autorizzazione per la creazione di nuovi membri e per l'aggiornamento dei membri di origine. Quando questa autorizzazione non viene concessa, viene restituito un errore in EntityMembersCopyResponse . Per informazioni generali sui membri, vedere Member . Gli attributi e gli elementi padre della gerarchia associati al membro di origine per cui viene concessa l'autorizzazione Update vengono assegnati al membro di destinazione.
Tutte le assegnazioni delle autorizzazioni dei membri della gerarchia che sono collegate direttamente ai membri di origine (non ereditate) vengono copiate nei membri di destinazione.