Dosya Transferi - Jandarma Genel Komutanlığı

Dosya Transferi - Jandarma Genel Komutanlığı

Kurulum______________________________________________________________________ 2
Sistem Gereksinimleri _________________________________________________________________ 2
Altyapı Gereksinimleri ________________________________________________________________ 2
.NET Framework Sürüm 1.1 Kurulumu: ___________________________________________________ 4
Microsoft WSE 2.0 SP3 Runtime.msi Kurulumu:____________________________________________ 6
.NET Framework Sürüm 3.5 Kurulumu: ___________________________________________________ 4
KBS Lokal Uygulama Yazılımı Kurulumu: ________________________________________________ 8
Versiyon Güncellemesinde Dikkat Edilmesi Gereken Hususlar: _______________________________ 10
Temel Bilgilerin Tanımlanması __________________________________________________ 12
Tesis Kodu: ________________________________________________________________________ 12
Web Servis Adresi Kontrol ve Değiştirme: ________________________________________________ 13
Dosya Transferi_______________________________________________________________ 15
Hangi Tip Dosya: ___________________________________________________________________ 15
Müşteri Bilgilerini Veri Tabanında Tutan Tesisler ________________________________________ 15
Otomasyon Programında, Emniyet Genel Müdürlüğü’nün GİYKİMBİL XML Standardını Destekleyen,
Modül Bulunan Tesisler ____________________________________________________________ 15
Veri Tabanı Olmayan Tesisler _______________________________________________________ 16
XML Yapıda Dosya Transferi: _________________________________________________________ 17
Excel Yapıda Dosya Transferi: _________________________________________________________ 19
Manuel Hazırlanmış Dosya Transferi:____________________________________________________ 21
Kayıt Listesi Formu: _______________________________________________________________ 21
Kayıt Giriş ve Güncelleme Formu:____________________________________________________ 26
T.C. Kimlik Numarası Sorgulama________________________________________________ 29
Yeni Versiyon Kontrolü ________________________________________________________ 30
Dosya Transferinde Alınan Hatalar ______________________________________________ 31
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. _________________________________
XML Dosya İçerisinde Tesis Kodu Bilgisi Eksik veya Tanımladığınızdan Farklı Olduğu İçin İşleme
Devam Edilemiyor.________________________________________________________________
'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: _________________________________________________
Hata Kodu: -1 ____________________________________________________________________
Hata Kodu: -2 ____________________________________________________________________
Hata Kodu: 11____________________________________________________________________
Hata Kodu: 12____________________________________________________________________
Hata Kodu: 21____________________________________________________________________
Hata Kodu: 22____________________________________________________________________
Hata Kodu: 23____________________________________________________________________
31
31
31
32
32
32
33
33
33
35
36
36
36
36
36
36
36
36
VERİ YAPILARI __________________________________________________________ 36
Müşteri Bilgileri Alan Açıklamaları ______________________________________________ 36
Ülke Kodları _________________________________________________________________ 39
Kimlik Belgesi Kodları _________________________________________________________ 41
Cinsiyet Kodları ______________________________________________________________ 41
Medeni Hal Kodları ___________________________________________________________ 41
XML Yapı ___________________________________________________________________ 42
XML Hakkında Genel Bilgi: ___________________________________________________________ 43
Dikkat Edilmesi Gereken Hususlar: _____________________________________________________ 44
EXCEL Yapı _________________________________________________________________ 45
Dikkat Edilmesi Gereken Hususlar: _____________________________________________________ 46
Kurulum
Sistem Gereksinimleri
 İş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, Window Vista (KBS 3.5.0 ve
yukarı sürümler), Windows 7 (KBS 3.5.0 ve yukarı sürümler).
 Microsoft Internet Explorer 5.01 veya daha yeni bir sürümünü de çalıştırıyor
olmanız gerekir.
Altyapı Gereksinimleri

.NET Framework Sürüm 1.1 (KBS 2.2.1 Sürümü İçin)

Microsoft WSE 2.0 SP3 Runtime.msi

.Net Framework Sürüm 3.5 (KBS 3.5.0 ve Yukarı Sürümler İçin)
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
adresinden indirilebilmektedir.
uygulama
37
yazılımları
www.jandarma.gov.tr/kbs
Şekil 1
37
.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.
http://www.microsoft.com/downloads/browse.aspx?displaylang=tr&productID=C
9C8FCFB-BFF3-40CA-B59D-216F6850000A
37
Şekil - 2
37
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.
37
Şekil - 3
.NET Framework Sürüm 3.5 Kurulumu:
Eğer bilgisayarınızda .Net Framework uygulaması yüklenmemişse:
1. Adım: “dotNetFx351setup.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.
37
2. Adım: Gelen pencerede “ÇALIŞTIR” 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.
.NET Framework Sürüm 3.5 hakkında detaylı bilgi ve son sürümleri için
Microsoft’un internet adresi ziyaret edilebilir.
http://www.microsoft.com/en-us/download/details.aspx?id=25150
KURULUM ADIMLARI GÖRSEL
Şekil-1
Şekil-2
37
Şekil-3
37
Şekil-4
37
Şekil-5
37
Şekil-6
KBS Lokal Uygulama Yazılımı Kurulumu:
1. Adım: “KBS_3_5_0.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.
37
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.
Yeni sürümün kurulumundan sonraTesis Kodu girişinde hata alındığında;
Bilgisayar kullanıcısına, KBS programının kurulu olduğu C:\Program
Files\JGNK\ klasörüne erişmesi için TAM YETKİ (Yazma ve Değiştirme)
verilmelidir.
37
Şekil - 4
37
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
37
Ş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.
37
Temel Bilgilerin Tanımlanması
Tesis Kodu:
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
37
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.
37
Ş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;

Girilen adres yanlış yazılmış olabilir,

Bilgisayarın internet bağlantısı kopmuş olabilir,

Bilgisayar üzerinde veya bilgisayarın bağlı bulunduğu ağ üzerinde bulunan
güvenlik yazılımları tarafından engelleniyor olabilir.
Ö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.
37
Dosya Transferi
Hangi Tip Dosya:
Müşteri bilgileri tesislerden belirli yapılara göre hazırlanmış dosyalar halinde
istenmektedir.

XML yapıda dosya,

Excel yapıda dosya,

