Geliştirici Klavuzu

Transkript

1 Geliştirici Klavuzu

2 Mdule Sınııfı Mdule luşturma Mdule Nedir Fn platfrmu üzerinde geliştirilen her bir ürün/derleme (dll) birer mdüle larak adlandırılır ve aynı zamanda ürünün tanımlayıcısıdır. FONO PLATFORM MODÜLLER MODÜL Ön Tanımlı Nesneler Ön Tanımlı Mesajlar Ön Tanımlı Yetki Nesneleri Ekranlar API ler Lisanaslama Bilgisi MODÜL Ön Tanımlı Nesneler Ön Tanımlı Mesajlar Ön Tanımlı Yetki Nesneleri Ekranlar API ler Lisanslama Bilgisi Fn.Cre çalışmaya başladığında bünyesindeki derlemeler arasından Cre.Dmain.Mdules.[Mdule] sınıfından türetilmiş bir sınıf lan derlemeleri (dll) bulur ve tmatik larak yükler Public Class X Inherits Cre.Dmain.Mdules.[Mdule] Private Sub X_OnInit(ByRef NeedLicense As Blean) Handles Me.OnInit '//-- Mdül ilk defa luşturulduğuda... Private Sub X_OnGetMenu(ByRef Menu As Cre.Dmain.Mdules.Menu.Rt) Handles Me.OnGetMenu '//-- Her menü gereksinimi duyulduğu nktalarda... With Menu.Add(True, False, New Gui.WebFrm) End With Public Class Items Public Shared ButtnText As New Cre.Dmain.Elements.Item("Buttn Text") Public Shared LabelText As New Cre.Dmain.Elements.Item("Label Text") Public Class Messages ''' <summary>generic Message</summary> Public Shared Generic As New Cre.Dmain.Elements.Message("{0}") ''' <summary>this is [MyMessage] frm => '{0}'.</summary> Public Shared MyMessage01 As New Cre.Dmain.Elements.Message("Test Message.) Public NtInheritable Class Authrizatins Public Shared MyAuthObj01 As New Cre.Dmain.Elements.Auth("System Inf Display") Public Shared PageDisplay As New Cre.Dmain.Elements.Auth("Page Display")

