ProWPS Yan Sanayi & Tedarikçi Portalı

Kullanım Klavuzu

Kurulum

Sistem Gereksinimleri

Uygulamada temelde 3 bileşenden oluşmaktadır. Bunlar:

1. Sunucu programı
2. İstemci programı
3. Veri tabanı

Uygulamanın çalışabilmesi için bu 3 bileşeninde konfigüre edilerek çalışır hale getirilmesi gerekmektedir.

Sunucu ve İstemci uygulamalar dotnet uygulamalarıdır, ve çalışabilmek için sisteminizde dotnet framework’ ün yüklü olması gerekir. Veri tabanı konusunda ise uygulamamız veri tabanı bağımsız çalışmaktadır, tercih ettiğiniz veri tabanı sistemini konfigüre ettikten sonra birkaç küçük ayarlama yaparak uygulamayı aktive edebilirsiniz.

Sitemiz üzerinden dağıtılan çalıştırılabilir paketlerimizde Sqlite veri tabanı sistemi tercih edilmiştir. Bu veri tabanı sisteminin sağladığı avantajlar ise kullanıcı tarafından herhangi bir konfigürasyona ihtiyaç duyulmaması ve taşınabilir olmasıdır. Tabiki kullanıcıların bu veri tabanı sistemi dışında farklı bir sistemi kullanma şanslarıda her zaman bulunmaktadır.

Özetlersek:

1. LivServer Sunucu Programı ( Windows için dotnet framework / Linux, Mac için Mono Framework )
2. LivClient İstemci programı ( Web sunucuya ihtiyaç duymaktadır. Kurulum paketinde Windows için “cassini”, Linux, Mac için “xsp” sunucu konfigure edilmiştir. )
3. Veritabanı ( default Sqlite, diğer veritabanı sistemleri tercihe bağlı )

Notlar:

Çalıştırılabilir paketimizi sorunsuz kullanmak için dotnet framework 4.5’ i yüklemelisiniz. Sunucu, Client uygulamamız Mono framework ile Linux üzerinde test edilmiştir.

Kurulum Adımları

Uygulama 3 katmanlı mimaride çalıştığı için her bir katmanın (sunucu, istemci, veritabanı) konfigürasyonu farklı şekillerde yapılabilmektedir, dolayısı ile altta bahsi geçecek olan Kurulum Süreci web sitemizdeki çalıştırılabilir paketimizin kurulumunu içerecektir.

Web sitemizin “download” menü linki ile en güncel program versiyonuna erişebilir, ilgili versiyon linki ile programı bilgisayarınıza indirebilirsiniz. Web sitemizde uzantısı x64 ( 64 bit ) ve x86 ( 32 bit ) olmak üzere iki adet çalıştırılabilir paket bulacaksınız, bunlardan sisteminize uygun olan paketi seçerek indirme işlemini başlatabilirsiniz.

Download linkinin tıklanması ardından sizden bazı bilgiler istenecek olup bu bilgiler dahilinde size özel üretilen download linki mail adresinize iletilecektir. Mailinizdeki link download işlemini başlatacak nihai link olacaktır.

Programın indirme işlemi tamamlanması sonrası elinizde bulunan “.rar” uzantılı sıkıştırılmış uygulama paketini açarak uygulamayı default ayarları ile kullanmaya başlayabilirsiniz.

Uygulamanın default ayarlarında istemci ve sunucu aynı pc de , veritabanının sqlite olduğu düşünülmüştür ve tek kullanıcı konfigürasyonu yapılmıştır. Bu hazır paketi birden fazla kullanıcı ile çalıştırmak isterseniz istemci programı farklı pc lere kopyalamanız yeterli olacaktır.

Daha detaylı kurulum prosedürü ilerleyen zamanlarda paylaşılacaktır.

Programı Başlatma

Programı sitemiz download linki vasıtasıyla indirdikten sonra gelen “zip” paketi bilgisayarımızda uygun bir konuma açıyoruz. Oluşturduğumuz bu yeni klasörü açtığımızda karşımıza şekilde gibi bir dizin yapısı çıkıyor.

Dizin içeriğini incelediğimizde gördüklerimiz:

