Tuğrul Meşebaşı

Sharepoint listelerinde farklı parametrelerle dataları çekmek ve var olan datarları sıralamak için CAML query’ler kullanılabilir. Oldukça hızlı ve kullanışlı dır. CAML Query taglarını başta yazmak zor gibi gözükse de , query’leri farklı tool’larla doğrulayarak kod parçanızın içerisine rahatlıkla ekleyebilirsiniz.

Örneğimizde CAML query oluşturmak ile ilgili bazı tanımlardan bahsedeceğim. Bir sonraki yazıda oluşturacağımız CAML query’leri projemizde kullanacağız.

U2U Caml Query Builder 2007 CAML queryleri oluşturmak ve test etmek için kullanacabileceğiniz kullanışlı bir araçtır. Programı http://www.u2u.net/res/Tools/CamlQueryBuilder.aspx linkinden indirebilirsiniz.

Program üzerinde CAML query’i nedir ne işe yarar bir göz atalım. Programı çalıştırıyoruz. Sharepoint site Url yazan kısma sitemizin url’ni girdikten sonra Connect tuşuna basıyoruz. Karşımıza çıkan ekranda tüm listeler yer almaktadır. Herhangi bir listeyi seçtikten sonra ekran listenin kolonları listelenecektir. Kolon seçimini ve sıralama ya da koşul vereceğimizi belirledikten sonra Editor sekmesinde oluşturduğunuz sorguyu görüntüleyebilirsiniz , Test tuşuna bastığınızda sorgunuzun sonuçları listelecektir.

Caml Query’leri kullanarak kullanıcıdan aldığınız parametler ile listeleri filtreyebilirsiniz , custom list view oluşturabilirsiniz. Sharepoint Listeler üzerinde çalışırken listedeki verilerin tümünü çekmediğiniz her işlem için CAML query’ler sizlere oldukça kolaylık sağlayacaktır .

İyi çalışmalar dilerim…

Sharepoint’e sharepoint’in kurulu olmadığı bir makineden bağlanarak işlemler yapmak istiyorsanız , sharepoint webservisleri kullanmalısınız. Sharepoint webservisleri ile sharepoint arayüzünden yapabildiğiniz birçok özelliği kullanabilirsiniz. Server üzerinde olmayan uygulamalar ile örneğin listelere bağlanmak, veri kayıt, silme , güncelleme gibi işlemleri yapabilirsiniz.

Sharepoint webservis uygulamaları ile yapacağınız uygulamalar sayesinde kullanıcılara sharepoint portal sayfanızı göstermeden sharepoint üzerinde yapmasını istediğiniz tüm işlemleri yapmanız mümkündür. Ayrıca sharepoint’te oluşan durumların farklı makinelerden kontrolü sonrası kullanıcıların uyarılması ya da bilgilendirme maili atılması gibi daha aklıma gelmeyen birçok işlemi servisler sayesinde gerçekleyebiliriz.

Yapacağımız projede sharepoint sitecollection’a webservis yardımı ile bağlanacağız. Gerekli Web Referanslar’ını ekleyeceğiz. Sitecollection üzerindeki sayfaları listeleyeceğiz. Ardından kullanıcının seçmiş olduğu sayfadaki tüm listeleri kullanıcıya göstereceğiz. Son olarak kullanıcının seçmiş olduğu listedeki tüm item’ları çekeceğiz.

Projemiz 3 kısımdan oluşacak : Siteleri listelemek ; Seçilen sayfadaki üm listeleri çekmek ;Seçilen listedeki kayıtları çekmek

Visual studio ile yeni bir Windows Form Application oluşturalım.

1)Siteleri listelemek : Oluşturduğumz projede , sharepoint portal sayfasında bulunan siteleri listelemek için projeye sağ tıklayarak Add Sevice Reference diyoruz. Karşımıza çıkan ekran Advanced seçeneğine bastıktan sonra karşımıza çıkan ekranda sol alta köşede Add Web Reference çıkacaktır , bu seçeneğe tıklıyoruz. Add Web Reference ekranında URL kısmına listeler ile işlem yapacağımız için siteleri çekebileceğimiz http://sharepointsite/_vti_bin/webs.asmx adresini URL kısmına yazıyoruz. Web referansa istediğiniz bir isim verdikten sonra tamam’a basıyoruz.

Web Referansında dikkat edilmesi gereken web servis URL ‘dir. http://sharepointsite/vti_bin/webs.asmx Url’inde olduğu gibi hangi sitecollection üzerinden bağlantı kuracağımız /vti_bin/webs.asmx ekinden önceki sayfa Url’idir. Örneğin : projeyi geliştirdiğimiz makinede spoint:1000 ve spoint:1000/examplesitecollection Url’leri altında farklı iki sitecollection var. Web servis eklerken url’lerimiz şu şekilde olmalıdır.

http://spoint:1000/vti_bin/webs.asmx

http://spoint:1000/examplesitecollection/vti_bin/webs.asmx

Web referansı projeye ekledik. Şimdi proje Form’una bir Button ve hemen altına da bir Listbox ekliyoruz. Button tıkladığında bağlı olduğumuz sitecollection altındaki tüm listeleri web servis yardımı ile çekerek listbox’da listeleyeceğiz. Button_Click olayına şu kod parçasını ekliyoruz.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Xml;
using System.Windows.Forms;
 
namespace SharepointWebService
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }
 
        private void button1_Click(object sender, EventArgs e)
        {
            spointwebs.Webs webColl = new SharepointWebService.spointwebs.Webs();
            webColl.UseDefaultCredentials = true;
            listBox1.Items.Clear();
            listBox1.Items.Add(webColl.Url.Remove(webColl.Url.IndexOf('_')));
            XmlNode xNode = webColl.GetWebCollection();
            foreach (XmlNode xchild in xNode.ChildNodes)
            {
                listBox1.Items.Add(xchild.Attributes["Url"].Value);
            }
        }
    }
}

Yukarıdaki kodda webColl.UseDefaultCredentials = true; satırı bağlanan kullanıcının yetkilerini kullan anlamına gelir. Eğer bu satırı kodda kullanmaz iseniz izinlere takılacak muhtemelen hata alacaksınız. Bu satır yerine yeni bir yetki tanımlaması yada sabit bir kullanıcı da verebilirsiniz.

2) Seçilen sayfadaki tüm listeleri çekmek : Siteleri çekip listeledikten sonra kullanıcın listelenen sitelerden herhangi birini seçmesi durumunda , seçilen sitenin listelerini, Form’a ekleyeceğimiz listbox’ta görüntüleyeceğiz. Bu işlem için projeye sağ tıklayarak Add Web Reference diyoruz URL kısmına http://sharepointsite/_vti_bin/lists.asmx yazıyoruz. Bu web servis ile listelere erişilebilir ve listeler üzerinde tüm işlemler yapılabilir. İlk aşamada siteleri listbox1′de listemiştik. Listbox1 seçim olayına liste çektiğimiz kodu ekliyoruz. Kod aşağıdaki şekilde oluşacaktır.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

namespace SharepointWebService
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }
 
        private void button1_Click(object sender, EventArgs e)
        {
            spointwebs.Webs webColl = new SharepointWebService.spointwebs.Webs();
            webColl.UseDefaultCredentials = true;
            listBox1.Items.Clear();
            listBox1.Items.Add(webColl.Url.Remove(webColl.Url.IndexOf('_')));
            XmlNode xNode = webColl.GetWebCollection();
            foreach (XmlNode xchild in xNode.ChildNodes)
            {
                listBox1.Items.Add(xchild.Attributes["Url"].Value);
            }
        }
 
        private void listBox1_SelectedIndexChanged(object sender, EventArgs e)
        {
            spointlists.Lists listCol = new SharepointWebService.spointlists.Lists();
            listCol.Url = listBox1.SelectedItem.ToString() + "/_vti_bin/lists.asmx";
            listCol.UseDefaultCredentials = true;
 
            listBox2.Items.Clear();
 
            XmlNode xNode = listCol.GetListCollection();
            foreach (XmlNode xchild in xNode.ChildNodes)
            {
                listBox2.Items.Add(xchild.Attributes["Title"].Value);
            }
        } 
     }
}

