Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel

Bir kaydın kaydedilmeden önce belirlediğimiz kurallara uygun olup olmamasına göre uyarma ve durdurma işlemidir.  Yani bir alan boş geçilemez ise kaydedilmesin ya da bir alanda 30 rakamından düşük yazılırsa kaydetme ya da uyar, devam et gibi seçenekleri bulunur. İki çeşit validasyon vardır.

Birincisi Kaydı, sizin belirlediğiniz validasyona uygun olmadığı sürece asla kaydetmez. Örneğin, firma kartında unvan’ ı boş bırakıp kaydetmeyi denediğinizde, aşağıdaki hatayı alınır.

Image Added

İkincisi de sizi uyarıp  “uyarıları yok say” derseniz kaydetme işlemine devam eder. Validasyon kuralları genel olarak kaydetmeyi engellesin ya da engellemesin olarak belirlenir. Image Added

Validasyon Genel Tanımı: Kaydın oluşturulmadan önce, belirlenen kurallara uygun olup olmadığının

...

kontrol işlemidir. Bir alan için boş geçilemez tanımı

...

yapılır ve ilgili kaydın kaydedilmemesi

...

sağlanır. Aynı zamanda ilgili alana girilen değerin belirli bir rakama göre kontrolü de

...

İki çeşit validasyon vardır. Birincisi belirlenen validasyona göre kayıtların uygunluğunun kontrolüdür. 

...

yapılması sağlanır. Oluşturulmuş bir kaydı silerken, kullanıcıya uyarı verme işlemi de Validasyon tanımı ile yapılır.

Validasyon Kuralları Tanımlama

Logo CRM uygulamasının kurulu olduğu klasör içerisinde, ModelEditor klasörü açılır ve ModelEditor.bat uygulaması çalıştırılır.

Image Added

Soldaki ağaç menüsünden Validation> Rules'a sağ tıklanır ve istenen kural türü tanımlanır.

Image Added

Tip
titleBilgilendirme

Aşağıdaki örneklerde Logo CRM ürün kurulum yapıldıktan sonra, sistemde var olan Validasyon örnekleri gösterilmiştir.

Logo CRM üzerinde var olan bazı validasyonlar;

Expand
title1- Belirlenen Validasyona göre kayıtların uygunluğunun kontrolü

Firma kartında Unvan alanı boş

...

bırakılarak kaydedilmek istenildiğinde, "Boş Olmamalıdır" şeklinde uyarı vermektedir. (Model Editör üzerinde "required_FirmTitleIsRequired" adıyla tanımlama yapılmıştır.)

Image Added

Firma kodu alanı benzersiz (unique) değere sahiptir. Sistemde bulunan firma kodu tekrar eklenmek istendiğinde, kural devreye girer ve kaydetmeyi durdurur. (Model Editör üzerinde "unique_FirmCodeUnique" adıyla tanımlama yapılmıştır.)

Image Added

Expand
title2- Tanımlı Validasyona göre, uyarı mekanizmasının devreye girip uyarı

...

vermesi

Uyarı, kullanıcının seçimine bırakılır.

...

"Uyarıları

...

Yok say" seçeneği ile kaydetme işlemine devam edilir.

...

İşlemler, Model Editor üzerinden yapılır. Soldaki ağaç menüsünden Validation> Rules'a sağ tıklanır ve istenen kurallar tanımlanır.

...

RuleRequiredField seçildiğinde, sağ tuş menüsünde aşağıdaki seçenekler bulunur.

...

Kaydedilmiş bir Fırsat kaydının içerisinde, İlişkili Kayıtlar> Teklifler/Sözleşmeler ekranından Yeni Teklif oluşturulur. Fırsat kaydı silinmek istenildiğinde, tanımlanmış validasyondan dolayı bir uyarı vermektedir. Kullanıcı isterse, "Uyarıları yok say" seçerek işlemine devam edebilir. (Model Editör üzerinde "delete_OpportunityIncludesProposals" adıyla tanımlama yapılmıştır.)

Image Added

Validasyon Çeşitleri

Expand
title1.Zorunlu Alan Kuralı Tanımlama (RuleRequiredField)

