Merhaba Arkadaslar,

Yedek Subay olarak askerlik hizmetimi yerine getirdigim yillarda(O zamanlar 16 ay idi) Jandarma Genel Komutanligi Personel Åžube’ de görev almistim. Aslinda temel isim Powerpoint ile sunum hazirlamakti ama verilen emir her ne ise onu da yerine getirmek mesuliyetini tasimaktaydim.

Bir gün komutanim ile birlikte yine sivil hayat için anlamsiz olan ama Askeri disiplin kurallari çerçevesinde gayet de makul görünen bir ise adanmistik. Neredeyse tüm komutanlik personelinin igneli Printer’ dan çikartilmis karinca yazisi ebatlarindaki bilgilerini, bir diger koca liste ile karsilastiracak ve bir filtreleme islemi gerçeklestirecektik. (Isin yaklaşık olarak kesintisiz çalisma ile 48 saate varabilecegini biliyorduk)

Takdir edersiniz ki o yillarda bilgisayar kullaniliyor olmasina ragmen, komutanligin ihtiyaç duydugu ve hayati kolaylastiracak islevsellikler için genellikle Microsoft Office ürünleri ele alinmaktaydi ama elimizde söyle zirt diye filtreleme yapabilecegimiz bir SQL/Oracle ortami da yoktu. (Yil 2001-2003 arasi diyeyim)

Hal böyle olunca elimize aldik çiktilari basladik tek tek karsilastirmaya. Bir ara ben durup bunu daha kolay nasil yapabiliriz diye düsünmeye basladigimi hatirliyorum. Hatta o anlarda arkamda beliren Yarbay’ imin da sert bir ses tonu ile beni rüyamdan uyandirdigini…”Astegmenimmmm!!!…”

Dogruyu söylemek gerekirse ne ben ne de komutanim tüm listeyi dolasmak istemiyorduk. Kafa kafaya vererek güzel bir yol bulduk elbette Yol derken elimizde cetvel, kalem vesaire vardi. Ne bilgisayar ne de baska bir akilli cihaz. O zaman anladim ki bazi islerde kisiye büyük sabir gerekebiliyor. Örnegin TFS(Team Foundation Server) üzerinde kullanilan XML Web Service örneklerinin teker teker bulunup çikartilmasi gibi

TFS mimari alt yapisi ve çevre etkilesimini inceledigimiz su yazimizda Client Object Model’ i kisaca anlamaya çalismistik. O makalede yer alan mimari çizime dikkatlice bakarsak eger, Client Object Model’ in aslinda TFS Web Service’ ler ile haberlestigini görebiliriz. Aslina bakarsaniz Team Foundation Server tarafinda epeyce fazla sayida XML Web Service yer almaktadir. Bu servisleri ana hatlari ile degerlendirdigimizde ise sunucu ve koleksiyon seviyesinde olmak üzere iki ana dala bölündüklerini görürüz.

Asagidaki sekilde bu servisler genel isimlendirmeler halinde ifade edilmektedir.

Dikkat edilmesi gereken notkalardan birisi de bazi servislerin her iki seviyede de yer aliyor olmasidir. Ne varki bu servislerin alanlari farklidir. Sadece bir koleksiyon ve içerigi için kullanilabilecek olan hizmetler Collection Level grubunda yer almaktadir. Diger taraftan tüm TFS sunucusunu ilgilendiren servisler de Server Level grubuna dahildir.

Yine dikkat edilecegi üzere koleksiyon seviyesinde farklilasan(Team Collection örneklerine özel olan) hizmetler bulunmaktadir. Örnegin Version Control veya Lab Management gibi. Normal sartlarda bu servislere, kurulu olan TFS ortamina erisim yetkisi olan istemcilerden ulasilabilinmektedir. Örnegin koleksiyon seviyesinde kullanilabilen ve proje listesinin çekilmesi, proje olusturmasi, silinmesi, branch silinmesi vb operasyonlari ele alabildigimiz Common Structure Service hizmetinin 4ncü versiyonuna asagidaki sekilde görüldügü gibi ulasabiliriz.

Çok dogal olarak diger servislere de ulasmamiz, hatta WSDL(Web Service Description Language) çiktilarina bakmamiz mümkündür. Ben çalismakta oldugum Team Foundation Server 2012 için, uygulama sunucusunun yüklü oldugu IIS(Internet Information Services) altinda yaptigim arastirmalarda, asagidaki uzun listeye ulastigimi rahatlikla ifade edebilirim.

Görüldügü üzere oldukça uzun bir servis listesi söz konusu.

Aslina bakarsaniz bu servislerin detayli olarak ne is yaptiklarina dair MSDN üzerinde çok fazla bilgi bulunmamaktadir. Standart bir teknik Help dokümanindan ötesi degildir. Bu nedenle TFS’ in çalisma yapisini bilip, biraz tahminler yürüterek ilerlemeye çalismak, isinizi epeyce kolaylastiracaktir.