Burada dikkat edilmesi gereken durum , listCol.Url = listBox1.SelectedItem.ToString() + “/_vti_bin/lists.asmx”; satırıdır. Bağlandığımız ilk servis spoint:1000 url’i altındaydı. Eklediğimiz liste web servisinin url’ini kullanıcının seçimine bağlı olarak değiştiriyoruz. Böylece kullanıcının seçmiş olduğu siteye göre web servis url’i değişecek dolayısıyla seçilen sitenin listeleri ekranda listelenecektir.

3)Seçilen listedeki kayıtları çekmek : Son adıma gelene kadar siteleri ve listeleri listeledik. Şimdi ise seçilen liste verilerini ekleyeceğimiz listbox’a ayraç kullanarak listeyeceğiz. Son eklediğimiz liste web servisi ile bu işlemi yapmak mümkün fakat yazımızda ne kadar farklı web servis kullanırsak o kadar iyi olur diye düşünüyorum.(Burada kullandıklarımız dışında sharepoint web servislerinin tüm listesini açıklamalarıyla birlikte http://msdn.microsoft.com/en-us/library/bb862916(office.12).aspx adresinden bulabilirsiniz.)

Liste verilerini çekmek için kullanacağımız web servisi ekliyoruz. Web servisimizin URL’i http://sharepointsite/_vti_bin/sitedata.asmx şeklinde olacaktır. Site listelerini gösterdiğimiz listbox2 ‘deki seçim değiştiğinde kullanıcının seçmiş olduğu listenin verilerini göstereceğiz. Kod aşağıdaki şekilde olacaktır.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

namespace SharepointWebService
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }
 
        private void button1_Click(object sender, EventArgs e)
        {
            spointwebs.Webs webColl = new SharepointWebService.spointwebs.Webs();
            webColl.UseDefaultCredentials = true;
            listBox1.Items.Clear();
            listBox1.Items.Add(webColl.Url.Remove(webColl.Url.IndexOf('_')));
            XmlNode xNode = webColl.GetWebCollection();
            foreach (XmlNode xchild in xNode.ChildNodes)
            {
                listBox1.Items.Add(xchild.Attributes["Url"].Value);
            }
        }
 
        private void listBox1_SelectedIndexChanged(object sender, EventArgs e)
        {
            spointlists.Lists listCol = new SharepointWebService.spointlists.Lists();
            listCol.Url = listBox1.SelectedItem.ToString() + "/_vti_bin/lists.asmx";
            listCol.UseDefaultCredentials = true;
 
            listBox2.Items.Clear();
 
            XmlNode xNode = listCol.GetListCollection();
            foreach (XmlNode xchild in xNode.ChildNodes)
            {
                listBox2.Items.Add(xchild.Attributes["Title"].Value);
            }
        }
 
        private void listBox2_SelectedIndexChanged(object sender, EventArgs e)
        {
            spointlists.Lists listCol = new SharepointWebService.spointlists.Lists();
            listCol.Url = listBox1.SelectedItem.ToString() + "/_vti_bin/lists.asmx";
            listCol.UseDefaultCredentials = true;
 
            spointsitedata.SiteData sdata = new SharepointWebService.spointsitedata.SiteData();
            sdata.Url = listBox1.SelectedItem.ToString() + "/_vti_bin/sitedata.asmx";
            sdata.UseDefaultCredentials = true;
 
            spointsitedata._sWebMetadata md;
            spointsitedata._sWebWithTime[] wt;
            spointsitedata._sListWithTime[] lwt;
            spointsitedata._sFPUrl[] furl;
            string role;
            string[] roles;
            string[] rolesg;
 
            uint i = sdata.GetWeb(out md, out wt, out lwt, out furl, out role, out roles, out rolesg);
            Guid g = new Guid(md.WebID);
 
            XmlDocument doc = new XmlDocument();
            doc.LoadXml("<Document><Query /><ViewFields /><QueryOptions /></Document>");
            XmlNode x = listCol.GetListItems(listBox2.SelectedItem.ToString(), string.Empty, doc.SelectSingleNode("//Query"), doc.SelectSingleNode("//ViewFields")
                                 , string.Empty, doc.SelectSingleNode("//QueryOptions"), g.ToString());
 
            listBox3.Items.Clear();
 
            foreach (XmlNode xchild in x.ChildNodes)
            {
                foreach (XmlNode xchild2 in xchild.ChildNodes)
                {
                    if (xchild2.Attributes != null)
                    {
                        try
                        {
                            string item = string.Empty;
                            foreach (XmlAttribute att in xchild2.Attributes)
                            {
                                item = item + " @ " + att.Value;
                            }
                            listBox3.Items.Add(item);
                        }
                        catch (Exception )
                        {
                            listBox3.Items.Add("Liste \"Title\" kolonu içermiyor...");
                        }
                    }
                }
            }
        }
    }
}