• Sunucu program klasörü “prowps_server”
• İstemci program klasörü “prowps_client”
• Geliştirme programı klasörü “prowps_develop”
• Sunucu program başlatan dosya “1-livserver_win.bat” / “1-livserver_oth.sh”
• İstemci program başlatan dosya “2-livclient_win.bat” / “2-livclient_oth.sh”
• Geliştirme programı başlatan dosya “3-livdevelop_win.bat” / “3-livdevelop_oth.sh”

Programı başlatmak için sırasıyla (dosya ismi başındaki sıra nosu) başlatıcı uygulamaları çalıştırıyoruz. Uygulama geliştirme yapmayacaksanız 3-livdevelop başlatıcısını çalıştırmanız gerekli değildir, ilk 2 başlatıcının çalışması yeterli olacaktır.

Başlatıcılar çalıştıktan sonra uygulamaya bağlanmak için sisteminizde yüklü olan browser’ ı başlatmalısınız. Tarayıcınızın adres çubuğunu “http://localhost:20000/login.aspx” yazarak uygulama giriş adımına ulaşabilirsiniz. İlk giriş için kullanıcı adı / şifre admin olarak belirlenmiştir.

Geliştirme Ortamını Başlatma

Uygulama tasarım aracı olan “livdevelop” python programlama dili kullanılarak geliştirilmektedir. Uygulamayı çalıştırabilmek için sisteminizde python3 programı ile beraber gtksourceview ve lxml python kütüphanelerininde yüklü olması gerekmektedir. Livdevelop programımızın arayüz tasarımında Gtk3 kullanılmaktadır.

Birçok Linux dağıtımda python3 ve gtk3 programları kurulu olarak gelmektedir. Linux kullanıcıları sistemlerinde iki ana programın haricinde gtksourceview ve lxml python kütüphanelerinin de kurulu olduğundan emin olduktan sonra kurulum paketinden çıkan kısayolu başlatarak geliştirme ortamına erişebilirler.

Windows kullanıcıları ise sırasıyla alttaki adımları izleyerek geliştirme aracımız olan Livdevelop’ u kullanabilirler:

• http://www.msys2.org/ adresinden msys2 programını download ediyoruz.
• Programın kurulumunu yaptıktan sonra uygulamayı çalıştırıyoruz (karşınıza uygulamanın konsolu açılacak).
• Konsolda sırasıyla alttaki komutları veriyoruz.

• pacman -Suy
• pacman -S mingw-w64-i686-gtk3 mingw-w64-i686-python2-gobject mingw-w64-i686-python3-gobject
• pacman -S mingw32/mingw-w64-i686-gtksourceview3 3.24.8-1
• pacman -S mingw32/mingw-w64-i686-python3-lxml 4.1.0-1

• Msys2 programını kurduğunuz klasörün altında yer home/kullanıcı dizinine livdevelop klasörünü kopyalıyoruz.
• Kurulum burada son bulmakta, kullanım içinse:
• Msys2 konsolunda alttaki komutları vererek Livdevelop’ u başlatıyoruz.

• cd livdevelop
• python3 livdevelop.py

Hazırlık

Mikro Aktarım Yapılandırması

PROWPS programımı üzerinde yer alan “Mikro Veri Aktarım Şemaları” kullanılarak Mikro veritabanından portal için gerekli olan verileri çekebilmek mümkündür.

Veri aktarım işlemi için birkaç ön kurulum adımını yerine getirmek gerekecektir. Bunlar:

Mikro veritabanı üzerinde bir kullanıcı tanımlamak. Mikro veritabanına ağ üzerinden erişimi aktive etmek. PROWPS üzerinde Mikro veritabanı erişim bilgilerini tanımlamak.

Şimdi üstte yer alan adımların üzerinden sırasıyla geçerek PROWPS’ in Mikro veritabanına erişiminin nasıl sağlanacağını öğrenelim.

1. Mikro veritabanı üzerinde bir kullanıcı tanımlamak