Örnek: Firma kayıt işleminde Vergi Dairesi girişi yapılmış ise, Vergi No alanının zorunlu alan yapılması.

Image Added

  • Model Editör üzerinden Validasyon tanımlama işleminin detayları aşağıda yer almaktadır.

Image Added

  • InvertResult: Yapılacak validasyonu terse çevirir. Ön değeri False seçeneğidir.
  • Result Type:

...

  •  Kayıt yapılıp yapılmayacağını kontrol eder. Seçenekler listesinde Error, Warning, Information yer almaktadır.
    • Error: İşlemin kaydedilmesini önler

...

    • . Kaydedilmek istendiğinde, kırmızı bir bölümde neden kaydedilmediği yazılır.
    • Warning: Kaydedilir, Uyarıyı

...

    • Yok Say butonu seçildiğinde, devam edilir.
    • Information: Kaydedilir, sadece belirlenen alanın yanında mavi-beyaz bir ünlem işareti çıkar.
  • SkipNullorEmptyValues:

...

  •  Alanın null veya boş değere sahip olmasının dikkate alınmamasını gösterir.
  • TargetContextIDs:

...

  • Oluşturulan validasyonun,

...

  • işlemi kaydedilirken mi yoksa silinirken mi devreye gireceğini seçer.
  • TargetCriteria: Zorunlu alandır

...

  • ve burada belirlenen kriter olduğunda validasyon devreye girer. Bunun için

...

  • öncelikle TargetType alanından hangi bölüm için

...

  • uygulanacağı seçilir.
  • TargetType:

...

  • Validasyonun uygulanacağı bölüm seçilir.
  • TargetPropertyName: Validasyonun uygulanacağı alanın adı tanımlanır.
  • Format: Bu alan

...

  • ön değerde belirli tanımlarla gelir. İstenirse bu alanlar kullanılmayıp farklı bir mesaj gösterimi sağlanır. Bu da

...

  • CustomMessageTemplate alanına yazılarak yapılabilir.
  • Id,Name: Aynı isimde olabilir ya da yeni isim verilebilir.  Boşluk, nokta gibi işaretler kullanılmamalıdır. Boşluk

...

  • kullanılmak isteniyorsa da kelimeler arasına "_ "(alt tire) kullanılmalıdır.
Expand
title2. Belirli Bir Kritere Göre Validasyon (RuleCriteria)

Belirlenen kritere göre validasyon yapılması sağlanır.

Örnek: Firma kartlarında

...

Şahıs Şirketi seçimi ve

...

Firma Rolüalanından Toptancı seçimi yapıldığında, uyarı verilmesinin sağlanması

...

.

Image Added

Image Added

  • Model Editör üzerinden Validasyon tanımlama işleminin detayları aşağıda yer almaktadır.

Image Added

  • Burada dikkat edilmesi gereken ilk nokta; verilecek kriterin doğru çalışabilmesi için InvertResult değerinin

...

  • True seçilmesidir. Sadece

...

  • RuleCriteria seçiminde bu şekilde tanımlama yapılmalıdır.

...

  • Bu validasyon tipinde farklı olan, Criteria bölümüdür. Kriter belirlemek için kırmızı ok ile gösterilen üç noktadan seçim yapılır.

Image Added

  • CustomMessageTemplate alanına da gösterilmesi istenilen mesaj yazılır.

...

  • Firma kartında, şahıs şirketi seçilip firma rolü toptancı seçildiğinde

...

  • resimdeki gibi uyarı verilir. Uyarıyı

...

  • Yok Say mesajının nedeni, ResultType=Warning değerinin

...

  • seçilmiş olmasıdır. Eğer Error değeri seçilirse, kaydedilmesine izin verilmez.

...


Info
titleBilgi

RuleCriteria içerisindeki IsNullOrEmpty parametresi altyapı çalışma şekli sebebiyle "Boş alan kontrolü" veya "IsEmpty" için çalışmamaktadır. Alternatif çözüm için kural RuleRequiredField ile eklenmelidir.

Expand
title3.Tekil (Unique) Kural Tanımlama (RuleUniqueValue)

Bir

...

alanda mükerrer kayıt oluşmaması için

...

alanları eşsiz(unique)

...

tanımlayabilirsiniz. Sistem

...

varsayılan birçok alan bu şekilde gelir.

...

Örneğin Firma kodu için unique

...

tanımlamaları  yapılı bir şekilde gelir. Sistemde bulunan firma

...

kodunu tekrar eklemeye çalıştığınızda bu kural devreye girer ve kaydetmeyi durdurur.

...

  Model Editor’ de ValidationRules alanına geldiğinizde, birçok kural görülür.

Örnek: Firma detay ekranında aynı Vergi No ile kayıt oluşturma işleminde uyarı vermesi.

Image Added

Image Added

  • Model Editör üzerinden Validasyon tanımlama işleminin detayları aşağıda yer almaktadır.

Image Added

  • TargetPropertyName alanına, unique alanın tanımlaması yapılır.

...

  • ResultType alanında Error seçiliyse, kayıt işlemi engellenir.

...

Expand
title4.Birden Fazla Alanın Tekil (Unique) Kontrolü (RuleCombinationPropertiesIsUnique)

Örnek: Firma kartında

...

hem

...

Vergi Dairesi hem de

...

Vergi Numarası aynıysa kaydetme

...

Yukarıdaki örnekteki gibi vergi dairesi ile vergi numarası aynı olduğunda Kural Çalışsın şeklinde tanımlama yapılabilir.

...

işleminin engellenmesi.

Image Added

Image Added

  • Model Editör üzerinden Validasyon tanımlama işleminin detayları aşağıda yer almaktadır.

Image Added

  • TargetProperties alanında birden fazla alan ekleyebilmek için, alan isimlerinin arasına ";" (noktalı virgül) koyuyoruz.
Expand
title5.Boolean Alana Bağlı Validasyon Oluşturma (RuleFromBoolProperty)

Örnek: Firma kaydedildiğinde, Aktif Ziyaret alanını seçilmesinin zorunlu olması.

Image Added

Image Added

  • Model Editör üzerinden Validasyon tanımlama işleminin detayları aşağıda yer almaktadır.

Image Added

Expand
title6. İki Değer Arasında Validasyon Kuralı Tanımlama (RuleRange)

Örnek: Firma kaydedildiğinde, Aylık Ziyaret alanına belirlenen değer aralığında değer girilmesinin sağlanması.

Image Added

Image Added

  • Model Editör üzerinden Validasyon tanımlama işleminin detayları aşağıda yer almaktadır.

Image Added

  • Bu tanımlamada dikkat edilmesi gereken MaximumValue ve MinimumValue alanlarına istenilen değer aralıkları bilgisinin girilmesidir.
Expand
title7. İstenilen Karakter Uzunluğu Belirleme (RuleRegularExpressions)

Bir alanda, sadece belirli bir karakter uzunluğunda ya da minimum, maximum karakter uzunlukları verilir. RegularExpression özelliği metin bir alana belirlediğiniz formatta yazmanızı sağlayan özelliktir. Örneğin mail adresleri ya da http ile başlayan web sitesi adreslerinin belirlenen formatta yazılması için bu kural kullanılır. Bu kural ile karakter sınırlaması da yapılır.

Örnek

Firma kartında vergi numarası 5-11 karakter sayısı  aralığında kural oluşturulması gerektiğinde,

Model Editor Validasyon Rules kısmında sağ tıklanır RuleRegularExpressions seçilip aşağıdaki değerleri girilir.

Image Added

  • Pattern^.{5,11}$ yazılır. 5,11 yazılan bölümde alanın  min ve max. karakter  uzunlukları belirtilir.11 yerine hiçbir rakam yazmayıp ^.{5,}$ yazılırsa min. 5 karakter ve üstü demektir. ^.{5}$ yazıldığında sadece 5 karakter uzunluğunda demektir.
  • TargetCriteria: Belirli bir kriter olduğunda bu validasyon çalışır.
  • TargetPropertyName: Hangi alan da validasyon uygulanacağı belirlenir.
  • TargetType: Hangi modülde validasyon uygulanacak.
  • Custom Message Template: Validasyon mesajı belirlenir.

Image Added

Info
titleBilgi

Validasyon uygulaması için aşağıdaki örnek paylaşımı inceleyebilirsiniz.

Children Display