IService.MetadataDelete(MetadataDeleteRequest) Methode

public:
 Microsoft::MasterDataServices::Services::MessageContracts::MetadataDeleteResponse ^ MetadataDelete(Microsoft::MasterDataServices::Services::MessageContracts::MetadataDeleteRequest ^ request);

[System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.EditionExpiredMessage))]
[System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.SkuNotSupportedMessage))]
[System.ServiceModel.OperationContract]
public Microsoft.MasterDataServices.Services.MessageContracts.MetadataDeleteResponse MetadataDelete (Microsoft.MasterDataServices.Services.MessageContracts.MetadataDeleteRequest request);

[<System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.EditionExpiredMessage))>]
[<System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.SkuNotSupportedMessage))>]
[<System.ServiceModel.OperationContract>]
abstract member MetadataDelete : Microsoft.MasterDataServices.Services.MessageContracts.MetadataDeleteRequest -> Microsoft.MasterDataServices.Services.MessageContracts.MetadataDeleteResponse

Public Function MetadataDelete (request As MetadataDeleteRequest) As MetadataDeleteResponse

Parameter

Gibt zurück

Attribute

FaultContractAttribute OperationContractAttribute

Hinweise

Der MetadataDelete(MetadataDeleteRequest) Vorgang löscht Metadatenobjekte aus einem MDS-Repository. Das Element der Metadata Anforderung identifiziert objekte, die gelöscht werden sollen. Ein oder mehrere Objekte können innerhalb einer einzelnen Anforderung angegeben werden. Die angegebenen Objekte können denselben oder mehrere Objekttypen aufweisen. Objekte werden nur über GUIDs gefunden. Namen werden ignoriert.

Dieser Vorgang gibt für jedes Element einzelne Delete-Vorgänge aus. Der Fehler oder die Unfähigkeit, ein Element zu löschen, wirkt sich nicht auf den Versuch zum Löschen oder das erfolgreiche Löschen anderer Elemente aus, die explizit in der Anforderung enthalten sind. Wenn eine alternative Fehlerbehandlung erforderlich ist, können mehrere Aufrufe für einzelne Elemente implementiert werden.

Löschungen einiger Metadatenkomponenten werden kaskadiert und die untergeordneten Komponenten automatisch gelöscht. Dies geschieht in Fällen, in denen die Komponenten vollständig von der gelöschten Komponente abhängig sind und daher ohne die gelöschte Komponente keinen weiteren Nutzen haben.

Die folgenden Ereignisse treten während eines Löschvorgangs des Modells auf:

• Alle zugehörigen Metadatenunterkomponenten (z. B. Entitäten, Attribute, Hierarchien und Versionen) werden gelöscht.
• Zugeordnete Geschäftsregeln werden gelöscht.
• Zugeordnete Sicherheitsberechtigungen für Modell und Hierarchieelement werden gelöscht.

Die folgenden Ereignisse treten während eines Entitätslöschvorgangs auf:

• Die zugehörigen Metadatenunterkomponenten (z. B. Attribute, Attributgruppen und explizite Hierarchien) werden gelöscht.
• Zugeordnete Geschäftsregeln werden gelöscht.
• Zugeordnete Modell- und Hierarchieelementsicherheitsberechtigungen (z. B. Modellsicherheitsberechtigungen, die der Entitätskomponente oder unten zugewiesen sind) werden gelöscht.

Ein Fehler tritt auf, wenn versucht wird, eine Komponente zu löschen, wenn mindestens eine der folgenden Bedingungen erfüllt ist:

• Eine Entität, ein Attribut oder eine explizite Hierarchie wird gelöscht, wenn sie von einer abgeleiteten Hierarchie verwendet wird.
• Ein Attribut wird gelöscht, wenn eine zugehörige Geschäftsregel vorhanden ist.
• Eine explizite Hierarchie wird gelöscht, wenn eine Geschäftsregel auf übergeordnete Elemente innerhalb der Hierarchie verweist.
• Ein Versionsflag, das einer Version zugewiesen ist, wird gelöscht.

Gilt für: