Microsoft Dynamics CRM içerisinde Ýstemci Taraflý Kod Geliþtirme

Web uygulamalarýnýn istemci (client) tarafýnda birtakým iþlemleri gerçekleþtirmesi sunucunun (server) daha rahat çalýþmasýný saðlayacaktýr. Dynamics CRM'de bir web tabanlý bir mimariye sahip olduðu için bu durum onda da geçerli. DOM nesne modelinde her HTML elemaný bir nesne olduðu için DHTML programlama teknikleri ile CRM'in formlarýna ve nesnelerine eriþip iþlemler gerçekleþtirebilirsiniz.
CRM'in SDK'sý içerisinde "Client Extensions and Scripting" bölümü altýnda detaylý bilgilerini bulabileceðiniz metot, olay ve nesneleri bir arada bulabileceðiniz bir yazý hazýrladým size.



Genel deðiþkenler ve metotlarý gördükten sonra þimdi nesnelerimizi içinde barýndýran crmForm isimli formumuza ait neler varmýþ bir bakalým.
 

Aþaðýdaki tabloda crmForm.all.<alanadi> ile eriþilebilir alanlarýn ortak özellik ve metotlarýný bulabilirsiniz.Burada unutulmamsý gereken nokta lookup ve picklist alanlarýn aslýnda birer dizi olduklarýdýr. Ýçlerinden birden fazla veri tutabildikleri gibi kullanýcýnýn gördüðü ile veritabanýna yazýlanlarýn farklý olmasýdýr. (lookup için GUID, picklist için ise seçilenin integer deðeri yazýlýr).

Ek olarak bilinmesi gereken PartyList ve email aktivitesi To alaný birden fazla deðer almaktadýr. Diðer Lookuplarýn yapýlarý da bir dizi olmasýna karþýn tek deðer alýrlar.Yani sadece 0. indis doludur.

Lookup alanlarý daha derinlemesine inceleyelim. Lookup alanlarýn yukarýdaki özelliklere ek olarak aþaðýdaki üç özelliði bulunmaktadýr.


Örneklerle konuyu pekiþtirelim. Lookup veri alanýndan deðer okumak ile ilgili örnek;
Bu örnekte bir primarycontactid isimli alandaki deðeri öðreniyoruz.

var lookupItem = new Array;
//primarycontactid alanndaki veriyi okuyoruz.
lookupItem = crmForm.all.primarycontactid.DataValue;
//eðer veri var ise gösteriyoruz.
if (lookupItem[0] != null) {     
// metin     
alert(lookupItem[0].name);
// GUID     
alert(lookupItem[0].id);     
// entity ad.    
alert(lookupItem[0].typename);
}

Lookup veri alanýna veri yazmakla ilgili örnek;
Bu örnekte parentaccountid isimli alana deðer atýyoruz.

//bir Array oluturuyoruz.
var lookupData = new Array();
//Object nesnesi ekliyoruz.
var lookupItem = new Object();
//Object nesnemizde id, typename ve name zelliklerini dolduruyoruz.
lookupItem.id = '{1AAC1363-01A1-DB11-8432-0003FF9CE217}';
lookupItem.typename = 'account';
lookupItem.name = 'A Bike Store';
// Object nesnemizi Array'a veriyoruz.
lookupData[0] = lookupItem;
// Array' parentaccountid alanna veriyoruz.
crmForm.all.parentaccountid.DataValue = lookupData;



Picklist alanlar ile örneðimize geçelim;
Bu örnekte categorytype isimli alan içerisindeki deðerlerle oynuyoruz.

var oField = crmForm.all.categorytype;

// 4. öðeyi alyoruz.
var oOption = oField.Options[4];

// kaç tane öðe olduðunu öðreniyoruz.
alert("Original length :" + oField.Options.length);

// birinci öðeye deðer atýyoruz.
oField.DataValue = 1;

// birinci öðenin adýný alýyoruz.
alert(oField.SelectedText);

// 4. öðeyi siliyoruz.
oField.DeleteOption(4);

// kaç tane öðe olduðunu öðreniyoruz.
alert("New length :" + oField.Options.length);

// 4. öðeyi yeniden ekliyoruz.
oField.AddOption(oOption.Text, oOption.DataValue);

// kaç tane öðe olduðunu öðreniyoruz.
alert("Restored length :" + oField.Options.length);

