Logo Connect Kural Tanımları

Transkript

Logo Connect Kural Tanımları
Logo Connect E-fatura Kural Tanımı
Tarih: 16.12.2014 Her hakkı Logo Elektronik Ticaret Hizmetleri A.Ş' ye aittir.
İÇİNDEKİLER
1.
E-fatura İşlemleri İçin Basit Kural Tanımları : .................................................................................................................. 4
1.1.
Basit Kural Seçenekleri ............................................................................................................................................ 4
1.2.
Basit Kural Koşul İşlemi ........................................................................................................................................... 9
1.3.
Basit Kural İşlem Seçenekleri .. ............................................................................................................................. 13
1.3.1.
Basit Kural İşlemler – Onaya Gönder ............................................................................................................ 13
1.3.2.
Basit Kural İşlemler - Onayla ......................................................................................................................... 14
1.3.3.
Basit Kural İşlemler - Paketle......................................................................................................................... 14
1.3.4.
Basit Kural İşlemler - Kaydet ......................................................................................................................... 15
1.3.5.
Basit Kural İşlemler - Onay Geri al ................................................................................................................. 16
1.3.6.
Basit Kural İşlemler – Veri Üzerinden Değişiklik Yap ..................................................................................... 16
1.3.7.
Basit Kural İşlemler – E-Posta Gönder........................................................................................................... 20
1.3.8.
Basit Kural İşlemler – Klasöre Kaydet ............................................................................................................ 21
1.3.9.
Basit Kural İşlemler - Onay Akış Grubu Seç ................................................................................................... 22
1.3.10.
Basit Kural İşlemler – Serbest Alan Ekle ........................................................................................................ 23
2.
E-fatura İşlemleri İçin Script Kural Tanımları : ............................................................................................................... 26
3.
Oluşturulan Kuralın İçeri Alımı - Dışarı Aktarımı ve Devri : ........................................................................................... 33
KURAL TANIMLARI
Kural Tanımları, Logo Connect platform’unun özelleştirilmesi amacıyla kullanılan geniş bir bölümdür. Logo
Connect Kural Tanımı Bankacılık, B2B ve FDA Modüllerinin yanı sıra E-fatura Modülü içinde kullanılabilir.
Logo Connect E-fatura Modülü Kural Tanımları, Gelir İdaresi Sistemine gönderilecek olan ve Gelir İdaresi
Sisteminden gelen e-fatura,uygulama yanıtları ve sistem yanıtları için, elle yaptığımız bir takım işlemlerin
otomatikleştirilmesi veya bu belgelerin XML belgesi üzerinde veri değişikliği yapılabilmesi için kullanılır.
Kural Tanımları, Basit ve Script kural olmak üzere ikiye ayrılmaktadır. Basit kural oluşturmak için belli
tanımlamalar yapılırken, Script kural tanımları için Visual Basic Script yazım dili kullanılmaktadır. Visual
Basic Script yazım dili Excel ve Word programlarının içerisindeki macro dili olarak da kullanılmakta olan, en
standart script kodlama dilidir ve yapılmak istenen her türlü işlem ile ilgili örnek kodlar internette
bulunabilmektedir.
Kural tanımlarına Logo Connect ara yüzündeki Planlama Modülü altındaki Kural Tanımları seçeneği ile
ulaşılmaktadır. Alt kısımda bulunan combobox (açılan kutu) içeriği ile Script kural veya basit kural ayrımı
yapılmaktadır.
Şekil 1 Kural Tanımı Tür Seçim Ekranı
1. E-fatura İşlemleri İçin Basit Kural Tanımları :
Kural tanımı türünün basit kural seçilmesinden sonra F9 menüsünden (sağ tık) “Ekle” işlemi ile kural
tanımı eklenebilir. Bu durumda açılacak olan ekran aşağıdaki gibidir.
Şekil 2 Basit Kural Tanım Ekranı
1.1.
Basit Kural Seçenekleri
Kural No : Tanımlanan kuralın tanım numarasıdır.
Açıklaması : Kural tanımının adı ya da açıklayıcı bilgisidir.
Doküman : Kuralın hangi belge türü için uygulanacağı bu alanda belirlenir.
E-fatura İçin Seçilebilecek Doküman Türleri :

Herhangi bir Doküman : Logo Connect ile aktarımı yapılabilen her türlü standart ve özel doküman
tiplerinde çalışacak bir kural tanımlamak için seçilir. Kural tanımı tüm paketlerde tipe bakılmaksızın
işletilecektir. Bu doküman tipi seçildiğinde koşul verilebilecek alanlar kısmında sadece
“Header_Record” bölümü gözükecektir.

E-fatura : Logo Connect aracılığı ile Gelir İdaresi Başkanlığının sistemine gönderilecek veya Gelir
İdaresi Başkanlığının sisteminden gelecek olan e-faturalar için çalışacak bir kural tanımlamak için
seçilir. Bu doküman tipi seçildiğinde koşul verilebilecek alanlar kısmında “Header_Record” ve efaturanın XML tagleri gözükecektir.

