Mikro Entegrasyonu 2 farklı yöntem ile tasarlanabilir ve 3 farklı yöntem ile de entegrasyon işlemi gerçekleştirilebilir.
Entegrasyon Tasarım Yöntemleri :
- Form Alanları ile Maping: Hazır entegrasyon aracıyla Form alanları Maping yapılarak ayarların tamamlanması.
- Query Sonucuna Göre Maping: SQL Query yazılarak hazır entegrasyon aracı ile Maping yapılarak ayarların tamamlanması.
Entegrasyon Çalıştırma Yöntemleri:
- Form Kayıt Sırasında: Form kaydedildiği anda kayıtlı bilgilerin mikro veri tabanına entegrasyonu.
- Akış ile Onay sonrası Entegrasyon: Kayıt sonrası başlatılacak akış sayesinde onaylardan veya gerekli kontrollerden geçtikten sonra entegrasyonun otomatik yapılması.
- Liste Rapordan Seçerek Entegrasyon: Form kaydedildikten sonra bir Liste aracında raporlanarak seçilen satırın bir buton yardımı ile entegrasyonu.
Örnek Kullanım:
Bu örneğimizde bir stok kartı tasarımı yaparak ilgili formun kayıt sırasında mikro entegrasyonunun gerçekleşeceği ayarlar anlatılmaktadır.
Öncelikle stok kartı tasarımımızı yapıyoruz. Stok kodu ve adı kısımları elle giriş yapılmakta, Cinsi kısmı açılır kutuya tanımladığımız seçeneklerden seçilmekte ve diğer seçimlerimiz ise mikrodaki kayıtlı bilgilerden getirilmektedir.
Tasarım ekran görüntüsü:
Form ayarlarımızı yaptıktan sonra Main Page kısmındaki Integration menüsüne tıklıyoruz.
Açılan ayarlar bölümünden Stok entegrasyonu için bir isim tanımladıktan sonra gerekli seçim alanlarını dolduruyoruz. Maping alanından ise formumuzun alanları ile STOKLAR tablosundaki uygun alanları eşleştiriyoruz. İstediğimiz bazı alanlara manuel veri girişi yaparak formdan almadan standart bilgilerin entegre edilmesini sağlıyoruz.
Not: Form tasarımını yaparken entegre edilmesi istenen alanların alan tiplerini ve boyutlarını entegre edeceğiniz tablodaki tip ve boyutlar ile aynı yapmanız gerekmektedir. Aynı şekilde manuel aktaracağınız (Elle maping tablosuna girilen veriler) verilerinde entegrasyon sırasında hata almamanız için boyutlarının ve tiplerinin uygun olduğuna dikkat edilmelidir. Örnek olarak Float ya da int tipindeki bir alana string bir veri göndermeye çalışırsanız entegrasyonunuz çalışmayacaktır.
Entegrasyon ayarlarımızı tamamladıktan sonra sağ üst köşedeki kayıt butonu ile kaydediyoruz. Kaydımız XPODA_INTEGRATIONS tablosuna oluşuyor. Her yaptığımız yeni entegrasyon ayarımız ilgili tabloya yeni bir kayıt oluşturacaktır. Şimdi oluşan integrationid bilgimizi formumuzun içerisine ekliyoruz ve kayıt sonrası entegrasyon çalışması için entegrasyon özelliğimizi aktif ediyoruz.
XPODA_INTEGRATIONS tablosunu kontrol edip id mizi öğreniyoruz ve Integration ID Query alanına SELECT 1 şeklinde ekliyoruz.
Az önce oluşturmuş olduğumuz entegrasyon XPODA_INTEGRATIONS tablosuna kaydedilmiştir. Bu kaydın IntegrationID alanındaki değeri 1 olduğu için SELECT 1 değerini yazıyoruz.
Son olarak kayıt sonrası anında entegrasyonun sağlanması için form özelliklerinden Integration özelliğini aktif ediyoruz.
Akış ile onay sonrası entegrasyon işleminin yapılması: Düzenlenen akış içerisinde onay sürecinden sonra yapılacak olan entegrasyon işlemi için kullanılır. Akış içerisindeki Document alanından hangi form sayfası seçildiyse o form sayfası içerisinde yer alan entegrasyon çalışacaktır.
Aşağıdaki link üzerinden örnek kullanımı inceleyebilirsiniz.
https://docs.xpoda.com/hc/tr/articles/360011676579-Integration
Liste Rapordan Seçerek Entegrasyon:
Form sayfasında yer alan liste üzerinden, istenilen satır için işlem yapılmasıdır. Bu işlemin yapılabilmesi için Liste sorgusunda mutlaka UserTableID, FormTypeID ve ProjectID değerlerinin bulunması gerekmektedir.
Bunun için kullanılacak olan aksiyon Run Linked Integration aksiyonudur.
Aksiyon örneği aşağıda yer almaktadır.
Linked List alanından form sayfasında hangi liste için işlem yapılacağı seçilir.
SIK SORULAN SORULAR
1. Evrak Tipi (Type Of Document) alanı boş geliyor. Ne yapmalıyım ?
Bu durum SQL kullanıcısının Mikro veribanlarına erişim yetkisiyle alakalıdır. İlgili SQL kullanıcısında "sysadmin" rolünün tanımlandığı kontrol edilmelidir.
Doküman linki ; https://docs.xpoda.com/hc/tr/SQLAyarları
2. Form alanları dışındaki bir bilgiyi entegrasyonda kullanabilir miyim?
Evet, örneğin bir sipariş entegrasyonu için formunuzun Seri bilgisi değişken değil ise Form alanlarında Seri bilgisi tutmanıza gerek yoktur. Maping sırasında Seri alanına default değer olarak istenilen seri bilgisi yazılabilir. Ayrıca Query ile entegrasyon yönteminde sorgunuzun içerisine Seri bilgisini manuel ekleyebilir ve bu bilgiyi maping sırasında kullanabilirsiniz. Query ile farklı tablolardan ihtiyacınız olan bilgileri çekebilir veya sorgunuzun içinde istediğiniz hesaplamaları yaptırarak maping içerisinde kullanabilirsiniz.
3. Entegrasyon sonrasında Xpoda Form tablosu ile mikronun nasıl bir bağlantısı olmaktadır?
Entegrasyon sonrasında mikro tarafında oluşan RecNo bilgisi veya Guid bilgisi (Mikro versiyonuna göre bu bilgi değişmektedir.) Form alanlarınızda otomatik oluşan IntegrationID alanına otomatik olarak yazılmaktadır. Siz de kendi formunuzda oluşan UserTableID bilgisini entegrasyon sırasında uygun olan farklı bir alana maping yapabilir ve bu sayede çift taraflı id bilgilerini eşleştirmiş olursunuz.
4. Aynı anda birden fazla evrak entegrasyonu yani çoklu entegrasyon yapabilir mi?
Evet yapılabilir ancak bunun için xpodanın Show Content (query) aksiyonu veya akış içerisindeki DB Query nesnesi ile yazacağınız bir procedure’u tetiklemeniz gerekmektedir. Procedure alacağı parametre sonucunda entegre edilecek tüm evrakları tespit edip gelen tüm sonuçlar için entegrasyon işleminizi yapabilecek kabiliyette yazılmalıdır.
5. Bir form birden fazla tabloya entegre edilebilir mi?
Bir form uygun şartlar sağlandıktan sonra istenilen kadar farklı tabloya entegre edilebilir. Bunu yapabilmek için öncelikle bir forma ait birden fazla entegrasyon mapingi oluşturmanız gerekmektedir. Her oluşan maping için XPODA_INTEGRATIONS tablosuna bir adet kayıt gelecektir. Bu tabloya oluşan kayıtların ID lerini form özelliklerinde bulunan Integration ID Query alanına şartlı şekilde yazmanız gerekmektedir. Örneğin form içerisinden seçtiğiniz bir tipe göre girdiğiniz bilgileri isterseniz yurt içi sipariş olarak isterseniz de seçtiğiniz tipe göre irsaliye olarak kayıt etmeyi otomatik yapabilirsiniz.