Versions Compared

Old Version 7

changes.mady.by.user Bora Koken

Saved on

compared with

New Version Current

changes.mady.by.user Hasret Tirnig

Saved on

Key

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

...

Panel
borderStyledashed

Amaç

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

  • Entegrasyon aktivitesi ile Tiger ve Netsis üzerindeki kayıtlarla ilişkilendirilmesi ve dokümanlara böylece ERP’deki doküman tuşu üzerinden erişilebilmesiDokümanlarının bir rest aktivitesi üzerinden Kets Docplace'e gönderilmesi
  • Logo Flow’daki doküman verisinin (binary data) istenen aralıklarla Kets’e aktarılması 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. Kets Docplace Basic Lisans ile 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ı)
        (Not: Dosyalara erişim için Kets Docplace Pro lisans modeli kullanılmalıdır.)
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.)

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

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

Panel
Panel
borderStyledashed

Gereksinimler

1- Kets Docplace Rest Servis 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 kurulmalıdırkurulur. 
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ı > Kets Docplace Servis Ayarları" altında bulunur.

Tip
iconfalse

ÖncesindeAyarlama öncesinde, Kets Docplace Rest servisi servisinin sunucu üzerinde kurulu ve çalışır durumda olmalıdırolduğ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.

Expand
titleAyarlar Servisi | Lflow LFlow Servis Ayarları | E-İmzaKets Docplace Servis Ayarları



Kets Docplace ?? Doküman Tipleri 

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
Panel
borderStyledashed

Tasarım Aracı

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ı > Servis Aktiviteleri > Kets Docplace Rest Servis") bknz: Kets Docplace Rest Servis Aktivitesi


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

Image Removed

Image Added

  • "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

  • 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 Tipi Dokümanı" tipleri seçilebilir. 
    2. Kets Docplace Pro lisans kullanılıyorsa, uygulama 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.
    • Panel
    borderStyledashed
    1. Seçilen Doküman Tipi sonrasında, doküman tipine ait alanlar otomatik listelenir.
    2. "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

    İş 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
    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
    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.

    Image RemovedImage Removed

    Panel

    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. 

    İ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

    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.

    1. Image Added

    2. 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 Added


    Panel

    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;

    Panel

    Detaylı Loglama Ekranı ile Hata Detaylarının Görüntülenmesi

    • 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:\
    Users
    • Netsis\
    KullanıcıAdı
    • ENTERPRISE9\
    AppData
    • DocPlace\
    Local\LogoFlowApp\SignFiles altından imza ve imzalanmış form bilgilerine erişilebilir.
    • 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.