.NET Framework Sürüm 1.1 Kurulumu:
Microsoft WSE 2.0 SP3 Runtime.msi Kurulumu:
KBS Lokal Uygulama Yazılımı Kurulumu:
Versiyon Güncellemesinde Dikkat Edilmesi Gereken
Hususlar:
Web Servis Adresi Kontrol ve Değiştirme:
Müşteri Bilgilerini Veri Tabanında Tutan Tesisler
Manuel Hazırlanmış Dosya Transferi:
Kayıt Giriş ve Güncelleme Formu:
T.C. Kimlik Numarası Sorgulama
Dosya Transferinde Alınan Hatalar
Lokal Uygulama Tarafından Üretilen Hatalar:
XML Yapısında Hata Bulunmaktadır.
Şema Olarak Kullanılan Dosya ('XML\Kayitsema.xsd')
Bulunamadı.
XML Şeması İstenen Şemaya Uymamaktadır.
HASH Değeri Eksik Olduğu İçin İşleme Devam Edilemiyor.
Kişi Sıra Numarası Alanında Uyumsuzluk Bulunmaktadır.
'Excel' Dosya Okunurken Hata İle Karşılaşıldı.
Göndermek İstediğiniz Kayıtlardan Bazıları İstenen
Formata Uymamaktadır.
Web Servis Kullanımı Sırasında Hata Oluşmuştur.
Ana Sistem Tarafından Üretilen Hatalar:
Müşteri Bilgileri Alan Açıklamaları
Dikkat Edilmesi Gereken Hususlar:
Dikkat Edilmesi Gereken Hususlar:
·
İşletim
Sistemleri: Windows 2000; Windows ME;
Windows Server 2003 Service Pack 1 for Itanium-based Systems; Windows Server
2003 x64 editions; Windows XP; Windows XP Professional x64 Edition.
·
Microsoft Internet
Explorer 5.01 veya daha yeni bir sürümünü de çalıştırıyor olmanız gerekir.
·
.NET Framework
Sürüm 1.1
·
Microsoft WSE
2.0 SP3 Runtime.msi
Sistem gereksinimleri tesis tarafından
karşılanacaktır.
Altyapı yazılımları Microsoft firması tarafından
ücretsiz olarak verildiğinden herhangi bir ücret ödenmeden
kullanılabilmektedir.
Gerekli olan altyapı ve uygulama yazılımları www.jandarma.gov.tr/kbs adresinden
indirilebilmektedir.

Şekil 1
.NET Framework Sürüm 1.1 Kurulumu:
Eğer bilgisayarınızda .Net Framework uygulaması
yüklenmemişse:
1. Adım: “dotnetfx.exe”
adlı dosya seçilmelidir. Bu dosya seçildikten ve dosyanın üzerine farenin
(mouse) sol tuşu ile iki kere üst üste basılır.
2. Adım: Gelen pencerede “EVET”
seçeneği seçilerek devam edilir.
3. Adım: Kurulum için
gerekli geçici dosyalar oluşturulmaktadır.
4. Adım: Kurulum
işlemi gerçekleştirilmektedir.
5. Adım: Kurulumun
bittiğine dair mesaj kutusu gelmektedir. “OK”
seçeneği seçilerek kurulum işlemi sonlandırır.
Eğer bilgisayarınızda .NET
Framework altyapısının herhangi bir versiyonu kurulu ise 2. adımda kuruluma
başlamak yerine aşağıdaki mesaj verilerek kurulum işlemi sonlandırılmaktadır.

Şekil - 1
.NET Framework Sürüm 1.1 hakkında detaylı bilgi ve
son sürümleri için Microsoft’un aşağıdaki internet adresi ziyaret edilebilir.

Şekil - 2
Microsoft WSE 2.0 SP3 Runtime.msi Kurulumu:
1. Adım: “Microsoft
WSE 2.0 SP3 Runtime.msi” adlı dosya seçilmelidir. Bu dosya seçildikten ve
dosyanın üzerine farenin (mouse) sol tuşu ile iki kere üst üste basılır.
2. Adım: Gelen pencerede “Next”
seçeneği seçilerek devam edilir.
3. Adım: Kırmızı
yuvarlak ile gösterilen seçenek tercih edilmezse kurulum yapılmasına devam
edilemez. Kırmızı yuvarlak ile belirtilen seçenek işaretlenerek “Next” seçeneği seçilmelidir.
4. Adım: “Install” seçeneği seçilerek kuruluma
başlanır.
5. Adım: Kurulumun
bittiğine dair mesaj kutusu gelmektedir. “Finish”
seçeneği seçilerek kurulum işlemi sonlandırır.


Şekil - 3
KBS Lokal Uygulama Yazılımı Kurulumu:
1. Adım: “KBS.msi”
adlı dosya seçilmelidir. Bu dosya seçildikten ve dosyanın üzerine farenin
(mouse) sol tuşu ile iki kere üst üste basılır.
2. Adım: Gelen pencerede “Tamam”
seçeneği seçilerek devam edilir.
3. Adım: Gelen pencerede “Next”
seçeneği seçilerek devam edilir.
4. Adım: Kurulum ile
ilgili tercihlerin sorulduğu bölümdür. Kurulum yeri değiştirilebilmektedir.
Ancak kurulum yerinin değiştirilmesi önerilmemektedir. Ayrıca uygulamayı
kurulumu gerçekleştiren kişiden başka kişiler de kullanacaksa kırmızı ufak
yuvarlak ile gösterilen seçenek tercih edilmelidir. Daha sonra “Next” seçeneği seçilmelidir.
5. Adım: “Next” seçeneği seçilerek kuruluma
başlanır.
6. Adım: Kurulumun
bittiğine dair mesaj kutusu gelmektedir. “Close”
seçeneği seçilerek kurulum işlemi sonlandırır. Kurulum işleminden sonra
bilgisayar masa üstünde ,
şeklinde görülen bir simge gelir.


