IService.EntityMembersCopy(EntityMembersCopyRequest) Methode

Referenz

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.

Kopiert die angegebenen Member in neue Zielmember.

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

Der EntityMembersCopy(EntityMembersCopyRequest) Vorgang kopiert Member und ihre zugeordneten Daten (z. B. Attribute und Hierarchieeltern) in neue Member mit neuen Membercodes.

Für die Eingabe wird eine Memberliste verwendet. Diese Liste enthält Quell- und Zielmitgliedscodes. Jedes Element in der Liste enthält eine Quelle (Code eines vorhandenen Members) und ein Ziel (Code eines neuen Members).

Quellmember werden nach Modell, Version, Entität und Membercode abgeglichen. GUIDs und/oder genaue Namen werden verwendet, um den Kontext von Metadatenkomponenten zu identifizieren.

Jedes Nicht gefundene Quellmember führt zu einem Fehler in .EntityMembersCopyResponse Jeder Zielcode, der bereits innerhalb der Entität und Version vorhanden ist, führt zu einem Fehler. Dies tritt auf, weil Codes eindeutig sein MÜSSEN. Alle aufgeführten Member werden unabhängig von einzelnen Datensatzfehlern versucht. Die Ausgabe enthält eine Liste der Elemente, die erfolgreich kopiert wurden.

Um diesen Vorgang verwenden zu können, MÜSSEN Benutzer über die Berechtigung verfügen, neue Member zu erstellen und die Quellmitglieder zu aktualisieren. wenn diese Berechtigung nicht erteilt wird, wird ein Fehler in EntityMembersCopyResponsezurückgegeben. Allgemeine Informationen zu Membern finden Sie unter Member. Alle Attribute und übergeordneten Hierarchien, die dem Quellmember zugeordnet sind, für das die Updateberechtigung erteilt wird, werden dem Zielmember zugewiesen.

Alle Hierarchiememberberechtigungszuweisungen, die direkt an Quellmember angefügt sind (nicht geerbt), werden in Zielmember kopiert.

Gilt für: