
WooCommerce RESTful API'ye giriş yapın
Bir WooCommerce online mağazasından veri okuyabilmek için öncelikle WooCommerce'de RESTful API'nin etkinleştirilmesi gerekir. Bu ayar WordPress arka ucunda şuradan yapılabilir [WooCommerce > Ayarlar] kayıt defterinde [API] yapılabilir.
Düğmeye tıklayın [Değişiklikleri kaydet]arayüzün etkinleştirilmesini onaylamak için. Bir sonraki adımda, yeni bir API anahtarı oluşturun. Bunu yapmak için sekmeye tıklayın [Anahtar/Uygulamalar] ve ardından düğmesine tıklayın [Anahtar ekle].
Sahada [Açıklama] seçtiğiniz bir açıklama ekleyebilirsiniz. WooCommerce RESTful API'ye erişmek için yetkilendirilmesi gereken bir kullanıcı seçin. Kullanıcının arayüz üzerinden mağaza sistemine de veri yazıp yazmayacağına bağlı olarak, uygun yetkileri atayabilirsiniz. Burada sunulan FileMaker çözümü için "Oku" yetkisi yeterlidir. Ardından düğmeye tıklayın [API anahtarı oluştur].
Şimdi "Anahtar (Tüketici Anahtarı)" ve "Tüketici Sırrı" alanlarının içeriğini not edin. Bu adım önemlidir çünkü anahtar veriler maskelenmiş biçimde saklandığından gelecekte bu alanların içeriğini görüntüleyemeyeceksiniz.
FileMaker'da WooCommerce REST API için arayüz
Bu makalede sunulan örnek çözüm, mağaza siparişlerini ve fatura ve teslimat adresleri gibi ilgili müşteri verilerini bir WooCommerce online mağazasından FileMaker veritabanına aktarmak için kullanılabilir. Örnek dosya (veya kendi çözümünüz) ek işlevler ve tablolar içerecek şekilde kolayca genişletilebilir. WooCommerce, RESTful API'ye erişmek için aşağıdaki uç noktaları sağlar:
- Kuponlar
- Müşteriler
- Siparişler (örnek dosyada kullanılır)
- Sipariş Notları
- Para İadeleri
- Ürünler
- Ürün özellikleri
- Ürün öznitelik terimleri
- Ürün kategorileri
- Ürün sevkiyat sınıfları
- Ürün etiketleri
- Raporlar
- Vergi oranları
- Vergi sınıfları
WooCommerce RESTful API ile, kuponlar, ürünler, ürün nitelikleri ve hatta vergi sınıfları gibi diğer birçok veri kaynağı da FileMaker ile okunabilir ve/veya işlenebilir. Örnek FileMaker çözümümüzde, siparişleri WooCommerce'den FileMaker'a aktarmak için "Orders" uç noktasını kullanıyoruz.
Örnek çözüm MBS FileMaker eklentisini gerektirir
Arayüzün geliştirilmesi için MBS FileMaker Eklentisi Monkeybread Software'den. Eklenti, RESTful API ile bir arayüz için gerekli tüm işlevleri sunar. Alternatif olarak, ücretsiz Temel Elemanlar Eklentisi yazılım buna göre yeniden programlanırsa.
FileMaker çözümündeki varsayılan ayarlar
Bir WooCommerce çevrimiçi mağazasının arayüzü için FileMaker çözümünün deneme sürümünü şu adresten indirebilirsiniz buradan indirin. Çözüm, .fmp12 formatı FileMaker 13 ila 15 içindir ve en az 4.4 sürümünde MBS FileMaker eklentisi gerektirir. Zip arşivini açtıktan ve çözümü FileMaker ile başlattıktan sonra, önce WooCommerce çevrimiçi mağazanızın RESTful API'si için verileri girmelisiniz.
Sarı renkle vurgulanan alanlara tüm verileri girin:
- API URL'SI - Sunucunuzun URL'si ve uzantısı /wp-api/v3
- Bitiş noktası - Standart: /orders
- Nesneyi başlat - Standart: siparişler
- Tüketici anahtarı - WordPress arka ucunda oluşturduğunuz ve not ettiğiniz tüketici anahtarı
- Tüketici Sırrı - WordPress arka ucunda oluşturduğunuz ve not ettiğiniz tüketici sırrı
Tüm veriler doğru bir şekilde girilmişse [Veri içe aktarma] Belirtilen WooCommerce çevrimiçi mağazasındaki tüm siparişleri ve ilgili müşteri verilerini içe aktarır.
FileMaker örnek veritabanının yapısı
Mağaza siparişlerini içe aktarmaya yönelik örnek veritabanı basit bir yapıya sahiptir ve aşağıdaki veri tablolarını içerir:
- Siparişler - Bir siparişin ana veri kaydı, aşağıdaki alanları içerir:
- __ORDERS ("orders" başlangıç nesnesinden alınan veriler, yalnızca açıklama amaçlıdır)
- Sipariş numarası (WooCommerce'den sipariş numarası)
- _ID_Fremdsystem (Birincil anahtar [post_id] WooCommerce'den)
- _pk_Order_ID (birincil anahtar)
- Açıklamalar (WooCommerce'den açıklamalar)
- Sipariş durumu
- Amount_total_gross
- Amount_total_net
- Tutar_KDV
- Amount_VAT_items
- Amount_VAT_shipping_costs
- Tutar_İndirim
- Tutar_Nakliye_Maliyetleri
- Tutar_Alt Toplam
- Tarih_Sipariş
- E_Posta
- JSON_Ausgabe (JSON verilerinin çıktısı için global alan, aşağıdaki durumlarda kullanılır Senaryo kullanılmış)
- Customer_No_WC
- LiAdr_Address (teslimat adresi)
- LiAdr_Company
- LiAdr_Country_code
- LiAdr_Name
- LiAdr_City
- LiAdr_PLZ
- LiAdr_first_name
- KDV oranı
- ReAdr_Address (fatura adresi)
- ReAdr_Company
- ReAdr_Country_Code
- ReAdr_Name
- ReAdr_City
- ReAdr_PLZ
- ReAdr_first_name
- Status_paid
- Telefon
- Nakliye yöntemi
- Para Birimi
- Ödeme yöntemi
- Pozisyonlar - Tablo sipariş kalemleri, aşağıdaki alanları içerir:
- Sipariş numarası (WooCommerce'den sipariş numarası)
- _pk_Position_ID (birincil anahtar)
- Miktar
- Makale_No
- Makale açıklaması
- Tutar_KDV
- Tutar_net
- id (WooCommerce'den birincil anahtar)
- product_id (WooCommerce'deki ürünün kimliği)
- Ayarlar - WooCommerce RESTful API için ayarlar
- Harici sistem (Global) - Harici sistemin adı (yalnızca birden fazla harici sistem kullanılıyorsa kullanılır)
- rf_URL (Global) - API'ye giden yolu içeren sunucu URL'si
- rf_Benutzer (Global) - RESTful API için kullanıcı adı/tüketici anahtarı
- rf_Password (Global) - Parola/Tüketici Sırrı
- rf_Status_SSL (Global) - Durum, SSL'in kullanılıp kullanılmayacağı
- rf_Endpoint (Global) - RESTful API'nin Uç Noktası
- rf_Start nesnesi (Global) - Bitiş noktası içindeki başlangıç nesnesi
"Siparişler" ve "Kalemler" tabloları "_Sipariş numarası" anahtarıyla bağlantılıdır. Bu tablolardaki alanlar, kendi FileMaker çözümlerinize entegrasyon için gerektiği şekilde yeniden adlandırılabilir. Tüm alanlar global olarak tanımlandığı için "Ayarlar" tablosu bir bağlantı içermez. RESTful API ile birden fazla üçüncü taraf sistem bağlanacaksa, alanların global alanlar olarak tanımlanmaması ve üçüncü taraf sistemi seçmek için bir birincil anahtar eklenmesi önerilir.
RESTful API'ye giriş yapın
FileMaker örnek çözümü, online mağazadan sipariş verilerinin FileMaker'a aktarılabileceği iki kısmi komut dosyası içerir. "ts.Query_REST_API" komut dosyasında, çevrimiçi mağazaya giriş Sunucu. Bu amaçla, MBS eklentisi ilgili cURL fonksiyonlarını aşağıdaki sırayla çağırır:
- Yeni cURL oturumu açın
- REST API için URL ayarlama
- Oturum açma verilerini ayarlama
- Başlık seçeneğini ayarla
- SSL'yi ayarla
- Günlük mesajlarını açma
- Hata mesajı ile sorguyu çalıştırma
- Sahadaki sonuç [Orders::JSON_Output] yaz
- cURL oturumunu kapat, Temizle
Arayüzden JSON verilerini okuma
İkinci alt simge "ts.Parse_JSON_Orders_WC" sunucu tarafından sağlanan JSON verilerini okur ve bunları "Orders" ve "Items" tablolarının ayrı alanlarına girer. "Siparişler" başlangıç nesnesindeki tüm veriler (ayarlardaki "Başlangıç nesnesi" alanına bakın) önce Değişken $ordersJSON yazılır. Bunu, tüm siparişleri okumak için bir ana yürütme döngüsü ve bir sipariş için tüm öğeleri içe aktarmak için bir başka yürütme döngüsü izler. Bu kodda sunucuya artık erişilmez.
Sevkiyat adresi (shipping_address), fatura adresi (billing_address) ve satır kalemlerinin (line_items) tüm alanları bir ağaç yapısında bulunur ve komutla doldurulmalıdır:
MBS( "JSON.GetObjectItemTree"; json; names )
ilgili ağaçtan okunabilir. Diğer tüm alanlar MBS( "JSON.GetStringValue"; json ) veya MBS( "JSON.GetIntegerValue"; json ) fonksiyonları kullanılarak normal şekilde okunabilir.
FileMaker örnek veritabanını indirin
FileMaker örnek veritabanını indirebilirsiniz buradan indirin ve herhangi bir WooCommerce çevrimiçi mağazasıyla test edin. Genel sürüm, alan tanımlarını ve komut dosyalarını düzenlemek için kilitlidir. Örnek çözümle hemen başlamak ve kendi gereksinimlerinize göre özelleştirmek ister misiniz? O zaman şunları yapabilirsiniz Bize ulaşın Bizimle birlikte.

Markus Schall 1994'ten beri Claris FileMaker tabanlı özelleştirilmiş veritabanları, arayüzler ve iş uygulamaları geliştirmektedir. Kendisi Claris ortağı, 2011 FMM Ödülü sahibi ve ERP yazılımı gFM-Business. Kendisi aynı zamanda bir kitap yazarı ve M. Schall Yayınevleri.







Bu benim aradığım şeye benziyor. Diğer yol da mümkün mü? Yani değişiklikleri mysql DB'ye geri yazmak?
Örnek çözümde kullanılan eklentiler doğal olarak verilerin RESTful API aracılığıyla WooCommerce veritabanına yazılmasını sağlayan ters işlemi de desteklemektedir.
FMP 16'nın entegre RESTful API ve Json ile piyasaya sürülmesinden sonra, MBC eklentisi olmadan WC'ye bağlanmak artık mümkün olacak mı?
Evet, FileMaker 16 ile artık MBS eklentisini kullanmadan da her şey mümkün olmalıdır. Ancak, çözüm yalnızca FileMaker 16'da çalışır ve daha eski sürümlerle çalışmaz.
Çok ilginç, bunu dikkate almak için örneğinizi güncellemeniz gerekecek mi?
Evet, işlevler yeni FileMaker 16 işlevleriyle yerel olarak çalışacaksa, MBS tabanlı işlevler buna göre yeniden programlanmalıdır.
MBS eklentisi olmadan yerel bir FMP 16 sürümü gerçekleştirmeyi planlıyor musunuz?
eğer öyleyse çok ilgileniyorum
Hayır, bu tür işlevler için genellikle MBS eklentisini kullandığımdan, bu çözümün yerel bir FileMaker sürümünü geliştirme planım yok.
Merhaba, mevcut demonun güncel Woocommerce sürümü ve fm 19 ile de çalışıp çalışmadığı konusunda herhangi bir deneyiminiz var mı? Teşekkür ederim
Merhaba, yazılımın FileMaker 19 ile hiçbir sorunu olmamalıdır - ancak burada muhtemelen tümleşik kaynaklarla her şeyi çözebilirsiniz, o zaman artık MBS FileMaker eklentisine ihtiyacınız yoktur. Mağaza ile ilgili olarak, yazılım artık güncel değil ve daha yeni WooCommerce sürümleri için uyarlanması gerekebilir. Ancak bu, temel prensibi değiştirmez.
Temel prensip, WooCommerce arayüzüne muhtemelen daha fazla alan eklenmesi dışında, geliştirmeden bugüne kadar değişmedi.