#Region Off Topic

Bu arada dilerseniz bu servislerin tamami izlemek için basit bir Web uygulamasi gelistirebilir ve örnegin listedeki adresleri bir Web User Control içerisine gömerek, tiklama usulüyle ilgili XML Web Service adreslerine gidebilirsiniz. Örnegin asagidaki gibi bir Web User Control ve yardimci sinif isinizi görecektir.

Text dosyasinda durmakta olan servis adreslerini okuyan yardimci tip ve metod;

using System.Collections.Generic;
using System.IO;
using System.Web.UI.WebControls;

namespace AllServices
{
    public static class Utility
    {
        public static List<HyperLink> GetServiceLinks(string textFilePath)
        {
            List<HyperLink> links = new List<HyperLink>();

            string[] lines = File.ReadAllLines(textFilePath);
            foreach (string line in lines)
            {
                if (line.StartsWith("http://"))
                {
                    HyperLink link = new HyperLink
                    {
                        Text = line.Substring(line.LastIndexOf("tfs")),
                        NavigateUrl = line
                    };
                    links.Add(link);
                }               
            }

            return links;
        }
    }
}

Web User Control kodu;

using System;
using System.Web.UI.WebControls;

namespace AllServices
{
    public partial class TfsServicesControl : System.Web.UI.UserControl
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var serviceLinks=Utility.GetServiceLinks(Server.MapPath("~/Services.txt"));
            foreach (var serviceLink in serviceLinks)
            {
                divLinks.Controls.Add(serviceLink);
                divLinks.Controls.Add(new Literal { Text = "<br/><br/>" });
            }
        }
    }
}

ve iste çalisma zamanina ait örnek ekran çiktisi

Bir servis adina tiklayin ve içerigine ulasin

#endregion Off Topic

Referans Etmek

Team Foundation Server üzerinden sunulan XML Web Service örneklerini herhangibir .Net istemcisi tarafindan tüketmek istedigimizde, Client Object Model üzerinden erisimde bulunmamiz gerekmektedir. Normal sartlarda ilgili Web Service’ leri, Add Service Reference sekmesinden hareket edilerek projeye ilave edilebilir ve üretilen Proxy tipinin metodlarina ulasilabilir.

Ancak çalisma zamaninda servis tarafinda kuvvetle muhtemel asagidaki sekilde görülen 504 Unknown Host hatasi alinacaktir.

Bunun nedeni aslinda ilgili servislerin, Client Object Model(veya Server Object Model) tafaindan ele alinis ve üretilis sekilleridir. Dilerseniz basit bir kullanim seklini degerlendirerek ilerlemeye çalisalim.

Hello World

Asagidaki kod parçasinda Collection Level grubundan iki örnek servisin kullanimina yer verilmistir. Bu servislerden birisi ICommonStructureSerice4, digeri ise IProcessTemplates arayüzleri(Interface) tarafindan tasinmaktadir. Dikkat edilecegi üzere anahtar nokta TfsTeamProjectCollection tipinin örneklenis seklidir. Burada TfsTeamProjectCollectionFactory sinifinin static GetTeamProjectCollection metodundan yararlanilmakta olup, fonksiyona parametre olarak TFS sunucusundaki Team Collection’ in HTTP tabanli adresi geçilmektedir.

Bildiginiz üzere TFS kurulumunda aksi belirtilmedikçe mutlaka Default Collection isimli bir Team Collection olusturulmaktadir.

Tabi ki Server Level servis gruplarini kullanmak da isteyebiliriz. Bu durumda TfsConfigurationServer ve TfsConfigurationServerFactory tiplerinden yararlanmamiz gerekmetedir.

Gelelim örnek uygulama kodlarimiza. Bunun için herzaman oldugu gibi basit bir Console uygulamasindan yararlaniyor olacagiz. Eger makinemizde TFS Client Object Model veya ilgili SDK yüklüyse en azindan Microsoft.TeamFoundation.Client ve Microsoft.TeamFoundation.Common assembly’ larinin referans edilmesi gerekmektedir. Ancak bazi servisler farkli Assembly’ larin referans edilmesini gerektirebilir. Söz gelimi WorkItemStore için, Microsoft.TeamFoundation.WorkItemTracking.Client.dll isimli assembly referans edilir.

using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.Server;
using System;

