DATASEL BİLGİ SİSTEMLERİ ÜRÜN GELİŞTİRME BÖLÜMÜ TİG AKTARIM DOSYASI OLUŞTURMA UYGULAMASI UYGULAMA KULLANIM KILAVUZU V 1.0 Hazırlayan : DataSel Bilgi Sistemleri A.Ş. 27/01/2012
İÇERİK 1. GİRİŞ... 1 1.1 AMAÇ... 2 1.2 HEDEF KİTLE... 2 2. SÖZLÜK VE KURALLAR... 3 2.1 SÖZLÜK... 3 3. UYGULAMA ÖZELLİKLERİ VE KULLANIMI... 4 3.1 GİRİŞ... 4 3.2 DESTEKLENEN VERİ TABANI SİSTEMLERİ... 4 3.3 UYGULAMA KULLANIMI... 4 3.3.1 Genel Parametreler... 4 3.3.2 Sağlık Bakanlığı Parametreleri... 6 3.3.2.1 TIG için Xml İçeriği Oluşturmada Kullanılan SQL Sorgusu Yapısı... 6 3.3.2.2 TIG için Xml İçeriği Oluşturmada Kullanılan SQL Sorgusu İncelemesi... 6 3.3.2.3 TIG için Xml İçeriği Oluşturma İşlemi... 7 4. EKLER... 13
TABLOLAR Tablo 1 - Sözlük... 3 Tablo 2 Genel Parametreler Bölümünde Saklanan Veriler ve Açıklamaları... 5 Tablo 3 Örnek Veri tabanı Bağlantı Cümleleri... 5 Tablo 4 Sağlık Bakanlığı Parametreleri Bölümünde Kullanılacak SQL Sorgusunun Kolon Yapısı... 8 Tablo 5 Veri tabanı Bazlı Sorgu Şart Bölümleri... 9 Tablo 6 Sağlık Bakanlığı Parametreleri Bölümü için Örnek SQL Sorgusu... 10 Tablo 7 Taburcu Şekilleri... 13 Tablo 8 Sosyal Güvence Durumları... 13 Tablo 9 Yatış Şekilleri... 13 Tablo 10 Hasta Yatış Tipleri... 14 ŞEKİLLER Sekil 1 Genel Parametreler Bölümü Ekran Görünümü... 6 Sekil 2 Sağlık Bakanlığı Parametreleri Bölümü Ekran Görünümü... 11 Sekil 3 Xml Oluşturma İşlem Özeti ve Dosya Kaydetme Ekran Görünümü... 12
VERSİYON GEÇMİŞİ Versiyon Versiyon Yazan Onaylayan / Not Numarası Tarihi Doğrulayan 1.0 27/01/2012 Onur KİPEL Nurali ÜNAL İlk dağıtım 1
1. GİRİŞ 1.1 Amaç Bu uyglama TİG bilgilerini içeren xml dosyasını oluşturmak amacıya kullanılır. Uygulama belirtilmiş veritabanına bağlanarak, istenilen verileri alır ve yollanacak xml dosyasının içeriğini oluşturur. 1.2 Hedef Kitle Bu dokümandan TİG için xml içeriği oluşturan kullanıcılar yararlanabilirler. 2
2. SÖZLÜK VE KURALLAR 2.1 Sözlük TERİM TİG Xml İm HBYS SQL Veritabanı ORACLE DB MS SQL ODBC AÇIKLAMA Teşhisle ilişkili gruplar 1970 li yıllarda, Amerika Birleşik Devletlerinde Yale Üniversitesi nde sağlık hizmetlerinin kalite denetimi amacıyla geliştirilmiş bir araç olup 1980 yılından itibaren geri ödemelerde de kullanılmaya başlanan bir vaka sınıflama sistemidir. Yatan hastalar, belirli verilere göre, belirli bir algoritma kullanılarak sınıflanmaktadır. Teşhis ilişkili grupların oluşturulmasındaki temel amaç, benzer çıktılar veya hizmetler alması beklenen vaka tiplerinin bir tanımının yapılması ve böylece kıyaslanabilir bilgi üretilmesidir. Extensible Markup Language (Genişletilebilir İşaretleme Dili, kısaca XML), hem insanlar hem bilgi işlem sistemleri tarafından kolayca okunabilecek dokümanlar oluşturmaya yarayan, W3C tarafından tanımlanmış bir standarttır. Bu özelliği ile veri saklamanın yanında farklı sistemler arasında veri alışverişi yapmaya yarayan bir ara format görevi de görür. SGML'in basitleştirilmiş bir alt kümesidir. Bir xml içeriğinde bulunan her bir elemana im denir. Bu imler ana ve yavru imler olmak üzere iki ayrı kategoride değerlendirilirler. Hastane Bilgi Yönetim Sistemi kelimelerinin kısaltılmış halini belirtmek için kullanılılır. SQL, (İngilizce "Structured Query Language", Türkçe: Yapılandırılmış Sorgu Dili) verileri yönetmek ve tasarlamak için kullanılan bir veritabanı yönetim sistemidir. SQL, kendisi bir programlama dili olmamasına rağmen birçok kişi tarafından programlama dili olarak bilinir. SQL herhangi bir veri tabanı ortamında kullanılan bir alt dildir. SQL ile yalnızca veri tabanı üzerinde işlem yapılabilir. SQL'e özgü cümleler kullanarak veri tabanına kayıt eklenebilir, olan kayıtlar değiştirilebilir, silinebilir ve bu kayıtlardan listeler oluşturulabilir. Sistematik erişim imkânı olan, yönetilebilir, güncellenebilir, taşınabilir, birbirleri arasında tanımlı ilişkiler bulunabilen bilgiler kümesidir. Oracle Database, zaman zaman Oracle RDBMS (relational database management system), Oracle ilişkisel veritabanı yönetim sistemi (Oracle İVTYS) veya sadece Oracle olarak anılan, gelişmiş bir ilişkisel veritabanı yönetim sistemidir. Microsoft a gelişmiş bir ilişkisel veritabanı yönetim sistemidir. Open Database Connectivity (kısaca ODBC, Türkçe: Açık Veritabanı Bağlantısı), veritabanı yönetim sistemlerine erişmek için standart bir yazılım arayüzü sağlar. Tablo 1 - Sözlük 3
3. UYGULAMA ÖZELLİKLERİ VE KULLANIMI 3.1 Giriş Uygulama, herhangi bir HBYS uygulamasının kullandığı aktif bir veri tabanından istenilen verileri, yapısı belirgin bir SQL sorgusu ile çeker ve bu SQL sorgusu sonuçları yardımı ile de TİG için xml içeriğini oluşturur. Uyarı : DataSel Bilgi Sistemleri A.Ş. uygulamanın kullanılabilirliğini arttırmak veya operasyon güncellemeleri sebebiyle uygulama içeriğinde ve kullanımında değişiklik yapabilir. 3.2 Desteklenen Veri Tabanı Sistemleri Uygulama, Oracle ve MS SQL Server veri tabanı sunucularını destekler. NOT : Oracle tipi veri tabanı sunucusu kullanan kullanıcılarının bilgisayarlarında ODBC kurulu olmalıdır. 3.3 Uygulama Kullanımı Uygulama iki ana bölümden oluşmaktadır. Bunlar; Genel Parametreler : Uygulamanın veri tabanına bağlanırken kullanacağı bilgileri içeren ve kaydeden bölümüdür. Sağlık Bakanlığı Parametreleri : İstenilen xml içeriğini oluşturmak amacıyla kaydedilmiş SQL sorgusunu içerir ve TİG için xml içeriğini oluşturur. 3.3.1 Genel Parametreler Uygulamanın bu bölümü, bağlanılacak veri tabanının bağlantı bilgilerini saklamak ve girilen veri tabanı bilgilerinin doğruluğunu kontrol etmek amacıyla kullanılır. Bu bölümde saklanan veriler Tablo 2 de gösterildiği gibidir. Tablo 3 de ise Tablo 2 de belirtilen Bağlantı Cümlesi için örnek bağlantı cümleleri gösterilmektedir. VERİ TİPİ Bağlantı Cümlesi Veri tabanı Tipi AÇIKLAMA Bağlanılacak veri tabanının bilgilerini içerir ve zorunlu bir alandır. Bağlanılacak veri tabanının tipini içerir ve zorunlu bir alandır. 4
Tablo 2 Genel Parametreler Bölümünde Saklanan Veriler ve Açıklamaları VERİTABANI TİPİ MS SQL SERVER ORACLE BAĞLANTI CÜMLESİ Data Source=[DataSource];Initial Catalog=[Database Name];User ID=[Username]; Password=[Password] Provider=MSDAORA;Data Source=[Database Service Id];User Id=[Username];Password=[Password]; Tablo 3 Örnek Veri tabanı Bağlantı Cümleleri Kullanıcı, uygulamanın bu bölümünü için gerekli olan bağlantı bilgileri girdisinin ardından, bu bağlantı bilgilerini Şekil 1 de gösterilen Bağlantıyı test et tuşu ile sınayabilir. Uygulama bağlantı bilgilerinin doğruluğuna göre sınama işleminin sonucunu kullanıcıya gösterir. Kullanıcı bu bölümde istenilen bağlantı bilgilerini kalıcı bir şekilde kaydetmek için Şekil 1 de gösterilen KAYDET tuşunu, kaydetmeden yaptığı değişiklikleri geri almak için ise İPTAL tuşunu kullanmalıdır. 5
Sekil 1 Genel Parametreler Bölümü Ekran Görünümü 3.3.2 Sağlık Bakanlığı Parametreleri Uygulamanın bu bölümü, veri tabanından veri almak için kullanılan SQL sorgusunu kaydetmek ve SQL sorgusu sonuçlarını istenilen xml içeriğine çevirmek amacıyla kullanılır. Bu bölümde saklanan veriler Tablo 2 de gösterildiği gibidir. Tablo 3 de ise Tablo 2 de belirtilen Bağlantı Cümlesi için örnek bağlantı cümleleri gösterilmektedir. 3.3.2.1 TIG için Xml İçeriği Oluşturmada Kullanılan SQL Sorgusu Yapısı Uygulamanın istenilen xml içeriğini oluşturabilmesi için standartlaştırılmış bir SQL sorgusuna ihtiyacı vardır. Bu nedenle, verilerin alımı için çalıştırılacak olan SQL sorgusunun kolonları, içerikleri ve veri tipleri Tablo 4 de gösterildiği gibi olmalıdır. 3.3.2.2 TIG için Xml İçeriği Oluşturmada Kullanılan SQL Sorgusu İncelemesi Uygulamanın çalıştıracağı SQL sorgusu, kullanıcı tarafından belirtilmiş bir tarih aralığındaki verileri alabilecek şekilde yazılmalıdır. Bu durum, sorgu içerisinde başlangıç ve bitiş tarihlerine denk düşen birer parametre olması gerektiğini belirtir ve yine sorgunun yapısı gereği sorgunun şart bölümü standartlaştırılmış bir yapıda olmalıdır. Bu standartlaştırılmış sorgu şart bölümü, uygulamanın desteklediği veri tabanı sunucu tiplerine göre değişiklik gösterir. Sorgunun şart bölümü Tablo 5 de gösterildiği gibi olmalıdır. 6
3.3.2.3 TIG için Xml İçeriği Oluşturma İşlemi Uygulamanın çalıştıracağı SQL sorgusunun yazılmasının ve kaydedilmesinin ardından, kullanıcı istenilen xml içeriğini Şekil 2 de gösterilen ekran aracılığı ile oluşturabilir. Şekil 2 de gösterilen bu ekran aracılığı ile, kullanıcı çalıştırılacak SQL sorgusunun şart bölümünde bulunan başlangıç ve bitiş tarihi parametrelerine seçili değerleri atar. Kullanıcının, belirtmiş olduğu tarih aralığındaki sorgu sonucunu xml içeriğine dönüştürebilmesi için Şekil 2 de gösterilen Xml İçeriği Oluştur tuşunu kullanması gerekir. Xml oluşturma işlem özetleri ise Şekil 3 de gösterilen ekran aracılığı ile kullanıcıya detaylı bir şekilde gösterilir. Şekil 3 de gösterilen ekrandaki Dosyayı Kaydet tuşu ile de oluşturulan xml içeriği xml uzantılı bir dosya olarak kullanıcının bilgisayarına kaydedilir. 7
KOLON ADI VERİ TİPİ AÇIKLAMASI NOT HOSPITALCODE String Hastane kodu Size verilen hastane kodunu belirtir. PATIENTNO String Hasta numarası Hasta T.C. kimlik numarasını belirtir. BIRTHDATE Date Time Hasta Doğum Tarihi Çevrilebilir tarih/saat düzeninde olmalıdır. AGE String Hasta Yaşı Tam sayı düzeninde olmalıdır. SEX String Hasta Cinsiyeti E:Erkek, K:Kadın, B:Bilinmiyor için kullanılır. ADMISSIONDATE Date Time Kabul Tarihi Çevrilebilir tarih/saat düzeninde olmalıdır. DISCHARGEDATE Date Time Çıkış Tarihi Çevrilebilir tarih/saat düzeninde olmalıdır. DISCHARGETYPE String Çıkış Tipi Ekler bölümündeki Taburcu Şekilleri tablosuna bakınız. ISNEWBORN String Yeni doğan mı? Yeni doğan ise E, değil ise H değerini almalıdır. BIRTHWEIGHT String Doğum Ağırlığı Yeni doğan alanı değeri E ise doğum ağırlığı bilgisi, değil ise -1 değerini almalıdır. ISPERMITTED String İzinli ayrıldı mı? Evet ise E, değil ise H değerini almalıdır. PERMITTEDDAYS String İzinli olduğu gün sayısı Tam sayı düzeninde olmalıdır. PATIENTNAME String Hasta Adı STATUS String Sosyal Güvence Durumu Ekler bölümündeki Sosyal Güvence Durumları tablosuna bakınız. ADMISSIONTYPE String Kabul Tipi Ekler bölümündeki Yatış Şekilleri tablosuna bakınız. CARETYPE String Hasta Yatış Tipleri Ekler bölümündeki Hasta Yatış Tipleri tablosuna bakınız. INTENSIVECAREDAYS String Yoğun bakımda geçirdiği gün adedi Tam sayıya çevrilebilir bir değer olmalıdır. TAKIPNO String ADMISSIONNO String Kabul Numarası CODETYPE String Kod Tipi ISPRINCIPAL String Evet ise E, değil ise H değerini almalıdır. CODE String Kodu ISPREDIAGNOSIS String Ön tanı mı? Evet ise E, değil ise H değerini almalıdır. DATEOFPROCESS String Çevrilebilir tarih/saat düzeninde olmalıdır. Tablo 4 Sağlık Bakanlığı Parametreleri Bölümünde Kullanılacak SQL Sorgusunun Kolon Yapısı 8
VERİTABANI TİPİ SORGU ŞART BÖLÜMÜ MS SQL SERVER Where *ÇıkışTarihiAlanAdı+>=@StartDate AND *ÇıkışTarihiAlanAdı+<=@EndDate ORACLE Where *ÇıkışTarihiAlanAdı+ between? and? Tablo 5 Veri tabanı Bazlı Sorgu Şart Bölümleri NOT : MS SQL SERVER kullanan kullanıcıların, Tablo 5 de gösterildiği üzere, sorgu şart bölümündeki başlangıç ve bitiş tarihlerini simgeleyen parametre adlarını @StartDate ve @EndDate şeklinde yazmaları gerekmektedir. Örnek sorgu içeriği ise Tablo 6 de gösterilmektedir. 9
SQL SORGUSU select '123' HOSPITALCODE,PatientNo PATIENTNO,BirthDate BIRTHDATE,Sex,round(((sysdate-birthdate)/365),0) AGE,AdmissionDate ADMISSIONDATE,AdmissionNo ADMISSIONNO,AdmissionType ADMISSIONTYPE,DischargeDate DISCHARGEDATE,DischargeType DISCHARGETYPE,'H' ISNEWBORN,-1 BIRTHWEIGHT,'H' ISPERMITTED,'-1' PERMITTEDDAYS,PatientName PATIENTNAME,Status STATUS,'1' CARETYPE,IntensiveCareDays INTENSIVECAREDAYS,'I' CODETYPE,Code CODE,IsPrincipal ISPRINCIPAL,IsPreDiagnosis ISPREDIAGNOSIS,DateOfProcess DATEOFPROCESS,'' TAKIPNO from drgv0001 where DischargeDate between? and? Tablo 6 Sağlık Bakanlığı Parametreleri Bölümü için Örnek SQL Sorgusu 10
Sekil 2 Sağlık Bakanlığı Parametreleri Bölümü Ekran Görünümü 11
Sekil 3 Xml Oluşturma İşlem Özeti ve Dosya Kaydetme Ekran Görünümü 12
4. EKLER TABURCU ŞEKLİ SORGU SONUCUNDA OLMASI GEREKEN DEĞER Akut Bakım Hastanesine Taburcu/Transfer 1 Evde Bakım 2 Psikiyatri 3 Rehabilitasyon İçin Taburcu/Transfer 4 İstatistiksel Taburcu - Hasta Türü/Servisi 5 Değişimi Tavsiyeye Karşın Ayrılış 6 İstatistiksel Taburcu - İzinli Ayrılış 7 Ölüm 8 Eve 9 Tablo 7 Taburcu Şekilleri SOSYAL GÜVENCE DURUMU SORGU SONUCUNDA OLMASI GEREKEN DEĞER SGK 1 Yeşil Kart 2 Ücretli 3 Özel Sigortalı 4 Diğer 5 Tablo 8 Sosyal Güvence Durumları YATIŞ ŞEKLİ SORGU SONUCUNDA OLMASI GEREKEN DEĞER Birinci Basamaktan Sevk İle 1 Bir Başka Hastaneden Sevk İle 2 Doğrudan Başvuru 3 Hasta Türü/Servisi Değişimi 4 Diğer 5 Bilinmiyor 6 Tablo 9 Yatış Şekilleri 13
HASTA YATIŞ TİPİ SORGU SONUCUNDA OLMASI GEREKEN DEĞER Yatan Hasta 1 Ayaktan Hasta 2 Rehabilitasyon 3 Aynı Gün 4 Tablo 10 Hasta Yatış Tipleri 14