Partager via


IService.EntityMembersCopy(EntityMembersCopyRequest) Méthode

Définition

Copie les membres spécifiés vers les nouveaux membres cibles.

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

request
EntityMembersCopyRequest

Demande.

Retours

Attributs

Remarques

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

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

Les membres sources sont mis en correspondance par modèle, version, entité et code membre. Des GUID et/ou des noms exacts sont utilisés pour identifier le contexte du composant de métadonnées.

Chaque membre source introuvable génère une erreur dans le EntityMembersCopyResponse. Chaque code cible qui existe déjà dans l’entité et la version génère une erreur. Cela se produit parce que les codes DOIVENT être uniques. Tous les membres répertoriés sont tentés indépendamment des erreurs d’enregistrement individuelles. La sortie inclut une liste des membres qui ont été copiés avec succès.

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

Toutes les attributions d’autorisations de membre de hiérarchie qui sont directement attachées aux membres sources (non hérités) sont copiées dans les membres cibles.

S’applique à