Uygulama Yanıtı (e-Fatura) : Logo Connect aracılığı ile Gelir İdaresi Başkanlığının sistemine
gönderilecek veya Gelir İdaresi Başkanlığının sisteminden gelecek olan uygulama yanıtları
(Kabul,Red) için çalışacak bir kural tanımlamak için seçilir. Bu doküman tipi seçildiğinde koşul
verebilecek alanlar kısmında sadece “Header_Record” bölümü gözükecektir.

Sistem Yanıtı (e-Fatura) : Logo Connect aracılığı ile Gelir İdaresi Başkanlığının sisteminden gelecek
olan sistem yanıtları (Zarf durum kodları) için çalışacak bir kural tanımlamak için seçilir. Bu doküman
tipi seçildiğinde koşul verebilecek alanlar kısmında sadece “Header_Record” bölümü gözükecektir.
NOT : “Header_Record” bölümünün altında Connect Database’inde bulunan LG_XXX_APPROVAL
tablosunun kolonları bulunmaktadır.
Olay : Kural tanımı için seçilmiş olan doküman tipindeki belgenin hangi hareketi sırasında kural’ın
çalışacağının belirlendiği alandır. Kural’ın çalışacağı olay tipleri aşağıda verilmiştir, bu tiplerden bazıları
seçilen doküman tipine göre kullanım dışı olabilmektedir veya seçilen olaya göre basit kural “İşlem”
kısmındaki yapılabilecek işlemler kısıtlanabilir.
E-fatura İçin Seçilebilecek Olay Türleri :

Geldiğinde : Logo Connect Posta Kutusu altında Gelen İşlemler kısmına (Gelen Kutusu - Inbox)
herhangi bir şekilde ilgili belge geldiğinde kural tanımı işletilmektedir.

Onaya Gönderildiğinde : Logo Connect ile oluşturulan belge hemen alıcıya gönderilmek
istenmeyebilir. Önce şirket içerisindeki bir onay sürecinden geçirilmek istenebilir, bu durumda
onaylayacak kişinin onayına gönderilir. Bu işlem sırasında kural tanımının çalışması için kullanılır.
(Hem giden hem gelen için çalışır.)

Onaylandığında : Onaya gönderilen bir kayıt, yetkili kişi tarafından incelenip onaylandığında kural
tanımının çalışması için seçilmektedir. (Hem giden hem gelen için çalışır.)

Onay Geri Alındığında : Onaylanmış bir belge için onay’ı geri al işlemi yapıldığında kural tanımının
işletilmesini sağlar. (Hem giden hem gelen için çalışır.)

Kaydedilmeden Önce (İşlenmeden) : Kural için seçilmiş olan tipteki dokümanın kaydetme işleminde
tetiklenecek olan kural tanımlamaya yarar. Bu seçenekteki “İşlenmeden” terimi, kaydedilecek veri
üzerinde bazı eşleme değişiklikleri yapılabilir anlamına gelmektedir. Bu değişiklikler yapılmadan
önce kaydın ham hali üzerinde kural çalıştırılmak istenirse bu olay seçilmelidir.

Kaydedilmeden Önce (İşlendikten sonra) : Kural için seçilmiş olan tipteki dokümanın kaydetme
işleminde tetiklenecek olan kural tanımlamaya yarar. Bu seçenekteki “İşlendikten sonra” terimi,
kaydedilecek veri üzerinde bazı eşleme değişiklikleri yapılabilir anlamına gelmektedir. Bu
değişiklikler yapıldıktan sonra kaydın son hali üzerinde kural çalıştırılmak istenirse bu olay
seçilmelidir.

Kaydedildikten sonra : Kural için seçilmiş olan tipteki dokümanın kaydetme işlemi tamamlandıktan
sonra tetiklenecek olan kural tanımlamaya yarar.

Paketlenmeden/Zarflanmadan Önce : Kural için seçilmiş olan tipteki Dokümanın paketleme veya
zarflama işleminden hemen önce tetiklenecek olan kural tanımlamaya yarar.

Paketlendiğinde/Zarflandığında : Kural için seçilmiş olan tipteki Dokümanın paketleme veya
zarflama işleminden sonra tetiklenecek olan kural tanımlamaya yarar.

Gönderildiğinde : Kural için seçilmiş olan tipteki Dokümanın gönderme işleminden sonra
tetiklenecek olan kural tanımlamaya yarar.
NOT : E-fatura UBL-TR formatında gönderilmekte ve alınmaktadır. E-fatura gönderilirken ERP Sisteminden
Logo Connect’te XML olarak aktarılır. Logo Connect “Paketlemeden/Zarflamadan Önce” işlemi sırasında
XML’i UBL’e çevirir. Kural tanımları bölümünde yapılan veri değişikliği işlemi sırasında XML’deki veriler
değişir ve UBL’e taşınır. E-fatura üzerinde veri değiştirmek amaçlı kural tanımı yapılırken
“Paketlemeden/Zarflamadan Önce” olayı seçilmelidir. E-fatura alınırken UBL-TR formatında gelir ve
“Geldiğinde” işlemi sırasında XML formatı oluşur. Gelen e-fatura üzerinde veri değiştirmek amaçlı
tanımlanacak olan kural tanımlarında “Geldiğinde” olayı seçilmelidir.
Statüsü : Bir kural’ın belli bir süre çalışmasını durdurmak için kullanılan alandır. Bu durumda kural’ı
silmeden çalışmasını engellemek için bu alanın içeriğinin “Pasif” durumuna çekilmesi gerekir. Kuralın tekrar
çalışmasını için içeriği “Aktif” durumuna çekilmesi gerekir.
ÖNEMLİ NOT : Yapılan kural tanımının çalışıp çalışmayacağı sadece kural tanımı içerisindeki “Statüsü”
alanına bağlı değildir. Logo Connect – Çalışma Parametreleri – Genel Parametreler altındaki “Kural Kullan”
parametresininde işaretli olması gerekir. Bu parametre işaretli değilken tanımlanan hiçbir kural çalışmaz.
Şekil 3 Genel Parametreler - Kural Parametresi
ÖNEMLİ NOT : “Kural Geçmişini Kaydet” parametresi ile dokümanlar üzerinde çalışacak olan kurallar İzleme
Kayıtları tutulur. Belgeler üzerinde F9 menüsünden “Uygulanan kurallar” seçeneği ile belge üzerinde
çalışmış olan kurallar bu parametre işaretliyken görülebilir.
NOT : Diğer İşlemler – İzleme Kayıtları altına Logo Connect ile yapılan tüm doküman işlemleri yazılmaktadır.
Planlama – İzleme Kayıtlarına ise Kural tanımı ile ilgili işlemler yazılmaktadır.
Şekil 4 Planlama – İzleme Kayıtları Ekranı
Şekil 5 Uygulanan Kurallar Ekranı
Öncelik : Aynı doküman tipine ve olaya birden fazla kural tanımlanabilir, bu durumda hangisinin önce
çalışacağını belirlemek için kullanılacak alandır.
1.2.
Basit Kural Koşul İşlemi
Koşul : Elle giriş yapılıp, koşul yazılabilen bir alandır. Kural’a atanacak koşul bu alanda belirtilir. Koşul
bölümünde hiçbir şey yazılmamış ise oluşturulan kural tanımı her koşulda çalışacak demektir.
Alanlar : Seçtiğimiz doküman tipi ile ilişkili olarak koşul tanımlayabileceğimiz XML alanları bu bölümde
bulunmaktadır. Doküman tipinin Logo ürünündeki XML formatı bellidir. Logo Connect ürünü bu formatı
temel alarak, ihtiyacı olan diğer alanları bu format üzerine eklemektedir.
NOT : “Header_Record” bölümünün altında Connect Database’inde bulunan LG_XXX_APPROVAL
tablosunun kolonları bulunmaktadır.
HEADER_RECORD Alanları :
Bir veri gönderilmek üzere paketlendiğinde veya geldiğinde LG_XXX_ APPROVAL tablosuna kayıt atılır.
XML kayıtları arasında bu tablo alanlarının tamamına denk gelen Tag’ler yoktur. Bu alanların da kural
tanımlarında kullanılabilmesi için ilgili dokümanın standart XML formatı bozulmadan aşağıda
gösterildiği üzere en başta bulunan HEADER_RECORD başlığı altında toplanarak standart XML formatına
eklenmektedir. HEADER_RECORD başlığı altındaki alanlar doküman tipinden bağımsız olarak tüm
dokümanlarda aynıdır. Standart alanlarda olduğu gibi bu alanlar üzerinde de koşul
tanımlanabilmektedir.
Connect Veritabanında (Inboxta, outboxta, onay işlemlerinde görünen) her kayıt APPROVAL
tablosunda tutulur. Her doküman için APPROVAL tablosunda bulunan aşağıdaki alanlara ulaşılabilir.
Şekil 6 HEADER_RECORD Alanı

GENEXP : Onaylama işlemi için girilen mesaj.

DATE : Giden paket için hazırlanma, gelen paket için alınma tarihi.

RECTYPE : Doküman tipi.

SENDER : Gelen belge için gönderen carinin vergi numarası/kimlik numarası, Giden belge için
gönderilen carinin numarası/kimlik numarası.

EXPLAIN : Giden için alıcıya mesaj, gelen için göndericinin mesajı.

TRCODE : Belgelerin ERP’deki tipi.

ATTRIBUTE : 0: eklenecek, 1: güncellenecek, 2: silinecek.

ERRORCODE : 0: hata yok 1: eşleme hatası var.

TIME : Giden belge için hazırlanma, gelen belge için alınma zamanı.

SCROSS : 0: düz 1: Çapraz (FDA Modülü için)

SUBTYPE : Özel dokümanlar için custom tip.
Veri tabanındaki LG_XXX_APPROVAL tablosunda bulunup “HEADER_RECORD” bölümünde bulunmayan
alanlar:

STATUS : Alan dokümanın hangi aşamada olduğunu gösterir.

CUSTOMDATA1 : Posta Kutusu Özelleştir bölümündeki 1. No' lu alan.

CUSTOMDATA2 : Posta Kutusu Özelleştir bölümündeki 2. No' lu alan.

CUSTOMDATA3 : Posta Kutusu Özelleştir bölümündeki 3. No' lu alan.

CUSTOMDATA4 : Posta Kutusu Özelleştir bölümündeki 4. No' lu alan.

DATA : Gelen veya gönderilecek verinin kendisinin tutulduğu bölümdür.
Operatörler : Kuralın çalışacağı koşulları tanımlanırken bir takım alan ve bilgileri karşılaştırıp, kıyaslayıp,
kural tanımının bu karşılaştırmaların sonuçlarına göre işlemesi sağlanabilir. Bu durum için
operatörlerden yararlanılır.
-
-
Matematiksel Operatörler : Alanların değerleri üzerinde çalışırken kullanılabilir.

(+) Toplama

(-) Çıkarma

(*) Çarpma

(/) Bölme
Karşılaştırma Operatörleri : Karşılaştırma operatörleri değişkenin belirlediğimiz kriterle arasındaki
ilişkiyi belirlerken kullanılabilir.

Eşit Operatörü : Belirlenen alanın değeri ile belirlenen kriterin eşit olma durumu.

Eşit Değil Operatörü : Belirlenen alanın değeri ile belirlenen kriterin eşit olmama durumu.

Büyük Operatörü : Belirlenen alanın değeri ile belirlenen kriterin büyük olma durumu.

Büyük Eşit Operatörü : Belirlenen alanın değeri ile belirlenen kriterin büyük eşit olma
durumu.

Küçük Operatörü : Belirlenen alanın değeri ile belirlenen kriterin küçük olma durumu.

Küçük Eşit Operatörü : Belirlenen alanın değeri ile belirlenen kriterin küçük eşit olma
durumu.
-
Mantıksal Operatörler : Bazı durumlarda yukarıda açıklanan karşılaştırma operatörleri ile tanımlanan
koşullar yeterli olmayabilir. Birden fazla şart’ı bir arada kullanmak için mantıksal operatörlere ihtiyaç
duyulabilir.

Ve Operatörü : Birden çok şart’ın doğru olmasını isteyen bir operatördür. Birleştirdiği her
bir karşılaştırma şartının doğru olmasını gerekir.
ÖRN : DOĞRU AND DOĞRU = DOĞRU
YANLIŞ AND DOĞRU = YANLIŞ

VEYA Operatörü : Birden çok şart’ın içerisinde sadece bir şart’ın doğru olmasının yeterli
olduğu operatördür. Birleştirdiği tüm karşılaştırma şartlarından sadece birisi doğru olması
yeterlidir.
ÖRN : DOĞRU OR YANLIŞ = DOĞRU
YANLIŞ OR YANLIŞ = YANLIŞ

DEĞİL Operatörü : Belirlenen sonucun tersine işlem yapar.
ÖRN : NOT DOĞRU = YANLIŞ

EXCLUSIVE OR (Özel VEYA) Operatörü : Koşullardan sadece seçilen bir tanesinin sağlanması
durumunda kullanılır. Sonucunun olumlu olabilmesi için bileşenlerden sadece bir tanesinin
olumlu olması gerekir, her iki birleşende olumlu ise sonuç olumsuz olur.
ÖRN : DOĞRU XOR DOĞRU = YANLIŞ
YANLIŞ XOR DOĞRU = DOĞRU

,
ve Yardımcı Operatörler : Mantıksal operatörler kullandığımızda mutlaka ifadeler
parantez ile düzenlenmelidir.
-
Koşul Operatörleri : Kuralın belirlenen koşulun sağlanması halinde çalışmasını sağlayan operatörlerdir.

IFTHEN İfadesi : Bu operatör ile tanımlanmış bir şart ifadesinin sonucunun doğru ya da yanlış
olmasına göre kuralın nasıl çalışacağı belirlenebilir.
ÖRN : IFTHEN(Koşul? Doğruysa;Yanlışsa) : Koşul doğruysa 1. yanlışsa 2. değeri verir.
NUMBER = IFTHEN(LEN(NUMBER)=7?’X’+NUMBER;’Y’+NUMBER)
Yukarıdaki örnekte kural tanımında seçilmiş olan ilgili XML şablonunda bulunan fiş numarası 7
karakter ise başına ‘X’ koymakta, 7 karakterden küçük veya büyük ise fiş numarasının başına ‘Y’
karakteri eklemektedir.