Şekil - 4
Versiyon Güncellemesinde Dikkat Edilmesi Gereken Hususlar:
Aynı veya daha düşük versiyonun kurulmak istenmesi
durumunda var olan versiyonun bilgisayardan kaldırılması gerekmektedir.
Daha üst versiyonlar kurulmak istenirse eski sürüm
otomatik olarak kaldırılmaktadır. Ancak bazen çeşitli sebeplerden eski versiyon
otomatik olarak kaldırılamadığından kullanıcıdan bunu manuel yapması
istenebilmektedir.

Şekil - 5

Şekil - 6
Alt yapı yazılımları bir sefer kurulmasını müteakip
sürüm güncellemelerinde tekrar kurulmasına ihtiyaç bulunmamaktadır. Ancak
herhangi bir sebeple tekrar kurulmak istendiği takdirde önceki sürümünün
bilgisayardan kaldırılması gerekmektedir.
Versiyon güncelleme veya tekrar kurulum sırasında
daha önce tanımlanmış olan temel bilgiler sistemden silinmektedir. Dolayısıyla
bu bilgiler kurulumdan sonra uygulamanın ilk çalışması esnasında tekrar
tanımlanmalıdır.
Manuel dosya hazırlayan tesislerin de müşteri bilgileri
silinmekte olup tekrar baştan girilme zorunluluğu bulunmaktadır.
Güvenlikli dosya transferi için kullanılan tesis kodu
ve şifre bilgilerine ihtiyaç bulunmaktadır.
Tesis yetkilisinin, tesis kodunu her dosya
transferinde tekrar yazmasını engellemek maksadıyla tesis kodu uygulama
yazılımı içinde parametrik olarak tutulmaktadır. Dolayısıyla tesis yetkilisi
tarafından kendisine verilen tesis kodunu uygulamaya bir defaya mahsus girmesi
gerekmektedir.
Uygulama programı bilgisayara her yüklendiğinde
yukarıda bahsedilen adımlar tekrarlanarak tesis kodu girilmelidir

Şekil - 7
Web Servis Adresi Kontrol ve Değiştirme:
Üç maksatla kullanılmaktadır.
1.
Uygulama ilk
kurulduğunda otomatik olarak gelen web servis adresinin doğru olup olmadığının
kontrolü,
2.
Uygulamayı
kullanırken dosya transferinde web servis adresinin bulunamadığına dair mesaj
alındığında kontrol için,
3.
J.Gn.K.lığı
tarafından yeni web servis adresi bildirildiğinde değiştirmek için.

Şekil - 8
Testin olumsuz çıkma durumunda bir mesaj gelmekte ve
form üzerinde bulunan “Kaydet” tuşu
pasif duruma geçmektedir. Testten geçemeyen adresin sisteme kaydedilmesi
önlenmektedir.

