IService.EntityMembersCopy(EntityMembersCopyRequest) Méthode

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

Paramètres

Retours

Attributs

FaultContractAttribute OperationContractAttribute

Remarques

L’opération EntityMembersCopy(EntityMembersCopyRequest) copie les membres et leurs données associées (par exemple, les attributs et les parents hiérarchiques) vers de nouveaux membres avec de nouveaux codes membres.

Une liste des membres sert à l’entrée. Cette liste inclut les codes membres source et cible. Chaque élément de la liste comprend une source (code d’un membre existant) et une cible (code d’un nouveau membre).

Les membres sources sont associés par modèle, version, entité et code membre. Les GUID et/ou les noms exacts sont utilisés pour identifier le contexte des composants de métadonnées.

Chaque membre source non trouvé entraîne une erreur dans le EntityMembersCopyResponse. Chaque code cible déjà présent dans l’entité et la version entraîne une erreur. Cela se produit parce que les codes DOIVENT être uniques. Tous les membres listés sont tentés, indépendamment des erreurs individuelles de dossier. La sortie inclut une liste des membres qui ont été copiés avec succès.

Pour utiliser cette opération, les utilisateurs DOIVENT avoir la permission de créer de nouveaux membres et de mettre à jour les membres sources ; lorsque cette permission n’est pas accordée, une erreur est retournée dans le EntityMembersCopyResponse. Pour des informations générales sur les membres, voir Member. Tous les attributs et parents hiérarchiques associés au membre source pour lequel la permission de mise à jour est accordée sont attribués au membre cible.

Toute attribution de permissions de membres hiérarchiques directement attachée aux membres sources (non héritées) est copiée vers les membres cibles.