Devexpress SchedulerControl Kullanımı

Uzun bir aradan sonra merhaba;

Sizlere bu makalede Devexpress ürününün en karmaşık kontrollerinden biri olan SchedulerControl nesnesinin kullanımı açıklamaya çalışacağım.

Scheduler kontrol adındanda anlaşılacağı üzere tarihsel işlemleri görsel hale getirebileceğimiz detaylı bir kontroldür.zamanlamalı olarak randevu,görev,işlem vb. kavramları scheduler kontrol nesnesiyle kullanabiliriz.bunlarlada sınırlı değil tabiki.isterseniz Microsoft Outlook Takviminede bağlayabilir ve işlem kapsamınızı genişletebilirsiniz.Lafı fazla uzatmadan kodlamaya geçelim isterseniz.


bu makaledeki bağlantı ve işlem şekilleri tamamen C# kodları ile yapılmaktadır.dataset vb. kontrolleri kullanmadım.

yeni bir windows forms Projesi açalım ve boş bir forma schedulercontrol nesnesini sürükleyip bırakalım.
kontrol ekranımıza yerleştiğinde alt kısımda SchedulerStorage isimli nesneyi göreceksiniz.SchedulerStorage SchedulerControl'ün çalışması için gerekli bir nesnedir zira veri işlemleri SchedulerStorage nesnesinde yapılır(Veri tabanı bağlantıları,kaynaklar vs.)
Scheduler control aslında Storage içerisindeki verileri görsel hale getirmeye yarar.

SchedulerControl nesnesinin veri tabanı ile ilişkisini sağlayabilmek için SchedulerStorage kontrolünü veritabanına bağlamamız gerekiyor.bunu yapabilmek için aslında ayrı bir makale konusu olan SchedulerStorage mappings kavramını kısaca burada açıklayalım;

SchedulerStorage mappings kendisi için gerekli alanları tutan (Renk,Zamanlama,Açıklama vs.) ve istediğinizde custom olarak da saha ekliyebileceğiniz bir nevi sanal bir tablodur.ilk olarak SchedulerStorage veritabanından sql sorgusuyla doldurulur.Daha sonra mappings işlemi yapılır yani SchedulerStorage nesnesinin mappings alanlarına sorgudan dönen kolonların ataması yapılır.

SqlConnection qcon = new SqlConnection("BAGLANTIDIZESİ");
qcon.Open();
SqlCommand qcommand = new SqlCommand("SELECT * FROM TABLO", qcon);
SqlDataAdapter qadapter = new SqlDataAdapter(qcommand.CommandText, qcon);
DataTable qtbl = new System.Data.DataTable();
qadapter.Fill(qtbl);
qcon.Close();

schedulerStorage1.Appointments.DataSource =qtbl;

evet yukarıda da gördüğünüz gibi veritabanından verileri çektik,bir datatable nesnesine atadık ve bu datatable nesnesini schedulerstorage nesnesinin appointments(Randevu,Görev) dataSource una eşitledik.yine bu şekilde storage nesnesinin "Appointment Dependencies (Randevu Bağımlılıkları)" ve "Resources (Kaynaklar)" bağlantısınıda yukarıdaki şekilde kurabilirsiniz.ben burada sadece randevu bağlantısını kurdum.

şimdi bağlantıyı kurduğumuza göre tek yapmamız gereken mappings yolu ile storage nesnesine hangi alanı ne için kullanacağımızı anlatmak.bunuda şu şekilde yapıyoruz;

schedulerStorage1.Appointments.Mappings.AppointmentId = "Id";
schedulerStorage1.Appointments.Mappings.Description = "ACIKLAMA";
schedulerStorage1.Appointments.Mappings.Start = "BASLANGICTARIHI";
schedulerStorage1.Appointments.Mappings.End = "BITISTARIHI";
schedulerStorage1.Appointments.Mappings.Label = "RANDEVURENGI(ÖZELLİĞİ,ÖNEMİ)";
schedulerStorage1.Appointments.Mappings.Status = "DURUMU";
schedulerStorage1.Appointments.Mappings.Location = "MEKAN_YER_VS";

projeyi çalıştırdığımızda eğer tablonuzda kayıt var ise ve eşleşmeyi doğru yaptıysanız kontrol üzerinde verileri görmeniz gerekir.

işinize yarıyacak diğer SchedulerStorage event'ları aşağıdaki gibidir;

AppointmentsInserted=yeni bir kayıt gerçekleştiğinde tetiklenir.
AppointmentsDeleted = kayıt silindiğinde tetiklenir.
AppointmentsChanged = kayıt düzenlendiğinde tetiklenir.


SchedulerControl nesnesinin "AppointmentViewInfoCustomizing" event'ı sayesinde görünümleri kısıtlı hale getirebilirsiniz.mesela; başlangıç tarihi bugün tarihinden önce olan kayıtların arka planını kırmızı renkli hale getir gibi.

şu şekilde yapabilirsiniz;

private void schedulerControl1_AppointmentViewInfoCustomizing(object sender, AppointmentViewInfoCustomizingEventArgs e)
{
if (e.ViewInfo.Appointment.Start == Convert.ToDateTime("2014-04-11 11:40:42.010"))
{
e.ViewInfo.Appearance.BackColor = Color.Red;
e.ViewInfo.Appointment.SetValue(schedulerStorage1, "Aciklama", "yenideger");
}
}

//yukarıdaki kod eğer belirli tarihe eşit başlangıç tarihi olan bir kayıt varsa arka planını kırmızı yapar ve açıklamaya "yenideger" yazar.


hepinize Kolay Gelsin


Can Çevikoğlu
Yazılım Uzmanı