• Mikronun kurulu bulunduğu sunucu makinada Microsoft SQL Server Management Studio uygulamasını başlatıyoruz.
• Uygulamanın sol menüsünü kullanarak Veritabanı sunucusu > Security > Logins adımlarını takip ediyoruz, Logins menü adımı üzerinde iken farenin sağ tuşunu kullanarak işlem menüsünün gelmesini sağlıyoruz. Gelen menüden New Login seçeneğini seçiyoruz.
• Yapılan seçim sonucu karşımıza gelen yeni kullanıcı tanımlama diyaloğunda entegrasyonda kulllanmak üzere yeni bir kullanıcı tanımı yapıyoruz. Genel sekmesinde kullanıcı doğrulama seçeneği olarak SQL Server autantication ‘ı seçtikten sonra yeni bir kullanıcı adı ve şifresi belirliyoruz. Ardından User Mapping sekmesine geçerek ilgili kullanıcı için Mikro veritabanlarına db_owner yetkisi tanımlıyoruz. Diğer seçenekler varsayılan ayarlarında kalabilir, resimleri takip edebilirsiniz.

2. Mikro veritabanına ağ üzerinden erişimi aktive etmek

• Yine Mikronun kurulu bulunduğu sunucu makinada SQL Server Configuration Manager uygulamasını başlatıyoruz.
• Uygulamanın sol menüsünü kullanarak SQL Server Network Configuration > Protocols for .. adımlarını takip ediyoruz. İlgili menü adımının seçimi ardından sağ tarafta beliren listede yer alan TCP/IP seçeneğinin üzerini çift tıklıyoruz. Gelen diyalog üzerinde Protocol sekmesinde yer alan Enabled opsiyonunu Yes yaptıktan sonra IP Addresses sekmesine geçerek TCP Port seçeneklerinin tümüne 1433 yazıyoruz. Ardından Uygula butonu ile diyalog dan çıkıyoruz.
• Son olarak yine aynı uygulama üzerinde sol menüden SQL Server Services seçimine bağlı sağ tarafta açılan liste üzerinde SQL Server servisini sağ tıklayarak yeniden başlatıyoruz.

3. PROWPS üzerinde Mikro veritabanı erişim bilgilerini tanımlamak

• PROWPS sunucu programının bulunduğu klasörde (prowps_server) yer alan livserver.exe.config isimli dosyayı metin editörü ile açıyoruz.
• Dosya içerisinde configuration > connectionStrings tag’i altında yer alan mssql, connectionString parametresini mikro kurulumuna uygun şekilde ayalıyoruz. İlgili parametre değerinde sunulan örnek ifade: Server=[IPADRESS],[PORT];Network Library=DBMSSOCN;Database=[DATABASE];User Id=[USERNAME];Password=[PASSWORD]; şeklindedir. Bu ifadede köşeli parantezler içine doğru değerler vererek dosyayı kaydediyoruz.

Mail Ayarları Yapılandırması

Uygulama üzerinde yer alan bir takım işlemler (bilgilendirmeler, mutabakat sistemi, vs..) mail gönderimine ihtiyaç duymaktadır. ProWPS üzerinden mail gönderebilmek için yapmanız gereken ayarlamalar ise şöyle:

• ProWPS dizininde yer alan prowps_server klasörünü açıyoruz.
• livserver.exe.config isimli dosyayı notepad ile açıyoruz.
• appSettings içinde yer alan “smtp” ile başlayan parametreleri girip, dosyayı kaydediyoruz.

Bu işlemler sonrası sunucu uygulamayı yeniden çalıştırdığınızda mail ayarlarınız geçerli olacaktır.

Yönetim

Data Transfer İşlemleri

Programda yer alan Data Transfer İşlemleri menü adımı ile ilgili uygulamaya erişilir.

Data transfer işlemleri adımı ile ProWPS’ in harici sistemlerle olan veri alış verişini yönetebilmekteyiz. Uygulama ile sisteme direk bağlantı yada Excel seçenekleri ile veri alınabilmektedir. Ayrıca yine aynı uygulamayı yeni bir aktarım altyapısı hazırlamaktada kullanabilmekteyiz. Bu başlık altında hazır şemaların kullanımı ve yeni şema oluşturma konulu iki başlık bulunmaktadır.

1. Hazır Şemalarla Aktarım Yapılması

Aktaracağımız veriye ilişkin şema ister direk bağlantı isterse de Excel aktarımı yapısında olsun her iki yöntemde de uygulama şekli aynı olacaktır. Listeden aktarım yapılacak şema satırı yada satırları seçili hale getirildikten sonra ekrandaki “Seçili Şema Aktarımı Başlat” butonu ile aktarım ekranına ulaşılır.

Gelen aktarım ekranında kaynak belge “dosya seç” butonu vasıtası ile seçildikten sonra ekranın sağ üst köşesindeki “OK” butonu ile aktarım işlemi başlatılır. Aktarım esnasında ekranın alt tarafında bulunan “Aktarım durumu” kontrolöründe aktarım işleminin %? değerini görebileceksiniz. İşlem tamamlanması ardından sistem yeniden ana ekrana dönecektir.

Cari Kart Tanımlama

Programda yer alan Cari Kartlar menü adımı ile ilgili uygulamaya erişilebilir.

Cari Kartlar uygulamasında müşteri/tedarikçi tanımlarını ve ilgili kayıtların portal entegrasyon işlemlerini yapabilmekteyiz. Bu uygulama altındaki kayıtlar manuel oluşturulabileceği gibi, data transfer uygulaması ile de sisteme yüklenebilmektedir.

Uygulama çalıştırıldığında kullanıcıyı alttaki ekran görüntüsü karşılayacaktır. Ekranın üzerinde yer alan butonlar vasıtası ile arama, filtreleme, kaydın içeriğini görüntüleme, kayıtta değişik yapma, yeni kayıt oluşturma gibi işlemler yapılabilmektedir.

Herhangi bir kayıt seçilip kaydı göster ya da değiştir denildiğinde ise alttaki detay ekrana ulaşılacaktır. Bu ekran/lar vasıtası ile kayda ait detay bilgiler görüntülenip, düzenlenebilecektir.

Cari Kart Portal Entegrasyonu

Cari Kartlar uygulaması üzerinde yer alan bu entegrasyon fonksiyonu ile seçilen tedarikçi(lerin) portal hesapları oluşturularak, tedarikçilere hesap bilgilerinin gönderimi sağlanır.

Liste üzerinde tedarikçi(ler) seçildikten sonra “entegrasyon” butonuna basılır. Sistem sırasıyla seçilen her tedarikçi için hesap bilgilerini üretir ( kullanıcı adı/ şifre ) ve cari kart içinde tanımlı olan mail adresine üretilen bu hesap bilgilerini iletir. Her iletim sonrası oluşan hatalar ekranın sağ tarafında yer alan durum mesajı alanından izlenebilir ayrıca portal entegrasyonu başarı ile yapılan cari kartlar liste üzerinde işarelenir.

Kullanım (Tedarikçi)

Sipariş Teyitleri

Programda yer alan Tedarikçi Uygulamaları > Sipariş Teyitleri menü adımı ile ilgili uygulamaya erişilebilir.

Bu uygulama ile Müşteriden (Sağlayıcıdan) gelen siparişler görüntülenebilir, istenirse siparişlerin çeşitli formatlarda (Sağlayıcı tarafından belirlenen uluslararası edi formatlarında) içeriği alınabilir ve sipariş kalemlerine ilişkin teyit yazışmaları yapılabilir.

Uygulama çalıştırıldığında açılış ekranında Müşteride (Sağlayıcıda) bekleyen açık siparişler listelenecek, istenirse araç çubuğunda bulunan büyüteç vasıtasıyla arama işlevi çeşitli kriterler dahilinde özelleştirilebilinecektir. Açılışta yada arama sonucu filtrelenen liste üzerinde bulunan “Sipariş Şeması” kolonunda yer alan linkler vasıtasıyla seçilen siparişlerin istenen formatta dışa aktarımı sağlanabilinecektir.

Listeden bir sipariş satırı seçilip kalem butonu yardımı ile sipariş içeriği görüntülenebilir.

Açılan detay ekranda üstte siparişe ait genel bilgiler, sol altta sipariş kalemleri ve sağ altta ise sipariş kalemlerine ait teyit bilgileri görülmektedir. Uygulama üzerinde sipariş kalemleri teyit durumlarına göre renklendirilmektedir. İlk bakışta kalem renklerinde teyit talebinde bulunduğunuz kalemlere ilişkin yanıtlanmamış, yanıtlanmış yada onaylanmış durumları görebilirsiniz.