Manuel hazırlanmış dosya.
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 Tesisler
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
37
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.
37
XML Yapıda Dosya Transferi:
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:
gönderilir.
Tesis şifresi girildikten sonra “Gönder” tuşu tıklanarak dosya
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.
37
Şekil - 10
37
Excel Yapıda Dosya Transferi:
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:
gönderilir.
Tesis şifresi girildikten sonra “Gönder” tuşu tıklanarak dosya
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.
37
Şekil - 11
37
Manuel Hazırlanmış Dosya Transferi:
Kayıt Listesi Formu:
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.
37
Ş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.
37
37
Ş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.
37
Şekil - 16
37
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.
37
Ş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:
37
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.
37
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
sorgulayabileceği bir hizmet sunmaktadır.
T.C.
Kimlik
Numaralarını
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
37
Yeni Versiyon Kontrolü
İ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.
37
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
37
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
aşılabilmektedir.
program
içerisinde
gerekli
düzeltmeler
ile
sorun
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
aşılabilmektedir.
program
içerisinde
gerekli
düzeltmeler
ile
sorun
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
aşılabilmektedir.
program
içerisinde
37
gerekli
düzeltmeler
ile
sorun
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:
37
Bölüm 2:
Bölüm 3:
Şekil - 25
37
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.
37
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.
VERİ YAPILARI
Müşteri Bilgileri Alan Açıklamaları
37
MÜŞTERİ BİLGİLERİ
ZORUNLU
EN FAZLA
UZUNLUK
ADI
ALAN TİPİ
XX
T.C. KİMLİK NUMARASI
TamSayı
11
X
ADI
Karakter
80
X
SOYADI
Karakter
80
XX
BABA ADI
Karakter
80
XX
ANNE ADI
Karakter
80
DOĞUM YERİ
Karakter
80
X
DOĞUM TARİHİ
Tarih
X
ÜLKESİ
Karakter
5
Referans Tablo İçerisindeki
Değerler Olmalı
X
KİMLİK BELGESİ TÜRÜ
Karakter
1
Referans Tablo İçerisindeki
Değerler Olmalı
X
KİMLİK BELGESİ SERİ VE NUMARASI
Karakter
20
NÜFUSA KAYITLI OLDUĞU İL
Karakter
80
NÜFUSA KAYITLI OLDUĞU İLÇE
Karakter
80
NÜFUSA KAYITLI OLDUĞU MAHALLE/KÖY
Karakter
80
CİLT NO
TamSayı
15
AİLE SIRA NO
TamSayı
15
BİREY SIRA NO
TamSayı
15
CİNSİYETİ
Karakter
1
Referans Tablo İçerisindeki
Değerler Olmalı
MEDENİ HALİ
Karakter
1
Referans Tablo İçerisindeki
Değerler Olmalı
İŞİ
Karakter
80
X
İKAMET ADRESİ
Karakter
255
X
GELİŞ TARİHİ
Tarih
"YYYY-MM-DD HH:MM:SS"
şeklinde olmalı
AYRILIŞ TARİHİ
Tarih
"YYYY-MM-DD HH:MM:SS"
şeklinde olmalı
VERİLEN ODA NUMARASI
Karakter
15
ARACININ PLAKASI
Karakter
20
X
AÇIKLAMA
Tam 11 Rakamdan
Oluşmalıdır.
"YYYY-MM-DD" şeklinde
olmalı
X
Tesis tarafından tüm müşterileri için zorunlu bildirmesi gerekenler
XX
Tesis tarafından T.C. Vatandaşı müşterileri için extra bildirmesi gerekenler
Şekil - 27
37
Açıklamalar:
1. Yaş, cinsiyet durumuna bakılmaksızın tesiste konaklayan her müşterinin
bilgisinin gönderilmesi gerekmektedir.
2. T.C. Kimlik Numarası alanına mutlaka 11 rakamdan oluşan değer girilmelidir.
Yabancı ülke vatandaşları için bu alan boş bırakılmalıdır. Bazı otomasyon
programlarının yabancı vatandaşlar için bu alana müşteri numarası veya
‘*’,’.’,’ ‘ gibi karakterler girdiği görülmüştür. Bu gibi durumlarda uygulama hata
mesajı vermektedir.
3. ADI,SOYADI,BABA ADI, ANNE ADI alanları kimlik belgesinde yazıldığı
şekilde aynen girilmelidir. İki adı olanlar için kısaltma kullanılmamalıdır.
“Mustafa Kemal” şeklinde aynen yazılmalıdır. Adının başında unvan bilgileri
konulmamalıdır. Bazı tesislerin “Mr. Ahmet” şeklinde yazdıkları görülmüştür.
Bu şekildeki hatalı girişler sebebiyle kimlik doğrulaması hatalı çıkmaktadır.
4. Alanlara mutlaka alan tipine uygun karakterler yazılmalıdır.
5. Sayısal olan alanlar için boş bırakılması gerekiyorsa hiçbir karakter
girilmemelidir. Bazı otomasyon programlarının sayısal alanların boş bırakıldığı
zamanlar boşluk karakteri atadığı. Bu gibi durumlarda uygulama hata mesajı
vermektedir.
6. Kimlik belgesi seri ve numarası için “SERİ+BOŞLUK+NO” şeklinde giriş
yapılmalıdır. Örnek “CS 764999”
7. Araç plakası plakanın tamamı arada boşluk bırakılmadan girilmelidir.
“06ZXC99”
8. Doğum tarihi alanı için örnek “1972-01-29” şeklinde olmalıdır.
9. Geliş veya Ayrılış Tarihi tarih saat grubunu içermelidir. Örnek “2007-01-09
14:00:00”
10. Ülkesi alanına mutlaka referans tablo içinde geçen değerlerden biri
verilmelidir. Bazı tesisler örnek olarak T.C. vatandaşlar için “TC” yerine “T.C.”
veya “TR” gibi değerler girdiği için hata mesajı almaktadırlar.
11. Referans tablo değerleri kullanan alanlara mutlaka tablo değerlerinden biri
girilmelidir. Örneğin erkek için cinsiyeti hanesine “E” yerine “M” veya başka
tabirler yazılmamalıdır.
12. İkametgâh adresi beyana dayalı bilgi olup müşteri nasıl beyan ederse aynı
şekilde girilmelidir.
37
Ülke Kodları
Ülke bilgileri tablosu, pasaportlarda kullanılan ülkelerin İngilizce adlarına göre
sıralı verilmiştir.
Ülke
Kod
Ülke
Kod
TÜRKİYE
TC
DJIBOUTI
DJI
KUZEY KIBRIS TURK CUMHURİYETİ
KKTC
DOMINICA
DMA
AFGHANISTAN
AFG
DOMINICAN REPUBLIC
DOM
ALBANIA
ALB
ECUADOR
ECU
ALGERIA
DZA
EGYPT
EGY
AMERICAN SAMOA
ASM
EL SALVADOR
SLV
ANDORRA
AND
EQUATORIAL GUINEA
GNQ
ANGOLA
AGO
ERITREA
ERI
ANGUILLA
AIA
ESTONIA
EST
ANTARCTICA
ATA
ETHIOPIA
ETH
ANTIGUA AND BARBUDA
ATG
FAEROE ISLANDS
FRO
ARGENTINA
ARG
FALKLAND ISLANDS (MALVINAS)
FLK
ARMENIA
ARM
FIJI
FJI
ARUBA
ABW
FINLAND
FIN
AUSTRALIA
AUS
FRANCE
FRA
AUSTRIA
AUT
FRENCH GUIANA
GUF
AZERBAIJAN
AZE
FRENCH POLYNESIA
PYF
BAHAMAS
BHS
FRENCH SOUTHERN TERRITORIES
ATF
BAHRAIN
BHR
GABON
GAB
BANGLADESH
BGD
GAMBIA
GMB
BARBADOS
BRB
GEORGIA
GEO
BELARUS
BLR
GERMANY (Deutschland)
DEU
BELGIUM
BEL
GHANA
GHA
BELIZE
BLZ
GIBRALTAR
GIB
BENIN
BEN
GREECE
GRC
BERMUDA
BMU
GREENLAND
GRL
BHUTAN
BTN
GRENADA
GRD
BOLIVIA
BOL
GUADELOUPE
GLP
BOSNIA AND HERZEGOVINA
BIH
GUAM
GUM
BOTSWANA
BWA
GUATEMALA
GTM
BOUVET ISLAND
BVT
GUERNSEY
GBG BRAZIL
BRA
GUINEA
GIN
BRITISH INDIAN OCEAN TERRITORY
IOT
GUINEA-BISSAU
GNB
BRUNEI DARUSSALAM
BRN
GUYANA
GUY
BULGARIA
BGR
HAITI
HTI
BURKINA FASO
BFA
HEARD ISLAND AND MCDONALD ISLANDS
HMD
BURUNDI
BDI
HND
CAMBODIA
KHM
HONDURAS
HONG KONG (Special Administrative Region of China)
CAMEROON
CMR
HUNGARY
HUN
CANADA
CAN
ICELAND
ISL
CAPE VERDE
CPV
INDIA
IND
CAYMAN ISLANDS
CYM
INDONESIA
IDN
CENTRAL AFRICAN REPUBLIC
CAF
IRAN (Islamic Republic of Iran)
IRN
CHAD (Tchad)
TCD
IRAQ
IRQ
CHILE
CHL
IRELAND
IRL
CHINA
CHN
ISRAEL
ISR
CHRISTMAS ISLAND
CXR
ITALY
ITA
COCOS (KEELING) ISLANDS
CCK
JAMAICA
JAM
COLOMBIA
COL
JAPAN
JPN
COMOROS
COM
JERSEY
GBJ JORDAN (Hashemite Kingdom of Jordan)
JOR
COG
CONGO - REPUBLIC OF
CONGO-THE DEMOCRATIC REPUBLIC OF THE
(formerly Zaire)
COD
HKG
KAZAKHSTAN
KAZ
COOK ISLANDS
COK
KENYA
KEN
COSTA RICA
CRI
KIR
CÔTE DIVOIRE (Ivory Coast)
CIV
KIRIBATI
KOREA (Democratic Peoples Republic of [North] Korea)
CROATIA (Hrvatska)
HRV
KOREA (Republic of South Korea)
KOR
CUBA
CUB
KUWAIT
KWT
CYPRUS
CYP
KYRGYZSTAN
KGZ
CZECH REPUBLIC
CZE
LAO PEOPLE'S DEMOCRATIC REPUBLIC
LAO
DENMARK
DNK
LATVIA
LVA
37
PRK
Kod
Ülke
Kod
Ülke
LEBANON
LBN
SAINT HELENA
SHN
LESOTHO
LSO
SAINT KITTS AND NEVIS
KNA
LIBERIA
LBR
SAINT LUCIA
LCA
LIBYA (Libyan Arab Jamahirya)
LBY
SAINT PIERRE AND MIQUELON
SPM
LIECHTENSTEIN (Fürstentum Liechtenstein)
LIE
SAINT VINCENT AND THE GRENADINES
VCT
LITHUANIA
LTU
SAMOA (formerly Western Samoa)
WSM
LUXEMBOURG
MACAO (Special Administrative Region of China)
LUX
SAN MARINO (Republic of)
SMR
MAC
SAO TOME AND PRINCIPE
STP
MACEDONIA (Former Yugoslav Republic of Macedonia)
MKD
SAUDI ARABIA (Kingdom of Saudi Arabia)
SAU
MADAGASCAR
MDG
SENEGAL
SEN
MALAWI
MWI
SERBIA AND MONTENEGRO
SCG
MALAYSIA
MYS
SEYCHELLES
SYC
MALDIVES
MDV
SIERRA LEONE
SLE
MALI
MLI
SINGAPORE
SGP
MALTA
MLT
SLOVAKIA (Slovak Republic)
SVK
MARSHALL ISLANDS
MHL
SLOVENIA
SVN
MARTINIQUE
MTQ
SOLOMON ISLANDS
SLB
MAURITANIA
MRT
SOMALIA
SOM
MAURITIUS
MUS
ZAF
MAYOTTE
MYT
SOUTH AFRICA (Zuid Afrika)
SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
MEXICO
MEX
SPAIN (España)
ESP
MICRONESIA
FSM
SRI LANKA
LKA
MOLDOVA
MDA
SUDAN
SDN
MONACO
MCO
SURINAME
SUR
MONGOLIA
MNG
SVALBARD AND JAN MAYEN
SJM
MONTSERRAT
MSR
SWAZILAND
SWZ
MOROCCO
MAR
SWEDEN
SWE
MOZAMBIQUE (Moçambique)
MOZ
SWITZERLAND (Confederation of Helvetia)
CHE
MYANMAR (formerly Burma)
MMR
SYRIAN ARAB REPUBLIC
SYR
NAMIBIA
NAM
TAIWAN (Chinese Taipei for IOC)
TWN
NAURU
NRU
TAJIKISTAN
TJK
NEPAL
NPL
TANZANIA
TZA
NETHERLANDS
NLD
THAILAND
THA
NETHERLANDS ANTILLES
ANT
TIMOR-LESTE (formerly East Timor)
TLS
NEW CALEDONIA
NCL
TOGO
TGO
NEW ZEALAND
NZL
TOKELAU
TKL
NICARAGUA
NIC
TONGA
TON
NIGER
NER
TRINIDAD AND TOBAGO
TTO
NIGERIA
NGA
TUNISIA
TUN
NIUE
NIU
TURKMENISTAN
TKM
NORFOLK ISLAND
NFK
TURKS AND CAICOS ISLANDS
TCA
NORTHERN MARIANA ISLANDS
MNP
TUVALU
TUV
NORWAY
NOR
UGANDA
UGA
OMAN
OMN
UKRAINE
UKR
PAKISTAN
PAK
UNITED ARAB EMIRATES
ARE
PALAU
PLW
UNITED KINGDOM (Great Britain)
GBR
PALESTINIAN TERRITORIES
PSE
UNITED STATES
USA
PANAMA
PAN
UNITED STATES MINOR OUTLYING ISLANDS
UMI
PAPUA NEW GUINEA
PNG
URUGUAY
URY
PARAGUAY
PRY
UZBEKISTAN
UZB
PERU
PER
VANUATU
VUT
PHILIPPINES
PHL
VATICAN CITY (Holy See)
VAT
PITCAIRN
PCN
VENEZUELA
VEN
POLAND
POL
VIET NAM
VNM
PORTUGAL
PRT
VIRGIN ISLANDS( BRITISH)
VGB
PUERTO RICO
PRI
VIRGIN ISLANDS( U.S.)
VIR
QATAR
QAT
WALLIS AND FUTUNA
WLF
RÉUNION
REU
WESTERN SAHARA (formerly Spanish Sahara)
ESH
ROMANIA
ROU
YEMEN
YEM
RUSSIAN FEDERATION
RUS
ZAMBIA
ZMB
RWANDA
RWA
ZIMBABWE
ZIM Şekil - 28
37
SGS
Kimlik Belgesi Kodları
Kimlik Belgesi Türleri
Pasaport
Avrupa Birliği Kimliği
Nüfus Hüviyet Cüzdanı
Ehliyet
Diğer
Kod
P
A
N
E
D
Şekil - 29
Cinsiyet Kodları
Cinsiyet
Erkek
Kadın
Kod
E
K
Şekil - 30
Medeni Hal Kodları
Medeni Hali
Bekar
Evli
Kod
B
E
Şekil - 31
37
XML Yapı
<?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>
37
XML Hakkında Genel Bilgi:
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.
37
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
olmalıdır.
<?xml version=”1.0” encoding=”iso-8859-9”?>
şeklinde
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.
37
EXCEL Yapı
Bölüm 1:
Bölüm 2:
Şekil - 32
Dikkat Edilmesi Gereken Hususlar:
1. Müşteri bilgilerinin bulunduğu sayfa, Excel dosyanın ilk sayfası olmalıdır.
Uygulama diğer sayfalardaki bilgileri dikkate almaz.
2. Sayfanın birinci satır alan açıklamaları içindir.
3. Kolon sıraları örnekte olduğu gibidir. Kolon sıralamasına riayet edilmesi
gerekmektedir.
4. Bilgisi girilecek her müşteri için bir satır olacak şekilde satır atlamadan giriş
yapılmalıdır.
5. Uygulama ilk boş gördüğü satırda okuma işlemini sonlandırdığı için satır
atlandığı takdirde eksik bilgi gönderilmiş olunur.
6. En son müşteri bilgisi satırından sonraki satıra hiçbir şey yazılmamalıdır. Bu
satırdaki hücrelere konulacak en ufak boşluk karakteri, “.” vb değerler,
uygulamanın o satırın dolu olduğunu kabul etmesine ve dolayısıyla hataya
sebebiyet verecektir.
7. Sıra numarası 1’den başlayarak artan değer olmalıdır.
8. Bilgilerin alan açıklamalarında belirtilen formatta girilmesi gerekmektedir.