SWITCH ifadesi : IFTHEN ifadesinden farklı birden fazla değer tanımlanarak kuralın nasıl
çalışacağı belirlenebilir.
ÖRN : SWITCH(ifade?Değer1=Sonuç1;DeğerN=SonuçN;...) : ifade sonucu değer1 ise Sonuç1,
ifade sonucu değerN ise SonuçN verir.
NUMBER = SWITCH(DOC_NUMBER?’01’=’A’;’02’=’B’;’03’=’D’)
Yukarıdaki örnekte fiş numarasına fişin doküman izleme numarasındaki değer ‘01’ ise ‘A’, ‘02’
ise ‘B’, ‘03’ ise ‘D’ değerleri atanmaktadır.
-
Metin Operatörleri : Metin alanlar içinden istenilen bilginin alınması veya işlenmesinde kullanılır. Kural
tanımlarında metin tipindeki ifadeler ‘XYZ’ de olduğu gibi tek tırnak içerisinde gösterilirler.

MID Operatörü : Bir metin alanın istenilen karakterinden başlayıp istenilen kadarını almak için
kullanılır.
ÖRN : MID(String,Başlangıç,Bitiş) : Verilen String’in Başlangıç’tan itibaren Bitiş’e kadar olan
karakterlerini verir.
MID(CODE,1,5)='KALEM'
Yukarıdaki koşul tanımında ilgili XML şablonundaki CODE alanının taşıdığı metin bilginin ilk beş
karakteri alınır ve ‘”KALEM” ifadesi ile karşılaştırır. Eğer ilk beş karakter ‘”KALEM” ise koşul
olumlu, değil ise koşul olumsuz sonuç üretir.

LEN Operatörü : Bir metin ifadenin karakter sayısını öğrenmek için kullanılır.
ÖRN : LEN(String) : Parametre olarak aldığı metin ifadenin kaç karakter olduğunu sonuç olarak
döner.
NUMBER = MID(DOC_NUMBER,1,LEN(DOC_NUMBER)-1)
Yukarıdaki kural tanımında seçilen XML şablonundaki doküman numarası tag’inde
(DOC_NUMBER) taşınan bilginin son karakteri hariç fiş numarası (NUMBER) alanına atanır.

% Operatörü : Bir metin ifadesinin bulunduğu koşullarda kullanıldığında sonraki karakterler ne
olursa olsun anlamını taşır.
ÖRN : NUMBER ='A%' : İlgili fişin numarası ‘A’ ile başlıyorsa sonuç olumlu döner.
-
Özel Operatörler : Farklı amaçlar tanımlanmış operatörlerdir.

TODAY Operatörü : Üzerinde çalışılan terminal’in sistem tarihinden okuyarak günün tarih’ini
metin olarak getirir. Oluşturulan metinin işletim sisteminin bölgesel ayarlarından etkilendiği
unutulmamalıdır.
1.3.
Basit Kural İşlem Seçenekleri
İşlemler : Basit kural tanımlarında yapılacak işlemlerin tanımlandığı kısımdır. Basit kural tanımında kod
yazımı olmadığı için kural tanımlarının yapacağı işlemler önceden tanımlanmıştır. Doküman tipine ve
olaya göre işlemler değişiklik gösterebilir.
Şekil 7 Basit Kural İşlem Ekranı
1.3.1. Basit Kural İşlemler – Onaya Gönder

Onaya Gönder : Bu işlem seçeneği ile belirlenen olay ve koşul’a uyan belgeler otomatik olarak
onaya gönderilebilirler.

Onay İçin Açıklama : Belgenin onaya gönderilmesi sırasında kullanıcıya gönderilecek
olan mesajın girildiği alandır.

Onay Grubu : LogoConnectSYS’de tanımlanmış kullanıcı gruplarının seçildiği ekrandır.
Şekil 8 Onaya Gönder Kuralı
1.3.2. Basit Kural İşlemler - Onayla

Onayla : Bu işlem seçeneği ile belirlenen olay ve koşul’a uyan belgeler otomatik olarak
onaylanabilir.
Şekil 9 Onayla Kuralı
1.3.3. Basit Kural İşlemler - Paketle

Paketle : Belirlenen kural’a uyan belgeler otomatik paketlenebilir.
Şekil 10 Otomatik Paketleme Kuralı
1.3.4. Basit Kural İşlemler - Kaydet

Kaydet : Bu işlem seçeneği ile belirlenen olay ve koşul’a uyan belgeler otomatik olarak Logo
Uygulamasına kaydedilebilir. Logo Connect ayarlarına göre belge kaydedilirken gösterilebilir
veya gösterilmeden kaydedilebilir. ( Logo Connect – Çalışma Parametreleri – Doküman
Parametreleri – e-Fatura sekmesi altında “Faturayı Kaydetmeden Önce Göster” parametresi)
Şekil 11 “Faturayı Kaydetmeden Önce Göster” Parametresi
1.3.5. Basit Kural İşlemler - Onay Geri Al

