gFM Business ERP yazılımında çevrimiçi mağaza arayüzünü genişletin

FileMaker platformunu temel alan ERP yazılımı Apple macOS, Windows ve iOS üzerinde çalışan gFM-Business, entegre bir çevrimiçi mağaza işlevi içerir.Arayüz Müşterilerin, ürünlerin ve mağaza siparişlerinin bir düğmeye dokunarak gFM-Business'a aktarılabildiği REST-API tabanlı gFM-Business, stok seviyelerinin çevrimiçi mağazadaki ürünlerle otomatik olarak senkronize edilmesini de destekler. Standart kapsam şu anda mağaza sistemlerini içermektedir Shopware 5.x, Gambio WordPress için GX3 ve WooCommerce desteklenir.

Açık lisansın bir parçası olarak gFM-Business Basic veya Profesyonel FileMaker Pro (veya Advanced) ile online mağaza arayüzü, ek alanlar veya başka bir online mağaza sistemi içerecek şekilde genişletilebilir. Bu makalede, gFM Business'taki REST API tabanlı çevrimiçi mağaza arayüzünün nasıl yapılandırıldığı ve ek alanlar veya başka bir mağaza sistemi içerecek şekilde nasıl genişletilebileceği açıklanmaktadır. gFM-Business'taki tüm temel tanımların ve standartların bir dokümantasyonunu şu adreste bulabilirsiniz Burada.

Entegre online mağaza arayüzünün genel yapısı

gFM Business ERP yazılımına entegre edilen online mağaza arayüzü basit bir yapıya sahiptir ve aşağıdaki bileşenlerden oluşur:

"Ayarlar" modülündeki çevrimiçi mağazalar

Tüm çevrimiçi mağazalar [Ayarlar > Çevrimiçi mağaza] altında kurulabilir. Altta yatan Tablo "gFMw_Stammdaten" dosyasındaki "REST_API" tablosudur. Yeni bir çevrimiçi mağaza oluşturulursa, tüm veriler referans olarak "gFMw_Stammdaten" dosyasında da bulunan "REST_API_Stamm" tablosundan elde edilir. Arayüze başka bir mağaza sistemi eklenirse, bu mağaza sistemi için de "REST_API_Stamm" tablosunda bir ana veri kaydı oluşturulmalıdır, böylece birkaç çevrimiçi mağazayı her kullandığınızda tüm verileri manuel olarak girmeniz gerekmez.

Küçük sürüm gFM-Business Basic varsayılan olarak yalnızca bir çevrimiçi mağazanın kullanımını destekler. Prensip olarak bu, gFM-Business Basic'in birden fazla çevrimiçi mağazanın kullanımına da izin verecek şekilde genişletilebilir. Bunun için sadece ilgili bir Portal Online mağazayı seçmek için Profesyonel sürümde olduğu gibi uygulanabilir. Tüm işlevler ve komut dosyaları Temel sürümde birden fazla çevrimiçi mağazayı da destekler ve bu işlev için genişletilmesi gerekmez.

Sanal tablolar

İçe aktarılacak müşterileri, ürünleri veya mağaza siparişlerini seçerken, mağaza sunucusunda bulunan tüm veriler bir seçim penceresinde görüntülenir. Burada görüntülenen veriler yalnızca gFM Business'taki sanal bir tabloda geçici olarak saklanır ve seçimden sonra atılır. Sanal tablo kavramı FileMaker Conference 2015'te Arnold Kegebein tarafından sunulmuştur sunuldu. Sanal bir tabloda, gelen veriler ayrı ayrı alanlarda değil, yalnızca tekrar eden bir alanda saklanır. Tekrar sayısı, bir tabloda görüntülenecek alan sayısına karşılık gelir, bir veri kaydı, sağlanan verilerin bir veri kaydına karşılık gelir. Tüm sanal tablolar "gFM_Business.fmp12" dosyasında bulunur.

Bir sanal tablo aşağıdaki alanları içerir (örnek olarak makaleleri kullanarak):