3 Sayfa Oluşturma Sayfa luşturma, Menü luşturma Bu bölümde mevcut prjemize nasıl sayfa ekleyeceğimizi ve daha snra bu sayfanın menü ye bir adım larak eklenilip kullanılır hale getirilmesini nasıl yapacağımızı inceleyeceğiz. Sayfa Oluşturulurken Sayfa luştururken öncelikle prjemize yeni bir.aspx dsyası ekleriz. Oluşturulan sayfanın Inherits sınıfını Fn.Cre.Ext.Net.PageEx larak değiştiriyruz. Public Class WebFrm Inherits System.Web.UI.Page Public Class WebFrm Inherits Fn.Cre.Ext.Net.PageEx Bir sayfayı çalıştırdığınız zaman Fn ilgili sayfanın CheckAuth methdunu çağırır ve yetki kntrlüne göre sayfanın çalışmasına izin verir. Sayfa açılırken bir yetki kntrlü yapılacak ise bu fnksiynu kullanabiliriz. Eğer bir yetki kntrlü yapılmayacak ise genel kullanım amacıyla bir sayfa tasarlanıyr ise bu fnksiyndan True değerini döndürmeliyiz. Public Overrides Functin CheckAuth(Parameters As PageParameters, Optinal RaiseErrr As Blean = True) As Blean Return True End Functin Public Overrides Functin CheckAuth(Parameters As PageParameters, Optinal RaiseErrr As Blean = True) As Blean Return X.Authrizatins.PageDisplay.Check(RaiseErrr) End Functin Fn.Cre.Ext.Net.PageEx ile sayfa laylarına FirstLad larak ek bir lay gelir. Bu lay sayfa her açılışında 1 defa lmak üzere call edilir. Sayfa açılıldığında sadece 1 defa yapılmasını istediğiniz işlemleri bu blğa yazabilirsiniz. (Örnek: sayfa dil metinlerinin veya resimlerin/iknların set edilmesi.) Public Class X Inherits Cre.Dmain.Mdules.[Mdule] Public Class Items Public Shared ButtnText As New Cre.Dmain.Elements.Item("Buttn Text") Public Shared LabelText As New Cre.Dmain.Elements.Item("Label Text") Public Class WebFrm Inherits Fn.Cre.Ext.Net.PageEx Public Sub Page_FirstLad(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.FirstLad BTN01.setTextIcn(X.Items.ButtnText, Gui.Helper.Icns.Inf) LABEL01.Text = X.Items.LabelText

4 Sayfayı Menüye Eklerken Hazırladığımız sayfa menüye eklenmediği sürece uygulama tarafından iletişime geçilebilir bir sayfa larak algılanmayacaktır. Kullanıcılar tanımladıkları sayfaları menüye Ayar Sayfası larak, Uygulama Sayfası larak veya her ikisi de larak eklenebilir. Bu seçim uygulama başlatıldığında tanımladığımız sayfanın ayarlar menüsünde mi yksa uygulamalar menüsünde mi geleceğini belirler. Sayfayı menüye eklerken yapmamız gereken sadece mdule sınıfının OnInit eventine aşağıdaki kd parçacığını eklemek lacaktır. Public Class X Inherits Cre.Dmain.Mdules.[Mdule] Private Sub X_OnInit(ByRef Menu As Cre.Dmain.Mdules.Menu.Rt, ByRef NeedLicense As Blean) Handles Me.OnInit With Menu.Add(True, False, New Gui.WebFrm) End With Sayfaya Parametre Eklerken Tanımladığımız sayfalar varsayılanda parametresiz larak çağırılırlar, fakat sayfaları parametre ekleyerek çağırmamız da mümkündür. Sayfa tanımlanırken alınmak istenilen parametreler öncelikle sınıfın içerisinde Private değişkenler larak tanımlanırlar, daha snra sayfanın parametre aldığı New(...) metdunda bu değişkenler çağrının atıldığı yerden gelen parametreler ile eşleştirilir. Public Class Entry Inherits Fn.Cre.Ext.Net.PageEx Private GUID As New Cre.Dmain.Elements.Pages.PageParameter("GUID") 'Parametre kullanmadan varsayılan sayfa çağırma New() metdu. Sub New() 'Parametrik sayfa çağırmak için tanımlanan New() metdu. Sub New(GUID As String) Me.GUID.Value = GUID Prtected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Init 'Sayfa luştuktan snra istenilen metdların içerisinde parametreler kullanılır. Dim TestGuid As String = Me.GUID

5 Yetki Nesneleri Kullanımı Yetki Nesnesi Tanımlama, Yetki Nesnesi Kntrlleri Bu bölümde sistem içerisinde yetki nesnelerinin tanımlanmasını ve daha snra tanımlanan yetki nesnelerine bağlı kntrllerin nasıl yapılacağını inceleyeceğiz. Yetki Nesnesi Tanımlarken Yetki nesnesi tanımlamaları Mdule sınıfı içerisinde tanımlanır. Public Shared PageDisplay As New Cre.Dmain.Elements.Auth("Page Display") Yetki Nesneleri Kntrlleri Bir yetki nesnesi kntrlü ilgili yetki nesnesinin Check fnksiynu çağrılarak yapılır. Fnksiyn çağrıldığında yetki yk ise hata fırlatır. Fnksiyn False parametresi ile çağrıldığıda hata fırlatmaz; yetki durumunu geri döner. 'Yetki yk ise hata mesajını tmatik fırlatır. Call MyPrj.X.Authrizatins.PageDisplay.Check() 'Yetki durumunu geri döner. Hata fırlatmaz. Dim _result = Call MyPrj.X.Authrizatins.PageDisplay.Check(False) Yetki nesnelerini bir sayfanın açılışını kntrl etmek için kullanacağımız zaman; ilgili sayfanın CheckAuth fnksiynu içerisinde kullanmalıyız. Public Overrides Functin CheckAuth(Parameters As PageParameters, [RaiseErrr As Blean = True]) As Blean Return X.Authrizatins.PageDisplay.Check(RaiseErrr) End Functin

6 Dil Bağımlı Nesneler Dil Nesneleri, dil nesnesi kullanımı, lkalizasyn, metin Dil bağımlı nesneler mdül kapsamında mdüle ait larak tanımlanır ve prjenin genelinde izin verilmesi halinde kullanılabilirler. Dil nesnelerini bir üst sınıftan devralabilirsiniz. Public Class X Inherits Cre.Dmain.Mdules.[Mdule] Public Class Items Inherits Cre.Dmain.Mdules.[Items] Public Shared ButtnText As New Cre.Dmain.Elements.Item("Buttn Text") Public Shared LabelText As New Cre.Dmain.Elements.Item("Label Text") ' Lgn lunan dil karşılığındaki metnini verir. Dim _result = X.Items.ButtnText.Text.TString() Dim _result As String= X.Items.ButtnText ' TString Casting ' dil karşılığındaki metnini verir. Eğer dil karşılığı yk ise varsayılan metni (İngilizce) verir. Dim _result = X.Items.ButtnText.Text.TString( tr ) Bir sayfa üzerindeki nesnelerin metinlerini lgn diline göre göstermek istersek, bu değerleri sayfanın FirstLad fnksiynunu kullanabiliriz. Public Class WebFrm Inherits Fn.Cre.Ext.Net.PageEx Public Sub Page_FirstLad(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.FirstLad BTN01.setTextIcn(X.Items.ButtnText, Gui.Helper.Icns.Inf) LABEL01.Text = X.Items.LabelText.Text.TString() am

7 Mesaj İşlemleri Mesaj tanımlama, mesaj gösterme. Uygulama içinde mesajları tanımlama ve ön tanımlı/tanımsız mesajların gösterimidir. Public Class X Inherits Cre.Dmain.Mdules.[Mdule] Public Class Messages ''' <summary>generic Message. {0}</summary> Public Shared Generic As New Cre.Dmain.Elements.Message("Generic Message. ID:{0}") ''' <summary>test Message.</summary> Public Shared MyMessage01 As New Cre.Dmain.Elements.Message("Test Message.) Tanımlı bir mesajı kendi üzerinden parametre belirterek TERMINATE larak kullanabilirsiniz. Erp.X.Messages.MyMessage01.Terminate() Erp.X.Messages.Generic.Terminate(2158) ' Thrws Test Message ' Thrws Generic Message. ID:2158 Tanımlı bir mesajın metnini parametre belirterek kullanıcı diline göre frmatlayabiliriz. Dim _result As String= X.Messages.ErrrMessage2.Frmat("2015") ' Returns Generic Message. ID:2158 Thrw New Exceptin("ERROR : (" & result & ")") ' Thrws ERROR : (Generic Message. ID:2158) Ekran üzerinden mesaj vermek için PageEx sınıfından türeyen sayfalarda ShwMessage (Ekranın Üstünde) veya ShwNtify (Ekranın Altında) fnksiynları kullanılabilir. ShwNtifyErrr(Message As String) ShwNtifyErrrClse(Message As String) ShwNtifyWarning(Message As String) ShwNtifyWarningClse(Message As String) ShwMessageWarningClse(Message As String) ShwMessageWarning(Message As String, [Handler] As String = "") ShwNtifyInf(Message As String) ShwNtifyInfClse(Message As String) ShwMessageInfClse(Message As String) ShwMessageInf(Message As String, [Handler] As String = "") ShwMessageCnfirm(Message As String, YesHandler As String, NHandler As String)

8 Zamanlanmış Görev Oluşturmak Zamanlanmış Görevler. Yazdığınız bir kdu kullanıcının planlamasını yaptığı şekliyle rahatça çalıştırılmasını istiyrsak, bu özelliği kullanabiliriz. Bunun için Cre.Runtime.Jb.Base uyumlu bir sınıf türetmek yeterli lacaktır. Public Class TestJb Inherits Cre.Runtime.Jb.Base Public Overrides ReadOnly Prperty Descriptin As String Get Return "Test Zamanlanmış Görev" End Get End Prperty Public Overrides Sub Wrk() Thrw New NtImplementedExceptin() Kdunuzu zamanlanmış görev sınıfı içinde WORK fnksiynu altında yazmalısınız. Wrk fnksiynu planlanan zamanlarda tmatik larak tetiklenir. Wrk fnksiynu içinde bir kırılma lursa veya Wrk methdu bittiğinde Current.Wrker.Event içinde HasErrr fnksiyn snucu True dönüyr ise yapılan işlemler veritabanı seviyesinde rllback edilir.

9 Yazdırma İşlemleri Yazdırma sınıfının luşturulması, Çıktı frmatı hazırlama Prjeniz içinde Cre.Printing.PrinterTemplateBase sınıfından türettiğiniz herhangi bir sınıfı, yazdırabilirsiniz. Türettiğiniz sınıf zrunlu larak PrintData fnksiynu ile sizden bir XmlDcument bekler. Bu fnksiyn üzerinden döneceğiniz xml verisini XSLT dönüşümü ile frmatlayarak çıktı elde edersiniz ve PDF larak görüntülersiniz. App_Data\<mdüle_name> klasörünün altında türettiğiniz sınıfın tam adıyla aynı XSLT dsyası bulunmalıdır. Bu örnekte Fn.Cre.Printing. isimli bir XSLT dsyası lmalıdır.

10 Yazıcıdan çıktı almak için veri luştururken bu örneği inceleyebilirsiniz. Namespace Cre.Printing.Test Public Class Template1 Inherits Cre.Printing.PrinterTemplateBase Public Overrides Functin PrintData() As XmlDcument Dim _data As New data With _data.company_logo = "base64 image data.company_name_val = "ABC Cmpany".COMPANY_ADRS_VAL = "Address Of ABC Cmpany".COMPANY_REG_NAME_VAL = "ABC Cmpany Registered Name".PARTY_NAME_VAL = "Custmer XYZ".PARTY_ADR_VAL = "Address Of Custmer XYZ".PARTY_TAX_OFC_VAL = "Office01".PARTY_TAX_NUM_VAL = " ".TYPE_VAL = "SATFAT".CONSINGMENT_VAL = True.NOTE_VAL = "the ntes cmes here...".date_val = Nw.FrmatDate().CURRENCY_VAL = "Try".EXCH_RATE_VAL = "1,0".HAS_GM_VAL = True.AMOUNT = D.Frmat(2).AMOUNT_TXT = D.TWrds().Jin(", ").TOTAL_AMOUNT_VAL = D.Frmat(2).TOTAL_DISCOUNT_VAL = 68.25D.Frmat(2).TOTAL_VAT_AMOUNT_VAL = 630D.Frmat(2).TOTAL_WITH_HOLDING_VAT_AMOUNT_VAL = 30D.Frmat(2).PAYABLE_AMOUNT_VAL = 600D.Frmat(2).LBL_TYPE = "Sale Invice".LBL_PARTY_TAX_OFC = "Tax Office".LBL_PARTY_TAX_NUM = "Tax Number".LBL_NOTE = "Nte".LBL_DATE = "Date".LBL_CURRENCY = "Currency".LBL_EXCH_RATE = "Exch. Rate".LBL_CONSINGMENT = "Cnsingment?".LBL_HAS_GM = "Has Gds Mvement?".LBL_TOTAL_AMOUNT = "Ttal Amunt".LBL_TOTAL_DISCOUNT = "Ttal Discunt".LBL_TOTAL_VAT_AMOUNT = "Ttal VAT Amunt".LBL_TOTAL_WITH_HOLDING_VAT_AMOUNT = "Ttal VAT (With Hlding) Amunt".LBL_PAYABLE_AMOUNT = "Payable Amunt" With.TABLE.COL.MATERIAL = "Material".QUANTITY = "Quantity".UNIT = Cre.X.Items.Unit.TString().PRICE = "Price".AMOUNT = "Amunt" End With Fr n As Decimal = 1 T 5 With.TABLE.ROW.AddNew().MATERIAL = "Material-" & n.quantity = CDec(100 * n).frmat(2).unit = "item".price = n.frmat(2).amount = (100 * n * n).frmat(2) End With Next End With Dim jsn = Newtnsft.Jsn.JsnCnvert.SerializeObject(New With {Key.rt = _data}) Return DirectCast(Newtnsft.Jsn.JsnCnvert.DeserializeXmlNde(jsn), System.Xml.XmlDcument) End Functin.

11 Örnekte kullanılan veri yapıları şu şekildedir. Private Class data Public COMPANY_LOGO As String Public COMPANY_NAME_VAL As String Public COMPANY_ADRS_VAL As String Public COMPANY_REG_NAME_VAL As String Public PARTY_NAME_VAL As String Public PARTY_ADR_VAL As String Public LBL_PARTY_TAX_OFC As String Public LBL_PARTY_TAX_NUM As String Public PARTY_TAX_OFC_VAL As String Public PARTY_TAX_NUM_VAL As String Public AMOUNT As String Public AMOUNT_TXT As String Public LBL_TYPE As String Public TYPE_VAL As String Public LBL_CONSINGMENT As String Public CONSINGMENT_VAL As Blean Public LBL_NOTE As String Public NOTE_VAL As String Public LBL_DATE As String Public DATE_VAL As String Public LBL_CURRENCY As String Public CURRENCY_VAL As String Public LBL_EXCH_RATE As String Public EXCH_RATE_VAL As String Public LBL_HAS_GM As String Public HAS_GM_VAL As Blean Public TABLE As New data_table Public LBL_TOTAL_AMOUNT As String Public TOTAL_AMOUNT_VAL As String Public LBL_TOTAL_DISCOUNT As String Public TOTAL_DISCOUNT_VAL As String Public LBL_TOTAL_VAT_AMOUNT As String Public TOTAL_VAT_AMOUNT_VAL As String Public LBL_TOTAL_WITH_HOLDING_VAT_AMOUNT As String Public TOTAL_WITH_HOLDING_VAT_AMOUNT_VAL As String Public LBL_PAYABLE_AMOUNT As String Public PAYABLE_AMOUNT_VAL As String Private Class data_table Public COL As New data_table_rw Public ROW As New List(Of data_table_rw) Private Class data_table_rw Public MATERIAL As String Public QUANTITY As String Public UNIT As String Public PRICE As String Public AMOUNT As String Snuçta luşacak XML yaklaşık şu şekildedir. <rt> <COMPANY_LOGO>base64 image data</company_logo> <COMPANY_NAME_VAL>ABC Cmpany</COMPANY_NAME_VAL> <COMPANY_ADRS_VAL>Address Of ABC Cmpany</COMPANY_ADRS_VAL> <COMPANY_REG_NAME_VAL>ABC Cmpany Registered Name</COMPANY_REG_NAME_VAL> <PARTY_NAME_VAL>Custmer XYZ</PARTY_NAME_VAL> <PARTY_ADR_VAL>Address Of Custmer XYZ</PARTY_ADR_VAL> <LBL_PARTY_TAX_OFC>Tax Office</LBL_PARTY_TAX_OFC> <LBL_PARTY_TAX_NUM>Tax Number</LBL_PARTY_TAX_NUM> <PARTY_TAX_OFC_VAL>Office01</PARTY_TAX_OFC_VAL> <PARTY_TAX_NUM_VAL> </PARTY_TAX_NUM_VAL> <AMOUNT>24.234,45</AMOUNT> <AMOUNT_TXT>Twenty-Fur Thusand Tw Hundred Thirty-Fur, Frty-Five</AMOUNT_TXT>

12 <LBL_TYPE>Sale Invice</LBL_TYPE> '... <TABLE> <COL>Material</COL> <COL>Material</COL> <COL>Quantity</COL> <COL>Unit</COL> <COL>Price</COL> <COL>Amunt</COL> <ROW> <MATERIAL>Material-1</MATERIAL> <QUANTITY>100,00</QUANTITY> <UNIT>item</UNIT> <PRICE>1,00</PRICE> <AMOUNT>100,00</AMOUNT> </ROW> <ROW> <MATERIAL>Material-2</MATERIAL> <QUANTITY>200,00</QUANTITY> <UNIT>item</UNIT> <PRICE>2,00</PRICE> <AMOUNT>400,00</AMOUNT> </ROW> <ROW> <MATERIAL>Material-3</MATERIAL> <QUANTITY>300,00</QUANTITY> <UNIT>item</UNIT> <PRICE>3,00</PRICE> <AMOUNT>900,00</AMOUNT> </ROW> '... </TABLE> <LBL_TOTAL_AMOUNT>Ttal Amunt</LBL_TOTAL_AMOUNT> <TOTAL_AMOUNT_VAL>3.568,25</TOTAL_AMOUNT_VAL> <LBL_TOTAL_DISCOUNT>Ttal Discunt</LBL_TOTAL_DISCOUNT> <LBL_PAYABLE_AMOUNT>Payable Amunt</LBL_PAYABLE_AMOUNT> <PAYABLE_AMOUNT_VAL>600,00</PAYABLE_AMOUNT_VAL> '... </rt> Fn luşan XML yapısını XSLT dsyası ile transfrm edere ve HTML üzerinden PDF dsyasına dönüştürür.

13 Oturumlar ve İşleyiciler Keywrds Oturum luşturma, İşleyici luşturma, paralel işleyici luşturma. Fn.Cre Oturum, İşleyici bileşenlerini kullanarak gelen istekleri aynı anda birbirinden bağımsız larak yürütebilir. Sunucuya gelen her bir istek birbirinden izle larak luşturulan işleyiciler (wrker) sayesinde, işlemler hem uygulama hemde veritabanı için ayrı larak çalıştırılır. Bu sayede her bir işleyici kendi sanal rtamında çalışmakta ve veritabanı işlemlerini yürütmektedir. Bir hata luşması durumunda veritabanı üzerinde transactinları yönetmeniz gerekmez. Eğer ki İşleyici (wrker) çalışırken bir hata alınır ise, luşan tüm mesajlar İşleyici içinde biriktirilir ve ardından veritabanı seviyesinde yapılan bütün işlemler geri alınır Paralel İşleyiciler Bir Oturum(Sessin) içerisinde paralel başka İşleyici (Wrker) ler luşturabilirsiniz. Bu sayede yüksek iş yükü gerektiren veya uzun sürmesi öngörülen işlemler paralel işleyiciler kullanılarak yapılan işin etkinliği arttırılabilir ve geçen süre çk daha aşağıya çekilebilir. Bu şekilde luşturulan işleyiciler tmatik larak çalışırlar ve işlemin bitmesini beklemeden kdlar çalışmaya devam eder. Dim _wrkerfactry = Cre.Current.Sessin.WrkerFactry() _wrkerfactry.add(sub() Methd1()) _wrkerfactry.add(sub() Methd2("XXX")) _wrkerfactry.add(sub() Methd2("YYY")) _wrkerfactry.startandwait(waitallwrkertcmmit:=true) Sub Methd1() System.Diagnstics.Debug.Print("Methd1 (START)") Fr n As Integer = 1 T 10 System.Threading.Thread.Sleep(100) System.Diagnstics.Debug.Print("Methd1 (" & n & ")") Next System.Diagnstics.Debug.Print("Methd1 (END)") Sub Methd2(value As String) System.Diagnstics.Debug.Print("Methd2 (" & value & " - START)") Fr n As Integer = 1 T 10 System.Threading.Thread.Sleep(100) System.Diagnstics.Debug.Print("Methd2(" & value & "-" & n & ")") Next System.Diagnstics.Debug.Print("Methd2 (" & value & " - END)")