Dreamweaver'da ColdFusion bileşenleri kullanma
ColdFusion bileşenleri hakkında
Bileşenler paneline genel bakış (ColdFusion)
Dreamweaver'da bir CFC oluşturma veya silme
CFC'leri Dreamweaver'da görüntüleme
CFC'leri Dreamweaver'da düzenleme
CFC'ler kullanan web sayfaları oluşturma
CFC'de bir kayıt kümesi tanımlama
CFC kayıt kümesini dinamik içerik kaynağı olarak kullanma
CFC kullanarak dinamik içerik tanımlama
Dreamweaver CC ve sonraki sürümlerinde ColdFusion desteği kaldırılmıştır.
ColdFusion bileşeni (CFC) dosyaları uygulama ve ticaret mantığınızı kendi kendine yeterli, yeniden kullanılabilir birimler halinde kapsüllemenizi sağlar. CFC'ler ayrıca web servisleri oluşturmanın hızlı ve kolay bir yolunu sunar.
Bir CFC, ColdFusion işaretleme dilinde (CFML) yazılmış, böylece kodunuzu yeniden kullanmayı ve bakımını yapmayı kolaylaştıran yeniden kullanılabilir bir yazılımdır.
Dreamweaver uygulamasını CFC'ler ile çalışmak için kullanabilirsiniz. CFC etiketleri ve sözdizimi hakkında daha fazla bilgi için Dreamweaver içinden ColdFusion belgelerine bakın (Yardım > ColdFusion Uygulamasını Kullanma).
CFC'leri yalnızca ColdFusion MX veya daha sonrası ile kullanabilirsiniz. CFC'ler ColdFusion 5'te desteklenmez.
CFC'ler geliştiricilere web sitelerinin öğelerini kapsüllemek için basit ama güçlü bir yol sunma amacını taşımaktadır. Genel olarak bileşenleri uygulama veya ticaret mantığı için kullanmalısınız. Özel selamlama biçimleri, dinamik menüler vs. gibi özelleştirilmiş sunum öğeleri için özel etiketler kullanın.
Başka tür kurma biçimlerinde olduğu gibi dinamik siteler, bileşenlerinin başkalarıyla değiştirilebilir olmasından yarar sağlar. Örneğin dinamik bir site aynı sorguyu tekrar tekrar çalıştırabilir veya alışveriş sepeti sayfalarının toplam fiyatını hesaplayıp her seferinde yeni bir kalem eklendiğinde bunu yeniden hesaplayabilir. Bu işlemler bileşenler tarafından yapılabilir. Bir bileşeni, uygulamanın geri kalanını en az derecede etkileyerek onarabilir, iyileştirebilir, genişletebilir veya topyekun değiştirebilirsiniz.
Çevrimiçi bir mağazanın nakliye ücretlerini siparişlerin fiyatını esas alarak hesapladığını varsayalım. 20$'ın altındaki siparişlerde nakliye ücreti 4$ olsun; 20$ ile 40$ arası 6$ vs. Nakliye ücretini hesaplama mantığını hem alışveriş sepeti sayfasına hem de kasaya ödeme sayfasına ekleyebilirsiniz, ancak bu HTML sunum kodu ile CFML mantığı kodunu iç içe geçirir; kodun bakımını ve yeniden kullanılmasını güçleştirir.
İçinde ShippingCharge adlı bir işlev olan Pricing (fiyatlandırma) adında bir CFC oluşturmaya karar verirsiniz. Fonksiyon, fiyatı bağımsız değişken olarak ele alır ve nakliye ücretini döndürür. Örneğin bağımsız değişkenin değeri 32,80 olsa işlev 6 döndürmektedir.
Hem alışveriş sepeti hem de kasaya ödeme sayfasında ShippingCharge işlevini çağırmak için özel bir etiket eklersiniz. Sayfa istendiğinde işlev çağrılır ve bir nakliye ücreti sayfaya döndürülür.
Daha sonra, mağaza özel bir promosyon ilan eder: 100$'ın üzerindeki tüm siparişler için ücretsiz nakliye. Nakliye fiyatlarındaki değişikliği tek bir yerde (Pricing bileşeninin ShippingCharge işlevinde) yaparsınız ve işlevi kullanan tüm sayfalar yeni nakliye fiyatlarını doğru biçimde alır.
ColdFusion bileşenlerini görmek ve düzenlemek için Bileşenler panelini (Pencere > Bileşenler) kullanın ve CFM sayfası istendiğinde işlevi çağıran sayfaya kod ekleyin.
Bileşenler paneli yalnızca Dreamweaver içinden bir ColdFusion sayfasına bakılırken kullanılabilir.
Dreamweaver uygulamasını bir CFC'yi ve onun işlevlerini görsel olarak tanımlamak için kullanabilirsiniz. Dreamweaver bir .cfc dosyası oluşturur ve gerekli CFML etiketlerini sizin yerinize ekler.
Bileşene bağlı olarak kodun bir kısmını elinizle tamamlamanız gerekebilir.
Dreamweaver içinde bir ColdFusion sayfası açın.
Bileşenler panelinde (Pencere > Bileşenler) açılır menüden CF Bileşenleri'ni seçin.
Artı (+) düğmesini tıklatıp Bileşen Oluştur iletişim kutusunu tamamlayın ve Tamam'ı tıklatın.
a.Bileşenler kısmında bileşenlerin ayrıntılarını girin. Kısmi bir liste:
Ad Bileşenin dosya adını belirtir. Ad yalnızca alfasayısal karakterler ve alt çizgi (_) içermelidir. Adı girerken .cfc dosya uzantısını belirtmeyin.
Bileşen Dizini Bileşenin kaydedildiği yeri belirtir. Web uygulamasının kök klasörünü (örneğin \Inetpub\wwwroot\myapp\) veya alt klasörlerinden birini seçin.
b.Bileşende bir veya birkaç işlev tanımlamak için Kısım listesinden İşlevler'i seçin, Artı (+) düğmesini tıklatın ve yeni işlevin ayrıntılarını girin.
Döndürme Türü seçeneğinde işlev tarafından döndürülen değerin türünü belirtmeyi unutmayın.
Erişim menüsünden uzağı seçerseniz, işlev bir web servisi olarak kullanılabilir hale gelir.
c.Bir işleve bir veya daha fazla bağımsız değişken tanımlamak için Kısım listesinden Bağımsız Değişkenler'i seçin, açılır menüden işlevi seçin, Artı (+) düğmesini tıklatın ve sağa yeni bağımsız değişkenin ayrıntılarını girin.
Uzak bir geliştirme sunucusu kullanıyorsanız, CFC dosyasını ve tüm bağımsız dosyaları (örneğin bir işlevi gerçekleştirmek için kullanılan dosyaları veya dahil edilen dosyaları) uzak sunucuya yükleyin.
Dosyaları karşıya yüklemek Canlı görünüm ve Tarayıcıda Önizleme gibi Dreamweaver özelliklerinin düzgün çalışmasını sağlar.
Dreamweaver bir CFC dosyasını yazar ve belirttiğiniz klasöre kaydeder. Yeni bileşen ayrıca Bileşenler panelinde görünür (Yenile'yi tıklattıktan sonra).
Dreamweaver, site klasörünüzde veya sunucuda bulunan ColdFusion bileşenlerini (CFC'ler) topluca görsel olarak incelemek için bir yol sunar. Dreamweaver, CFC dosyalarını okur ve Bileşenler panelinde kolayca gezinilebilen bir ağaç görünümünde bu dosyalarla ilgili bilgileri görüntüler.
Dreamweaver bileşenleri test sunucunuzda arar (bkz. Dreamweaver uygulamasında veritabanına bağlanma). CFC'ler oluşturur veya varolan CFC'lerde değişiklik yaparsanız CFC dosyalarını, Bileşenler panelinde doğru olarak yansıtılması için test sunucusuna yüklemeyi unutmayın.
Başka bir sunucuda bulunan bileşenleri görmek için test sunucusu ayarlarını değiştirin.
CF bileşenleri hakkında aşağıdaki bilgileri görüntüleyebilirsiniz:
Sunucuda tanımlı ColdFusion bileşenlerini listeleyin.
ColdFusion MX 7 veya daha yenisini çalıştırıyorsanız, listeyi yalnızca site klasörünüzde bulunan CFC'leri gösterecek şekilde filtreleyin.
Her bileşenin işlevlerini ve bağımsız değişkenlerini öğrenin.
Web servisi olarak iş gören işlevlerin özelliklerini inceleyin.
Dreamweaver'ı, sunucu kökünde duran CFC'leri incelerken bir yandan da başka bir web sitesi kökündeki site dosyalarınızı yönetmek üzere kullanmak için iki Dreamweaver sitesi tanımlayabilirsiniz. İlk siteyi sunucu köküne, ikincisini ise web sitesi köküne işaret edecek şekilde ayarlayın. İki site arasında çabucak geçiş yapmak için Dosyalar panelindeki site açılır menüsünü kullanın.
Dreamweaver içinde CFC'leri görüntülemek için aşağıdaki adımları izleyin:
Dreamweaver içinde herhangi bir ColdFusion sayfası açın.
Bileşenleri almak için panelde Yenile düğmesini tıklatın.
Bileşenler paketi sunucuda gösterilir. Bileşen paketi CFC dosyaları içeren bir klasördür.
Varolan bileşen paketleri görünmezse, panel araç çubuğundaki Yenile düğmesini tıklatın.
Yalnızca site klasörünüzde bulunan CFC'leri görüntülemek için Bileşenler panelindeki Yalnızca Geçerli Sitenin CFC'lerini Göster düğmesini tıklatın.
Bu özellik yalnızca, Dreamweaver test sunucusu olarak ColdFusion MX 6 veya daha yenisini çalıştıran bir bilgisayar tanımladıysanız kullanılabilir.
Geçerli site uzak bir sunucuda sanal bir klasör olarak listeleniyorsa filtreleme çalışmaz.
Pakette depolanan bileşenleri görmek için paket adının yanındaki Artı (+) düğmesini tıklatın.
Bir bileşenin işlevlerini listelemek için bileşen adının yanındaki Artı (+) düğmesini tıklatın.
Bir işlevin aldığı bağımsız değişkenleri, bu değişkenlerin türünü, zorunlu mu yoksa isteğe bağlı mı olduklarını görmek için ağaç görünümünde işlevin dalını açın.
Hiçbir bağımsız değişkeni olmayan işlevlerin yanında Artı (+) düğmesi olmaz.
Bir bağımsız değişkenin, işlevin, bileşenin veya paketin ayrıntılarını görmek için, onu ağaç görünümünde seçin ve panel araç çubuğundaki Ayrıntıları Al düğmesini tıklatın.
Ayrıca öğeyi sağ tıklatabilir (Windows) veya Control tuşu basılıyken tıklatabilir (Macintosh) ve açılır menüden Ayrıntıları Al'ı seçebilirsiniz.
Öğenin ayrıntıları bir mesaj kutusunda gösterilir.
Dreamweaver, siteniz için tanımlı ColdFusion bileşenlerinin kodunu düzenlemenin daha verimli bir yolunu sunar. Örneğin herhangi bir bileşen işlevini Dreamweaver'dan çıkmadan ekleyebilir, değiştirebilir veya silebilirsiniz.
Bu özelliği kullanmak için geliştirme ortamınız şu şekilde kurulmalıdır:
ColdFusion'ın yerel olarak çalışıyor olması gerekir.
Dreamweaver içindeki gelişmiş Site Tanımı iletişim kutusunda, Test Sunucusu kategorisinde tanımlı Erişim türü Yerel/Ağ olmalıdır.
Gelişmiş Site Tanımı iletişim kutusunda yerel kök klasörünüzün yolu test sunucusu klasörünün yolu ile aynı olmalıdır (örneğin c:\Inetpub\wwwroot\cf_projects\myNewApp\). Bu yolları Site > Siteleri Düzenle'yi seçerek inceleyip değiştirebilirsiniz.
Bileşenin sabit diskinizdeki yerel site klasöründe veya alt klasörlerinden birinde saklanıyor olması gerekir.
Dreamweaver içinde herhangi bir ColdFusion sayfasını açın ve bileşenleri Bileşenler panelinde gösterin. Bileşenleri göstermek için Bileşenler panelini açın (Pencere > Bileşenler), panelin açılır menüsünden CF Bileşenleri'ni seçin ve paneldeki Yenile düğmesini tıklatın.
ColdFusion yerel olarak çalıştığından, Dreamweaver sabit diskinizdeki bileşen paketlerini gösterir.
Bileşen düzenlemek için aşağıdaki yordamı kullanın.
Dreamweaver içinde herhangi bir ColdFusion sayfasını açın ve bileşenleri Bileşenler panelinde (Pencere > Bileşenler) gösterin.
Panelin açılır menüsünden CF Bileşenleri'ni seçin ve paneldeki Yenile düğmesini tıklatın.
CFC kayıt kümesini görsel olarak düzenlemek için Veri Bağlantıları panelini çift tıklatın.
Bir bileşeni genel olarak düzenlemek için paketi açın ve bileşen adını ağaç görünümünde çift tıklatın.
Bileşenin dosyası Kod görünümünde açılır.
Belirli bir işlevi, bağımsız değişkeni veya özelliği düzenlemek için, onu ağaç görünümünde çift tıklatın.
Değişikliklerinizi el ile Kod görünümünde yapın.
Dosyayı kaydedin (Dosya > Kaydet).
Bileşenler panelinde yeni bir işlev görmek için panel araç çubuğundaki Yenile düğmesini tıklatarak görünümü yenileyin.
Web sayfalarınızda bileşen işlevi kullanmanın bir yolu, kodu, sayfa istendiğinde işlevi çağıran sayfaya yazmaktır. Bu kodu yazmanıza yardımcı olması için Dreamweaver uygulamasını kullanabilirsiniz.
Bileşen kullanmanın başka yolları için Dreamweaver içinden ColdFusion belgelerine bakın (Yardım > ColdFusion Uygulamasını Kullanma).
Dreamweaver uygulamasında bileşen işlevini kullanacak ColdFusion sayfasını açın.
Bileşenler panelini açın (Pencere > Bileşenler) ve panelin açılır menüsünden CF Bileşenleri'ni seçin.
İstediğiniz bileşeni bulun ve aşağıdaki tekniklerden birini kullanarak ekleyin:
Ağaç görünümünden sayfaya bir işlev sürükleyin. Sayfaya işlevi çağırmak için kod eklenir.
Fonksiyonu panelde seçin ve panel araç çubuğunda Ekle düğmesini (sağdaki ikinci düğme) tıklatın. Dreamweaver kodu, ekleme noktasının olduğu yerde sayfanıza ekler.
Bağımsız değişkenleri olan bir işlev eklerseniz bağımsız değişken kodunu el ile tamamlayın.
Daha fazla bilgi için Dreamweaver içinden ColdFusion belgelerine bakın (Yardım > ColdFusion Uygulamasını Kullanma).
Sayfayı kaydedin (Dosya > Kaydet).
Dreamweaver bir ColdFusion bileşeninde (CFC) kayıt kümesi (ColdFusion sorgusu olarak da bilinir) tanımlamanıza yardımcı olur. CFC'de bir kayıt kümesi tanımlayarak kayıt kümesini, onu kullanan her sayfa için tanımlamanız gerekmez. Kayıt kümesini CFC'de bir kez tanımlar ve CFC'yi farklı sayfalarda kullanırsınız.
Bu özellik yalnızca ColdFusion MX 7 veya daha yenisini çalıştıran bir bilgisayara erişiminiz varsa kullanılabilir. Daha fazla bilgi için bkz. ColdFusion geliştirmelerini etkinleştirme.
Dreamweaver içinde bir CFC dosyası oluşturun veya varolan bir CFC dosyasını açın.
Veri Bağlantıları panelinde (Pencere > Veri Bağlantıları) Artı (+) düğmesini tıklatın ve açılır menüden Kayıt Kümesi (Sorgu) seçeneğini belirleyin.
Kayıt Kümesi iletişim kutusu görünür. İster basit ister gelişmiş Kayıt Kümesi iletişim kutularında çalışabilirsiniz.
CFC'deki varolan işlevi kullanmak için işlevi, İşlev açılır menüsünden seçin ve 5. adıma atlayın.
Kayıt kümesi işlevde tanımlanır.
CFC'de yeni bir işlev tanımlamak için Yeni İşlev düğmesini tıklatın, açılan iletişim kutusunda işlev için bir ad girin, sonra Tamam'ı tıklatın.
Ad yalnızca alfasayısal karakterler ve alt çizgi (_) içermelidir.
Fonksiyona bir kayıt kümesi tanımlamak için, Kayıt Kümesi iletişim kutusu seçeneklerini tamamlayın.
Yeni işlev kayıt kümesini tanımlayan CFC'ye eklenir.
Bir ColdFusion bileşenini (CFC), bileşende bir kayıt kümesi tanımlayan bir işlev varsa sayfalarınız için dinamik veri kaynağı olarak kullanabilirsiniz.
Bu özellik yalnızca ColdFusion MX 7 veya daha yenisini çalıştıran bir bilgisayara erişiminiz varsa kullanılabilir. Daha fazla bilgi için bkz. ColdFusion iyileştirmelerini etkinleştirme.
Kayıt Kümesi iletişim kutusu görünür. İster basit ister gelişmiş Kayıt Kümesi iletişim kutusunda çalışabilirsiniz.
CFC Sorgusu düğmesini tıklatın.
CFC sorgusu iletişim kutusunu tamamlayın, Tamam'ı tıklatın, CFC kayıt kümesini Veri Bağlantıları panelinde kullanılabilir içerik kaynakları listesine eklemek için tekrar Tamam'ı tıklatın.
Kayıt kümesini çeşitli sayfa öğeleri ile bağlamak için Veri Bağlantıları panelini kullanın.
Daha fazla bilgi için bkz. Sayfalara dinamik içerik ekleme.
Bir kayıt kümesini Dreamweaver uygulamasında, bir kayıt kümesi tanımı içeren bir CFC kullanarak dinamik içerik kaynağı olarak tanımlayabilirsiniz.
1.Ad kutusuna CFC kayıt kümesinin adını girin.
Kayıt kümesi adlarını koddaki diğer nesne adlarından ayırt etmek için bunlara rs önekini eklemek sık başvurulan bir uygulamadır (Örneğin rsPressRelease).
Kayıt kümesi adları yalnızca alfasayısal karakterler ve alt çizgi (_) içermelidir. Özel karakter veya boşluklar kullanamazsınız.
2.Daha önce sunucuda tanımlanmış paketlerden birini seçin.
Paket açılır menüde görünmezse, paket listesini açılır menünün yanındaki Yenile düğmesini tıklatarak yenileyebilirsiniz.
CFC'lerinizi önce test sunucusuna yüklediğinizden emin olun. Yalnızca test sunucusundaki CFC'ler gösterilir.
3.O anda seçili olan pakette tanımlı bileşenlerden birini seçin.
Bileşen açılır menüsünde hiçbir bileşen yoksa veya daha önce oluşturduğunuz bileşenlerden hiçbiri menüde görünmüyorsa, CFC dosyalarını test sunucusuna yüklemeniz gerekir.
4.(İsteğe bağlı) Bileşen oluşturmak için Yeni Bileşen Oluştur düğmesini tıklatın.
a.Ad kutusuna yeni CFC için ad girin. Ad yalnızca alfasayısal karakterler ve alt çizgi (_) içermelidir.
b.Bileşen Dizini kutusuna CFC'nizin konumunu girin veya klasörü bulmak için göz atın.
Klasörün, site kök klasörüne göreceli yol olması gerekir.
5.İşlev açılır menüsünden kayıt kümesi tanımını içeren işlevi seçin.
Fonksiyon açılır menüsünde yalnızca o anda seçili olan belgedeki tanımlı işlevler bulunur. Açılır menüde hiçbir işlev görünmezse veya son değişiklikleriniz o anda listelenen işlevlere yansıtılmıyorsa, son değişikliklerinizin kaydedilip sunucuya yüklendiğinden emin olun.
Bağlantı ve SQL kutuları salt okunurdur.
6.Düzenle düğmesini tıklatarak işlev bağımsız değişkeni olarak geçilmesi gereken her parametreyi (tür, değer ve varsayılan değer) düzenleyin.
a.Geçerli parametre için, Değer açılır menüsünden değer türünü seçip sağdaki kutuya yazarak bir değer girin. Değer türü bir URL parametresi, bir form değişkeni, bir tanımlama bilgisi, bir oturum değişkeni, bir uygulama değişkeni veya girilen bir değer olabilir.
b.Parametre için Varsayılan Değer kutusuna bir varsayılan değer girin. Hiçbir çalışma zamanı değeri dönmezse, varsayılan parametre değeri kullanılır.
Veritabanı bağlantısını ve kayıt kümesinin SQL sorgusunu değiştiremezsiniz. Bu alanlar daima devre dışıdır; bağlantı ve SQL sorgusu sadece bilgi için gösterilir.
7.Veritabanına bağlanmak için Test'i tıklatın ve kayıt kümesinin bir örneğini oluşturun.
SQL deyimi sayfa parametreleri içeriyorsa, Test düğmesini tıklatmadan önce Parametreler kutusunun Varsayılan Değer sütununun geçerli test değerleri içerdiğinden emin olun.
Sorgu başarıyla yürütüldüyse bir tablo kayıt kümesini gösterir. Her satır bir kayıt içerir ve her sütun o kayıttaki bir alanı temsil eder.
CFC Sorgusunu temizlemek için Tamam'ı tıklatın.