IService.EntityMembersCopy(EntityMembersCopyRequest) Methode

Definition

Namespace:: Microsoft.MasterDataServices.Services.ServiceContracts

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Kopien spezifizierten Mitglieder zu neuen Zielmitgliedern.

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

Parameter

request: EntityMembersCopyRequest

Die Anforderung.

Gibt zurück

EntityMembersCopyResponse

Attribute: FaultContractAttribute OperationContractAttribute

Hinweise

Die Operation EntityMembersCopy(EntityMembersCopyRequest) kopiert Mitglieder und ihre zugehörigen Daten (zum Beispiel Attribute und Hierarchie-Eltern) auf neue Mitglieder mit neuen Mitgliedscodes.

Eine Mitgliederliste wird als Eingabe verwendet. Diese Liste enthält Quell- und Zielmitgliedscodes. Jedes Element in der Liste enthält eine Quelle (Code eines bestehenden Mitglieds) und ein Ziel (Code eines neuen Mitglieds).

Quellcode-Mitglieder werden nach Modell, Version, Entität und Mitgliedscode abgeglichen. GUIDs und/oder exakte Namen werden verwendet, um den Kontext der Metadatenkomponenten zu identifizieren.

Jedes Quellelement, das nicht gefunden wird, führt zu einem Fehler in der EntityMembersCopyResponse. Jeder Zielcode, der bereits innerhalb der Entität und Version existiert, führt zu einem Fehler. Das passiert, weil Codes eindeutig sein MÜSSEN. Alle aufgeführten Mitglieder werden unabhängig von individuellen Rekordfehlern versucht. Die Ausgabe enthält eine Liste der Mitglieder, die erfolgreich kopiert wurden.

Um diese Operation zu verwenden, MÜSSEN Benutzer die Berechtigung haben, neue Mitglieder zu erstellen und die Quellmitglieder zu aktualisieren; Wenn diese Berechtigung nicht erteilt wird, wird ein Fehler in der EntityMembersCopyResponsezurückgegeben. Allgemeine Informationen zu den Mitgliedern finden Sie unter Member. Alle Attribute und Hierarchie-Eltern, die mit dem Quellmitglied verbunden sind, für das eine Aktualisierungsberechtigung erteilt wird, werden dem Zielmitglied zugewiesen.

Alle Hierarchie-Mitglieder-Berechtigungszuweisungen, die direkt an Quellmitglieder angehängt sind (nicht vererbt), werden an Zielmitglieder kopiert.

Gilt für: