Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
borderStyledashed

Amaç

Akışta form üzerine eklenen dokümanlar için;

  • Dokümanlarının bir rest aktivitesi üzerinden Kets Docplace'e gönderilmesi
  • Logo Flow’daki doküman verisinin (binary data) belli aralıklarla aktarılarak Kets Docplace üzerinde saklanması

amaçlanmıştır.

İki farklı amaç için iki farklı şekilde entegrasyon yapılabilmektedir:

  1. Aktivite kullanımı ile akış üzerinden anlık entegrasyon sağlamak. (İş üzerindeki dosyaların bir doküman tipi eşlenmesi yapılarak, ilgili akış adımına gelindiğinde Kets Docplace'e gönderilmesi) (Not: ERP içerisinden dokümanlara erişim için ilgili ERP (Tiger - Netsis) seçilerek aktivite kullanılabilir)sağlamak 
    1. Doküman Tipi olarak Tiger ve Netsis seçildiğinde ERP kayıtları ile ilişkilendirilir ve böylece dokümanlara ERP’deki doküman tuşu üzerinden erişilebilir.
    2. Doküman Tipi olarak kullanıcı tanımlı bir seçim yapıldığında Kets içerisinden erişilebilir.
  2. "Doküman Yönetimi Senkronizasyonu" otomatik  otomatik süreç tanımı ile periyodik entegrasyon yaparak LFLOW veritabanının yoğunluğunu azaltmak (LFLOW veri tabanında tutulan dosyaların belirlenmiş zamanlarda boşaltılarak Kets Docplace üzerine atılması)
Panel
borderStyledashed

Sonuç

Örnek Senaryolar: 

  • Yalnızca Aktivite kullanımı: Aktivite kullanımı yapıldığında iş üzerindeki bir dosya LFLOW >NWFFILES tablosunda tutulmaya devam edilirken, Aktivite Kets Docplace veritabanına da kopyası olan bir dosya gönderilmiş olur.
    (Sonuç: 2 aynı kopyanın biri LFLOW diğeri Kets üzerinde tutulur.)
  • Yalnızca Otomatik Süreç kullanımı: "Doküman Yönetimi Senkronizasyonu" otomatik süreç tanımı ile LFLOW > NWFFILES üzerindeki dosya Kets Docplace'e "LOGO FLOW Dokümanı" tipi ile gönderilir.
    (Sonuç: İş üzerindeki dosya LFLOW veri tabanı yerine sadece Kets üzerinde tutulur.)
  • Hem Aktivite hem Otomatik Süreç kullanımı:
    Dosya;
      Aktivite kullanımında aktivite üzerinde seçilen doküman tipi ile Kets Docplace'e gönderilir.

      Otomatik süreç ile LFLOW veritabanında tutulan dosya "LOGO FLOW Dokümanı" tipi ile Kets Docplace'e gönderilir. 
    (Sonuç: 2 aynı kopyanın ikisi de Kets üzerinde iki farklı doküman tipi ile tutulmuş olur.)
Panel
borderStyledashed

Gereksinimler

Kişi üzerine atanmış işi, bireysel bir e-imza donanım cihazı (USB - dongle) kullanarak ilerletir. İşlemler lokal bilgisayar (yani istemci (client) bilgisayarı) üzerinde e-imza cihazı ve Logo Flow Masaüstü Uygulaması yardımıyla portal üzerinden yapılır. 

Bu sebeple e-imza bekleyen bir buton ile iş ilerletebilmek için;

1- Bireysel ve geçerli bir e-imza cihazı olması

2- Lokalde kurulu "Logo Flow Masaüstü Uygulaması"nın olması

gerekmektedir.

  • Bireysel e-imza > Kişi kendi kimliği ile bir servis sağlayıcıya başvuru yaparak e-imza cihazı temin etmelidir.
  • Logo Flow Masaüstü Uygulaması > Lokal bilgisayara herkes tarafından yüklenmiş olması beklenen uygulamadır. E-imza dışında kullanım kolaylığı sağlayan özellikler bulundurur. E-imza bölümünde e-imza işlemi sırasında cihaz ve sertifika kontrolünü yapan, kullanıcının e-imza PIN'ini girdiği ekrandır. 

    1- Kets Docplace Rest Servisin çalışır durumda bulunması.
         (Tiger ya da Netsis ERP ürünleri varsa ilgili sunucu üzerinde, yok ise Kets Docplace kurulu sunucu üzerinde Kets Rest servisinin çalışır durumda bulunması)
         
    2- Aktivite kullanımında Tiger - Netsis dışında özel bir Doküman tipi seçilmek isteniyorsa, Kets Docplace Pro kullanılıyor olmalıdır.

        (Not: ERP içerisinden dokümanlara erişim senaryosu için doküman tipi ilgili ERP (Tiger - Netsis) seçilerek aktivite kullanılabilir > Kets Docplace Basic Lisans ile kullanılabilir)
        (Not2: Kets Özel Doküman tipleri ile ilişkilendirilerek Kets içinden erişilebilmesi için aktivite kullanılabilir > Kets Docplace Pro lisans ile kullanılmalıdır)


    3-
     "Doküman Yönetimi Senkronizasyonu" 
    otomatik süreç tanımı kullanılacak ise, Kets Docplace Pro kullanılıyor olmalıdır.
         LFLOW veri tabanında tutulan dosyaların belirlenmiş zamanlarda boşaltılarak Kets Docplace üzerine atılır > Dosyalara erişim için Kets Docplace Pro lisans modeli kullanılmalıdır)

    Tip
    iconfalse

    Kets Docplace Rest servisi, 5 Ekim 2020 ve sonrası indirilen kurulum dosyaları ile sunucu üzerine kurulur. 
    http://www.docplace.com.tr/u

    Detaylı bilgi için bknz: http://www.kets.com/download/documents/DocPlace/Kets_DocPlace_Rest_Service.pdf

    Panel
    borderStyledashed

    Servis Ayarları

    Mevcut ayarlar sunucu üzerinde "Ayarlar Servisi > LFlow Servis Ayarları > E-İmza > E-imza Kets Docplace Servis Ayarları" altında bulunur.

    Tip
    iconfalse

    Bu bölümde genellikle ek bir işlem yapılmasına gerek yoktur, kurulumla gelen mevcut ayarlar ile kullanılabilir durumdadır.

    İmza Tipi: BES veya ESXLong seçilebilir.

    • Desteklenmiş e-imza tipleri: BES ve ESXLong'tur
      • BES: Varsayılan (ve en çok kullanılan) e-imza tipi olarak BES tanımlıdır. BES için zaman damgası ayarı bölümünün doldurulmasına gerek yoktur. Direkt kullanıma hazırdır.
      • ESXLong: Zaman Damgalı e-imza yapılandırması yapılmak isteniyorsa imza tipi olarak ESXLong seçilmeli ve ilgili sağlayıcı üzerinden zaman damgası hizmeti satın alınmalı ve müşteri no ve şifresi ilgili alanlara tanımlanmalıdır.
        Bu e-imza tipi kontör mantığı ile çalışarak ücretlendirilir. (BES için böyle bir ücretlendirme bulunmaz.)
    Zaman Damgası Ayarı: ESXLong seçilmiş ise ilgili servis sağlayıcı bilgileri ile doldurulması gerekir.

    Ayarlama öncesinde, Kets Docplace Rest servisinin sunucu üzerinde kurulu ve çalışır durumda olduğundan emin olunuz.

    Rest Servis Adres: Kets Docplace Rest Servis adresi girilmelidir.

    Kullanıcı Adı: Kets Docplace Rest servis kullanacak yetkili kullanıcı adı girilmelidir.

    Şifre: Kets Docplace Rest servis kullanacak yetkili kullanıcı şifresi girilmelidir.

    Info
    • Kets DocPlace Basic Lisans kullanılan durumda rest servise oturum açmak için alttaki bilgiler kullanılacaktır:

    Kullanıcı Adı= "logoflow"
    Şifre= "logoflow"

    • Kets DocPlace Pro Lisans kullanılan durumda ise DocPlace üzerinde tanımlı bir kullanıcıya ait bilgiler girilmelidir.
    Info

    Kets DocPlace lisans ve kullanıcıları Hakkında:

    • Kets DocPlace Basic paket sahibi kullanıcılar Logo Flow entegrasyonu için mevcut kullanıcı sayısına +2 kullanıcı lisansı alınmasına ihtiyaç duyulur.

    • Kets DocPlace Pro paketi için +1 kullanıcı lisansı alınması yeterli olacaktır. Logo Flow, Kets DocPlace’in ücretsiz paketi olan Starter ile entegre çalışmaz. Ürünleri en güncel versiyonlarıyla kullanmanız önerilir.

    Image Removed
    Expand
    titleAyarlar Servisi | Lflow LFlow Servis Ayarları | E-İmza
    Kets Docplace Servis Ayarları

    Image Added



    Form üzerindeki parametresi açık aksiyon butonları için iş ancak e-imza kullanılarak ilerletilebilir.

    Panel
    borderStyledashed

    Tasarım Aracı

    Akış tasarım sırasında ilgili aksiyon butonu için e-imza özelliği parametresi açılmalıdır

    Aktivite Kullanımı

    İş üzerindeki dosyaların bir doküman tipi eşlenmesi yapılarak, ilgili akış adımına gelindiğinde bir kopyasının Kets Docplace'e gönderilmesi için:

    1. Akış tasarım sırasında Kets Docplace Rest Servis aktivitesi sürükle bırak işlemi ile akış tasarım ekranına bırakılır.
      ( "Tasarım Aracı >
    Form Aktivitesi Özellikleri > Buton Bilgileri > Tuş Bilgileri > E-imza parametresi" ) bknz: Yönlendirme Aktiviteleri
    1. Servis Aktiviteleri > Kets Docplace Rest Servis") bknz: Kets Docplace Rest Servis Aktivitesi


      Expand
      titleTasarım Aracı |
    Form Aktivitesi Özellikleri | Buton Bilgileri | Tuş Bilgileri | E-imza

    Image Removed

    Panel
    borderStyledashed

    Logo Flow Masaüstü Uygulaması | E-imza Ayarlarının Yapılandırılması ve Kontrolü

    E-imza kullanabilmek için aşağıdaki işlemlerin yapılmış olması gerekmektedir: 

    1- E-imza cihazı lokal bilgisayara takılır.

    2- Logo Flow Masaüstü Uygulaması > Sağ Tık > Ayarlar bölümünde ilgili URL ve kullanıcı bilgileri tek seferlik girilip kaydedilmiş olmalıdır.

    Expand
    titleEkran Görüntüsü...

    Image RemovedImage Removed

    3- Logo Flow Masaüstü Uygulaması > E-imza bölümüne tıklanır.

    Expand
    titleEkran Görüntüsü...

    Image Removed

    4- İlk defa kullanım yapılıyorsa (Ayarlar servisinde tanımlanan kullanıcı adı-şifre için sistem tanımlı bir e-imza bulunmuyorsa) e-imza ekranında eşleştirme onayı sorusu gelir, Evet ile kullanıcı ile kendisine ait e-imza eşleştirilerek kaydedilir.

    Kullanıcı sistemde bu e-imza ile tanımlandıktan sonra değiştiremez, bu sebeple kullanıcı - e-imza eşleşmesinin doğruluğundan emin olunmalıdır.

    Expand
    titleEkran Görüntüsü...

    Image Removed

    5- E-imza ekranında eşleşme sonrası kart bilgisi bölümünde sistemde kayıt olunduğuna dair ikon görünür.

    Expand
    titleEkran Görüntüsü...

    Image RemovedImage Removed

    6- Kullanıcı sertifikası kontrol edilir ve geçerli ise sertifika durumu bölümünde sertifika doğrulama ikonu gösterilir. İkon üzerine tıklandığında kişiye ait sertifika bilgileri görüntülenebilir.

    Expand
    titleEkran Görüntüsü...

    Image RemovedImage Removed

    Image Removed

    7- E-imza takılı, geçerli ve hazır durumda ise, "E-imza kart bilgileriniz senkron edildi." bilgilendirmesi görünür. Bu aşama sonrası uygulama açık bırakılarak portal üzerinden butona basılarak imzalama işlemi başlatılabilir.

    Expand
    titleEkran Görüntüsü...

    Image Removed

    E-imza Bilgisinin Görüntülenmesi

    Amaç:  İmzalı olan akışlara ait bilgilerin ; sorgulanması ve doğruluğunun kontrolünün sağlanmasıdır.

    İş no (NWFLOGMASTER.INSTANCEUNIQUEID) ya da instanceguid (NWFLOGMASTER.INSTANCEID) değeri ile o işe ait imzalı adımlar ve imzalayan bilgisine ulaşılabilir. 

    İş No ile Sorgulama:  http://localhost:64022/Pages/ESignControl/ESignControl.aspx?jobid=23317 INSTANCEID ile Sorgulama: http://localhost:64022/Pages/ESignControl/ESignControl.aspx?instanceid="BBE59951-2019-489D-823D-D1ECD34FD154"
    Image Removed
    Image Removed
    Not: Kullanıcı "Logo Flow Masaüstü Uygulaması"ndaki ayarlar tanımlamalarını daha önce hiç gerçekleştirmeden portal üzerinde e-imza ile ilerlemek isterse "Kullanıcıya ait e-imza kartı bulunamadı. İşleme devam edilemiyor!" uyarısı gösterilir.
    Panel
    Panel
    borderStyledashed

    Portal Üzerinde Formun E-imza ile İlerletilmesi (İşe Ait Akış Adımının İmzalanması)

    Portal üzerinde e-imza isteyen kol üzerinden işi ilerletebilmek için aşağıdaki adımlar izlenmelidir:

    1- E-imza takılı, geçerli ve hazır durumdadır, ve Logo Flow Masaüstü Uygulaması üzerinde "E-imza kart bilgileriniz senkron edildi." bilgilendirmesi görünür
    1. Servis Aktiviteleri > Kets Docplace Rest Servis

      Image Added

    2. "Kets Docplace Rest Servis Aktivitesi > Doküman Ayarları" bölümüne tıklanır.

      Expand
      titleTasarım Aracı | Servis Aktiviteleri > Kets Docplace Rest Servis | Doküman Parametreleri > Doküman Ayarları

      Image Added

    3. Doküman tipi açılır listesi içerisinden ilgili doküman tipi seçilir.
      1. ERP entegrasonu için Tiger için "Logo Dokümanı", Netsis için "Netsis Dokümanı" tipleri seçilebilir. 
      2. Kets Docplace uygulaması içerisinden yaratılmış olan özel Doküman Tipleri görüntülenerek seçim yapılabilir. Bu eşleme ile gönderilen dokümanlara Kets Docplace uygulaması içinden erişilebilir.
    4. Seçilen Doküman Tipi sonrasında, doküman tipine ait alanlar otomatik listelenir.
    5. "Değişkenler" ya da Formül ile doküman tipi alanları adları eşleştirilir.
      1. Netsis Dokümanı için, Netsis Kayıt Türü 'nün "Rehber" alanı ile eşleştirilmesi beklenmektedir.
      2. Logo Dokümanı için, Tiger Kayıt Türü 'nün "Rehber" alanı ile eşleştirilmesi beklenmektedir.

        Expand
        title"Doküman Tipi > Kayıt Türü" Ekran Görüntüsü

        Image AddedImage Added

    Tip
    • "Logo Dokümanı" eşlemesi ile gönderilen dokümanlara Tiger içerisinden erişilebilir.
    • "Netsis Dokümanı" eşlemesi ile gönderilen dokümanlara Netsis içerisinden erişilebilir.


    Erişimi sağlayan bilgi GUID alanıdır. İstenilen kayda ait EVRAKGUID değeri Tiger ya da Netsis veritabanından bulunup getirilerek ilgili değişkene eşlenmelidir.

    Örnek:

    • Tiger veri tabanına açılan bir Malzeme kartı için ilgili rest metodundaki EVRAKGUID değeri bir değişkene atandıktan sonra bu değişken ilgili alana eşlenebilir. Böylece Tiger üzerinde ilgili malzeme kartı kaydı içerisinden ilgili dokümana erişilebilir.
      Tiger - Docplace Malzeme Oluşturma Şablon Akışı:
      View file
      nameDocplace Tiger_Malzeme Oluşturma.nxm
      height150


    • Netsis veri tabanına açılan bir Stok kartı için EVRAKGUID değerine ulaşabilmek için ilgili stok kodu değeri EvrakGuidGetir prosedürü çalıştırılarak alınır. Bu değer bir değişkene atandıktan sonra ilgili alana eşlenebilir. Böylece Netsis üzerinde ilgili stok kartı kaydı içerisinden ilgili dokümana erişilebilir.
      Netsis - Docplace Malzeme Oluşturma Şablon Akışı:
      View file
      nameDocplace Netsis Malzeme Oluşturma.nxm
      height150



    Tip

    Proje Uyarlama için bilgiler:

    1. Doküman Tipi seçimi yapılır, Parametreler eşlenir.
    2. Guid bilgisi eşlenmesi:
      1. Tiger için restten alınarak bir değişkene atılır ve ilgili alana bu değişken ataması yapılır.
      2. Netsis için, Stored Procedure aktivitesi içerisinde EvrakGuidGetir prosedürü çağırılması sonucu dönen değer bir değişkene atılır ve ilgili alana bu değişken ataması yapılır.
        Netsis akışı için Evrak Guid getirme ve kullanım detayları:

    Senaryo Videoları

    Tip

    Tiger

    Widget Connector
    urlhttps://www.youtube.com/watch?v=eejm6QU32r8&list=PLZUf8To2Hsbrnd_2QqZPdYlCWPFSgxiOU&index=7
           


    Netsis

    Widget Connector
    urlhttps://www.youtube.com/watch?v=BG5Dw0kYWXY&list=PLZUf8To2Hsbrnd_2QqZPdYlCWPFSgxiOU&index=8


    Otomatik Süreç Kullanımı

    Logo Flow’daki doküman verisinin(binary data) belli aralıklarla aktarılarak Kets Docplace üzerinde saklanması için;

    1. "Tasarım Aracı >Genel İşlemler > Otomatik Süreç Tanımlama" ekranı açılır.

      Expand
      titleEkran Görüntüsü...

    Image Removed

    Image Added

  • Tip Olarak "Doküman Yönetimi Senkronizasyonu" seçilir

    Expand
    titleEkran Görüntüsü...
  • Image Removed

    2- Portal Üzerinde e-imza özellikli aksiyon butonuna basıldığında bir "Onay Kodu" üretilir ve bu kod otomatik olarak Logo Flow Masaüstü Uygulaması'na gönderilir.

    Expand
    titleEkran Görüntüsü...

    Image Removed

    3- Logo Flow Masaüstü Uygulaması üzerinden "Evet" ile onay verilir.

    Expand
    titleEkran Görüntüsü...

    Image Removed

    4- Onay için PIN ekranı açılır, PIN girişi yaparak Tamam tuşuna basılır. 

    Expand
    titleEkran Görüntüsü...

    Image Removed

    5- E-imza ile imzalama işlemi tamamlanır, portal ve Logo Flow Masaüstü Uygulama üzerinde bilgilendirme mesajları gösterilir.

    Expand
    titleEkran Görüntüsü...

    Image RemovedImage Removed

    Panel
    borderStyledashed

    İş Detay Ekranında E-imza ile İlerletilmiş Akış Adımlarının Görüntülenmesi

    • Portal > İş Detay ekranında "Akış Adımları" bölümünde e-imza ile ilerletilmiş adımlar üzerinde bir onay ikonu gösterilir.
    • Bu onay ikonu üzerine gelindiğinde tooltip olarak kim tarafından imzalandığı bilgisi (kullanıcı adı değil, e-imza kişisi) gösterilir.
    • İkon tıklandığında detay bilgiler de görüntülenebilir.
    1. Image Added

    2. "Doküman Ayarları" bölümünden LFLOW veritabanında tutulan dokümanlar için aktarma periyodu belirlenir.

    3. Belirlenen zaman geldiğinde, "Devam Ediyor" durumdaki işler dışındaki tüm durumlar için (Tamamlandı - Hatalı - İptal) işe eklenmiş dokümanlar "LOGO FLOW Dokümanı" tipi ile Kets Docplace uygulamasına gönderilir.
      • "LOGO FLOW Dokümanı" tipli Kets Docplace dokümanı için belirlenmiş sabit alanlar ve gönderilen bilgiler aşağıdaki gibidir:

        Expand
        titleAlan Bilgisi Detay Tablo...

        DocPlace Alan Adı

        DocPlace Alan Tipi

        Alan Açıklaması (Eşleşecek Logo Flow Bilgisi)

        Alan Tip Bilgisi

        Akış Adı

        Metin

        FLOWNAME

        varchar

        Akış No

        Tamsayı

        FLOWID

        int

        İş No

        Tamsayı

        JOBID

        int

        İş Guid

        Metin

        INSTANCEID

        GUID

        Dosya Guid

        Metin

        FILEID

        GUID

        Dosya Eklenme Tarihi

        Date

        CREATION

        datetime

        Açıklama

        Metin

        -

        -

        Bu bilgiler kullanılarak Kets Docplace içerisinden de arama yapılarak ilgili dokümanlara erişim sağlanabilir.

    4. Aktarım sonrası, portal içerisinde iş detay ve form ekranlarından geçmiş işlere ait dokümanlar yine erişilebilir durumdadır. Tıklama işlemi sonrası doküman arka planda LFLOW yerine Kets veritabanından çekilerek kullanıcıya gösterilir.
    5. Yetkili kullanıcı Portal üzerinden; gönderilmiş ve gönderilebilecek dosya sayısı ve boyutu hakkında durum bilgisine "Sistem Takip | Dosya Durumu" bölümünden erişebilir.
    Panel

    Sistem Takip Ekranı | Dosya Durumu

    Amaç: 
    Otomatik süreç tanımı ile aktarılmış - aktarılabilecek dosya sayı ve boyutu hakkında bilgi alabilmek

    Ekran: 

    • "Portal > Yönetici İşlemleri > Sistem Takip" ekranı sağ üst köşesinde bulunan ikon ile bilgilere ulaşılabilir.
    Expand
    titleEkran Görüntüsü...

    Image RemovedImage Added


    Image RemovedImage Added


    Panel
    Son İşlem ve

    Doküman Hata Loglarının Görüntülenmesi

    Portal üzerinde hata Hata alındığında son işlem logları görüntülenmek istenirse;

    Expand
    titleEkran Görüntüsü...

    Image Removed

    "Logo Flow Masaüstü Uygulaması > Sağ Tık > E-imza >  İşlemler > Son İşlem Logları" menüsü tıklanarak son işlem ve hata loglarına erişilebilir.
    Expand
    titleEkran Görüntüsü...

    Image RemovedImage Removed

    Panel

    İmzalanmış Dosyaların ve İmzaların Kontrolü

    C:\Users\KullanıcıAdı\AppData\Local\LogoFlowApp\SignFiles altından imza ve imzalanmış form bilgilerine erişilebilir.

    Expand
    titleEkran Görüntüsü...

    Image RemovedImage Removed

    • Sistem takip ekranı > Olay Görüntüleyicisi bölümü
    • Kets DocPlace Rest Sevis Log klasörü içeriği
      (ÖR: Sunucu üzerinde, "C:\Netsis\ENTERPRISE9\DocPlace\RestService\log" ,
      "
      C:\Program Files (x86)\Logo\TIGER ENTERPRISE\DocPlace\RestService\log" gibi 
      klasörler içindeki güncel loglar

    kontrol edilebilir.

    • Kets Docplace Rest Aktivitesi aktarım hatası detayı için "Yönetici İşlemleri > Detaylı Loglama" ile iş başlatması yapılarak akış adımları da izlenebilir.