Şekil - 9
Testin olumsuz çıkmasının çeşitli sebepleri
olabilmektedir. Bunlar;
Öncelikli olarak yukarıda belirtilen sebeplerin
araştırılması gerekmektedir. Bunun için tesis bilgisayar ve alt yapısından
sorumlu olan kişilerden yardım istenmelidir.
Her
türlü kontrol yapıldıktan sonra test hala olumsuz çıkıyorsa durumu İl veya İlçe J. K.lıklarındaki yetkili
kullanıcılara iletiniz.
Müşteri bilgileri tesislerden belirli yapılara göre
hazırlanmış dosyalar halinde istenmektedir.
Dosya tipleri ve yapıları tespit edilirken sistem
gereksinimlerinin yanında tesislerin imkan kabiliyetleri ile en kısa zamanda
adapte olmaları için gerekli koşullar da dikkate alınmıştır.
Müşteri Bilgilerini Veri Tabanında Tutan Tesisler
Öncelikli olarak müşteri bilgilerini bir otomasyon
programı vasıtasıyla veri tabanında tutan tesislerin aynı bilgileri KBS için
lokal programa tekrar girişi önlenmek istenmiştir.
Veri tabanında bulunan müşteri bilgilerini, kendi
otomasyon programlarının içine ekletecekleri modül aracılığıyla, dosya içine
aktarabilmeleri için XML ve Excel yapıda olmak üzere iki değişik dosya yapısı
belirlenmiştir.
Bu şekilde
veri tabanına sahip tesislerin sahip oldukları otomasyon programı teknik destek
elemanları ile irtibata geçerek kendilerine uygun olan iki yapıdan bir tanesine
göre dosya üreten modülü ekletmeleri gerekmektedir.
Otomasyon Programında, Emniyet Genel Müdürlüğü’nün GİYKİMBİL XML Standardını Destekleyen, Modül Bulunan Tesisler
Emniyet Genel Müdürlüğü daha önceden kendi sorumluluk
sahasında bulunan geçici ikamet edenlerin kimlik bildirimi ile ilgili GİYKİMBİL
projesini geçirerek bu proje kapsamında gönderilecek verilerin GİYKİMBİL XML standardında
hazırlanmasını istemiştir.
Bu gelişme üzerine piyasada bulunan tesis otomasyon
programlarının büyük bölümü, veri tabanlarından istenen standartta müşteri
bilgileri dosyası üretmek için gerekli olan modülleri geliştirmişlerdir.
Jandarma sorumluluk sahasında da yukarıda anlatılan
otomasyon programlarından kullanan tesislerin sayısının fazla olduğu tespit
edilmiş olup bu tesislerin mevcut otomasyon programlarına herhangi bir ek modül
ekleme ihtiyacı duymaması için GİYKİMBİL
XML standardında hazırlanış dosyalarda kabul edilmektedir.
Bu durumda olan tesisler, sahip oldukları otomasyon
programı teknik destek elemanları ile irtibata geçerek dikkat etmesi gereken
hususlarda kendilerinin bilgilendirilmelerini istemeleri gerekmektedir.
Veri tabanı olmayan, olduğu halde kendi veri tabanını
kullanmak istemeyen tesislerin yasa kapsamında bulundurması zorunlu olan
donanım dışında ek külfete girmeden müşteri bilgilerini iletmeleri mümkündür.
Bunu için kendilerine verilen iki seçenekten birini kullanmaları yeterli
olacaktır.
1. Müşteri bilgileri dosyasını “EXCEL” yapıda
hazırlayarak göndermelidir. Bu seçenekte bir program kullanmadan elle veri
giriş olacağından girilmesi zorunlu alanlar, alan tiplerine çok dikkat
edilmelidir.
2. Lokal program içersindeki manuel dosya hazırlama
arayüzünü kullanmaktır. Manuel dosya hazırlama, tesis sorumlusuna bir arayüz
yardımıyla müşteri bilgilerini girmede yardımcı olmaktadır.
Manuel
hazırlanan bilgiler bir dosya içerisinde bulunması, bir kontrol mekanizması
olmadığından yanlışlıkla silinebilmesi, silinmesi durumunda geriye dönüş imkanı
olmadığı için tüm bilgilerin baştan girilecek olması önemli problemler
yaratmaktadır. Bu yolu seçen tesislerin yukarıda anlatılan hususlara çok dikkat
etmeleri gerekmektedir.
1. Adım: Ana menüdeki “Dosya
Transferi” altındaki “XML Dosya
Gönder” tuşu tıklanır.
Açılan form Excel yapıda dosya transferi için
kullanılan form ile benzer olduğundan hatalı işlem yapmamak için formun
başlığında “XML Tipi Dosya Gönderme
Formu” yazıldığından emin olunmalıdır.
2. Adım: Gelen formda, hazırlanan XML dosyayı seçmek için “Dosya Seç” tuşu tıklanarak.
3. Adım: Açılan dosya seçim penceresi yardımıyla hazırlanan
XML dosya seçilerek “Aç” tuşu
tıklanır. Dosya seçim penceresi XML uzantısı haricindeki dosyaları seçmeyi engellemektedir.
4. Adım: Tesis şifresi
girildikten sonra “Gönder” tuşu
tıklanarak dosya gönderilir.
5. Adım: Ana sistem
tarafından dosya kabul edildiği takdirde “İşlem
Başarı İle Tamamlandı” ile başlayan ve kaç müşteriye ait kayıt alındığına
dair bir mesaj geri döner.
Gönderilmek istenen XML dosya lokal uygulama ve ana
sistem tarafından kabul edilmeden önce çeşitli kontroller yapılmakta ve uygun
olmayanlar hakkında çeşitli uyarı veya hata mesajları verilmektedir.
Karşılaşabilinecek uyarı ve hata mesajları ileride toplu olarak verilmektedir.

Şekil - 10
Excel yapıda dosya transferinde uygulama bulunduğu
bilgisayardaki “Microsoft Office dll” dosyalarını kullanmaktadır. Bu yüzden
uygulamanın çalıştığı bilgisayarda “Microsoft Office” paketi kurulu olmadığı
takdirde hata verecektir. Bu durumda tesisin bilgisayarına ya “Microsoft
Office” paketini kuracak ya da diğer gönderme seçeneklerini kullanacaktır.
1. Adım: Ana menüdeki “Dosya
Transferi” altındaki “Excel Dosya
Gönder” tuşu tıklanır.
Açılan form XML yapıda dosya transferi için
kullanılan form ile benzer olduğundan hatalı işlem yapmamak için formun
başlığında “XLS Tipi Dosya Gönderme
Formu” yazıldığından emin olunmalıdır.
2. Adım: Gelen formda, hazırlanan Excel dosyayı seçmek için “Dosya Seç” tuşu tıklanarak.
3. Adım: Açılan browser yardımıyla hazırlanan Excel dosya
seçilerek “Aç” tuşu tıklanır.
Browser XLS uzantısı haricindeki dosyaları seçmeyi engellemektedir.
4. Adım: Tesis şifresi
girildikten sonra “Gönder” tuşu
tıklanarak dosya gönderilir.
5. Adım: Ana sistem
tarafından dosya kabul edildiği takdirde “İşlem
Başarı İle Tamamlandı” ile başlayan ve kaç müşteriye ait kayıt alındığına
dair bir mesaj geri döner.
Gönderilmek istenen XLS dosya lokal uygulama ve ana
sistem tarafından kabul edilmeden önce çeşitli kontroller yapılmakta ve uygun
olmayanlar hakkında çeşitli uyarı veya hata mesajları verilmektedir.
Karşılaşabilinecek uyarı ve hata mesajları ileride toplu olarak verilmektedir.

