Versions Compared

Old Version 24

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

...

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 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ı > Kets Docplace Servis Ayarları" altında bulunur.

Tip
iconfalse

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.

Expand
titleAyarlar Servisi | LFlow Servis Ayarları | Kets Docplace Servis Ayarları



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ı" 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.
  • Seçilen Doküman Tipi sonrasında, doküman tipine ait alanlar otomatik listelenir.
  • "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ü...

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

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

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

    4. 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.

    5. 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.
    6. 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şilebilinireriş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ü...



    Panel

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

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

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

    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.

    ...