4.3 Gelişmiş komut dosyası yazma teknikleri
FileMaker'da komut dosyası yazmanın temellerini öğrendiğinize göre, daha karmaşık ve sağlam uygulamalar geliştirmenize yardımcı olacak gelişmiş tekniklere geçmenin zamanı geldi. Bu eğitimde, komut dosyalarında hata işleme, komut dosyalarında hata ayıklama ve belgeleme ve birden fazla komut dosyası ile karmaşık iş akışları oluşturma konularına odaklanacağız. Bu teknikler, güçlü ve güvenilir FileMaker uygulamaları oluşturma becerinizi geliştirecektir.
İçindekiler tablosu
- 4.3 Gelişmiş komut dosyası yazma teknikleri
- Komut dosyalarında hata işleme
- Net ve tamamen belgelenmiş komut dosyası yapısı ve geliştirici modülü ile FileMaker ERP.
- gFM-Business Açık Kaynak FileMaker Basis ERP hızlandırılmış kurs yazılımı
- Birden fazla komut dosyası ile karmaşık iş akışları oluşturun
- FileMaker'da kısmi komut dosyalarının ve komut dosyası parametrelerinin kullanımı
- Birden fazla kod parametresi geçirme
- Kısmi komut dosyalarının ve komut dosyası parametrelerinin avantajları
- FileMaker ve gFM-Business ERP için ipuçları, talimatlar ve arayüzler
- Gelişmiş komut dosyası işlevleri hakkında sıkça sorulan sorular
Komut dosyalarında hata işleme
Hata işlemeye giriş
Hata işleme, iyi geliştirilmiş her kodun önemli bir parçasıdır. FileMaker'da bu şu anlama gelir Senaryo Böylece bir dosya bulunamadığında, bir hesaplama başarısız olduğunda veya kullanıcı geçersiz bir giriş yaptığında olduğu gibi beklenmedik durumlara tepki verebilir. Etkili hata işleme, kodunuzun basitçe "çökmemesini", bunun yerine hatayı tanımasını, uygun şekilde tepki vermesini ve kullanıcıyı bilgilendirmesini sağlar.
Hata işlemenin temelleri
- Aracılığıyla hata tespiti
Hata kaydını ayarlama: Senaryo adımı ileHata kaydını ayarla [Açık]FileMaker'ın bir hata oluştuğunda otomatik olarak bir hata mesajı görüntülemesini engelleyebilirsiniz. Bunun yerine, hata işlemeyi kendiniz halledebilirsiniz. - ile hata durumunu kontrol edin
Get(LastErrorNo): Koddaki her kritik adımdan sonra hata durumunu kontrol etmelisiniz.Get(LastErrorNo)içine girebileceğiniz bir hata kodu döndürür.Ne zaman-hataya tepki vermek için koşul. Örnek:Hata kaydını ayarla [Açık]
Dosyayı aç ["Database.fmp12"]
Eğer [Get(LastErrorNo) ≠ 0]
Kendi diyalog kutusunu gösterin ["Hata"; "Dosya açılamadı"].
Geçerli koddan çık
End Eğer - Hata işleme adımlarını ekleyinBir hata tespit edilirse, sorunu çözmek veya kullanıcıyı bilgilendirmek için uygun adımları ekleyebilirsiniz. Bu, değişiklikleri geri almayı, bir hata günlüğü kaydetmeyi veya alternatif bir eylem önermeyi içerebilir.
Gelişmiş hata işleme
- Tekrar denemeleri için döngüleri kullanma: Bazı durumlarda, bir hata durumunda kod sonlandırılmadan önce birkaç deneme yapmak yararlı olabilir. Örnek:
Değişkeni ayarla [$Vtry; değer: 1]
Döngü
Dosyayı aç ["Database.fmp12"]
Eğer [Get(LastErrorNo) = 0]
Ne zaman döngüden çık [Get(LastErrorNo) = 0]
Aksi takdirde Eğer [$attempt ≥ 3]
Kendi diyalog kutusunu gösterin ["Hata"; "Dosya 3 denemeden sonra açılamadı"].
Geçerli koddan çık
End Eğer$attempt > 3] ise döngüden çıkın
Değişken ayarla [$attempt; değer: $attempt + 1]
Döngü sonuHata kaydıKarmaşık uygulamalarda, meydana gelen hataların ayrıntılarının kaydedildiği bir hata günlüğü tutmak yararlı olabilir. Bu, FileMaker veritabanınızdaki ayrı bir hata günlüğü tablosunda yapılabilir.
Örnek:
Eğer [Get(LastErrorNo) ≠ 0]Düzen'e gidin [Ad: "Hata günlüğü"]
Yeni veri kaydı/sorgusu
Alan değerini ayarla [ErrorLog::Date; Get( SystemTimestamp )]
Alan değerini ayarla [ErrorLog::ErrorCode; Get(LastErrorNo)]
Alan değerini ayarla [Hata log::User; Get( AccountName )]
Veri kaydını/sorgusunu kaydet [Diyalog ile: Kapalı]
End Eğer
Net ve tamamen belgelenmiş komut dosyası yapısı ve geliştirici modülü ile FileMaker ERP.
Daha fazla bilgi
Hata ayıklama ve komut dosyası dokümantasyonu
Hata ayıklamaya giriş
Komut dosyalarında hata ayıklama, komut dosyalarınızın doğru çalıştığından ve beklendiği gibi performans gösterdiğinden emin olmak için kritik bir adımdır. FileMaker'daki Komut Dosyası Çalışma Alanı, Komut Dosyası Hata Ayıklayıcı ve Veri Görüntüleyici işlevi gibi hata ayıklama için güçlü araçlar sağlar.
Kod hata ayıklayıcısını kullanma
- Kod hata ayıklayıcısını etkinleştirmeKod çalışma alanını açın ve kod hata ayıklayıcısını şu yolla başlatın Araçlar > Kod hata ayıklayıcı. Hata ayıklayıcı, kodunuzu adım adım gözden geçirmenize ve her bir değişkenin ve her bir kod adımının mevcut durumunu kontrol etmenize olanak tanır.
- Adım adım uygulamaKodunuzu adım adım yürütmek için kod hata ayıklayıcısındaki düğmeleri kullanın. Bu, tam olarak nerede hata oluştuğunu veya beklenmedik sonuçlar üretildiğini görmenizi sağlar.
- Kesme noktalarını ayarlamaBelirli bir noktada yürütmeyi durdurmak ve mevcut durumu kontrol etmek için kodunuzda kesme noktaları ayarlayabilirsiniz. Bu, özellikle kodunuzun karmaşık alanlarını analiz etmek için kullanışlıdır.
Veri Görüntüleyiciyi Kullanın
Veri Görüntüleyici, kodunuz çalışırken alanların, değişkenlerin ve hesaplamaların değerini gerçek zamanlı olarak gösterir. Bu, özellikle tek tek kod adımlarının verileriniz üzerindeki etkilerini gözlemlemek için kullanışlıdır.
- Açık Veri Görüntüleyici: Veri Görüntüleyici şu yolla açılabilir Araçlar > Veri Görüntüleyici açılabilir.
- İfadeleri izleyinKodun yürütülmesi sırasında değerlerini kontrol etmek için izlemek istediğiniz alanları veya değişkenleri ekleyin.
Komut dosyası belgeleri
Komut dosyalarınızın açık ve iyi yapılandırılmış dokümantasyonu, FileMaker çözümünüzün sürdürülebilirliğini ve anlaşılabilirliğini sağlamak için önemlidir. İyi bir dokümantasyon yalnızca kodun kendisindeki yorumları değil, aynı zamanda kodun açıklamasını, amacını ve kullanılan parametreleri de içerir.
- Senaryonuz hakkında yorum yapın: Kullanım
Yorumkomut dosyanızın her bölümünü belgelemek için komut dosyası çalışma alanında -fonksiyonu. Her bölümün ne yaptığını ve neden gerekli olduğunu açıklayın.örnek:# Bu kod dosyanın açılıp açılamayacağını kontrol eder ve açılamazsa bir hata mesajı verir. - Komut dosyası açıklaması ekleyin: Kod çalışma alanına kodun genel bir açıklamasını girin. Bu, sizin veya diğer geliştiricilerin komut dosyasının ne yaptığını hızlı bir şekilde anlamasına yardımcı olur.
- Sürüm kontrolünü yönetmeÖzellikle değişiklik yaptığınızda, senaryolarınızın farklı sürümlerinin kaydını tutun. Değişikliklerin ne zaman ve neden yapıldığını not edin.
gFM-Business Açık Kaynak FileMaker Basis-ERP
Çarpışma kursu için yazılım
Ücretsiz indirin
Birden fazla komut dosyası ile karmaşık iş akışları oluşturun
Karmaşık iş akışlarına giriş
Daha büyük FileMaker uygulamalarında, eksiksiz bir iş akışı uygulamak için genellikle birkaç komut dosyasının birlikte çalışması gerekir. Bu komut dosyaları birbiri ardına çalıştırılabilir veya karmaşık süreçleri eşleştirmek için koşullar ve tetikleyiciler aracılığıyla birbirine bağlanabilir.
Modül oluşturma komut dosyaları
- Modüllere ayırmaKarmaşık görevleri daha küçük, yeniden kullanılabilir modüllere ayırın. Bu modüllerin her biri belirli bir görevi yerine getirmelidir ve diğer komut dosyaları tarafından çağrılabilir, örneğin verileri doğrulayan bir komut dosyası modülü, bir rapor oluşturan başka bir modül ve raporu dışa aktaran başka bir modül.
- Kod parametrelerini kullanmaEsnek ve yeniden kullanılabilir hale getirmek için komut dosyaları arasında parametreler geçirin. Bu, örneğin bir komut dosyasını farklı girdi verileriyle farklı bağlamlarda kullanmanıza olanak tanır:
# Ana senaryoKomut dosyasını çalıştır
Eğer [Get(ScriptParameter) = "Report"]
Komut dosyasını çalıştır ["Rapor oluştur"]
Aksi takdirde [Get(ScriptParameter) = "Validation"] ise
End Eğer - Çağrı senaryoları: Kullanım
Senaryo Gerçekleştir-Bir ana komut dosyası içinde diğer komut dosyalarını çağırmak için adımlar. Bu, birkaç adım ve modülden oluşan karmaşık iş akışları oluşturmayı mümkün kılar.
Hata işleme ve iş akışı yönetimi
- Karmaşık iş akışlarında hata izlemeBirden fazla komut dosyası içeren iş akışlarında, komut dosyaları arasında hata izlemeyi koordine etmek önemlidir. Hata kodlarının komut dosyaları arasında aktarıldığından ve ana komut dosyasının buna göre tepki verdiğinden emin olun.
- Geri alma stratejileriKritik iş akışlarında, bir hata oluştuğunda tüm değişikliklerin geri alındığı bir geri alma stratejisi uygulamak gerekebilir. Bu, alanları sıfırlayarak veya yeni oluşturulan veri kayıtlarını silerek gerçekleştirilebilir.
Optimizasyon ve performans
- Komut dosyalarını optimize edinGereksiz adımlardan kaçınarak ve veritabanı sorgularının sayısını en aza indirerek komut dosyalarınızın mümkün olduğunca verimli bir şekilde yürütülmesini sağlayın.
- Yükleme sürelerini en aza indirinBüyük miktarda veri veya karmaşık hesaplamalarla çalışırken, yükleme sürelerinin en aza indirildiğinden emin olmalısınız. İndeksler, optimize edilmiş sorgular ve yalın düzenler kullanın.
FileMaker'da kısmi komut dosyalarının ve komut dosyası parametrelerinin kullanımı
FileMaker'da şunları yapabilirsiniz Kısmi senaryolar ve Komut dosyası parametreleri komut dosyalarının verimliliğini ve yeniden kullanılabilirliğini en üst düzeye çıkarmak için kullanılabilir. Kısmi senaryolar yinelenen görevleri gerçekleştirmek için diğer komut dosyaları tarafından çağrılan daha küçük, özel komut dosyalarıdır. Bu, kodun daha iyi yapılandırılmasını sağlar ve bir alt komut dosyasında yapılan değişiklikler otomatik olarak çağıran tüm ana komut dosyalarında etkili olduğundan bakımı kolaylaştırır. Komut dosyası parametreleri farklı komut dosyaları arasında bilgi aktarımını mümkün kılarak komut dosyası çağrılarının esnekliğini ve dinamiğini artırır.
Örnek: Kısmi komut dosyalarının ve komut dosyası parametrelerinin kullanımı
Sık tekrarlanan bir öğeyi kullanmak istediğimizi varsayalım, örneğin Yeni bir veri kaydı oluşturma ve bu veri setine bilgi aktarımını birden fazla komut dosyası arasında yeniden kullanın.
1. ana senaryo: Kısmi bir komut dosyası çağırma
Ana kodda yeni veri kaydını oluşturan kısmi bir kod çağrılır. A Komut dosyası parametreleri kısmi komut dosyasına aktarılacak verileri göndermek için kullanılır:
# Ana komut dosyası: "Yeni müşteri oluştur"Değişkeni ayarla [1TP4Customer name; değer: "Max Mustermann"]
Değişkeni ayarla [$customer number; değer: "12345"]
# Aktarılan parametrelerle kısmi komut dosyasının çağrılması
Script Gerçekleştir ["Müşteri sistemi"; Parametre: JSONSetElement ( "{}" ; ["name"; 1TP4CustomerName; JSONString]; ["number"; 1TP4CustomerNumber; JSONString] )]Bu örnekte, "Müşteri oluşturma" alt komut dosyası çağrılır. Müşteri adı ve müşteri numarası bilgileri JSON formatında kod parametreleri olarak aktarılır. Bu, birkaç veri noktasının tek bir parametrede aktarılabilmesi avantajını sunar.
2. alt simge: Kod parametrelerinin işlenmesi
"Müşteri oluşturma" alt komut dosyası, komut dosyası parametresini alır, bilgileri çıkarır ve aktarılan verilere göre yeni bir veri kaydı oluşturur:
# Kısmi senaryo: "Müşteri kurulumu"
Değişkeni ayarla [$param; Değer: Get ( ScriptParameter )]
# JSON parametresinden veri çıkarma
Değişken ayarla [$name; Değer: JSONGetElement ($param; "name")]
Değişken ayarla [$number; Değer: JSONGetElement ($param; "nummer")]
# Aktarılan değerlere dayalı yeni veri kaydı
Yeni veri kaydı/sorgusu
Alan değerini ayarla [Customer::Name; $name]
Alan değerini ayarla [Customer::Number; $number]Bu alt komut dosyasında, aktarılan JSON parametresi şu şekilde analiz edilir JSONGetElement işlenmiştir. Değişkenler $name ve $numarası çıkarılır ve yeni veri kaydının ilgili alanlarına girilir.
Birden fazla kod parametresi geçirme
FileMaker'da çeşitli kod parametreleri farklı şekillerde geçirilebilir. Yaygın bir yöntem, parametreleri Liste ve daha sonra fonksiyon ile iletmek için GetValue() ayrı ayrı. Alternatif olarak, gFM-Business'ta parametrelerin üst simgelerle ayrıldığı bir yöntem kullanılabilir (|) ayrılır. Bu değerler daha sonra "StringColumns" tekrar bölünür ve ayrı ayrı işlenir. Bu yaklaşımlar, daha sonra ilgili komut dosyalarında daha fazla işlenebilecek çeşitli parametrelerin esnek ve yapılandırılmış bir şekilde aktarılmasını sağlar.
Kısmi komut dosyalarının ve komut dosyası parametrelerinin avantajları
- Yeniden KullanılabilirlikAlt komut dosyaları birkaç komut dosyası tarafından çağrılabilir, bu da kodu modüler ve bakımı kolay hale getirir. Bir alt komut dosyasındaki değişikliklerin yalnızca bir kez yapılması gerekir ve çağıran tüm komut dosyalarını etkiler.
- EsneklikKomut dosyası parametreleri, alt komut dosyalarına dinamik bilgi aktarmak için kullanılabilir, bu da komut dosyalarını daha esnek hale getirir. JSON parametrelerinin kullanımı, karmaşık veri yapılarının tek bir parametrede aktarılmasını mümkün kılar.
- Netlik ve yapıKomut dosyalarını daha küçük alt komut dosyalarına bölerek, kod daha net ve daha iyi yapılandırılmış hale gelir. Bu sadece geliştirmeyi değil, aynı zamanda hata ayıklamayı da kolaylaştırır.
FileMaker ve gFM-Business ERP için ipuçları, talimatlar ve arayüzler
İpuçları ve talimatlar
Gelişmiş komut dosyası işlevleri hakkında sıkça sorulan sorular
- FileMaker'da komut dosyalarında hata olup olmadığını nasıl kontrol edebilirim ve bunları nasıl düzeltebilirim?
- FileMaker'da, standart hata mesajlarının görüntülenmesini engelleyen "Set Error Logging" komutunu kullanarak hata işlemeyi kontrol edebilirsiniz. Daha sonra hata durumunu kontrol etmek ve hata koduna göre uygun eylemleri tanımlamak için "Get(LastErrorNo)" komutunu kullanabilirsiniz. Bu, alternatif kod yollarının yürütülmesini veya kullanıcıları bilgilendirmek için özelleştirilmiş hata mesajlarının görüntülenmesini mümkün kılar.
- FileMaker'da komut dosyalarının hata ayıklaması nasıl çalışır?
- FileMaker Pro'daki Script Debugger aracı, komut dosyalarını adım adım gözden geçirmenizi sağlar. Bir komut dosyasının ilerlemesini gerçek zamanlı olarak izleyebilir, kesme noktaları ayarlayabilir ve değişkenlerin ve alanların mevcut durumunu kontrol edebilirsiniz. Bu, hataları hızlı bir şekilde bulmanızı ve düzeltmenizi sağlar. Hata ayıklayıcıyı "Araçlar" > "Kod Hata Ayıklayıcı" menüsünden başlatabilirsiniz.
- Bir araç menüsü göremiyorum, nasıl etkinleştirebilirim?
- Menü çubuğunda bir araç menüsü bulamazsanız, FileMaker tercihlerine gidin ("FileMaker Pro" altında Mac, "Düzenle" altında Windows) ve ilk sekme olan "Genel "de "Gelişmiş araçları kullan" seçeneğini seçin. Diyaloğu onaylayın ve FileMaker Pro'yu bir kez yeniden başlatın.
- FileMaker'da birden fazla komut dosyasını nasıl bağlayabilirim?
- FileMaker'da, başka bir komut dosyasını çağırmak için "Komut Dosyasını Çalıştır" komutunu kullanarak birden fazla komut dosyasını birbirine bağlayabilirsiniz. Bu, karmaşık süreçleri birlikte çalışan daha küçük, daha yönetilebilir komut dosyalarına bölmenize olanak tanır. Komut dosyalarını alt komut dosyalarına bölerek, belirli görevleri yeniden kullanabilir ve komut dosyası çözümlerinizin sürdürülebilirliğini artırabilirsiniz.
- Kısmi komut dosyaları nedir ve bunları ne zaman kullanmalıyım?
- Alt komut dosyaları, daha büyük bir komut dosyasının parçası olarak çağrılan daha küçük, özel komut dosyalarıdır. Yeni veri kümeleri oluşturma veya düzenler arasında gezinme gibi yinelenen görevleri kapsüllemek için kullanışlıdırlar. Kısmi komut dosyaları, komut dosyalarınızda temiz ve modüler bir yapıyı teşvik eder, bu da bakımı kolaylaştırır. Bir işlem sık kullanılıyorsa, bunu bir alt komut dosyasına dış kaynak olarak kullanmalı ve diğer komut dosyalarından çağırmalısınız.
- FileMaker'da kod parametrelerini nasıl kullanırım?
- Kod parametreleri, bir koddan diğerine veri aktarmanıza olanak tanır. Bir komut dosyasını çağırırken, "Execute script" komutunu kullanarak ve parametreleri belirterek komut dosyasına bir veya daha fazla parametre aktarabilirsiniz. Kod içinde, parametreleri "Get(ScriptParameter)" komutuyla alabilir ve kullanabilirsiniz. Bu, çağrılan kodun hangi eylemleri yürüteceğini dinamik olarak kontrol etmek için kullanışlıdır.
- Birden fazla kod parametresini nasıl geçirebilirim?
- Birden fazla kod parametresi aktarmak için bunları bir liste veya JSON biçiminde özetleyebilirsiniz. Parametreleri satır sonlarıyla ayrılmış bir liste halinde aktarmak için "List()" fonksiyonunu kullanabilir ve GetValue("Get (ScriptParameter)"; number) fonksiyonunu kullanarak bunları kod içinde alabilirsiniz. Sayı, x'inci kod parametresini tanımlar. Alternatif olarak, parametreleri yapılandırılmış bir biçimde aktarmak için JSON kullanabilir ve ardından belirli parametrelere erişmek için "JSONGetElement" gibi fonksiyonları kullanabilirsiniz.
- gFM-Business çeşitli kod parametreleri için parametreleri kesme işareti "|" ile ayıran "StringColumns" fonksiyonunu kullanır. Bu prosedür, geçirilen parametrelerin satır ayrımları da içerebilmesi avantajına sahiptir.
- Komut dosyalarındaki global değişkenleri nasıl yönetirim?
- Global değişkenler ($$ ile başlayan), kod tamamlandıktan sonra bile tüm oturum boyunca erişilebilen verileri depolar. Bir komut dosyasında "Değişken Ayarla" komutuyla global değişkenleri tanımlayabilir ve değerlerini istediğiniz zaman alabilir veya değiştirebilirsiniz. Bunlar özellikle farklı kodlar veya düzenler arasında veri paylaşımı için kullanışlıdır. Ancak, dosya kapatılana kadar kalıcı olduklarından, istenmeyen müdahaleleri önlemek için global değişkenler dikkatli kullanılmalıdır.
- FileMaker komut dosyalarında yerel değişkenler nasıl çalışır?
- Yerel değişkenler ($ ile başlayan) yalnızca bir kodun çalışma süresi boyunca geçerlidir. Genellikle yalnızca belirli bir kodda veya alt adımda gerekli olan verileri geçici olarak depolamak için kullanılırlar. Kod biter bitmez yerel değişken silinir. Yerel değişkenler, hesaplama sonuçlarını veya ara değerleri tüm oturumda kalmadan kaydetmek için çok uygundur.
- Bir komut dosyasında koşulları nasıl etkili bir şekilde kullanabilirim?
- Bir kodun akışını belirli kriterlere göre kontrol etmek için "Eğer" koşullarını kullanabilirsiniz. Bir koşulun yerine getirilip getirilmediğini kontrol edebilir ve sonuca bağlı olarak farklı eylemler yürütebilirsiniz. Tipik bir örnek, yeni bir veri kaydı oluşturulmadan önce bir alanın boş olup olmadığını kontrol eden bir koşul olabilir. Daha karmaşık durumlarda, birden fazla koşulu kontrol etmek için iç içe geçmiş if koşulları veya if/else senaryoları da kullanabilirsiniz; bunun için "Else if" komutu kullanılabilir.
- Verileri işlemek için komut dosyalarında tekrarları ve döngüleri nasıl kullanabilirim?
- Döngüler, belirli bir koşul karşılanana kadar bir dizi eylemi tekrarlamanızı sağlar. Tipik bir örnek, bir arama sonucundaki tüm veri kayıtlarını taramak ve belirli bir alanı güncellemek olabilir. Döngüyü "Loop" komutuyla başlatır ve istenen koşul karşılandığında, örneğin son veri kaydına ulaşıldığında "Exit loop when" ile sonlandırırsınız.
- Komut dosyalarını ve kısmi komut dosyalarını nasıl modüler ve yeniden kullanılabilir hale getirebilirim?
- Kodları modüler ve yeniden kullanılabilir hale getirmek için genel süreçleri alt kodlara devretmeli ve süreci dinamik olarak kontrol etmek için kod parametrelerini kullanmalısınız. Bu, fazlalıkları azaltır ve komut dosyalarını farklı bağlamlarda yeniden kullanmanıza olanak tanır. Ayrıca, her seferinde yeni kodlar oluşturmak zorunda kalmadan bir kod içinde veya kodlar arasında veri aktarmak için global ve yerel değişkenleri verimli bir şekilde kullanabilirsiniz. Gerekirse, "Get(ScriptResult)" işlevini kullanarak okuyabileceğiniz birkaç kod parametresini bir koddan başka bir koda da aktarabilirsiniz.