• _fk_Makale_ID (gFM-Business'tan Makale Kimliği ile SQL-Makale yöneticisindeki "_Shop_ID" üzerinde sorgu. Makale gFM-Business'ta zaten mevcutsa doldurulur)
• _id_foreign_system (Harici sistemin kimliği)
• _sGlobal (Global anahtar, her zaman 1 değerini içerir)
• Seçim (gFM-Business'a aktarılacak bir veri kaydının kullanıcı tarafından seçilmesi için kullanılan alan)
• Veri alanları (Tabloda görüntülenecek arayüzden 6 veri alanı için 6 tekrarlı alan)
• ID_selection (Hesaplanan alan, hangi ID seçildi)
• Başlık alanları  (Tabloda görüntülenecek arayüzden 6 alan başlığı için 6 tekrarlı alan tekrarı)
• Nesne_seçimi (Hesaplanan alan, sonuç kümesinde en son hangi konumun seçildiği)

Diğer iki sanal tablo da prensipte aynı şekilde çalışır, ancak siparişler tablosunda ürün kimliği yerine fatura ve sipariş kimlikleri, müşteriler için ise müşteri kimliği mevcut veri kayıtları için kontrol edilir.

"gFM_Business.fmp12" dosyasında online mağaza arayüzü için üç sanal tablo bulunmaktadır:

• vt_selection_article (kayıtlı makale verilerini görüntülemek için sanal tablo, alan [veri alanları] 6 tekrar içerir)
• vt_selection_orders (kayıtlı makale verilerini görüntülemek için sanal tablo, alan [veri alanları] 9 tekrar içerir)
• vt_selection_customers (kayıtlı makale verilerini görüntülemek için sanal tablo, alan [veri alanları] 6 tekrar içerir)

gFM İşletme tablolarındaki Mağaza Kimlikleri

İlgili tüm tablolar, gFM-Business ERP yazılımının online mağazadaki hangi verilerin gFM-Business'taki verilere atandığını takip edebilmesi için aşağıdaki alanları içerir:

• _Dükkan_Kimliği (çevrimiçi mağazadaki ilgili veri kaydının kimliğini içerir)
• _Shop_Foreign_system (gFM-Business aynı anda birden fazla mağazanın kullanımını desteklediğinden, mağaza kimliğinin hangi üçüncü taraf sistemine ait olduğu bilgisini içerir)

Bu alanlar gFM-Business'ın aşağıdaki tablolarında yer almaktadır:

• Makale ustası (tüm ürünlerin ana tablosu)
• Müşteriler (tüm müşterilerin ana tablosu)
• Siparişler (tüm siparişlerin ana tablosu)
• Faturalar (tüm faturaların ana tablosu)

Tüm komut dosyaları "REST "i dinler

Çevrimiçi mağaza arayüzüyle ilişkili tüm komut dosyaları, aşağıdaki arama alanında bulunabilir Senaryo-"rest" girerek editör. Teslim edildiğinde, arayüz toplam yedi komut dosyasından oluşur:

REST_Query [harici sistem|uç nokta|]

Bu komut dosyası, oturum açmak için kullanılır SunucuOnline mağazanın kurulduğu ve "Harici sistem" ve "Uç nokta" parametreleriyle çağrıldığı sunucu. Online mağazanın sunucusuna bir sorgu yapılmadan önce, sorgudan önce sunucuda oturum açmak için bu oturum açma komut dosyası her zaman önce çalıştırılmalıdır.

Hata kaydını ayarla [ Açık ]

UserCancelAllow [ Kapalı ] olarak ayarlayın

# 

# >>>>>>>>>> SES AKTARIMI

Değişkeni ayarla [ $dg_001 ; Değer: SQLAusführen ( "SELECT \"Dialog_001\" FROM \"lg\" WHERE \"_fk_ScriptName\"='" & Hole(ScriptName) & "' AND \"_pk_Sprache_ID\"=" & prf::_Sprache_ID ; "" ; "" ) ] 

Değişkeni ayarla [ $dg_002 ; Değer: SQLAusführen ( "SELECT \"Dialog_002\" FROM \"lg\" WHERE \"_fk_ScriptName\"='" & Hole(ScriptName) & "' AND \"_pk_Sprache_ID\"=" & prf::_Sprache_ID ; "" ; "" ) ] 

Değişkeni ayarla [ $dg_003 ; Değer: SQLAusführen ( "SELECT \"Dialog_003\" FROM \"lg\" WHERE \"_fk_ScriptName\"='" & Hole(ScriptName) & "' AND \"_pk_Sprache_ID\"=" & prf::_Sprache_ID ; "" ; "" ) ] 

Hata kaydını ayarlar ve sunucuda oturum açma başarısız olduğunda görüntülenen hata diyaloğu için metinleri dil tablosundan aktarır.

Değişken ayarla [ $fremdsystem ; Değer: StringColumns(Get(ScriptParameter); 1) ] 

Değişken ayarla [ $endpoint ; Değer: StringColumns(Get(ScriptParameter); 2) ] 

Değişkeni ayarla [ $api_url ; Değer: SQLAusführen ( "SELECT \"API_URL\" FROM \"REST_API\" WHERE \"name_foreign_system\"='" & $fremdsystem & "'" ; "" ; "" ) ] 

Değişkeni ayarla [ $login ; Değer: SQLAusführen ( "SELECT \"Consumer_Key\" FROM \"REST_API\" WHERE \"name_foreign_system\"='" & $fremdsystem & "'" ; "" ; "" ) ] 

Değişkeni ayarla [ $pass ; Değer: SQLAusführen ( "SELECT \"Consumer_Secret\" FROM \"REST_API\" WHERE \"name_foreign_system\"='" & $fremdsystem & "'" ; "" ; "" ) ] 

Gerekli tüm değişkenleri ayarlayın. Harici sistem (harici sistemin adı, örneğin "WooCommerce") ve bitiş noktası (örneğin "Makaleler için bitiş noktası") değişkenleri, kullanıcı diyaloğundan kod parametreleri olarak aktarılır. $api_url, $login ve $pass değişkenleri, "gFMw_Stammdaten.fmp12" dosyasında ayarlanan çevrimiçi mağazanın "REST_API" tablosundan alınır.

Diğer tüm komutlar RESTful API ile bir online mağaza sisteminde oturum açmak için kullanılır ve genellikle tüm sistemler için aynıdır. Aşağıdaki kısmi komut dosyası büyük ölçüde verilen örneğe karşılık gelir MBS FileMaker Eklentisi.

dlg.REST_selection_customers (parametre)

Bu kod, çevrimiçi mağazada bulunan verilere dayalı olarak içe aktarılacak müşterilerin seçilebileceği seçim penceresini görüntüler. Bu kod aşağıdaki kod parametreleri ile çağrılabilir:

• İthalat - Bu parametre, müşterileri online mağazadan gFM Business'a aktarmak için seçim penceresini görüntülemek için kullanılır. Bu alt komut dosyası açılır pencere komut dosyasından oluşturulur "ts.kon_data_import" ve seçime bağlı olarak çağrılan tüm çevrimiçi mağazaların ana arayüz komut dosyası için çağrılar içerir.
• Tümünü seçin - Bu parametre seçim penceresindeki tüm satırları seçmek için kullanılabilir.
• Customers_call - Bu parametre, gFM Business penceresindeki seçim penceresinden bir müşteriyi çağırmak için kullanılabilir.

dlg.REST_selection_orders (parametre)

Bu kod, çevrimiçi mağazada bulunan verilere dayalı olarak içe aktarılacak siparişlerin seçilebileceği seçim penceresini görüntüler. Bu kod aşağıdaki kod parametreleri ile çağrılabilir:

• Import_Order - Bu parametre, siparişlerin online mağazadan gFM Business'a aktarılması ve ardından sipariş onayı olarak içe aktarılması için seçim penceresini görüntülemek için kullanılır. Bu alt komut dosyası açılır pencere komut dosyasından oluşturulur "ts.fak_data_import" ve seçime bağlı olarak çağrılan tüm çevrimiçi mağazaların ana arayüz komut dosyası için çağrılar içerir.
• Import_Invoice - Bu parametre, siparişlerin online mağazadan gFM Business'a aktarılması ve ardından fatura olarak içe aktarılması için seçim penceresini görüntülemek için kullanılır. Bu alt komut dosyası açılır pencere komut dosyasından oluşturulur "ts.fak_data_import" ve seçime bağlı olarak çağrılan tüm çevrimiçi mağazaların ana arayüz komut dosyası için çağrılar içerir.
• Tümünü seçin - Bu parametre seçim penceresindeki tüm satırları seçmek için kullanılabilir.
• Order_call - Bu parametre, gFM Business penceresindeki seçim penceresinden bir sipariş onayı çağırmak için kullanılabilir.
• Invoice_call - Bu parametre, gFM Business penceresindeki seçim penceresinden bir faturayı çağırmak için kullanılabilir.

dlg.REST_selection_article (parametre)

Bu kod, çevrimiçi mağazada bulunan verilere dayalı olarak içe aktarılacak öğelerin seçilebileceği seçim penceresini görüntüler. Bu kod aşağıdaki kod parametreleri ile çağrılabilir:

• İthalat - Bu parametre, online mağazadan gFM Business'a ürün aktarmak için seçim penceresini görüntülemek için kullanılır. Bu alt komut dosyası açılır pencere komut dosyasından oluşturulur "ts.art_data_import" ve seçime bağlı olarak çağrılan tüm çevrimiçi mağazaların ana arayüz komut dosyası için çağrılar içerir.
• Tümünü seçin - Bu parametre seçim penceresindeki tüm satırları seçmek için kullanılabilir.
• Customers_call - Bu parametre, gFM Business penceresindeki seçim penceresinden bir öğeyi çağırmak için kullanılabilir.

REST_Gambio_GX3_API_v210 (veri türü|harici sistem|{nesne|ID dışa aktarma}|)

Bu komut dosyası, Gambio GX3 tabanlı çevrimiçi mağazalarla bağlantılı olarak verilerin içe ve dışa aktarılması için tüm alt komut dosyalarını içerir. Bu betikteki tüm komutlar, aşağıdaki değerlere sahip olabilen ilk parametre "Veri türü" aracılığıyla kontrol edilir:

• Müşteriler (Müşterilerin otomatik olarak içe aktarılması için içe aktarma komut dosyası. Bu içe aktarma türünde, içe aktarmadan önce herhangi bir seçim penceresi görüntülenmez; bunun yerine, henüz mevcut olmayan tüm müşteriler otomatik olarak içe aktarılır. Bu içe aktarma türünde, istenmeyen spam girişlerinin de içe aktarılması riski vardır).
• Orders_Orders (Mağaza siparişlerinin sipariş onayları olarak otomatik içe aktarılması için içe aktarma komut dosyası. Bu içe aktarma türünde, içe aktarmadan önce herhangi bir seçim penceresi görüntülenmez, ancak henüz mevcut olmayan tüm siparişler otomatik olarak içe aktarılır. Bu içe aktarma türüyle, istenmeyen spam girişlerinin de içe aktarılması riski vardır).
• Siparişler_Faturalar (Mağaza siparişlerinin fatura olarak otomatik içe aktarılması için içe aktarma komut dosyası. Bu içe aktarma türünde, içe aktarmadan önce herhangi bir seçim penceresi görüntülenmez, ancak henüz mevcut olmayan tüm siparişler otomatik olarak içe aktarılır. Bu içe aktarma türüyle, istenmeyen spam girişlerinin de içe aktarılması riski vardır).
• Makale (Çevrimiçi mağazadan ürünlerin otomatik olarak içe aktarılması için içe aktarma komut dosyası. Bu içe aktarma türünde, içe aktarmadan önce herhangi bir seçim penceresi görüntülenmez; bunun yerine, henüz mevcut olmayan tüm ürünler otomatik olarak içe aktarılır.
• Müşteri (gFM-Business'taki online mağazadan tek bir müşteriyi güncellemek için güncelleme komut dosyası. Bu kodu çağırmak için [ID export] parametresi müşteri veri kaydının ID'si ile birlikte verilmelidir).
• Order_Orders (Online mağazadan tek bir siparişi bir siparişten içe aktarmak için içe aktarma komut dosyası. Bu komut dosyasını çağırmak için [ID export] parametresi sipariş veri kaydının ID'si ile birlikte verilmelidir).
• Sipariş_Faturaları (Online mağazadan tek bir siparişi bir faturadan içe aktarmak için içe aktarma komut dosyası. Bu kodu çağırmak için [ID export] parametresi sipariş veri kaydının ID'si ile birlikte verilmelidir).
• Tek makale (Online mağazadan tek bir ürünü gFM-Business'a aktarmak için içe aktarma komut dosyası. Bu kodu çağırmak için, [ID-Export] parametresi makale veri kaydının ID'si ile birlikte verilmelidir).
• Customers_selection (Seçim penceresi ile online mağazadan müşteri verilerini içe aktarmak için içe aktarma komut dosyası. Seçim penceresindeki işlevler ilgili diyalog komut dosyasında kontrol edilir [dlg.REST_Auswahl_Kunden]).
• Orders_selection (Seçim pencereli çevrimiçi mağazadan mağaza siparişlerini içe aktarmak için içe aktarma komut dosyası. Seçim penceresindeki işlevler ilgili diyalog betiğinde kontrol edilir [dlg.REST_Auswahl_Bestellungen]).
• Makale_seçimi (Seçim penceresi ile online mağazadan ürünleri içe aktarmak için içe aktarma komut dosyası. Seçim penceresindeki işlevler ilgili diyalog komut dosyasında kontrol edilir [dlg.REST_Auswahl_Artikel]).
• Güncel_stok (Bu komut dosyası, bir öğenin stoğunu çevrimiçi mağazanın stoğuyla karşılaştırmak için kullanılabilir. Sunucudaki stokun üzerine gFM-Business'tan gelen stok yazılır).
• Güncelle_Müşteriler (Bu kod, online mağazadaki müşteri verilerini güncellemek için kullanılır. Online mağazadaki verilerin üzerine gFM-Business'tan gelen veriler yazılır. Bu kodu çağırmak için [ID-Export] parametresi müşteri veri kaydının ID'si ile birlikte verilmelidir).
• Update_Order_status (Bu komut dosyası, gFM-Business'taki çevrimiçi mağazadan sipariş durumunu güncellemek için kullanılır. gFM-Business içindeki verilerin üzerine online mağazadan gelen veriler yazılır. Bu kodu çağırmak için [ID export] parametresi sipariş veri kaydının ID'si ile birlikte verilmelidir).
• Güncel_Makale (Bu kod çevrimiçi mağazadaki makale verilerini güncellemek için kullanılır. Online mağazadaki verilerin üzerine gFM-Business'tan gelen veriler yazılır. Bu kodu çağırmak için [ID-Export] parametresi, ürün veri kaydının ID'si ile birlikte verilmelidir).

REST_WooCommerce_API_v3 (veri türü|harici sistem|{object|ID export}|)

Bu komut dosyası, WooCommerce tabanlı çevrimiçi mağazalarla bağlantılı olarak veri içe ve dışa aktarmaya yönelik tüm alt komut dosyalarını içerir. Bu komut dosyası, yukarıda açıklanan Gambio online mağazalarına yönelik komut dosyasıyla aynı komut parametrelerini içerir.

REST_Shopware_5x_API (veri türü|harici sistem|{nesne|ID dışa aktarma}|)

Bu komut dosyası, Shopware tabanlı online mağazalarla bağlantılı olarak veri içe ve dışa aktarmaya yönelik tüm alt komut dosyalarını içerir. Bu komut dosyası, yukarıda açıklanan Gambio online mağazalarına yönelik komut dosyasıyla aynı komut parametrelerini içerir.

Mevcut bir çevrimiçi mağaza için alanları genişletme

"REST_Shopsystem" arayüz komut dosyaları, çevrimiçi mağazadan veri almak için gerekli olan tüm alt komut dosyalarını içerir. İlgili her bir alt komut dosyasında, mağazadan alınacak veriler ilk olarak bir Değişken kaydedildi, örn:

Değişkeni ayarla [$artikel_nr ; Değer: MBS("JSON.GetStringValue"; MBS("JSON.GetObjectItem"; $objekt; "productModel" )) ]

Bu değişken ayarlandığında, online mağazanın [productModel] alanını sorgulamak için MBS eklentisinin işlevleri kullanılır. Bu durumda, bu bir metin alanıdır, bu nedenle "JSON.GetStringValue" işlevi kullanılır. Sayı alanları için "JSON.GetIntegerValue" veya "JSON.GetDoubleValue" işlevi kullanılır. Veri türleri kesinlikle ayırt edilmelidir, aksi takdirde fonksiyon çalıştırılamaz. Tüm alanlar için değişkenler ayarlandıktan sonra, değişkenlerde saklanan veriler MBS fonksiyonu "FM.InsertRecord" kullanılarak gFM-Business tablolarına yazılır.

Online mağazadan ek alanları içe aktarmak için, istenen ek alanlar için ek değişkenler oluşturun ve verileri gFM Business tablolarına yazmak için "FM.InsertRecord" işlevini uygun şekilde genişletin.

$json ve $object değişkenleri

Tüm işlevler için, mağazadan sağlanan veriler $json değişkenine tam olarak kaydedilir. Dolayısıyla bu değişken her zaman online mağazadan teslim edilen JSON veri akışının tamamını içerir. Tanıma bağlı olarak, $object değişkeni sağlanan verilerin yalnızca bir kısmını, örneğin bir veri kaydını içerir. Online mağazadan veya mağaza uzantılarından REST-API arayüzüne başka tablolar eklemek istiyorsanız, bir içe aktarma komut dosyası içinde arayüze ilgili uç noktayla yeni bir sorgu gerçekleştirmeniz gerekir. Anlaşılır olması için, JSON sonucunu ayrı bir değişkene de kaydedebilirsiniz, örneğin "$json_extension_1" ve "$objekt_extension_1".

Arayüzün başka bir çevrimiçi mağazayı içerecek şekilde genişletilmesi

Henüz gFM-Business tarafından desteklenmeyen yeni bir çevrimiçi mağaza eklemek prensip olarak oldukça basittir ve aşağıdaki adımlardan oluşur:

• Yeni çevrimiçi mağazanın eklenmesi gFM-Business'ta [Ayarlar > Online mağaza] altında, tüm veri türleri için oturum açma verilerini ve uç noktaları dikkate alarak
• Mevcut bir arayüz komut dosyasını çoğaltmaörneğin "REST_Shopware_5x_API" ve yeni komut dosyasını yeni mağaza sisteminin adıyla yeniden adlandırın, örneğin "REST_Magento_xy_API"
• Yeni içe aktarma komut dosyasındaki tüm işlevlerdeki alanları özelleştirin. Ön koşul, yeni online mağazanın da bir REST API'ye sahip olmasıdır. "Mevcut bir online mağaza için alanları genişletme" bölümünde daha önce tartışılmış olan tüm değişkenler uyarlanmalıdır. Değişkenlerin adları değiştirilmemelidir. Yeni alanlar/değişkenler eklenirse, bunlar da "FM.InsertRecord" veya "FM.UpdateRecord" MBS işlevlerinde dikkate alınmalıdır. Tüm JSON değerleri gFM-Business'in standart versiyonunda MBS fonksiyonları ile okunur. Bu MBS fonksiyonlarını FileMaker fonksiyonları ile değiştirmek de mümkündür (örn. JSONGetElement).
• Diyalog komut dosyalarını genişletin "dlg.REST_Auswahl_xyz". Tüm çevrimiçi mağazalar için içe aktarma komut dosyaları, seçime bağlı olarak bu komut dosyalarından çağrılır. Yeni bir mağaza sistemi eklenirse, bu seçim komut dosyaları da yeni çevrimiçi mağaza için komut dosyası çağrısını içerecek şekilde genişletilmelidir. Ayarlar > Çevrimiçi mağaza] altında ayarlanan çevrimiçi mağazanın adı, $shopystem değişkeninde bu komut dosyalarında sorgulanan metin ifadesini içermelidir.

Mevcut sistemlerde, mağaza arayüzünün genişletilmesi için üretken sistemin kopyalanmasını ve daha sonraki test çalışmalarıyla gerçek veritabanını tehlikeye atmamak için geliştirmenin önce bir test sistemi üzerinde yapılmasını öneriyoruz.

Arayüzün bir hizmet ortağı veya bizim tarafımızdan genişletilmesi

Biz veya hizmet ortaklarımızdan biri, açık lisansın bir parçası olarak çevrimiçi mağaza arayüzünün genişletilmesinde size kişisel olarak yardımcı olmaktan mutluluk duyacaktır. Arzu ettiğiniz genişletmenin tamamını sizin için uygulayabilir veya arayüzün genişletilmesi ya da gFM-Business ERP yazılımı ile ilgili diğer sorularınız için size veya geliştiricinize uygun koçluk hizmeti sunabiliriz. Bizimle iletişime geçmekten çekinmeyin!

gFM-Business ERP yazılımının açık lisansı hakkında daha fazla bilgi