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

Die Operation MetadataDelete(MetadataDeleteRequest) löscht Metadatenobjekte aus einem MDS-Repository. Das Metadata Element der Anfrage identifiziert Objekte, die gelöscht werden sollen. Ein oder mehrere Objekte können innerhalb einer einzigen Anfrage angegeben werden. Die spezifizierten Objekte können denselben oder mehreren Objekttypen angehören. Objekte werden ausschließlich durch GUIDs lokalisiert; Namen werden ignoriert.

Diese Operation führt für jedes Element individuelle Löschoperationen aus. Das Scheitern oder die Unfähigkeit, ein Element zu löschen, beeinflusst nicht den Versuch zu löschen oder die erfolgreiche Löschung weiterer Elemente, die explizit in der Anfrage enthalten sind. Mehrere Aufrufe einzelner Elemente können implementiert werden, wenn alternative Fehlerbehandlungen erforderlich sind.

Löschungen einiger Metadatenkomponenten sind kaskadierend und löschen automatisch ihre Unterkomponenten. 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 einer Modell-Löschungsoperation auf:

• Alle zugehörigen Metadaten-Unterkomponenten (wie Entitäten, Attribute, Hierarchien und Versionen) werden gelöscht.
• Zugehörige Geschäftsregeln werden gelöscht.
• Die zugehörigen Modell- und Hierarchie-Sicherheitsrechte werden gelöscht.

Die folgenden Ereignisse treten während einer Entitäts-Löschoperation auf:

• Die zugehörigen Metadaten-Unterkomponenten (wie Attribute, Attributgruppen und explizite Hierarchien) werden gelöscht.
• Zugehörige Geschäftsregeln werden gelöscht.
• Zugehörige Sicherheitsrechte für Modell- und Hierarchiemitglieder (wie Modellsicherheitsberechtigungen, die an der Entitätskomponente oder darunter zugewiesen sind) werden gelöscht.

Ein Fehler tritt auf, wenn versucht wird, eine Komponente zu löschen, wobei eine oder mehrere der folgenden Bedingungen erfüllt sind:

• 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 verwandte Geschäftsregel existiert.
• Eine explizite Hierarchie wird gelöscht, wenn eine Geschäftsregel auf Eltern innerhalb der Hierarchie verweist.
• Ein Versionsflag, das einer Version zugewiesen ist, wird gelöscht.