*** Beyaz renkte yada kesin renkte olan kalemler talep girmediğiniz müddetçe tarafınızca kabul edilmiş sayılmaktadır.

Kalemler listesinden açık statüde yada cevabınız beklenen kalemi seçip , sol taraf teyit durumlarını görüntüleyebilirsiniz. Teyit durumunda yeni bir talep girişi için istediğiniz yeni termini ve açıklamınızı girdikten sonra “Onaylamadan Güncelle” butonuna basarsanız teyit talebiniz Müşteriye (Sağlayıcıya) bildirilir ve Müşteri dönüşüne göre aksiyonlarınızı alabilirsiniz. Termin grubunda yer alan “Onayla” butonu ilede Müşteri terminini onaylayabilirsiniz.

Son olarak yaptığınız termin taleplerini ve onaylarınızı sağ üst köşede bulunan disket butonuyla kaydetmelisiniz. Kaydetme öncesi “Kayıtta mail gönder” tikini atmanız halinde ise kayıt esnasında girdiğiniz termin taleplerine ilişkin Müşteriye (Sağlayıcıya) mail gönderim aksiyonunu tetikleyebilirsiniz.

Termin Talepleri

Termin talepleri uygulaması çift taraflı kullanılan bir uygulamadır. Müşteri (Sağlayıcı) tarafında tedarikçilerden gelen termin taleplerini listelemek ve cevaplamak, Tedarikçi tarafında ise benzer şekilde Müşteri (Sağlayıcı) tarafından gelen yanıtları cevaplandırmak maksatlı kullanılır.

Uygulamaya Tedarikçi tarafında Tedarikçi Uygulamaları > Termin Talepleri menü adımı ile Müşteri (Sağlayıcı) tarafında ise Portal Uygulamaları > Termin Talepleri menu adımı ile erişilebilir.

Uygulama ilgili menu adımı ile başlatıldığında ilk açılışta cevap beklenen termin talepleri listelenecektir.

Listenen istenilen termin talebi seçilebilir ya da arama kriterleri özelleştirilerek liste güncellenebilir. Listeden kayıt seçilip düzenle butonuna basıldığında, termin talebinde bulunulan kaleminde içinde yer aldığı sipariş detayları açılacaktır.

Belge detayında kalem statüleri farklı renklerle ifade edilmektedir. Yanıt beklenen statüdeki kalem seçilip üzerinde cevaplama ya da onaylama işlemleri yapılabilir. Talepte bulunulan termin sadece ** onaylama ** işlemi ile kapatılabilir, cevap ve yanıt modunda ilgili talep Müşteri (Sağlayıcı) ve Tedarikçi arasında onaylanana dek gidip gelecektir.

Sipariş Çizelge

Programda yer alan Tedarikçi Uygulamaları > Sipariş Çizelge menü adımı ile ilgili uygulamaya erişilebilir.

Uygulama açık siparişlerinizi Müşteri (Sağlayıcı)’ nin belirlediği periyotlarda sizlere çizelgeleyecektir. Uygulamanın varsayılan ayarları önümüzdeki ilk 21 güne düşen siparişleri günlük, takip eden 60 günü haftalık ve takip eden diğer açık siparişleri ise aylık periyotlarda listeyelecek şekilde kurgulanmıştır. Çizelge günün tarihinden çizilmeye başlar, ilgili günün öncesine düşen ve henüz karşılamadığınız siparişlerinizi ise “Bakiye” kolonunda sizlere gösterir.

Uygulamanın varsayılan çizelge ayarları Müşteri (Sağlayıcı) isteği doğrultusunda değiştirilebilir.

Sevkiyat İşlemleri

Programda yer alan Tedarikçi Uygulamaları > Sevkiyat İşlemleri menü adımı ile ilgili uygulamaya erişilebilir.

Uygulama başlatıldığında ekranın ortadan ikiye bölündüğünü göreceksiniz. Ekranın üst bölümü açık siparişlerinizi listeyelecek ve sevkiyata konu olan kalemleri seçmenizi sağlayacak , ekranın alt bölümü ile ilgili sevk belgesi için üzerinde çalıştığınız kalemleri gösterecek. İki bölme arasında ve ekranın en altında kalan fonksiyonel butonlar vasıtası ilede işlemlerimizi yapıyor olacağız.

Bu uygulama üzerinden gerçekleşen veya planlanan sevkiyat bilgilerini sisteme dahil edebilirsiniz. İşlem yapabilmek için irsaliye yada sevk numarası girişi gerekmektedir. Eğer planlanan bir sevkiyat düzenliyorsanız buraya önceden ayırdığınız irsaliye numarasını girebilirsiniz.

İşlem adımları:

1. Açık kalemler listesinden sevkiyata konu olan kalemlerin seçimi
2. Kutu ve palet barkodlarının düzenlenmesi
3. İrsaliye numrası girilerek sevk belgelerinin sisteme kaydı
4. Asn çekimi

Şimdi sırasıyla bu işlemlerin nasıl yapıldığını inceleyelim.

1. Açık kalemler listesinden sevkiyata konu olan kalemlerin seçimi

Giriş bölümünde ekranı üst/alt olacak şekilde iki gruba ayırmıştık. Bu bölümde üst grupta yer alan tablo vasıtasıyla sevkiyata konu olacak sipariş kalemlerini seçip alt gruba ekliyor olacağız.

Üst grupta bulunan tabloda işlem yapılacak satır seçili hale getirildikten sonra tablonun sonunda yer alan “Paket Tipi”, “Paket İçi Miktar” ve “İşlem Miktarı” alanları doldurulur. Öncelikli olarak “Sağlayıcı” tarafından tanımlanmış paketleme tiplerinden birini seçerek işe başlıyoruz, paketleme tipi seçimi sonrası sistemde tanımlı paket içi miktar bilgisi tabloya eklenecek bizlerde son olarak işlem miktarını sistemin izin verdiği boyutta (sipariş açık miktarını aşmayacak şekilde) giriyor olacağız.

Bu üst grupta tüm giriş işlemlerini bitirdikten sonra “Yeni sevk referansı” numarasını giriyor ve “Paket Oluştur” yada “Karma Paket Oluştur” butonunu kullanarak seçimlerimizi alt gruba ekliyoruz.

Paket:Aynı kodlu ürünlerin girdiği paketleme tipi Karma Paket:Farklı kodlu ürünlerin girdiği paketleme tipi

2. Kutu ve palet barkodlarının düzenlenmesi

Üst grup yapılan seçimler alt gruba eklendiği esnada sistem üst grupta seçimi yapılan satırların her birinin her paketi için seçime göre paket yada karma paket barkodlarını oluşturacaktır. Alt grupta sevk belgesi üzerine Palet barkodu oluşturma opsiyonu sunulmaktadır.

Bu işlem için alt grup tablo üzerinden paletlenen kalemlerin seçimi yapıldıktan sonra “Palet barkod” butonuna basılır, gelen seçim ekranından “Palet kodu” seçilerek sistemin seçilen satırlar için barkod üretmesi sağlanır.

3. İrsaliye numrası girilerek sevk belgelerinin sisteme kaydı

Barkod düzenlemeleri sonrası irsaliye (sevk belge) numarası girilerek belgenin sisteme kaydı sağlanır. Önceden kaydedilmiş bir belge orta barda yer alan sevk belge no kutucuğuna irsaliye numarası girilerek ekrana alınabilir. Bu kayıtlı belge üzerinde yeni sipariş kalemi eklemi , palet barkod düzenleme ve yeniden kayıt işlemleri yapılabilir.

Tüm işlemler tamamlandıktan sonra ekranın alt barında yer alan barkod üret butonları ile kutu ve palet barkodları oluşturularak fiziksel ortamda ürünlerin bu barkodlarla etiketlenmesi sağlanır.

4. Asn çekimi

Detayları kendi uygulama konu başlığı altında anlatılacak olan uygulama hakkında özet bilgi vermek gerekirse, sisteme kaydı yapılmış olan sevk belgesi üzerinden Sağlayıcıya asn çekiminde kullanılan ekrandır diyebiliriz.

Sağlayıcının tercihine bağlı olarak belirlenen asn dosya formatı konusunda müdahale şansınız bulunmamaktadır. Sisteme dahil ettiğiniz sevk belgelerini Sağlayıcının tercihine bağlı asn formatında kapalı ortamda gönderdiğiniz uygulamadır.