namespace ClientApp
{
    class Program
    {
        static void Main(string[] args)
        {
           TfsTeamProjectCollection collection = TfsTeamProjectCollectionFactory
               .GetTeamProjectCollection(new Uri("http://tfsserver:8080/tfs/defaultcollection"));

            #region Bazi servislerin çekilmesi

           ICommonStructureService4 commonStructureService = (ICommonStructureService4)collection
                .GetService(typeof(ICommonStructureService4));

            IProcessTemplates processTemplateService = (IProcessTemplates)collection.GetService<IProcessTemplates>();

            #endregion Bazi servislerin çekilmesi

            #region Bir Team Project adi üzerinden temel proje bilgisinin çekilmesi

            ProjectInfo argeInfo = commonStructureService.GetProjectFromName("ARGE");
            Console.WriteLine("Proje\t\t\t{0}\nDurumu\t\t\t{1}\nTemplate Id\t\t{2}"
                , argeInfo.Name
                , argeInfo.Status
                , argeInfo.Uri.ToString()
                );

            string name;
            string state;
            int templateId;
            ProjectProperty[] projectProperties;

            // Tüm Proje özelliklerinin çekilmesi
           commonStructureService.GetProjectProperties(
                argeInfo.Uri.ToString()
                , out name
                , out state
                , out templateId
                , out projectProperties);
            Console.WriteLine("\nProje Özellikleri\n");
            foreach (var projectProperty in projectProperties)
                Console.WriteLine("Proje Özelligi\t\t{0}\nDegeri\t\t\t{1}", projectProperty.Name, projectProperty.Value);

            #endregion Bir Team Project adi üzerinden temel proje bilgisinin çekilmesi

            #region Sunucuda yüklü Process Template' lerin bilgilerinin elde edilmesi

            Console.WriteLine("\nProcess Templates\n");
            TemplateHeader[] templateHeaders = processTemplateService.TemplateHeaders();
            foreach (TemplateHeader templateHeader in templateHeaders)
            {
                Console.WriteLine("Template Id\t{0}\nAdi\t\t{1}\nRank\t\t{2}\nDurumu\t\t{3}\nMetadata\t{4}\nAçiklama\t{5}\n",
                    templateHeader.TemplateId,
                    templateHeader.Name,
                    templateHeader.Rank,
                    templateHeader.State,
                    templateHeader.Metadata,
                    templateHeader.Description
                    );
            }

            #endregion Sunucuda yüklü Process Template' lerin bilgilerinin elde edilmesi          
        }
    }
}

TfsTeamProjectCollection referansi elde edildikten sonra, alinmak istenen hizmete ait nesne örneginin üretilmesi için GetService metodundan yararlanilmaktadir. Bu metodun Type parametresi ile çalisan versiyonu disinda generic olan bir versiyonu daha bulunmaktadir. Örnegin,

ICommonStructureService4 commonStructureService = (ICommonStructureService4)collection
                .GetService(typeof(ICommonStructureService4));

kod satiri ile Common Structure Service örnegi üretilmektedir. Bu adimdan sonra söz konusu servise ait referansin fonksiyonlari kullanilabilir. Söz gelimi bir proje adi verilerek özelliklerinin elde edilmesi saglanabilir. Bu özellikler arasinda bir Team Project’ in uyguladigi Process Template bilgisi ve hatta XML tabanli sablon içerigi de yer almaktadir. Asagidaki örnek ekran çiktisinda ARGE isimli projenin ulasilan bilgileri gösterilmektedir.

Diger yandan IProcessTemplate arayüzüne atanan servis referansinin elde edilmesi için, GetService metodunun generic sürümünden yararlanilmistir. Sonrasinda ise TFS sunucusunda yüklü olan Process Template listesine gidilerek Name, State, Metadata, Id, Description gibi bilgileri elde edilmistir. Asagidaki ekran çiktisina bakildiginda Scrum 2.0, CMMI ve MSF sablonlarinin yüklenmis oldugu bilgisine ulasilabilinir.

Tabi burada akla takilan en önemli sorunlardan birisi kullanabilecegimiz TFS Web Service’ lerinin kod tarafindaki GetService metodu tarafindan kullanilabilecek karsiliklarinin neler oldugudur? Bu konuda asagidaki listenin yardimci olabilecegini düsünüyorum.

Yukaridaki listede eksikliker olabilir. Gelen Update’ ler, Service Pack’ ler ve yeni sürümler sonrasin güncellenebilir. Lütfen MSDN üzerinden kontrol ediniz.

Demek ki, istemci tarafinda çalisarak hayatimizi kolaylastirmakta olan pek çok .Net tabanli uygulama(Örnegin Power Tools veya Team Explorer gibi) söz konusu nesne modellerini ve ilgili XML Web Service’ lerini kullanmaktadir. Elbette Team Foundation Server tarafinda çok fazla sayida XML Web Service metodu ve hatta versiyonu bulunmaktadir. TFS üzerindeki tecrübelerinizden yararlanarak bu servislerin efektif olarak kullanimlarini irdeleyebilirsiniz. Böylece geldik bir yazimizin daha sonuna. Tekrardan görüsünceye dek hepinize mutlu günler dilerim.

HowTo_TFSServices.zip (213,36 kb)