Umarım bu örnek sizler için yararlı olmuştur. Herkese iyi çalışmalar.

Shareopint basit iş akışları için bize hızlı ve kullanışlı çözümler sunsa bile , bir zaman sonra farkedeceksiniz ki , iş akışı süreci analiz sırasında sizlere basit gelse dahi , bu akışı sharepoint ortamına aktarmak hiç de kolay değil. Dolayısıyla sharepoint arayüzden iş akışı tanımlamayı çok sık kullanacağınızı düşünmüyorum.

O yada bu sebepten iş akış ihtiyaçlarınızı sharepoint üzerinde kullanma olasılığınız oldukça yüksek. Sharepoint’in iş akışlarının , bizler için yeterli olmadığı durumlarda alternatif çözümlerimizin neler olduğundan ileriki yazılarımızda bahsedeceğiz.

Yazımızda custom uygulamalarda karşısınıza oldukça sık çıkacak olan Workflow Status’lerden bahsedeceğim.
Sharepoint listesi üzerinde herhangi bir iş akışı başlattığınızda , listeye iş akışınıza vermiş olduğunuz varsayılan ad ile aynı isimde bir kolon oluşturulur ve varsayılan liste view’ine eklenir. Eklenen bu kolon iş akışına sokulmuş olan item’ın workflow status değerini tutar. Sharepoint sitenize bağlanıp , iş akışını tanımladığınız listeden verileri çekerseniz , iş akışı ile listeye eklenen kolon değerleri şu şekilde gelecektir :

Bu değerleri bir yere not etmenizi şiddetle tavsiye ederim. Farklı sayfalardaki iş akışlarını raporlarken ya da görevlerin düştüğü tasks listelerinde workflow status değerlerini çekip durumları kullanıcılara bildirmek gibi istekli karşılarken bu değerleri kullanacaksınız. Çektiğiniz değer bu şekilde rakamla gelirken , listede açıklamaları şeklinde gözükecektir.

Oluşturduğunuz iş akışını kullanmış olduğunuz listedeki item’lerin workflow status’lerini çekerken daha önceki örneklerde yaptığımız gibi listeye bağlanıp workflow status bilgisini tutan alana erişerek herbir veri için bu değeri alıyor ve yazdırıyoruz.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
 
namespace GetWorkflowStatus
{
    class Program
    {
        static void Main(string[] args)
        {
            SPSite site = new SPSite("http://spoint:1000/sites/sitecollection");
            SPWeb web = site.RootWeb;
            SPList list = web.Lists["Onay Listesi"];
            foreach (SPItem item in list.Items)
            {
                Console.WriteLine(item["Title"].ToString() + " - " + item["Onay"].ToString());
            }
            Console.ReadLine();
        }
    }
}

Sharepoint içerisinde gizli içerik yapıları , listeler ve alanlar bulunmaktadır. Projede öncelikle listeleri inceleyeceğiz. Gizli listelerin özelliklerini değiştirerek listeleyeceğiz. Daha sonra listenin kolonlarına bakacağız. Liste kolonlarından özelliği gizli (hidden) ayarlanmış olanları tespit ederek bu alanları görünür hale getireceğiz. Gizli liste ve alanları göstererek sharepoint üzerindeki birçok log bilgilerine ulaşabilirsiniz.

Visual Studio ile console projesi oluşturuyoruz. Microsoft.Sharepoint.dll referansını ekliyoruz. Öncelikle sharepoint sitecollection’a bağlanıyoruz. Bağlandığımız sayfadaki tüm listeleri adları ve “hidden” özellikleri ile listeliyoruz.