Onay Geri Al : Onaylama işleminin geri alınması için tanımlanır. Kayıt, Onay Bekleyen işlemler
bölümünde görülebilir.
Şekil 12 Onay Geri Al Kuralı
1.3.6. Basit Kural İşlemler – Veri Üzerinden Değişiklik Yap

Veri Üzerinde Değişiklik Yap : Kural tanımında seçilen Doküman tipi ve olaya bağlı olarak
taşıdığı alanlar ve içerikleri üzerinde değişiklik yapılmak için kullanılır. Alan içerikleri
değiştirilebilir, boşaltılabilir veya yeni XML alanı eklenebilir.
Şekil 13 Veri Üzerinde Değişiklik Yap Kuralı

Alan Adı : Hangi alan üzerinde değişiklik yapılacağının seçildiği bölümdür.

Değeri : Değişiklik yapılacak olan alana hangi değerin geleceğinin seçildiği bölümdür.
Alan üzerindeki seçim alanı ile ilgili XML’de tanımlı olan bütün alanlar arasından seçim yapılabilir
veya “Değeri” alanına manuel giriş yapılabilir. Seçim ekranına HEADER_RECORD alanları gelmez.
Şekil 14 XML Alanı Seçim Ekranı
ÖRNEK 1 : Giden e-fatura Özel Kodu “X” ’e eşit ise DOC_NUMBER (Fatura Belge Numarası)
alanına AUXIL_CODE (Fatura Özel Kod) alanınındaki bilgiyi getir.
Şekil 15 Koşul Ekranı
Şekil 16 DOC_NUMBER Alanına AUXIL_CODE Alanındaki Bilgiyi Getirmek İçin Yapılan Tanımlama Ekranı
Şekil 17 ERP Fatura Özel kod Tanımı Ekranı
SONUÇ :
Şekil 18 Fatura XML Ekranı
1.3.7. Basit Kural İşlemler – E-Posta Gönder

E-Posta Gönder : Kural tanımı ile seçilen Doküman tipindeki kayıtlar için, seçilen olay ve
koşulların gerçekleşmesi durumunda kişilere otomatik bilgilendirme maili yollanması
sağlanabilir.

Subject : Mail konu başlığı.

Message : Mail içeriği.
NOT : Mail gönderiminin gerçekleştirilmesi için Logo ConnectSYS – Araçlar – E-Posta Ayarları
altından gönderimi yapacak mail adresinin tanımlanması gerekmektedir.
Şekil 19 E-Posta Gönder Kuralı
ÖNEMLİ NOT : Message bölümüne sağ tuş ile “Alan Adları” bölümünden XML’in alanları
taşınabilir. Bu durumda oluşturulan mesaj alanına gelen belgeye özgü alanların taşınması
sağlanabilir. Mesaj alanına XML alanları dışında HEADER_RECORD alanlarıda taşınabilir.
ÖRNEK 2 : Fatura numarasının “FYS” ile başlaması durumunda bilgi maili atılması.
Şekil 20 E-Posta Gönder Kuralı Koşul Ekranı
Şekil 21 E-Posta Gönder Kural Örneği
1.3.8. Basit Kural İşlemler – Klasöre Kaydet

Klasör’e Kaydet : Gelen verinin seçilen klasör’e kaydedilmesini sağlar.

Klasör : Belgenin kaydedileceği klasörün seçildiği alan.

İşlem Sonrası Arşive Gönder : Klasör’e kaydetme işleminden sonra kayıtların arşive
gönderilmesini sağlar.
Şekil 22 Klasör’e Kaydet Kuralı
1.3.9. Basit Kural İşlemler - Onay Akış Grubu Seç

Onay Akış Grubu Seç : Entegratör sayfasında tanımlanmış olan İş Akış Sisteminin tanımlı Çalışma
Alanında çalışmasını sağlayan kural tanımıdır. Bu kural tanımı sadece E-fatura Gönderim
Bağlantı Ayarı Logo Özel Entegratör olan Çalışma Alanlarında gelecektir.
Şekil 23 Entegratör İş Akış Kuralı
NOT : Entegratörlük sayfasında oluşturulan kullanıcılara onay yetkisi görevi verilmesinden sonra
“Onay İş Akış Tanımla” ile iş akış tanımlanması durumunda bu işlemin Logo Connect’te çalışması
için yukarıdaki kuralın tanımlanması gerekmektedir. Entegratör İş Akışı ile kural tanımından
sonra Connect’te gelen faturalar üzerinde “İncele” dışında işlem yapılamayacaktır. Onay yetkisi
olarak tanımlanmış kullanıcı Entegratör sayfasına girerek “Onay Bekleyen” kayıtlar altındaki
faturalara onay vermesi durumunda Connect’te “Al” işlemi yapıldıktan sonra bu faturalar
üzerinde işlem yapılabilecektir.
1.3.10. Basit Kural İşlemler – Serbest Alan Ekle

