IService.MetadataDelete(MetadataDeleteRequest) Metodo

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

Parametri

Valori restituiti

Attributi

FaultContractAttribute OperationContractAttribute

Commenti

L'operazione MetadataDelete(MetadataDeleteRequest) elimina gli oggetti metadati da un repository MDS. L'elemento della Metadata richiesta identifica gli oggetti da eliminare. Uno o più oggetti possono essere specificati all'interno di una singola richiesta. Gli oggetti specificati possono appartenere allo stesso tipo o a più tipi di oggetti. Gli oggetti sono localizzati solo tramite GUID; i nomi vengono ignorati.

Questa operazione esegue operazioni di cancellazione individuali per ogni elemento. Il mancato o l'impossibilità di eliminare un elemento non influisce sul tentativo di eliminazione o sulla cancellazione con successo di altri elementi esplicitamente inclusi nella richiesta. Possono essere implementate chiamate multiple per singoli elementi se è richiesta una gestione alternativa degli errori.

Le cancellazioni di alcuni componenti dei metadati sono a cascata e eliminano automaticamente i loro componenti figli. Questo avviene nei casi in cui i componenti dipendono completamente dal componente eliminato e quindi non hanno ulteriore utilità senza il componente eliminato.

I seguenti eventi si verificano durante un'operazione di cancellazione del modello:

• Tutti i sottocomponenti dei metadati correlati (come entità, attributi, gerarchie e versioni) vengono eliminati.
• Le regole aziendali associate vengono eliminate.
• I permessi di sicurezza associati ai membri del modello e della gerarchia vengono eliminati.

I seguenti eventi si verificano durante un'operazione di Cancellazione di un'entità:

• I sottocomponenti dei metadati correlati (come attributi, gruppi di attributi e gerarchie esplicite) vengono eliminati.
• Le regole aziendali associate vengono eliminate.
• I permessi di sicurezza associati ai membri del modello e della gerarchia (come i permessi di sicurezza del modello assegnati al componente dell'entità o inferiore) vengono eliminati.

Un errore si verifica quando si tenta di eliminare un componente quando una o più delle seguenti condizioni sono vere:

• Un'entità, un attributo o una gerarchia esplicita viene eliminato quando viene utilizzato da una gerarchia derivata.
• Un attributo viene eliminato quando esiste una business rule correlata.
• Una gerarchia esplicita viene eliminata quando una business rule fa riferimento ai genitori all'interno della gerarchia.
• Un flag di versione assegnato a una versione viene eliminato.