Özelleştirilmiş Fonksiyon (Custom Function) yazabilmek için izlenmesi gereken adımlar, hazırlanmış bir fonksiyonu içeri alma işlemleri ve konu ile ilgili hazır paket örnekler aşağıdaki gibidir:

Kurulum

  1. Custom Function için gerekli template ve yardımcı uygulamalar için visual studio'ya ilgili Framework versiyonuna göre paylaşılan eklentinin çalıştırılması gerekmektedir. 

Framework 4.6 versiyonu için eklenti dosyası

Framework 4.8 versiyonu için eklenti dosyası


2. Kurulum tamamlandıktan sonra Visual Studio uygulamasını açıp, aşağıdaki menü üzerinden "Extensions and Updates" ekranını açılır.

Aşağıdaki gibi eklentinin yüklenme durumu gözlemlenir.

Fonksiyon Oluşturulması

  1. Visual Studio’da New Project üzerinden “LFlow.Custom.Function” template seçilir.
    Not: Name ve Solution Name alanlarında ‘.’ İçermeyecek şekilde namespace belirlenmelidir. Örnek: “MyCustomFunction” vs.

  2. Oluşturulan proje detayı aşağıdaki gibi olacak.

  3. Template açıldğında FunctionLibrary.cs dosyası örnek olması için eklenmiştir. Oluşturulacak fonksiyon sınıfı INCustomFunctionLibrary interface’inden implemente edilmelidir.

  4. .Net Framework 4.6.1 ile derlenmiş dll leri referans edilebilinmektedir. Publish işlemi sonrası oluşturulan paket içerisinde ilgili referans dll içerecektir.

  5. Testleri ve geliştirimi tamamlanan özelleştirilmiş fonksiyon projesi sağ tıklanarak Publish edilebilir.

  6. . lflowfunccustom uzantılı bir dosya belirtilen dosya yoluna oluşturulur.


Versiyon

Fonksiyon paketi oluşturma sırasında projenin namespace’i versiyon ile birlikte güncellenir. Bu şekilde fonksiyonun farklı versiyonları oluşturulmasına imkan sunularak iş akışlarında uygun versiyondaki fonksiyonların işletilmesi sağlanabilir.

namespace MyCustomFunctions_v1001

İçeri Alma İşlemi ve Tasarım Aracı Üzerinde Özelleştirilmiş Fonksiyon Kullanımı

  1.  LogoFlow tasarım aracı “Akış” altında “Özelleştirilmiş Fonksiyonlar” açılır.

  2.  Önceden eklenmiş paketler burada görüntülenir. Yeni fonksiyon paketleri de “İçeri Aktar” ile aktarılır.

  3. Özelleştirilmiş fonksiyon paketi eklendikten sonra formül editöründe LFlow.Custom üzerinden fonksiyon listesine ulaşılabilir ve işletilebilir.

  4. Yukarıdaki kod ile yapılan denemelerde dosya loglama, signalr ile anlık bilgi gönderilmesi denemeleri yapılmıştır. Çıktı görüntüleri ise aşağıdaki gibidir:





Örnek İndir

Not : Yukarıdaki örnekler için oluşturulmuş projeler için oluşturulan *.nxm ve *.lflowcustom dosyalarına aşağıdan ulaşabilirsiniz.


Eklenti (Publisher Extension):

LFlow.CustomActivity.Publisher.Extension.rar


Özelleştirilmiş Fonksiyon (*.lflowfunccustom) dosyası:

MyLFlowCustomFunctions_v1.0.0.2.lflowfunccustom


Akış Paketi (*.nxm) dosyası:

CA EInvoice Reader.nxm