Serbest Alan Ekle : Kural ile XML ve UBL alanlarına “AdditionalDocumentReference” alanı script
kurala ihtiyaç kalmadan otomatik eklenir.

ID : XML’de oluşacak olan “AdditionalDocumentReference” alanı altındaki <ID> alanının
değerinin belirlendiği alandır.

DOCUMENTTYPE : XML’de oluşacak olan “AdditionalDocumentReference” alanı
altındaki <DOCUMENTTYPE > alanının değerinin belirlendiği alandır.
Şekil 24 Serbest Alan Ekleme Kuralı
ÖRNEK 3 : Fatura belge numarasının faturanın UBL’ine taşınması.
Şekil 25 AdditionalDocumentReference Alanı Ekleme Örneği
Şekil 26 ERP Fatura Belge No Tanımı Ekranı
SONUÇ :
Şekil 27 Fatura UBL Ekranı
2. E-fatura İşlemleri İçin Script Kural Tanımları :
Kural tanımı türünün script kural seçilmesinden sonra F9 menüsünden (sağ tık) “Ekle” işlemi ile kural
tanımı eklenebilir. Bu durumda açılacak olan ekran aşağıdaki gibidir.
Şekil 28 Script Kural Ekranı
Kural No, Açıklama, Doküman, Olay, Statüsü,Öncelik alanları basit kural tanımı bölümünde anlatılan
bilgiler ile aynıdır.
Şifre : Oluşturulan script kurala şifre konulmasını sağlayan alandır.
Script : Kural tanımının yapılacağı alandır. Burada tanımlanacak kuralın script dili VBScript (Vusial Basic
Script)'tir.
Script ekranı açıldığında yukardaki gibi içi boş App nesnesini parametre olarak alan bir prosedür üretilir.
sub ProcessEvent(App)
end sub