Form üzerinde JavaScript kodu ile yukarýdaki anlattýklarýmý birleþtirerek her þeyi yazmanýz mümkün.
Daha önceki JavaScript ile ilgili makalelerimden baþka örnekler de bulabilirsiniz:
http://www.cub-e.net/post/CRM-icerisinden-Java-Script-kullanarak-web-sayfasc4b1-cagc4b1rmak.aspx (http://www.cub-e.net/post/CRM-icerisinden-Java-Script-kullanarak-web-sayfasc4b1-cagc4b1rmak.aspx)
http://www.cub-e.net/post/Microsoft-CRM-30-Navigation-Bar-Ogelerini-Form-Icinde-IFrame-Ile-Gostermek.aspx (http://www.cub-e.net/post/Microsoft-CRM-30-Navigation-Bar-Ogelerini-Form-Icinde-IFrame-Ile-Gostermek.aspx)
http://www.cub-e.net/post/OnSave()-Events-on-Dynamics-CRM-javascipt.aspx (http://www.cub-e.net/post/OnSave%28%29-Events-on-Dynamics-CRM-javascipt.aspx)
http://www.cub-e.net/post/OnSave()-Events-on-Dynamics-CRM---Part-II.aspx (http://www.cub-e.net/post/OnSave%28%29-Events-on-Dynamics-CRM---Part-II.aspx)
http://www.cub-e.net/post/Ascentium-CrmService-JavaScript-Library.aspx (http://www.cub-e.net/post/Ascentium-CrmService-JavaScript-Library.aspx)
http://www.cub-e.net/post/Use-JavaScript-executecalllaunch-Dynamics-CRM-40-Workflow.aspx (http://www.cub-e.net/post/Use-JavaScript-executecalllaunch-Dynamics-CRM-40-Workflow.aspx)
http://www.cub-e.net/post/CRM-workflow-date-update-includes-saturdays-sundays.aspx (http://www.cub-e.net/post/CRM-workflow-date-update-includes-saturdays-sundays.aspx)
http://www.cub-e.net/post/Microsoft-Dynamics-CRM-JScript-Export-Tool-JavaScript.aspx (http://www.cub-e.net/post/Microsoft-Dynamics-CRM-JScript-Export-Tool-JavaScript.aspx)

 Topluluk Çözümleri ve Ýçeriðiyle Ýlgili Sorumluluðun Bulunmadýðý Hakkýnda


Topluluk Çözümleri ve Ýçeriðiyle Ýlgili Sorumluluðun Bulunmadýðý Hakkýnda

Microsoft Corporation ve/veya tedarikçileri bu sitede yer alan bilgi ve baðlantýlý grafiklerin uygunluðu, güvenilirliði veya doðruluðu hakkýnda hiçbir beyanda bulunmamaktadýr. Bütün bu bilgiler ve baðlantýlý grafikler, hiçbir garanti verilmeden “olduðu gibi” sunulmaktadýr. Microsoft ve/veya tedarikçileri bu bilgilere ve baðlantýlý grafiklere iliþkin olarak, ticarete veya belirli bir amaca uygun olduklarýna, ustalýkla hazýrlandýklarýna, mülkiyet hakký ve ihlal etmemeye iliþkin yasal ve zýmni garanti ve hükümler de dahil hiçbir garanti vermemekte ve hiçbir hükmü kabul etmemektedir. Dayanaðýnýn sözleþme, haksýz fiil, ihmal, kusursuz sorumluluk veya sair bir neden olmasýna bakýlmaksýzýn, ve hatta Microsoft veya tedarikçilerinden herhangi biri zararýn ortaya çýkma olasýlýðý hakkýnda bilgilendirilmiþ olsa dahi, Microsoft ve/veya tedarikçilerinin hiçbir koþulda, kullaným imkansýzlýðý, veri veya kar kaybý da dahil ancak bunlarla sýnýrlý olmamak üzere bu web sitesinde yer alan bilgi ve baðlantýlý grafiklerin kullanýlmasýndan veya kullanýlamamasýndan veya bunlardan biriyle herhangi bir þekilde baðlantýlý olarak doðan doðrudan, dolaylý, cezai, özel, arýzi, neticede oluþan veya sair hiçbir zarardan sorumlu olmadýðýný özellikle ve açýkça kabul ediyorsunuz.

Not Bu, doðrudan Microsoft destek kuruluþu tarafýndan oluþturulan bir “FAST PUBLISH” makalesidir. Buradaki bilgiler, ortaya çýkan sorunlarý gidermek üzere olduðu gibi saðlanmaktadýr. Mümkün olduðu kadar hýzlý sunulmasýnýn bir sonucu olarak malzemelerde yazým hatalarý bulunabilir ve bunlar bildirimde bulunulmadan daha sonra düzeltilebilir. Diðer hususlar için Kullaným Koþullarý (http://go.microsoft.com/fwlink/?LinkId=151500) ’na bakýn.