IOrganizationService Delete Metodu

Bu yazı 25 Mayıs 2019 tarihinde Medium/@dynamics365 altında yayınlanmıştır. 21Mayıs 2020 tarihinde emregulcan.com altında taşınmıştır.

Merhaba,

Bu yazıda Dynamics 365 CE (CRM) SDK ‘da IOrganizationService interface ‘in sağlamış olduğu Delete metodunu inceleyeceğiz.

Delete metodu, Dynamics 365 CE (CRM) 2de herhangi bir Entity (Varlık) üzerinde bir kaydı kalıcı olarak silmemizi sağlamaktadır.

Önemli Noktalar

• Delete metodu ile kayıt silebilmek için ilgili kaydın Dynamics 365 CE (CRM) ID bilgisine ihtiyacımız vardır.
• Delete metodu 2 parametre almaktadır. Bunlar string olarak Entity (Varlık) LogicalName bilgisi, GUID formatında ilgili kaydın Id bilgisidir.
• Delete metodu void bir metotdur, yani geriye değer dönmez.
• Delete metodu ile silme işlemi kalıcı olarak yapılmaktadır ve silinen kayıt geri alınamaz.
• Delete metodu ile sadece 1 kayıt silebiliriz, herhangi bir kritere göre toplu silme işlemi yoktur.

Eğer toplu silme işlemi yapmak istiyorsak öncelikli olarak ilgili kritere göre data listesini çekip, bir döngü içinde (foreach ya da for vb) bu kayıtları tek tek silmeliyiz.

• İlgili varlık için Delete aşamasına yazılmış Plugin ve Workflow ‘lar tetiklenir.
• İşlem yapan kullanıcı (IOrganizationService ‘i oluşturan kimlik sahibi ya da CallerId olarak verilmiş SystemUser), ilgili Entity (Varlık) üzerinde ve ilişkili alt kayıtları üzerinde Delete yetkisine sahip olmalıdır.

.NET Projesi – Örnek Kod

.NET projelerimizde Microsoft.CrmSdk.CoreAssemblies kütüphanelerini kullanarak Dynamics 365 CE (CRM) ‘de Delete işlemi yapabiliriz. Bu kütüphaneleri NuGet üzerinden projemize dahil edebiliriz.

Dynamics 365 CE (CRM) SDK kütüphanelerini projemize nasıl ekleyeceğimizi daha önce burada detaylı olarak anlatmıştım.

Yukarıdaki örnekte görüldüğü gibi Delete metodunun kullanımı oldukça basit. İlk parametresi String olarak ilgili Entity (Varlık) ‘ın LogicalName değeri, ikinci parametre ise GUID formatında ilgili kaydın ID bilgisi.

İşlem yapan kullanıcının Delete işlemi için gerekli yetkileri varsa hatasız olarak bu işlemi tamamlayacaktır.

Umarım faydalı bir yazı olmuştur.

IOrganizationService metotları için oluşturduğum Index yazısına buradan ulaşabilirsiniz.

Dynamics 365 CE (CRM) SDK konusunda ilgili tüm yazılara tek nokta üzerinden ulaşmak isterseniz http://www.emregulcan.com/dynamics365-sdk adresine bakabilirsiniz.