App Nesnesinin Metodları :
LDXObject : LDXCComApi nesnesinin login olunmuş bir örneğini verir.
Uobject : UObjects nesnesinin login olunmuş bir örneğini verir.
HeaderByName(“alan_adı”) : Verilen dokümanın alan_adı ile tanımlanan başlık bilgisini verir.
FieldAsString(“alan_adı”) : Verilen doküman alan_adı datasının bilgisini String olarak verir.
FieldAsInteger(“alan_adı”) : Verilen dokümanın alan_adı datasının bilgisini Integer olarak verir.
FieldAsFloat (“alan_adı”) : Verilen dokümanın alan_adı datasının bilgisini Float olarak verir.
ModifyData (“alan_adı”,“değeri”) : “alan adı” ile verilen data field bilgisinin değerini “değeri” ile
değiştirir.
SaveData : Modify Data ile değeri değiştirilmiş alanlar XML'e kaydedilir. Eğer
SaveData çağrılmazsa
ModfiyData’daki değişiklikler XML'e yansıtılmaz.
RunQuery (Query, Quick) : XML üzerinde verilen query çalıştırılır ve XML'in şarta uygun olup
olmadığına göre sonuç döndürülür. Quick Parametresi eğer XML üzerinde işlem yapılacaksa true
yapılmayacaksa daha hızlı çalışması için false verilmelidir.
FirstChild (“child_path”) : Verilen path ilk child'a konumlanır.
NextChild : Sonraki Child noda konumlanılır. Eğer yoksa false döndürür.
SendToApproval “onay için mesaj” : Doküman Onaya gönderilir.
AppApprove : Doküman onaylanır.
UndoApproval : Onay Geri Alınır.
Save : Doküman kaydedilir.
Pack : Doküman paketlenir.
SendMail “to”, “cc”, “subject”, “message” : Mail gönderir.
ÖRNEK 4 : Alınan 'FYS2014000000001' numaralı faturanın onaya gönderilmesi.
sub ProcessEvent(App)
qry = "INVOICE.NUMBER.AsString = 'FYS2014000000001'"
if App.RunQuery(qry, true) then
App.SendToApproval "FYS2014000000001 fatura onaylandı."
end if
end sub
Şekil 29 Alınan Faturanın Onaya Gönderilmesi Örneği
ÖRNEK 5 : Script kural ile AdditionalDocumentReference alanına Özel Kod ve Proje Kodu alanlarının
eklenmesi
sub ProcessEvent(App)
OzelKod = App.Doc.FieldAsString("AUXIL_CODE") ' Ek bilgi olarak göndermek istenen fatura özel
kodunu ERP XML’den okur.’
App.Doc.WriteStartElement "ADDITIONALDOCUMENTS/ADDITIONALDOCUMENT" ' UBL'e ek
açıklama olarak taşınacak blok tanımlanır. Buradaki App.Doc nesnesi herhangi bir yerde
tanımlanmasına gerek yoktur. Hazır olarak gelen ve içerisinde XML dökümanını barındıran bir nesnedir.
Yapılmak istenen tüm değişiklikler bu App.Doc nesnesi üzerinde gerçekleşir.’
App.Doc.WriteElementString "ISSUEDATE", Year(Date()) & "-" & Month(Date()) & "-" & Day(Date())
' UBL'deki Ek Açıklama alanı bir tarih bilgisi bekler. Bu tarih bilgisi ISSUEDATE XML alanına set edilir.’
App.Doc.WriteElementString "DOCUMENTTYPE", "AUXIL_CODE" ' Gönderilen bilginin ne bilgisi
olduğunu DOCUMENTTYPE alanında belirlenir.’
App.Doc.WriteEndElement 'Set işlemlerini sonlandırıp Element'i(bloğu) kapatır.’
' Yukarıdaki işlemleri bir kez de ProjeKodu için tekrarlanır.’
ProjeKodu = App.Doc.FieldAsString("PROJECT_CODE")
App.Doc.WriteStartElement "ADDITIONALDOCUMENTS/ADDITIONALDOCUMENT"
App.Doc.WriteElementString "ID", ProjeKodu
App.Doc.WriteElementString "ISSUEDATE", Year(Date()) & "-" & Month(Date()) & "-" & Day(Date())
App.Doc.WriteElementString "DOCUMENTTYPE", "PROJECT_CODE"
App.Doc.WriteEndElement
App.Doc.SaveData ' Yapılan değişiklikleri kaydeder.’
end sub
Şekil 30 ERP Fatura Özel Kod ve Proje Kodu Tanım Ekranı
SONUÇ :
Şekil 31 Fatura UBL Ekranı
ÖRNEK 5 : Satır Açıklaması üzerinden cari kod kontrolü ile Malzeme Özel bilgisinin gönderilmesi
sub ProcessEvent(App)
okay=App.Doc.FirstChild("TRANSACTIONS.TRANSACTION") ' Faturanın ilk satırına konumlanır.’
while okay ' Eğer faturanın bir satırı varsa okay değişkeni true(başarılı) sonucunu alır. Bir sonraki satıra
her başarılı konumlanmada aşağıdaki while bloğu bir kez çalışacaktır.’
sType = App.Doc.FieldAsInteger("TRANSACTIONS.TRANSACTION.TYPE") ' Satır tipi okunur.’
if sType = 0 then ' Eğer satır tipi = 0 ise (malzeme ise) okuma-yazma işlemleri başlar.’
strLineSpeCode1 = App.Doc.FieldAsString("TRANSACTIONS.TRANSACTION.MASTER_AUXIL_CODE")
'İstenilen veriler ERP XML’i içerisinden okunur.’
strDescription = strLineSpeCode1
App.Doc.ModifyData "TRANSACTIONS.TRANSACTION.DESCRIPTION", strDescription ' Veri DESCRIPTION
alanına yazılır.’
end If
okay=App.Doc.NextChild ' bir sonraki satır çağrılır. Eğer çağırılabilirse okay = true değerini alıp döner.
Eğer çağırılamazsa, yani son satırda ise okay = false değerini alır ve döngü sona erer.’
wend
App.Doc.SaveData ' Yapılan değişiklikler kaydedilir.’
end sub
Şekil 32 Malzeme Market – Özel Kod Tanımı Ekranı
SONUÇ :
Şekil 33 Fatura UBL Ekranı
3. Oluşturulan Kuralın İçeri Veri Alımı - Dışarı Veri Aktarı ve Devri :

İçeri - Dışarı Veri Aktarımı : Veri aktarım işlemi ile tanımlanan kurallar tanımlanma yapılmış olan
Çalışma Alanından dışına aktarılabilir ve başka Çalışma alanına alınabilir. Bu işlem Logo Connect
– Araçlar – Veri Aktarımı (İçeri/Dışarı) kısmından yapılır.
Şekil 34 Veri Aktarım Ekranı
Şekil 35 İçeri Veri Aktarım Ekranı

Dosya Adı : İçeri aktarılacak olan kural dosyasının seçildiği alandır.

Tanımlı Alanlar Aktarılacak : Tanımlanmış olan kural tanımını içeri aktarmak için
seçilmesi gereken parametredir.
Şekil 36 Dışarı Veri Aktarım Ekranı

Dosya Adı : Dışarı aktarılacak olan kural dosyasının seçildiği alandır.

Tanımlı Alanlar Aktarılacak : Tanımlanmış olan kural tanımını dışarı aktarmak için
seçilmesi gereken parametredir.

Kural Devri : Çalışma Alanı Devir İşlemi sırasında tanımlanan kural tanımların aktarılması
sağlanabilir.
Şekil 37 Devir İşlemi Seçim Ekranı

Benzer belgeler