3- Arayüz Komutları
 

Komut Adı

Kullanım Şekli

Açıklama

Örnek KullanımEklendiği Sürüm

Text

Text(sütun,satır,metin,JSON)

Ekranda belirtilen sütun ve satıra verilen metni yazar. Eğer tanımlanmışsa, JSON biçimindeki parametrelere göre işlem yapar.

Sütun parametresi sadece Telnet el terminallerinde geçerlidir.
Satır ve sütun için 0 değeri tanımlandığında, verilen metin ekranın en üstündeki başlık bölümüne yazılır.

Komutun metin kısmında, değişkenler kullanılabilir.

JSON Parametre içinde kullanılabilecek değerler:

  • start: metnin kaçıncı karakterinden itibaren gösterilecek (belirtilmezse ilk karakterden
    itibaren gösterilir.)
  • length: metnin kaç karakteri gösterilecek (belirtilmezse sonuna kadar gösterilir.)
  • case : Büyük küçük harf (upper,lower)
  • style : stil adı
  • title: başlık. Bu parametre kullanıldığında, gösterilen metnin sol üst köşesinde küçük
    puntolarla girilen ifade görüntülenir. (v1.2 itibariyle)

Parametre kullanımı opsiyoneldir.

Text(1,1,"Malzeme Adı")
Text(0,0,"Firma Seçim")
Text(1,1, @barkod,{"start":5,"length":10})
Text(1,1, "Malzeme Adı : @malzemeadi", {"case":"
upper"})
Set(@Style.hata, {"color" : "Red-Black","effect" :
"Bold-Blink", "size":"4"})
Text(1,1, @hata,{"style":"@Style.hata"})
Text(1,1, @malzemeadi,{"title":"Malzeme Adı"}) (v1
.2 itibariyle)
1.0

Input

Input(x, y, etiket,
JSON formatında biçim parametreleri, sonuç değişkeni)

Bilgi girişi yapmak için kullanılır.

Parametreleri altta açıklandığı şekilde kullanılır:

  • x/y : Varsa etiketin, yoksa bilgi giriş alanının başlangıç koordinatları. Eğer y değeri 0 olarak girilirse, bilgi girişi için popup ekran açılır. Metin ekranın ortasında görüntülenir. Giriş yapılınca geri döner. x değeri popup ekranda da geçerlidir.
  • etiket: Bilgi girişi alanının önünde görüntülenecek açıklama bilgisi. Etiket metninde değişken kullanılabilir.

Biçim parametreleri :

  • type : (text, int, decimal, date, time)
  • min: text için minimum karakter uzunluğu, int/decimal için minimum girilecek sayı (ondalık limiti verilecekse . ile ayrılmalı), date/time için minimum tarih/saat
  • max: text için maksimum karakter uzunluğu, int/decimal için maksimum girilecek sayı (ondalık limiti verilecekse . ile ayrılmalı), date/time için maksimum tarih/saat
  • camera: boolean true olması durumunda kamera okuması aktif, false pasif. camera kullanılmazsa default değeri false kabul edilir.  (v1.16 itibariyle)
  • picker: boolean true olması durumunda tarih seçim işlemi için ekrana takvim açılır. picker kullanılmazsa default değeri false alınır. type date tipinde olduğunda bu özellik kullanılabilir. (v1.16 itibariyle)
  • alignment: inputlar pop-up olarak kullanıldığında ekranın neresinde açılacağını gösterir. Bottom, center, top değerlerini alır. Eğer kullanılmazsa varsayılanı center olur. (v1.29 itibariyle)
  • description: inputlar pop-up olarak kullanıldığında giriş yapılan alanın altına açıklama eklenmesini sağlar. Birden fazla satır olarak kullanılabilir. Yeni satıra geçmek için \n kullanılmalıdır. (v1.29 itibariyle)

sonuç değişkeni: Girilen bilginin atanacağı değişken. Biçim tanımında parantezli alanlar olması halinde, bu alan değerleri değişkenin alt alanları olarak kaydedilir.

Input(1,4,"Kullanici Adi", {"type":"text","min":"1"," 1.0
max":"10"},@kullanici_adi)
Input(1,4,"Adet", {"type":"int","min":"1","max":"5"} ,@adet)
Input(1,4,"Miktar", {"type":"decimal","min":"1.0","
max":"5.0"},@miktar)
Input(1,4,"Tarih", {"type":"date","min":"1-1-1990","
max":"31-12-2020","picker":"true"},@tarih)
Input(1,4,"Saat", {"type":"time","min":"09:00","max"
:"16:00"},@saat)

Input(1,4,"Barkod", {"type":"text","min":"1","max":"10",
"camera":"true"},@barcode)

Input(1,4,"Barkod", {"type":"text","min":"1","max":"10",
"alignment":"top"},@barcode)

Input(1,4,"Barkod", {"type":"text","min":"1","max":"10",
"description":"açıklama bilgisidir"},@barcode)

1.0
MenuItemMenuItem(form adı,
menü metni, yetki
kodu, simge
numarası)
Bir menü seçeneği oluşturur. Menünün ekranda gösterilmesi için MenuRun komutu çalıştırılmalıdır.
Yetki kodu bölümünde tanımlanan kod, Sys uygulamasında Kullanıcı Tanımları ekranında, kullanıcılara menü yetkisi vermek için kullanılır.
Simge numarası parametresi opsiyoneldir. Mobil uygulamada menülerin önünde simge gösterilmesini sağlar. Kullanılabilecek menü simge numaralarına şuradan ulaşılabilir.
MenuItem(MalKabul, "MAL KABUL","",3)1.0
MenuRunMenuRun(satır.
sütun, başlık)
Seçenekleri tanımlanmış menünün ekranda gösterilmesini sağlar.
Menünün en üstünde gösterilmek üzere bir başlık belirlenebilir. Başlık metninde değişken adı yazılabilir. (v1.2 itibariyle)
Menüden seçim işlemi, klavyedeki 1-9 arası sayı tuşları ile ya da dokunmatik ekranlarda seçeneğe tıklayarak yapılabilir. Klavyedeki ok tuşlarıyla menü seçenekleri arasında dolaşılabilir.

MenuRun(1,1,"ANA MENÜ")

MenuRun(1,1,"ANA MENÜ-@@LoginUser.
UserName")

1.0

PopupView

PopupView(değişken

adı, JSON, sonuç

değişkeni)

Verilen liste yapısındaki değişkenin değerlerinin, açılan ayrı bir ekranda listelenebilmesini ve seçim yapılabilmesini sağlar.

JSON biçiminde tanımlanan parametreleri şunlardır:

fields: Gösterilecek alanlar. Her alan bir JSON dizi nesnesi olarak tanımlanır. Alanın gösterim özellikleri (dikme) karakteriyle ayrılarak belirtilir.

Yazım biçimi şöyledir: Alan Adı Sütun başlığı (Ör. Stok Kodu) Alanın kaç karakter gösterileceği (Ör.10) Hizalama (L-left, R-right)

mode: Liste iki şekilde gösterilebilir: Sütunlu liste (mode=list) ya da alt alta (mode=card) Eğer bir "mode" nesnesi yoksa, sütunlu liste gösterileceği varsayılır.

Çok sayıda satır varsa, sayfayı dolduracak kadarı gösterilir. Aşağı-yukarı ok tuşlarıyla sayfalar arasında geçiş yapılır. Sütunlu listede sağ-sol ok tuşlarıyla listede ekranın görünmeyen kısmına kaydırma yapılabilir.

size: Açılacak ekranın boyutları "genişlik yükseklik" şeklinde tanımlanabilir. Varsayılan olarak 40 25 değerleri geçerlidir. Telnet için geçerlidir.

title: Ekranın en üstünde başlık gösterilebilir.

style: Liste için belirlenen stili uygular.

Listelenen her satırın başında satır numarası gösterilir. Klavyeden satırın numarası yazılıp Enter tuşuna basılarak ya da dokunmatik ekranda ilgili seçeneğe dokunarak seçim yapılabilir.

multiselect : boolean true olması durumunda listelerden çoklu seçim yapılması desteklenir. multiselect belirtilmezse default değer false alınır. Çoklu seçim desteklenmez. multiselect kullanımıyla liste seçimi aşağıdaki şekilde döndürülür. (v1.16 itibariyle)

{ "rows": [

{ "rowNumber": 1, }

, { "rowNumber": 3, }

, { "rowNumber": 5, }, ], "rowCount": 3 }


PopupView(@liste.rows, {"mode":"list","size":"

30|20","title":"Stok Listesi","fields":

["stk_kodu|Stok Kodu|10|L","stk_adi|Stok

Adı|15|L"]},@secim)

PopupView(@liste.rows, {"mode":"card","fields":

["stk_kodu|Stok Kodu|10|L","stk_adi|Stok

Adı|15|L"]},@secim)

PopupView(@depoliste.rows, {"title": "KAYNAK

DEPO SEÇİMİ", "fields":["depo_kodu|Depo

Kodu|10|L","depo_adi|Depo Adı|15|L"], "multiselect":"false","style" :

"@Style.liste"},@secim)

1.0
TableView

TableView(değişken

adı, ilk satır, ilk sütun,

JSON)

Verilen liste yapısındaki değişkenin değerlerini ekranda bir tablo olarak gösterir.

İlk sütun parametresi sadece Telnet için geçerlidir. Bu parametreye yazılan değer mobil uygulamada tablonun ekranda kaç satırlık yer kaplayacağını belirler.

JSON biçiminde tanımlanan gösterim parametrelerinde,

rows: Değişken içindeki kayıtların kaç tanesinin basılacağını gösterir.

start: Listenin kaçıncı kaydından başlanacağını gösterir. (Opsiyonel. Kullanılmazsa ilk kayıttan başlar.)

columns: Sütunların özellikleri. Her sütun bir JSON dizi nesnesi olarak tanımlanır. Sütunun gösterim özellikleri | (dikme) karakteriyle ayrılarak belirtilir. 


Yazım biçimi şöyledir: Alan Adı | Sütun başlığı (Ör. Stok Kodu) Alanın kaç karakter gösterileceği (Ör. 10 ya da 3-7. 3.karakterden 7.karaktere kadar) Hizalama (L-left, R-right)

Tablonun ekrana sığmayan bölümlerini görmek için ok tuşları kullanılabilir.

TableView(@liste.rows,1,5, {"rows":10,"columns": 1.0 ["stk_kodu|Stok Kodu|10|L","stk_adi|Stok Adı|15|L"]})

1.0

ShowMessage

ShowMessage(JSON)

Mesaj vermek ya da onay sormak için kolay ekran oluşturmayı sağlar. Mesaj ekranda ayrı bir pencere/popup gibi gösterilir. Mesajdan çıkıldığında, eski ekrana geri döner.

JSON biçiminde tanımlanan parametreleri şunlardır:

title: Başlık

message: Mesaj metni. Değişken kullanılabilir

buttons: Eylem düğmeleri. En fazla 3 düğme tanımlanabilir. Klavyeden sırasıyla 1,2,3 tuşları bu

düğme seçeneklerine karşılık gelir. İlk seçenek için ya da tek düğme varsa Enter tuşu kullanılabilir.

Tek düğme varsa ya da son seçenek için ESC düğmesi kullanılabilir. Hiç düğme belirtilmemişse

"TAMAM" olarak gösterilir.

style: Stil tanımı. Sadece telnet el terminalleri içindir. (v1.2 itibariyle Android terminaller için de kullanılabilir.) Tanımlanan stil içindeki .title, .border, .button1, .button2, .button3 ve .text elemanları kullanılır

ShowMessage({"title": "HATA", "message" : "@kod 1.0 KODLU MALZEME BULUNAMADI!","buttons": "TAMAM"}, @secim)


ShowMessage({"title": "HATA", "message" :


"HATALI SEÇİM!" "buttons": "TAMAM|İPTAL",


"style" : "@Style.mesaj"}, @secim)

1.0

Image

başlangıç satırı, bitiş satırı, JSON

Malzeme ve cari hesaplar için kaydedilmiş resim içeriğini getirir. Belirtilen satırlar arasında

gösterilir.

JSON biçiminde tanımlanan parametreleri şunlardır:

RecordType : Kaydın tür numarası. Cari-142,Malzeme-145

RecordId : Kayıt Id

ImageType : 0-Küçük resim (Varsayılan) 1- Orijinal

Bu komut sadece mobil uygulamada kullanım için anlamlıdır.

Image(5,8, {"RecordType" : "145", "RecordId": 1})1.0

ClearScreen

ClearScreen()

Ekranı temizler.

ClearScreen()1.0

ClearLines

ClearLines(başlangıç satırı, bitiş satırı)

Verilen satırlar arasındaki değerleri temizler.

ClearLines(1,5)1.0

Beep

Beep(çalma sayısı)

El terminalinden belirtilen sayıda tekrarlanan bip sesi çıkartır. Mobil uygulamada işletim sisteminin

desteklediği diğer ses dosyaları çalınabilir. Tekrar sayısı opsiyoneldir.

Beep()

Beep(2)

1.0
ListBox

Input(x, y, etiket,
JSON formatında biçim parametreleri, sonuç değişkeni)

Örnek : ListBox(değişken, y,

etiket, alan adı, sonuç değişkeni)


Verilen listeden (Combobox) bir seçim yapılmasını bekler.

değişken: Bir liste satırları şeklinde, bir ya da daha çok kayıt içerecek şekilde tanımlanır.

satır: Liste kutusunun görüntüleneceği satır.

etiket: Bilgi girişi alanının önünde görüntülenecek açıklama bilgisi. Etiket metninde değişken kullanılabilir.

alan adı: Değişken listesindeki gösterilecek sütunun adı.

sonuç değişkeni: Girilen bilginin atanacağı değişken. Bu değişken ile seçim yapılan satır değeri döner.

Warehouse.List("Id>0","Code Desc",@liste)

ListBox(@liste.rows, 1, "Depo Seçimi", "Name",@secim)

Text(1,2,"@[email protected]",

{"title":"Seçilen Depo Kodu","style":

{"color":"Blue","titleColor":"Green",

"effect":"Bold"}})

1.16