Sharepoint listelerinin hidden property’si true ise sharepoint sayfasında gözükmeyecektir. Sharepoint sitenize var olan listeleri sayfa üzerinde görebilmek için SiteActions->SiteSetting->Document Libraries And Lists linkine tıklayınız.
Listeledğimiz sharepoint listelerinden görünmeyen listeleri listelemek için bu özelliği false yapıyoruz. Sharepoint listelerini tekrar kontrol ettiğimizde daha önceden hidden property’leri true olan ve gözükmeyen listeleri listeleyebilirsiniz.
Devamı için tıklayın…

Projemizde Sharepoint Document Library ‘leri kod ile siteye ekleyeğiz ve sharepoint quick launch kategorisinde görünmesini sağlayacağız. Visual Studio ile console application açarak sharepoint dll’leri referans olarak ekledikten sonra kodlamaya başlıyoruz.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
 
namespace CreateList
{
    class Program
    {
        static void Main(string[] args)
        {
            SPSite site = new SPSite("http://spoint:1000/sites/sitecollection/");
            site.AllWebs[0].Lists.Add("CodeList", "bu liste kod ile oluşturulmuştur.", SPListTemplateType.DocumentLibrary);
            SPList list = site.AllWebs[0].Lists["CodeList"];
            list.OnQuickLaunch = true;
            list.EnableVersioning = true;
            list.Update();          
        }
    }
}

OnQuickLaunch -> eklenen listenin sol taraftaki hızlı erişim kategorisinde listelenmesini sağlar
EnableVersioning -> listeye eklenen dökümanların versiyonlarının tutulması ile ilgili özellik

Not: Eğer değişiklik yaptığınız listeyi güncellemesseniz yaptığınız değişiklikler gözükmeyecektir.

İyi çalışmalar …

Sitecollection altında bir website oluşturabilmek için sitecollection ‘a bağlandıktan sonra sitecollection altındaki tüm websitelerine AllWebs property’si ile erişilebilir. Sharepoint referanslarını ekledikten sonra kod aşağıdaki gibi olacaktır.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
 
namespace CreateWebSite
{
    class Program
    {
        static void Main(string[] args)
        {
            SPSite siteCollection = new SPSite("http://spoint:1000/sites/sitecollection");
            SPWeb spweb = siteCollection.AllWebs.Add("website1", "Web Sitesi", "Bu websitesi kod ile oluşturulmuştur", 1033, "BLOG#0", false, false);
 
            Console.Write("sitecollection altında site oluşturuldu...");
            Console.ReadLine();
        }
    }
}

SPWeb spweb = siteCollection.AllWebs.Add(“website1″, “Web Sitesi”, “Bu websitesi kod ile oluşturulmuştur”, 1033, “BLOG#0″, false, false); satırı ile websitesini ekledik. Parametreleri incelersek;
Devamı için tıklayın…

Sharepoint ile yapacağımız işlemler için windows uygulamaları yazacağız. Shareopint sitesine bağlanma, sitedeki kütüphaneleri listeleme , view oluşturma, liste oluşturma gibi birkez yapılacak işlemleri kodlarla geliştireceğiz. Arayüzden yapacağımız birçok işlemi kodla yaparak sharepoint hiyerarşisini daha iyi anlayacağız.

Visual Studio ile yeni Windows Console Application oluşturuyoruz. Sharepoint ile ilgili işlemler yapmak için projeye C:\Program Files \Common Files \Microsoft Shared \web server extensions \12 \ISAPI dizini altında Microsoft Sharepoint.dll referansını ekliyoruz.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
 
namespace CreateSiteCollection
{
    class Program
    {
        static void Main(string[] args)
        {
            SPSite site = new SPSite("http://spoint:1000");
            SPWebApplication webapp = site.WebApplication;
            webapp.Sites.Add("/sites/sitecollection", "Site Collection", "Bu site collection kod ile oluşturulmuştur.", 1033, "STS#0", "spoint\\administrator", "administrator", "administrator@spoint.com.tr");
 
            Console.WriteLine("SiteCollection oluşturuldu....");
            Console.ReadLine();
        }
    }
}

Varolan siteye bağlanarak , sitenin oluşturulduğu webapplication’ı çekiyoruz. Webapplication üzerinde yeni bir sitecollection oluşturuyoruz.
Devamı için tıklayın…