Süleyman PETEK - SharePoint 2010 Event Receivers

Wednesday, April 27, 2011

SharePoint 2010 Event Receivers

Merhaba,

SharePoint 2010 makalelerine vakit buldukça kendimce önemli olan konulardan devam etmek istiyorum.

Bu sefer anlatmak istediğim konu “Event Receivers” yani Türkçesi ile “Olay Algılayıcıları” dersek sanıyorum çok yanlış olmaz. SharePoint in ne kadar güçlü bir altyapıya sahip olduğunu tekrar söylememe gerek yok diye düşünüyorum ki Event Receiver lar da SharePoint e güç katan önemli bir özelliktir diyebiliriz.Ayrıca SharePoint in barındırdığı bu Event Receiverlar çok geniş bir yelpazeye sahiptir. Bir Event Receiverı, SharePoint List, ListItem ya da Site için kullanabilirsiniz. Kabaca özetleyecek olursak, SharePoint ekosisteminde bir olay meydana geldiğinde, bu olayı yakalayıp başka aktiviteleri tetiklemeye yarar. Örneğin, şirketinizin İK departmanı, personeli ilgilendiren dökümanlarını Custom bir SharePoint List üzerinde paylaşıyor olsun ve siz de bir çözüm geliştirici olarak personelin hayatını kolaylaştırmak adına, her yeni döküman eklenildiğinde personele e-mail atarak yeni döküman eklendiği bilgisini vermeyi düşünüyorsunuz. Bu işlemi otomatize etmek için imdadınıza EventReceiver lar koşacaktır.

Lafı fazla uzatmadan, basit bir örnek üzerinden giderek icraate geçelim.

Öncelikle boş bir SharePoint 2010 projesi oluşturuyorum ve ERTest olarak adlandırıyorum.Proje tipini de Deploy as a Farm Solution olarak seçiyorum.
Daha sonra SharePoint sistemim üzerinde IKDocs adında bir Document Library oluşturuyorum.
Tekrar Visual Studio tarafına geçiyoruz ve projemize Add New Item diyerek bir EventReceiver ekliyoruz, ben bu EventReceiver in ismine IKDocsER dedim. Karşımıza bir ekran gelecek, buradan Event Receiver ımızın nereleri ve neleri izleyeceğini belirliyoruz. “What type of Event Receiver do you want?” sorusuna “List Item Events” diyoruz, “What item should be the event source?” sorusuna “Document Library” diyoruz, Handle the following events yani hangi olayları izlememi istiyorsun kısmında ise “An item was added” i seçiyoruz sadece. (Siz bu kısımda birden fazla seçenek seçebilirsiniz ama hepsi için ayrı ayrı handle eden kodları da yazmanız gerek)

public override void ItemAdded(SPItemEventProperties properties)
       {
           base.ItemAdded(properties);

       }

Yukarıdaki şekilde hazır gelen kodumuzu şu şekilde değiştiriyoruz.

         public override void ItemAdded(SPItemEventProperties properties)

       {

           base.ItemAdded(properties);

           if (properties.ListTitle == "IKDocs")

           {

               //your logic ...

               //properties.ListTitle

           }

       }

Burada şunu yapıyor kodlarımız, doküman eklenen Document Library miz “IKDocs” mü değil mi kontrolü öncelikle. Daha sonra istediğimiz işi yapabiliriz, burada mail atma ve buna benzer işlemler tamamen size kalıyor. ItemAdded metoduna gelen SPItemEventProperties tipindeki properties değişkeninden size gereken bilgileri de alabilirsiniz...Burada birsürü şey yapılabilir, örneğin bu Document Library ile ilişkilendirilmiş bir workflow start edilebilir, announcements olarak başka yerlere de bildirimler yapılabilir vs. Gerisi tamamen sizin ihtiyaçlarınıza ve hayal gücünüze kalıyor. Özetle, IKDocs adlı document library mize yeni bir eleman eklendiğinde kodlarımız tetikleniyor.

Event Receiver lar konusuna da böylece değinmiş olduk. Umarım işinize yarar bir makale olmuştur.