Şekil - 11
Manuel Hazırlanmış Dosya Transferi:
Ana menüdeki “Dosya
Transferi” altındaki “Manuel Dosya
Hazırla” tuşu tıklanarak kayıt listesi formu açılır.

Şekil - 12
Girilen müşteri bilgilerini XML yapıda olan bir dosya
içinde saklamaktadır. Bu dosya, uygulamanın kurulumu sırasında oluşturulan
klasörün altında “JGNK.XML” adında
bulunmaktadır. Bu dosyayı oluştururken de dışarıdan erişime karşı kontrol
değerleri oluşturmaktadır.
Uygulama, her manuel dosya hazırlama formuna girişte
öncelikli olarak bu dosyayı aramaktadır. Dosyayı bulamadığında veya bulduğunda
yaptığı kontrolde dışarıdan müdahale edildiğini tespit ettiğinde içindeki
bilgileri yok sayarak listeyi boş getirmektedir.
Bu durumda liste formunu açmadan önce uyarmaktadır.

Şekil - 13
Daha önce girilmiş kayıtlar bozulmamış ise gelen
formun içinde liste halinde toplu olarak gösterilmektedir.
Kayıt listesi formu ile aşağıdaki işlemler
yapılabilmektedir:
·
Yeni kayıt ekleme
formuna geçiş,
·
Kayıt güncelleme
formuna geçiş,
·
Yanlışlıkla
girilen veya tesisten ayrılmış müşteri bilgisini silmek,
·
Hazırlanan
listeyi ana sisteme göndermek,
·
Hazırlanan
listeyi daha sonra göndermek üzere kaydetmek,
·
En son
kaydedilme işleminden sonra yapılan tüm işlemleri iptal ederek çıkmak.

Şekil - 14
JGNK.XML
Dosyasına Kayıt Esasları: Form
açıldığında “JGNK.XML” dosyasında
bulunan verileri geçici belleğe alınmaktadır. Bu aşamadan itibaren yapılan her
türlü ekleme, güncelleme ve silme işlemleri
“Kaydet ve Gönder” veya “Kaydet” tuşlarından birine basılmadığı
sürece geçici bellekte tutulmaktadır.
Kullanıcı yaptığı işlemlerden vazgeçmesi durumunda
kaydetmeden “İptal” tuşuna basarak
veya formun sol üstünde bulunan “x” işaretine
tıklayarak formdan çıkması durumunda o ana kadar yapılan işlemler iptal
edilecektir.
Yapılan işlemler kaydedilmeden önce programsal bir
hata sebebiyle veya elektrik kesilmeleri vb. sebeplerle programın kontrolsüz
olarak sonlandırılması durumunda da yapılan işlemler gene iptal olacaktır.
İstenmeyen sebeplerden dolayı yapılan işlemlerin
iptal edilmesini engellemek için yapılan işlemlerin zaman zaman “Kaydet” tuşu tıklanarak
kaydedilmesinde fayda bulunmaktadır.
Her kaydetme işleminde JGNK.XML dosyası o anda var olan verilerle güncellenecektir. Bu
sebepten kaydetme işlemi tamamlandıktan sonra da geriye dönüş mümkün
olmamaktadır.
Kayıt Silme
İşlemi: Öncelikli olarak silinmek
istenen kayıt seçilir ve “Sil”
tuşuna veya formun sağ üst köşesindeki “Program”
menüsünün altında bulunan “Sil” seçeneği
tıklanarak kayıt geçici olarak
silinir.
Kaydın kalıcı olarak silinmesi için “Kaydet ve Gönder” veya “Kaydet” işlemlerinden birinin
yapılması gerekir. Bu işlemler yapılmadan “İptal”
tuşuna basılarak veya formun sol üstünde bulunan “x” işaretine tıklanarak çıkma durumunda silme işlemi iptal
edilecektir.



Şekil - 15
Kayıt ve
Gönder: Müşteri bilgilerinin giriş
ve güncelleme işlemlerinin bitirilmesini müteakip verilerin ana sisteme
gönderilmesi için öncelikle şifre girilerek “Kaydet ve Gönder” tuşuna tıklanır.
Uygulama gerekli kontrolleri
tamamladıktan sonra öncelikli olarak JGNK.XML
dosyasına son durumu kaydetme işlemini tamamlar, daha sonra ana merkeze
verilerin gönderme işlemine geçer.
Ana sistem tarafından dosya kabul edildiği takdirde “İşlem Başarı İle Tamamlandı” ile
başlayan ve kaç müşteriye ait kayıt alındığına dair bir mesaj geri döner.
Gönderilmek istenen bilgiler dosya lokal uygulama ve
ana sistem tarafından kabul edilmeden önce çeşitli kontroller yapılmakta ve
uygun olmayanlar hakkında çeşitli uyarı veya hata mesajları verilmektedir.
Karşılaşabilinecek uyarı ve hata mesajları ileride toplu olarak verilmektedir.

Şekil - 16
Kayıt Giriş ve Güncelleme Formu:
Kayıt listesi formunda; giriş için “Ekle”, güncelleme için öncelikli
olarak güncellenmek istenen kayıt seçilir ve ”Güncelle” tuşuna tıklanarak
kayıt giriş ve güncelleme formuna geçilir.


Şekil - 17
Zorunlu alanların kolay anlaşılması için, formda alan
isimleri için üç ayrı renk grubu kullanılmıştır.
KIRMIZI : Tüm müşteriler için doldurulması zorunlu olan alanlardır.
MAVİ : T.C. Vatandaşı müşteriler için kırmızı alanlar ile
birlikte doldurulması zorunlu olan alanlardır.
SİYAH : Doldurma mecburiyeti bulunmayan alanlardır.
Formda üç çeşit veri girişi tipi mevcuttur:
1.
Uzun beyaz
dikdörtgen olan alanların içine istenen formatta karakter girişine müsaade
edilmektedir. Serbest giriş olmakla beraber her alan veri yapısında belirilen
tipte ve uzunlukta karakter girişine müsaade etmektedir.
2.
Seçmeli alanlar
olup sadece ekranda görülen tercihlerden birinin seçilmesine müsaade
etmektedirler.
3.
Tarih
alanlarıdır. Alanın solunda bulunan ok’a
basarak ekrana gelen tarih formu aracılığıyla veya elle tarih bilgileri
girilebilmektedir.

Şekil - 18
İstenen yapıya uygun müşteri bilgisinin giriş veya
güncellemesi yapıldıktan sonra “Kaydet”
tuşuna tıklanır.
Uygulama öncelikli olarak verinin istenen yapıda
girilip girilmediğini, eksik bilgi olup olmadığını kontrol eder. Hata olması
durumunda hata mesajı vererek imleci hatalı olan alana yerleştirir.

Şekil - 19
Kaydın uygun olması durumunda geçici belleğe
kaydederek kaydedildiğine dair mesaj verir ve kayıt listesi formuna geri döner.
Yapılan işlemin JGNK.XML dosyasına kaydedilme işlemi
ancak kayıt listesi formundan da kaydetme işlemi yapıldıktan sonra
gerçekleşmektedir.
Giriş ve güncelleme işleminden vazgeçmek istenmesi
durumunda formda bulunan “Geri” tuşunu
tıklamak yeterli olacaktır.
T.C. Kimlik Numarası Sorgulama
Nüfus ve Vatandaşlık İşleri Genel Müdürlüğü (NVİGM)
tarafından yürütülen MERNİS projesi kapsamında her T.C. vatandaşı için bir T.C.
Kimlik Numarası verilmektedir. Resmi, bankacılık vb. işlemlerde de T.C. Kimlik
Numarası kullanılması zorunlu hale getirilmiştir.
2000 yılından sonra verilen nüfus cüzdanlarında bu
bilgi mevcut olmakla beraber daha eski nüfus cüzdanları, ehliyet ve kimlik
yerine geçen diğer belgelerde bu alan mevcut değildir.
NVİGM internet sitesinde vatandaşların T.C. Kimlik
Numaralarını sorgulayabileceği bir hizmet sunmaktadır.
Tesiste bulunan müşterilerden T.C. Kimlik Numarası
bilinmeyenlerin sorgulanması için NVİGM internet sitesine daha rahat
ulaşabilmeleri için kısayollar konulmuştur.
T.C. Kimlik Numarası sorgulama ve doğrulama
servisleri NVİGM’ne ait olduğu için servislerin kullanımı ile ilgili bilgiler
ilgili sitede mevcut bulunmaktadır.

Şekil - 20
İhtiyaç duyulması halinde uygulama üzerinde
güncellemeler yapılarak yeni versiyon çıkarılabilmektedir.
Yeni
versiyonun kullanıma başlanılması ile ilgili tesislere tebligat yapılacak olsa
da tesislerin en son güncel versiyonu kullandıklarından emin olmaları için
uygulama içerisinden yeni versiyon kontrolü yapılabilmektedir.
Bunun için ana menüde bulunan “Yardım” menüsünün
altındaki “Yeni Versiyon Kontrolü” seçeneği tıklanır.

Şekil - 21
Yeni versiyonun mevcut olması durumunda tesis ikaz
edilerek kurulum dosyasının indirilmesi sağlanır. Kurulum dosyası indirildikten
sonra kurulum talimatına göre yeni versiyonun kurma işlemi gerçekleştirilerek
işlemlere devam edilir.
Dosya Transferinde Alınan Hatalar
Lokal Uygulama Tarafından Üretilen Hatalar:
XML Yapısında Hata Bulunmaktadır.

Şekil - 22
Otomasyon program tarafından üretilmiş olan XML
dosya, veri yapıları bölümündeki XML Hakkında Genel Bilgi’deki
belirtilen kurallara uygun olarak üretilmediği durumlarda verilen hatadır.
Özellikle kullanılmaması gereken karakterlerin
müşteri ad, soyadı, adres bilgileri içinde kullanıldığı ve otomasyon
programının bunları engellemediği zamanlarda sık sık alınmaktadır. Otomasyon program
içerisinde gerekli düzeltmeler ile sorun aşılabilmektedir.
Şema Olarak Kullanılan Dosya ('XML\Kayitsema.xsd') Bulunamadı.

