Genel Teknik Mimari
    • 10 Jan 2024
    • 5 Minutes to read
    • Dark
      Light

    Genel Teknik Mimari

    • Dark
      Light

    Article summary

    PaperWork teknik mimarisi aşağıdaki gibidir. Bu mimari kurulum ihtiyaçlarına göre ve ek lisanslara göre değişiklik gösterebilir. Bu mimaride hangi parçacığın fonksiyonunun ne olduğunu anlamak için Servis yönetimi sayfası incelenmelidir.

    Kurulumu gerçekleştirmeden önce PaperWork teknik mimarisi hakkında bilgi sahibi olmak ve kurulum bileşenlerini buna göre konumlandırmak daha uygun olur. Yük dengelemeli bir kurulum mimarisi aşağıda gösterildiği gibidir. Bu kurulumda PaperWork, dış kullanıma açılması amacıyla IIS üzerindeki web uygulaması DMZ ortamına taşınmıştır. Aksi durumda 1nci Content Server üzerinde de olabilir.

    Buna göre; 

    1. Content Server adı verilen uygulama sunucusu Yük Dengeleme (Load Balancing) ve Yüksek Erişim (High Availability) özelliklerine sahiptir. Bu kurulum, yine bu dokümanın ilgili sayfalarında anlatılmıştır. 
    2. Content Server, Veri Tabanına ve Storage Services adı verilen belgelerin saklandığı dizine erişebilen tek uygulamadır. Mimarideki tüm uygulamalar veri tabanına sadece Content Server aracılığı ile erişebilir. Birden fazla Content Server kurulu ise belirtilen kaynakların tamamına (Disk, Veri Tabanı, Active Directory gibi) her sunucunun erişebiliyor olması gerekir. Örneğin ERP, Web Servisleri, Active Directory gibi. 
    3. Tüm sistem genelinde işlem yapan bir dizi servis bulunur. Bu servislerin tamamı Content Server ile haberleşerek bu işlemleri yerine getirir. Örneğin Metot Server, WorkFlow Server gibi. Bu servisler de yük dengelemek amacı ile birden fazla sunucu üzerine kurulabilirler. Kurulum Uygulaması tüm ayarların yapılmasına izin verir. 
    4. Content Server tüm iş mantığını Metotlar halinde (encapsulation) dış dünyaya açar. Bu işlemler aşağıdaki portlar yardımı ile yapılır;
      1. 8097: PaperWork geliştirme katmanını içerir. 2 adet geliştirme katmanı bulunur;
        1. .NET Geliştirme Katmanı
        2. Web Servis Geliştirme Katmanı (SOAP 1.2 uyumludur)
      2. 8098: Büyük dosyaların transferi için kullanılır.
      3. 4278: Web ara yüzünde kullanılan HTML5 MS Word benzeri editörün çalışması için gereklidir.
      4. 8094: Rapor mimarisi bu port üzerinden çalışır.
        IIS üzerindeki web uygulamasının bu portlar ile Content Server’a erişebiliyor olması gerekir.
    5. PaperWork Content Server portları ile IIS arasındaki veri transferi SSL ile şifreli moda geçebilir. Eğer Mobil ara yüzler kullanılıyor ise mutlaka SSL sertifikalı çalışmalıdır. SSL protokolüne geçirmek için gerekli olan SSL sertifikası bu dokümanda açıklanmıştır. Bu durumda sunucular tam ismi ile (Full Qualified Name) kullanılmalıdır. Örneğin http://argustest/olan sunucu ismi https://argustest.g-gsoft.com/ olmalıdır. 
    6. Mevcutta kullanılan PaperWork ara yüzleri IIS üzerinde servis edilmektedir. IIS, Content Server ile aynı sunucu üzerinde olabildiği gibi farklı sunucular üzerinde de olabilir. IIS üzerinde ayrıca şu uygulamalar bulunur; 
      1. Sertifikasız dosya işlemleri yapılırken kullanılan GetFile.aspx
      2. İş Akışlarında Elektronik Posta ile iş adımı ilerletilirken kullanılan Confirm.aspx sayfası.
      3. HTML5 Belge Görüntüleyici
      4. HTML5 Elektronik Formlar
        İşlemler esnasında örneğin iş akışı adımı elektronik posta ile şirket dışından ilerletiliyor ise dışarı açık bir IIS üzerinde b maddesindeki uygulama kurulu olmalıdır. Kurulum uygulaması bunu otomatik olarak sağlar.
    7. Index Server: Bu servis arşivlenen tüm belgelerin içeriğini alarak tam metin aramaya dahil eder. Bu işlem sırasında taranmış belgeler üzerinde OCR, diğer belgeler üzerinde de metin yakalama yöntemleri kullanır. CPU yoğun çalıştığı için ayrı tutulmalıdır. Yığın eritmek amacı ile birden fazla kurulabilir. Bu servisler tam metin arama kataloglarına oluşturdukları veriyi yazar. Bu veri de 1nci Content Server üzerinde bu sunuculara paylaştırılmış bir disk alanı olmalıdır. Çalışan servislerin tamamı bu paylaşılan alana erişebilen kullanıcı hesabı ile olmalıdır. Şifreleri Never Expires (Son Kullanım Tarihi Olmayan) olarak işaretlenmelidir. Eğer ISDD™ lisansı aktif ise bu sunucu üzerinde PaperWork yapay zeka mimarisi de çalışır. İhtiyaç duyulan kaynak daha fazladır ve CPU kullanımı daha yoğundur. Bu sunucu için kaynak ihtiyacı “Sunucu Gereksinimleri” bölümünden incelenmelidir. 
    8. Şekilde gösterilen HTML5 istemcinin çalışma adımları şunlardır;
      1. Google Chrome üzerinden kullanıcı IIS adresini yazar.
      2. Adres ile IIS üzerindeki web ara yüzü kullanıcının önünde açılır ve şifre girmesi beklenir.
      3. Şifre ile yük dağılımına göre hangi Content Server ile işlem yapacaksa ortada hep IIS olmak üzere otomatik ona yönlendirilir.
        Not: Multi Factor Authentication olması durumunda çalışma senaryosu aynıdır. Sadece giriş ekranı ile doğrulama yöntemine göre (SMS, Elektronik Posta) 2nci bir ekran ile kullanıcıdan bilgi girmesi beklenir.
         Not: Şekilde HTML5 ekranlarının hemen altında PaperWorkTray uygulaması bulunmaktadır. Bu uygulama tarama işlemlerinde tarayıcının kullanılması, elektronik imza kullanılması için geliştirilen Tray uygulamasıdır. İlk işlem esnasında download edilip kurulması sağlanabilir. Veya merkezi dağıtım yapılması da mümkündür.
    9. Şekilde gösterilen mobil uygulamaların çalışma şekli şudur;
      1. Mobil Cihaz üzerinde çalışan Native uygulama açılır.
      2. Bu uygulama IIS üzerindeki SSL ile güvenli hale getirilmiş 8097 portunu kullanarak Content Server ile iletişime geçer.
      3. İşlemleri esnasında HTML5 Elektronik Formlar kullanır. Bunun için IIS ile haberleşir.
      4. İşlemleri esnasında belge arşivler ise yine IIS üzerindeki 8080 portunda çalışan REST servisine ulaşır.
      5. Belge görüntülemek istediğinde IIS üzerindeki 8080 portunda çalışan belge görüntüleyiciden istekte bulunur. Bu görüntüleyici Content Server ile haberleşerek belgeyi görüntüler.
    10. Şekilde gösterilen MS Outlook uygulamasının çalışma şekli şudur; a)MS Outlook ‘un çalışması ile PaperWork Outlook Uzantısı (Addin) çalışır. b)Outlook uzantısı Elektronik Form ve Belge Görüntüleme işlemleri için IIS 8080 portu üzerindeki uygulamaları kullanır.
    11. Şekilde gösterilen SAP ara yüzleri kurum içinde çalışır ve direk PaperWork 8097 portunu kullanarak SOAP katmanı aracılığı ile işlem yapar.
    12. Şekildeki tüm ara yüzler yerel ağ (Local Area Network) üzerinde olabileceği gibi internet üzerinden de çalışabilir. İnternet üzerinden çalıştıkları durumda IIS sunucusunun tercihen ayrı bir sunucuya taşınması (DMZ) tavsiye edilir. Aynı sunucu üzerinde ise ilgili IIS portunun dışarı açılması yeterlidir.
    13. Bu mimaride çalışan hem IIS Server hem de Content Server portları SSL ile sertifikalanabilir. Kurulum uygulaması sertifikalı kurulumu da sağlar.
    14. PaperWork kullanıcı mimarisi dış sistemdeki kullanıcı mimarileri ile senkronize olabilir ve beraber çalışabilir. Kullanıcı mimarisini belirlemeden önce bu kılavuzun Kullanıcı Senkronizasyonu bölümü incelenmelidir.
    15. Aktif Dizin, web servisleri, DBPlugin gibi entegrasyonların hepsinde ilgili kaynağa Content Server’ların her ikisinin de erişebiliyor olması gerekir.

    Görünümdeki bileşenler şu şekilde gruplanabilir;

    Servisler

    Servis yönetimi sayfasında tüm servisler detaylı olarak açıklanmıştır.

    Elektronik Posta Entegrasyonu

    Elektronik posta gönderimi için gerekli tanımlamalar şu sayfadan yapılabilir.

    Depolama Birimleri

    Arşivlenen belgelerin tamamı tanımlanan depolama birimlerinde saklanır. Daha detaylı bilgi için şu sayfa incelenebilir.

    PlugInler

    Mimaride 3 türlü PlugIn bulunabilir.

    1. DBPlugin
    2. FilePlugIn
    3. UserPlugIn
    4. SMSPlugIn

    Konnektörler

    Mevcutta 3 değişik konnektör bulunur. Bu konnektörlerin tanımı Entegrasyon Tanımları sayfasından yapılır.

    1. SAP Konnektörü
    2. Logo Konnektörü
    3. Robusta RPA konnektörü

    eFatura Entegrasyonu

    eFatura sisteme 2 türlü alınabilir. Entegrasyon sağlanmış eFatura sağlayıcılarından direk veya klasör dinleyerek. Daha fazla bilgi için eFatura Tanımları sayfası incelenmelidir.

    KEP Tanımları

    PaperWork TNBKEP ve TürkKEP ile entegredir. Tanımlamalar Entegrasyon tanımları sayfasından yapılabilir.

    Ara Yüzler

    1. HTML5 Son kullanıcı Ekranları
    2. SAP ECM UI
    3. SAP BPM UI
    4. Outlook UI
    5. Mobil Uygulamalar
    6. TrayIcon

    Kullanıcı Senkronizasyonu

    Detaylı bilgi için şu sayfa incelenebilir.

    Yedekleme

    PaperWork veri tabanı, Tam Metin Veri Tabanı, İş Akışı InstanceDB, Arşivlenen belgelerin yedeklenmesi için şu sayfa incelenmelidir.

    SDK Katmanı

    PaperWork tüm ara yüzleri ve bileşenleri PaperWork SDK üzerinden Content Server ile haberleşir. SDK dokümanlarına şu sayfadan ulaşabilirsiniz.

    Veri Tabanı

    Veri tabanı yönetimi ile ilgili şu adresten bilgi alabilirsiniz.

    IIS Ayarları
    IIS üzerinde yapılacak güvenlik ayarları kurumun sorumluluğundadır. Ayrıca eğer SSL sertifikası kullanılıyor ise bu sertifikanın güvenlik yeterlilikleri de kurum sorumluluğundadır.
    Forms Dizini

    Web uygulaması, içerik sunucusu ile aynı makina üzerine kurulu ise, "C:\Inetpub\wwwroot\paperwork\forms" şeklinde yapılandırılır.

    Eğer ayrı makinalara kuruluyorsa, ilgili dizine erişilecek network yolu yazılır. Örneğin, DMZ üzerine kuruldu ise, "\\192.168.1.XXX\c$\inetpub\wwwroot\paperwork\forms" şeklinde yazılmalıdır.

    Sunucu İşletim Sistemi Dil Ayarları
    Content Server ve Index Server servislerinin bulunduğu sunucularda dil İngilizce olmalıdır.




    What's Next