Şekil - 23
Kurulum sırasında oluşturulan klasörün altında
bulunan XML klasörünün içinde “Kayitsema.xsd”
ile “Kayitsema.xsx” şema dosyaları oluşturulmaktadır.
Şema dosyaları gönderilmek istenilen XML dosyanın
şekil olarak istenen formatta olup olmadığını kontrolde kullanılmaktadır. Şema
dosyalarının buradan silinmesi, taşınması, isminin değiştirilmesi gibi
durumlarda program dosyayı bulamadığı zaman ürettiği hata mesajıdır.
Şema
dosyaların yerine konması gerekmektedir. Dosyalar bulunamadığı takdirde
uygulama tekrar kurulmalıdır.
XML Şeması İstenen Şemaya Uymamaktadır.
Gönderilmek istenilen XML dosyanın şekil olarak
istenen formatta olup olmadığı, şema dosyaları yardımıyla kontrol edilmektedir.
Kontrol sonucu uyumsuz çıkan XML dosyaları için üretilen hata mesajıdır.
Alan adları, büyük, küçük harfe duyarlıdır. Örneğin “SiraNo” yerine “Sirano” yazılması hataya sebebiyet vermektedir.
Kişi bilgilerinde boş olan alanların da mutlaka
bulunması gerekmektedir.
Otomasyon
program içerisinde gerekli düzeltmeler ile sorun aşılabilmektedir.
HASH Değeri Eksik Olduğu İçin İşleme Devam Edilemiyor.
Uygulamada XML yapı için “HASH” değeri kontrolü yapılmıyor olsa da EGM’nün GİYKİMLBİL
projesindeki XML yapıya uygunluğunu sağlamak maksadıyla “HASH” bilgisinin bulunması aranmaktadır.
<?hash
432AB78342DFE0E7FDF4C8BFC116B1A4?>
Otomasyon
program içerisinde gerekli düzeltmeler ile sorun aşılabilmektedir.
Kişi Sıra Numarası Alanında Uyumsuzluk Bulunmaktadır.

Şekil - 24
Her kişi kaydı için ayrı sıra numarası olmalıdır. Bazı
otomasyon programlarında müşteri sıra numarasını, kişi sıra numarası olarak
kullanıldığı gözlemlenmiştir. Bu gibi durumlarda eğer aynı müşteri birden fazla
odada kalıyor ise birden fazla kayıt üretilmekte ama sıra numaraları aynı
olmaktadır.
Otomasyon
program içerisinde gerekli düzeltmeler ile sorun aşılabilmektedir.
XML Dosya İçerisinde Tesis Kodu Bilgisi Eksik veya Tanımladığınızdan Farklı Olduğu İçin İşleme Devam Edilemiyor.
Temel bilgi tanımlaması yapılırken tesis kodu bilgisi
tanımlanmaktadır. XML dosya üretilirken de otomasyon programı tarafından tesis
kodu XML dosyanın içine yazılmaktadır. Uygulama programı bu iki tesis kodu
arasında uyuşmazlık tespit ettiği zaman hata üretmektedir.
Öncelikli olarak tesis bilgi tanımlamasından tesis
kodunun doğru tanımlanıp tanımlanmadığı kontrol edilmelidir. Tesis kodu burada doğru
tanımlanmış ise o zaman otomasyon program içerisinde XML dosya üretilirken
oluşturulan tesis kodunun düzelttirilmesi gerekmektedir.
'Excel' Dosya Okunurken Hata İle Karşılaşıldı.
Excel yapıda dosya transferinde uygulama bulunduğu
bilgisayardaki “Microsoft Office dll” dosyalarını kullanmaktadır. Bu yüzden
uygulamanın çalıştığı bilgisayarda “Microsoft Office” paketi kurulu olmadığı
takdirde hata verecektir.
Paket kurulu olsa dahi kullanılmak istenen
“Microsoft.Office.Interop.Excel” ile “Office” dll dosyalarının sistemden
sislinmiş olma durumlarında da hata verilmektedir.
En son olarak Excel veri yapısı bölümündeki dikkat
edilmesi gereken hususlarda anlatılanlara dikkat edilmesi gerekmektedir.
Göndermek İstediğiniz Kayıtlardan Bazıları İstenen Formata Uymamaktadır.
Gönderilmek istenen bilgilerin müşteri bilgileri alan
açıklamalarında belirtilen şartlara uygunluğu kontrol edilmekte ve hata ile
karşılaşıldığında hata mesajı verilmektedir.
Tesislerin hatalarını daha süratli gidermeleri için
veriler baştan sona kadar teker teker kontrol edilmekte ve her hata ayrı bir
satır oluşturacak şekilde text dosyası oluşturulmakta ve kullanıcıya
gösterilmektedir.
Oluşturulan
text dosyada bilgisinde hata olan müşteriye daha süratli ulaşımı sağlamak için
öncelikle müşterinin oluşturulan dosyada kaçını sırada olduğu, oda numarası,
adı ve soyadı bilgileri verilmekte, sonra hatalı olan alanın adı ve
barındırdığı değer, en son olarak ta hata ile ilgili açıklama yapılmaktadır.
Hatalı
olan alanlara ait hataların giderilmesinden sonra gönderime geçilmelidir.
Dosya
başlığında hata olduğunun bildirilmesi durumunda ise otomasyon program
içerisinden düzeltilmelidir.
Bölüm 1:

Bölüm 2:

Bölüm 3:

Şekil - 25
Web Servis Kullanımı Sırasında Hata Oluşmuştur.
Gönderilmek istenen bilgilerin kontrollerinin
bitirilmesini müteakip ana sisteme bu bilgilerin gönderme işlemine geçilir.
Uygulama, ana sistemde bulunan web servis ile iletişim kuramadığı zamanlarda
hata mesajı vermektedir.
Duruma göre iletişim kuramamanın birden fazla sebebi
bulunmaktadır. Öncelik sırasına göre dikkat edilmesi gereken hususlar aşağıya
çıkarılmıştır.
1.
İnternet
bağlantısı kesilmiş olabilir. Dial-up bağlantı ile interneti kullanan
tesislerin sık sık başına gelmektedir.
2.
Bilgisayar
üzerinde veya bilgisayarın bağlı olduğu yerel ağ üzerinde bulunan güvenlik
yazılımları tarafından web servis kullanımı engelleniyor olabilir. Özellikle
büyük ölçekli, ana merkez üzerinden internete çıkan tesislerde sık sık meydana
gelmektedir.
3.
İnternet bağlantısında
sorun olmadığının ve güvenlik yazılımları tarafından engellenmediğinden emin
olduktan sonra web servis adresinin kontrol edilmesi gerekmektedir.

Şekil - 26
4.
Son olarak web servis adresinin
değişmiş veya ana sistemde arıza olma durumunun kontrolü için tesis
yetkilisinin kendisinden sorumlu olan birlikte (İl J. veya İlçe J. K.lıkları)
bulunan İl/İlçe J.K.lıkları Yetkili Kullanıcısına başvurması gerekmektedir.
Ana Sistem Tarafından Üretilen Hatalar:
J.Gn.K.lığı
Sistemi Hata Bildirmiştir:
Hata Kodu: -1
Sistem tarafından verilen şifre, tesis tarafından
değiştirilmeden lokal uygulama kullanımına izin verilmemektedir. Sistem
tarafından verilen şifre kullanılarak veri gönderimi yapmak istendiğinde
üretilen hata kodudur.
Hata Kodu: -2
Üç sefer üst üste hatalı şifre ile giriş denemesi
yapıldığı için kullanıma kapalı olduğunu bildiren hata kodudur. Tesis kodu ve
şifre kullanım esasları doğrultusunda kullanıcısının kullanıma açılması
gerekmektedir.
Hata Kodu: 11
Hatalı şifre girilme durumudur. Büyük, küçük harf
kullanımına dikkat edilmelidir.
Hata Kodu: 12
Sistem belirli zaman aralıklarında veri kabul
etmektedir. Bazen de sistem ana yetkilisi tarafından değişik maksatlarla geçici
olarak sistem kapatılabilmektedir. Bu durumlarda öncelikli olarak kullanım
zamanları içinde tekrar denemek, kullanım zaman dilimi içinde olduğu halde hata
veriyorsa bir müddet bekledikten sonra tekrar denemek gerekmektedir.
Sürenin uzaması halinde (İl J. veya İlçe J.
K.lıkları) bulunan İl/İlçe J.K.lıkları Yetkili Kullanıcısına bildirilmesi
gerekmektedir
Hata Kodu: 21
XML yapıda hata olduğunda üretilen hata kodudur.
Lokal uygulamadaki hatalarda detaylı olarak anlatılmıştır.
Hata Kodu: 22
HASH değerindeki eksiklik veya şemaya uyumsuzluk
olduğunda üretilen hata kodudur. Lokal uygulamadaki hatalarda detaylı olarak
anlatılmıştır.
Hata Kodu: 23
Gönderilmek istenen bilgilerin müşteri bilgileri alan
açıklamalarında belirtilen şartlara uygunluğu kontrol edilmekte ve hata ile
karşılaşıldığında hata mesajı verilmektedir. Yapılan açıklama lokal
uygulamadaki detaylı olmayıp sadece satır numarası ve hatalı olan alan adından
ibarettir.
Müşteri Bilgileri Alan Açıklamaları

Şekil - 27
Açıklamalar:
Ülke Kodları
Ülke bilgileri tablosu, pasaportlarda kullanılan
ülkelerin İngilizce adlarına göre sıralı verilmiştir.


Şekil - 28
Kimlik Belgesi Kodları

Şekil - 29
Cinsiyet Kodları

Şekil - 30
Medeni Hal Kodları

Şekil - 31
<?xml version="1.0" encoding="iso-8859-9" ?>
<?hash 432AB78342DFE0E7FDF4C8BFC116B1A4?>
<Konaklama
TesisKodu="54336"
Tarih="2006-06-12 23:50:26"
GonderenProgram="JGNK_XML"
GonderenProgramVersiyon="1.0.0">
<Kisi
SiraNo="1"
TCKimlikNo="12345678901"
Adi="ADI"
Soyadi="SOYADI"
BabaAdi="BABA ADI"
AnaAdi="ANNE ADI"
DogumYeri=""
DogumTarihi="1988-06-26"
Uyrugu="TC"
KimlikBelgesiTuru="N"
KimlikSeriNo="D 2345"
NufusaKayitliOlduguIl=""
NufusaKayitliOlduguIlce=""
NufusaKayitliOlduguMahalle=""
NufusCilt=""
NufusAileSira=""
NufusSiraNo=""
Cinsiyet="E"
MedeniHali="B"
Isi=""
IkametAdresi="ANKARA"
GelisTarihi="2006-10-04 14:41:58"
AyrilisTarihi=""
VerilenOdaNo=""
AracPlakaNo="" />
</Konaklama>
Extensible Markup Language(XML), uyumsuz programlar,
bilgisayar ağları, veri yapıları ve işletim sistemleri konularında endişelenmeye
gerek kalmadan yaygın olarak kullanılan bir veri tanımlama dili standardıdır.
XML, dosya yapısı ve içeriğini tanımlamak için
standart etiketler kullanır. Tüm dosyalarda aynı XML ekleri kullanılarak, metin
esaslı bilgilerde dizin, arama, birleştirme ve yeniden kullanma işlemleri etkin
biçimde gerçekleştirilebilir. XML, metin esaslı olduğu ve bilgisayar dilleriyle
kısıtlı olmadığı için, normalde uyumsuz olan sistemler arasında da veri
alışverişini mümkün kılmaktadır.
XML dokümanları ilişkisel veritabanlarından farklı
olarak hiyerarşik bir yapısı vardır. Bu yapı kendine has kuralları da
beraberinde getirmektedir.
• <?xml version="1.0"
encoding="ISO-8859-9" ?> bu satır başlangıç etiketidir ve kapanış
etiketi yoktur. Üç adet özniteliği vardır ve “version” özniteliği verilmek
zorundadır. “version” özniteliği XML dosyasının versiyonunu belirtir ve bu
bilgi dokümanı parse(okuma) edecek uygulama için gereklidir. “encoding”
özniteliği doküman içerisindeki dil seçeneğini belirtmek için kullanılır.
• <Konaklama> </ Konaklama >
etiketi ise kök(root) etikettir ve XML dokümanın da en az bir tane bulunmak
zorundadır. Bu etiket diğer bütün etiketleri içerisine almak zorundadır.
• <Kisi ….. /> etiketi çocuk(child)
etiket olarak isimlendirilir ve element olarak ta bilinir. Buradaki SiraNo,
Adi,Soyadi gibi başılklarda belirtilenler birer özniteliktir ve öznitelik
değerleri “” arasında verilmek zorundadır.
• XML dokümanında her alan bir etiket çifti
arasında belirtilir ve açılan her etiket kapatılmak zorundadır.
• Etiketler büyük küçük harf (case sensitivity)
duyarlıdır.
• Bir element içerisinde başka bir element
açılmış ise o element kapanmadan diğeri kapatılamaz, yani hiyerarşi bozulamaz.
• XML beyaz karakter(white space) göz önüne
alınır.
• <, >, ", ', & bu karakterler
XML içerisinde kullanılamaz.
• Doküman içerisinde en az bir element
olmalıdır.
Dikkat Edilmesi Gereken Hususlar:
1.
Sistemin bu
dokümanı okuyabilmesi için bir takım NODE ve ATTRIBUTE tanımları
kullanılmaktadır. NODE ve ATTRIBUTE dışındaki değerler dikkate alınmamaktadır.
2.
XML dokümanının
dil ayarı iso-8859-9 olacak şekilde
oluşturulmalıdır. Bu şekilde Türkçe karakterler sorunsuz algılanabilmektedir.
3.
İlk satır <?xml
version=”1.0” encoding=”iso-8859-9”?> şeklinde olmalıdır.
4.
Doküman Konaklama ve Kişi bilgilerinden oluşur.
·
Konaklama
• TesisKodu:
Tesise verilen kod. Tam sayı olmalıdır.
• Tarih:
Tarih ve Saat bilgilerini içermelidir. Formatı YYYY-MM-DD hh:mm:ss şeklinde
olmalıdır.
• GonderenProgram:
Bu veriyi hazırlayan programın adı yazılacaktır. En fazla 80 karakter olabilir.
• GonderenProgramVersiyon:
Gönderen programın versiyonu buraya yazılacaktır. En fazla 80 karakter
olabilir.
·
Kişi
Müşteri bilgileri burada yer alır. Her müşteri için
tekrarlanacaktır. Müşteri Bilgileri Alan
Açıklamalarında belirtilen sıra ve kurallara uygun olarak oluşturmalıdır.
5.
Uygulamada XML
yapı için “HASH” değeri kontrolü
yapılmıyor olsa da EGM’nün GİYKİMLBİL projesindeki XML yapıya uygunluğunu
sağlamak maksadıyla “HASH”
bilgisinin bulunması aranmaktadır.
<?hash
432AB78342DFE0E7FDF4C8BFC116B1A4?>
Konaklama verisi içindeki <Konaklama kodu ile başlayıp </Konaklama> ile biten kısmının MD-5 algoritması ile HASH
değeri elde edilip XML dosyasında prolog olarak eklenmelidir.
6.
XML standardı
olarak <?xml versiyon=”1.0” encoding=”iso-8859-9” ?> kodu dokümanın en
başında olmak zorundadır. Yine standart olması açısından <?hash ?>
bilgisinin de başta olması beklenmektedir.
Dikkat Edilmesi Gereken Hususlar: