Otevřete stránku ColdFusion v aplikaci Dreamweaver.
Naposledy aktualizováno
25. 4. 2024
Poznámka
Podpora pro ColdFusion je v aplikaci Dreamweaver a novějších verzích odstraněna.
O komponentách ColdFusion
Soubory komponent ColdFusion (CFC) umožňují zapouzdřit logiku aplikace a obchodní logiku do samostatných, znovu použitelných jednotek.CFC také poskytují rychlý a snadný způsob vytváření webových služeb.
CFC je znovupoužitelná softwarová jednotka napsaná v jazyce ColdFusion Markup Language (CFML), což usnadňuje opětovné použití a údržbu kódu.
Aplikace Dreamweaver umožňuje práci s komponentami CFC. Informace o CFC značkách a syntaxi naleznete v dokumentaci ColdFusion v aplikaci Dreamweaver (Nápověda > Používání ColdFusion).
Poznámka
CFC můžete používat jen s verzí ColdFusion MX nebo novější verzí. CFC nejsou podporovány v ColdFusion 5.
CFC mají poskytovat jednoduchý, ale výkonný způsob, jak vývojáři mohou zapouzdřit prvky svých webových stránek.Obecně byste měli používat komponenty pro aplikační nebo obchodní logiku.Používejte vlastní značky pro prezentační prvky, jako jsou přizpůsobené pozdrvy, dynamické nabídky a podobně.
Stejně jako u mnoha dalších typů konstrukcí mohou dynamické weby často těžit ze zaměnitelných částí. Například dynamický web může opakovaně spouštět stejný dotaz nebo vypočítat celkovou cenu stránek nákupního košíku a přepočítávat ji pokaždé, když je přidána položka.Tyto úkoly mohou být prováděny komponentami. Můžete opravit, vylepšit, rozšířit a dokonce nahradit komponentu s minimálním dopadem na zbytek aplikace.
Předpokládejme, že online obchod počítá poštovné na základě ceny objednávek. U objednávek do 20 $ je poštovné 4 $; u objednávek mezi 20 $ a 40 $ je poštovné 6 $ a tak dále.Mohli byste vložit logiku pro výpočet poštovného na stránku nákupního košíku i na stránku pokladny, ale to by smísilo HTML prezentační kód a CFML logický kód a obecně by to učinilo kód obtížně udržovatelný a znovu použitelný.
Rozhodnete se vytvořit CFC s názvem Pricing, které má mimo jiné funkci s názvem ShippingCharge.Funkce přijímá cenu jako argument a vrací poštovné. Například, pokud je hodnota argumentu 32,80, funkce vrátí 6.
Na stránku nákupního košíku i na stránku pokladny vložíte speciální značku pro vyvolání funkce ShippingCharge. Když je stránka vyžádána, vyvolá se funkce a na stránku se vrátí poštovné.
Později obchod oznámí speciální akci: bezplatné poštovné na všechny objednávky nad 100 $. Provedete změnu sazeb poštovného na jednom místě—ve funkci ShippingCharge komponenty Pricing—a všechny stránky používající tuto funkci automaticky získají přesné poštovné.
Panel Komponenty – přehled (ColdFusion)
Použijte panel Komponenty (Okno > Komponenty) k zobrazení a úpravě ColdFusion komponent a přidejte kód na stránku, který vyvolá funkci při vyžádání CFM stránky.
Poznámka
Panel Komponenty je dostupný pouze při zobrazení stránky ColdFusion v aplikaci Dreamweaver.
Vytvoření nebo odstranění komponenty CFC v aplikaci Dreamweaver
Pomocí aplikace Dreamweaver můžete vizuálně definovat komponenty CFC a související funkce. Dreamweaver vytvoří soubor .cfc a vloží potřebné tagy CFML za vás.
Poznámka
V závislosti na konkrétní komponentě může být nutné, abyste nějaký kód vložili ručně.
V panelu Komponenty (Okno > Komponenty) vyberte z rozbalovací nabídky CF Components.
Klikněte na tlačítko Plus (+), vyplňte dialogové okno Vytvořit komponenty a klikněte na OK.
a. V sekci Komponenty zadejte podrobnosti o komponentě. Několik příkladů:
Název – Určuje název souboru komponenty. Název smí obsahovat jen písmena, číslice a znaky podtržítka (_). Při zadávání názvu nezadávejte příponu .cfc.
Složka komponenty – Určuje, kam se má komponenta ukládat. Vyberte kořenovou složku webové aplikace (například \Inetpub\wwwroot\myapp\) nebo některou z jejích podsložek.
b.Chcete-li pro komponentu definovat jednu nebo více funkcí, vyberte ze seznamu Sekce položku Functions, klikněte na tlačítko Plus (+) a zadejte podrobnosti nové funkce.
Nezapomeňte do volby Vracený typ zadat typ hodnoty, kterou funkce vrací.
Poznámka
Pokud z nabídky Přístup vyberete volbu Vzdálený, bude funkce k dispozici jako webová služba.
c.Chcete-li pro funkci definovat jeden nebo více argumentů, vyberte ze seznamu Sekce položku Arguments, vyberte funkci z rozbalovací nabídky, klikněte na tlačítko Plus (+) a zadejte vpravo podrobnosti nového argumentu.
Pokud používáte vzdálený vývojový server, nahrajte soubor CFC a všechny závislé soubory (například ty, které se používají k implementaci funkce nebo zahrnutí souborů) na vzdálený server.
Nahrání souborů zajistí, že funkce aplikace Dreamweaver jakožto Live view a Preview In Browser budou fungovat správně.
Dreamweaver napíše soubor CFC a uloží jej do složky, kterou jste zadali. Nová komponenta se také objeví v panelu Komponenty (po kliknutí na Aktualizovat).
Pokud používáte vzdálený vývojový server, nahrajte soubor CFC a všechny závislé soubory (například ty, které se používají k implementaci funkce nebo zahrnutí souborů) na vzdálený server.
Zobrazení komponent CFC v aplikaci Dreamweaver
Aplikace Dreamweaver nabízí možnost, jak vizuálně prohlížet komponenty ColdFusion (CFC) umístěné ve složce webového místa nebo na serveru jako celku. Dreamweaver načte soubory CFC a zobrazí informace o nich ve snadno procházitelném stromovém zobrazení v panelu Komponenty.
Dreamweaver hledá komponenty na vašem testovacím serveru (viz Připojení k databázi v aplikaci Dreamweaver). Pokud vytvoříte CFC nebo měníte stávající CFC, nezapomeňte nahrát soubory CFC na testovací server, aby se správně zobrazily v panelu Komponenty.
Komponenty umístěné na jiném serveru zobrazíte přepnutím nastavení testovacího serveru.
Můžete zobrazit následující informace o komponentách CF:
Seznam všech komponent ColdFusion definovaných na serveru.
Pokud používáte ColdFusion MX 7 nebo novější, filtrujte seznam tak, aby zobrazoval jen CFC umístěné ve složce webového místa.
Zobrazte si funkce a argumenty jednotlivých komponent.
Prohlédněte si vlastnosti funkcí, které slouží jako webové služby.
Poznámka
Pokud chcete v aplikaci Dreamweaver kontrolovat CFC umístěné v kořenové složce jednoho serveru a současně provádět údržbu souborů webového místa umístěných v kořenové složce webového místa, můžete definovat dvě webová místa aplikace Dreamweaver. Nastavte první místo tak, aby odkazovalo na kořenovou složku serveru, a druhé tak, aby odkazovalo na kořenovou složku webového místa. Mezi dvěma místy pak můžete rychle přepínat pomocí rozbalovací nabídky v panelu Soubory.
Pokud chcete CFC zobrazit v aplikaci Dreamweaver, postupujte takto:
Otevřete v aplikaci Dreamweaver libovolnou stránku ColdFusion.
V panelu Komponenty (Okno > Komponenty)
vyberte z rozbalovací nabídky CF Components.
Klikněte na tlačítko Obnovit v panelu pro načtení komponent.
Zobrazí se balík komponent na serveru. Balíček komponent je složka obsahující soubory CFC.
Pokud se existující balíčky komponent nezobrazí, klikněte na tlačítko Aktualizovat na panelu nástrojů.
Chcete-li zobrazit pouze soubory CFC umístěné ve složce vašeho webu,
klikněte na tlačítko Show Only Current Site's CFCs v panelu nástrojů
panelu Komponenty.
Poznámka
Tato funkce je k dispozici pouze v případě, že jste jako testovací server pro aplikaci Dreamweaver definovali počítač s ColdFusion MX 6 nebo novějším.
Poznámka
Pokud je aktuální web uveden ve virtuální složce na vzdáleném serveru, filtrování nefunguje.
Klikněte na tlačítko Plus (+) vedle názvu balíčku pro
zobrazení komponent uložených v balíčku.
Chcete-li vypsat funkce komponenty, klikněte na tlačítko Plus (+) vedle názvu komponenty.
Chcete-li zobrazit argumenty, které funkce přijímá, a také typ argumentů a zda jsou povinné nebo volitelné, otevřete větev funkce ve stromovém zobrazení.
Funkce, které nepřijímají žádné argumenty, nemají vedle sebe tlačítko Plus (+).
Chcete-li rychle zobrazit podrobnosti argumentu, funkce, komponenty nebo balíčku, vyberte položku ve stromovém zobrazení a klikněte na tlačítko Získat podrobnosti na panelu nástrojů.
Můžete také kliknout pravým tlačítkem (Windows) nebo kliknout při stisknuté klávese Control (Macintosh) na položku a vybrat Get Details z rozbalovací nabídky.
Podrobnosti o položce se zobrazí v okně se zprávou.
Úpravy komponent CFC v aplikaci Dreamweaver
Dreamweaver poskytuje zjednodušený způsob úprav kódu komponent ColdFusion definovaných pro váš web.Můžete například přidat, změnit nebo odstranit jakoukoli funkci součásti, aniž byste museli opustit Dreamweaver.
Chcete-li tuto funkci používat, musí být vaše vývojové prostředí nastaveno následovně:
Aplikace ColdFusion musí běžet lokálně.
V rozšířeném dialogovém okně Definice webu v aplikaci Dreamweaver musí být typ přístupu určený v kategorii Testovací server nastaven na Místní/Síť.
V rozšířeném dialogovém okně Definice webu musí být cesta k vaší místní kořenové složce stejná jako cesta ke složce testovacího serveru (například c:\Inetpub\wwwroot\cf_projects\myNewApp\). Tyto cesty můžete zkoumat a měnit výběrem Web > Upravit weby.
Součást musí být uložena v místní složce webu nebo v některé z jejích podsložek na vašem pevném disku.
Otevřete jakoukoli stránku ColdFusion v aplikaci Dreamweaver a zobrazte součásti v panelu Součásti. Chcete-li zobrazit součásti, otevřete panel Součásti (Okno > Součásti), vyberte CF Components z vyskakovací nabídky panelu a klikněte na tlačítko Obnovit v panelu.
Protože ColdFusion běží místně, Dreamweaver zobrazí balíčky součástí na vašem pevném disku.
Pokud chcete upravovat komponentu, použijte následující postup.
Otevřete libovolnou stránku ColdFusion v aplikaci Dreamweaver a zobrazte komponenty v panelu Komponenty (Okno > Komponenty).
Vyberte Souč. CF z vyskakovací nabídky panelu a
klikněte na tlačítko Obnovit v panelu.
Protože ColdFusion běží lokálně, Dreamweaver zobrazí balíčky součástí na vašem pevném disku.
Poznámka
Chcete-li upravit sadu záznamů CFC vizuálně, poklepejte na ni v panelu Vazby.
Chcete-li upravit soubor součásti obecně, otevřete balíček
a dvakrát klikněte na název součásti ve stromovém zobrazení.
Soubor komponenty se otevře v zobrazení Kód.
Chcete-li upravit konkrétní funkci, argument nebo vlastnost, dvakrát klikněte
na položku ve stromovém zobrazení.
Proveďte změny ručně v zobrazení Kód.
Uložte soubor (Soubor > Uložit).
Chcete-li vidět jakoukoli novou funkci v panelu Součásti, obnovte zobrazení kliknutím na tlačítko Obnovit na panelu nástrojů.
Vytváření webových stránek, které používají komponenty CFC
Jednou z možností, jak na webových stránkách použít funkci komponenty, je napsat na stránku kód, který vyvolá funkci v okamžiku, kdy je stránka vyžádána. Můžete použít Dreamweaver k tomu, aby vám pomohl napsat tento kód.
Poznámka
Další způsoby použití součástí naleznete v dokumentaci ColdFusion v aplikaci Dreamweaver (Nápověda > Použití ColdFusion).
V aplikaci Dreamweaver otevřete stránku ColdFusion, která bude používat funkci komponenty.
Přepněte na zobrazení Kód (Zobrazení > Kód).
Otevřete panel Komponenty (Okno > Komponenty) a vyberte CF Components z vyskakovací nabídky panelu.
Najděte součást, kterou chcete, a vložte ji pomocí jedné z
následujících technik:
Přetáhněte funkci ze stromového zobrazení na stránku. Do stránku se vloží kód, který vyvolá funkci.
Vyberte funkci v panelu a klikněte na tlačítko Vložit na panelu nástrojů (druhé tlačítko zprava).Dreamweaver vloží kód na stránku na místo vložení.
Pokud vložíte funkci s argumenty, dokončete
kód argumentu ručně.
Další informace naleznete v dokumentaci ColdFusion v aplikaci Dreamweaver (Nápověda > Používání ColdFusion).
Uložit stránku (Soubor > Uložit).
Definice sady záznamů v CFC
Aplikace Dreamweaver vám může pomoci definovat sadu záznamů (také označovanou jako dotaz ColdFusion) v komponentě ColdFusion (CFC). Pokud definujete sadu záznamů v CFC, nemusíte definovat sadu záznamů na každé stránce, která ji používá. Sadu záznamů definujete jednou v CFC a CFC použijete na více stránkách.
Poznámka
Tato funkce je k dispozici, jen pokud máte přístup k počítači, na kterém běží aplikace ColdFusion MX 7 nebo novější. Další informace naleznete v části Povolení rozšíření ColdFusion.
Vytvořte nebo otevřete stávající soubor CFC v aplikaci Dreamweaver.
Na panelu Vazby (Okno > Vazby) klikněte na tlačítko Plus (+) a v místní nabídce vyberte Sada záznamů (Dotaz).
Objeví se dialogové okno Sada záznamů. Můžete pracovat buď v jednoduchém, nebo v rozšířeném dialogovém okně Sada záznamů.
Chcete-li použít existující funkci v CFC, vyberte funkci
z automaticky otevírané nabídky Funkce a přeskočte na krok 5.
Sada záznamů se definuje ve funkci.
Chcete-li definovat novou funkci v CFC, klikněte na tlačítko Nová funkce, zadejte název funkce do dialogového okna, které se zobrazí, a pak klikněte na OK.
Název musí obsahovat pouze alfanumerické znaky a podtržítka (_).
Chcete-li definovat sadu záznamů pro funkci, vyplňte
možnosti dialogového okna Sada záznamů.
Nová funkce je vložena do CFC, které definuje sadu záznamů.
Použití sady záznamů CFC jako zdroje dynamického obsahu
Komponentu ColdFusion (CFC) můžete použít jako zdroj dynamického obsahu pro vaše stránky, pokud komponenta obsahuje funkci, která definuje sadu záznamů.
Poznámka
Tato funkce je k dispozici jen pokud máte přístup k počítači, na kterém běží aplikace ColdFusion MX 7 nebo novější. Více informací viz část Povolení rozšíření ColdFusion.
Otevřete v aplikaci Dreamweaver stránku ColdFusion.
Na panelu Vazby (Okno > Vazby)
klikněte na tlačítko Plus (+) a v automaticky otevírané nabídce
vyberte příkaz Sada záznamů (Dotaz).
Objeví se dialogové okno Sada záznamů. Můžete pracovat buď v jednoduchém, nebo v rozšířeném dialogovém okně Sada záznamů.
Klepněte na tlačítko Dotaz CFC.
Vyplňte dialogové okno dotazu CFC, klikněte na tlačítko OK a pak
znovu klikněte na tlačítko OK, abyste přidali sadu záznamů CFC do seznamu dostupných
zdrojů obsahu na panelu Vazby.
Pomocí panelu Vazby propojte sadu záznamů s různými elementy stránky.
Další informace naleznete v části Přidávání dynamického obsahu na stránky.
Definování dynamického obsahu pomocí CFC
V aplikaci Dreamweaver můžete definovat sadu záznamů jako zdroj dynamického obsahu pomocí CFC, které obsahuje definici sady záznamů.
1. Do pole Název zadejte název sady záznamů CFC.
Běžnou praxí je přidat předponu rs k názvům sad záznamů, aby se odlišily od ostatních názvů objektů v kódu, například: rsPressRelease.
Názvy sad záznamů smí obsahovat jen písmena, číslice a znaky podtržítka (_). Nemůžete použít speciální znaky ani mezery.
2.Vyberte balíček z již definovaných na serveru.
Pokud se balík nezobrazuje v rozbalovací nabídce, můžete seznam balíků obnovit klepnutím na tlačítko Obnovit u rozbalovací nabídky.
Nejdříve vždy nahrajte CFC na testovací server. Zobrazí se jen CFC na testovacím serveru.
3.Vyberte komponentu z definovaných v aktuálně vybraném balíčku.
Pokud rozbalovací nabídka Komponenta neobsahuje žádné komponenty nebo pokud se v menu nezobrazí žádné z komponent, které jste vytvořili, musíte soubory CFC nahrát na testovací server.
4.(Volitelně) Chcete-li vytvořit komponentu, klikněte na tlačítko Vytvořit novou komponentu.
a. V rámečku Název zadejte název nové komponenty CFC. Název smí obsahovat jen písmena, číslice a znaky podtržítka (_).
b.Do pole Adresář komponent zadejte umístění svého CFC nebo procházejte a najděte složku.
Poznámka
Složka musí být zadána jako relativní cesta vůči kořenové složce webového místa.
5.Z místní nabídky Funkce vyberte funkci, která obsahuje definici sady záznamů.
Rozbalovací nabídka Funkce obsahuje jen funkce definované v právě vybrané komponentě. Pokud tato rozbalovací nabídka nezobrazuje žádnou funkci nebo pokud právě zobrazené funkce neodpovídají změnám, které jste provedli, zkontrolujte, zda jste uložili poslední změny a nahráli soubory na server.
Poznámka
Rámečky Připojení a SQL jsou jen pro čtení.
6.Upravte každý parametr (typ, hodnotu a výchozí hodnotu), který musí být předán jako argument funkce, kliknutím na tlačítko Upravit.
a. Hodnotu aktuálního parametru zadejte výběrem typu hodnoty z rozbalovací nabídky Hodnota a zadáním hodnoty do rámečku vpravo. Typ hodnoty může být parametr URL, proměnná formuláře, soubory cookie, proměnná relace, proměnná aplikace nebo zadaná hodnota.
b. V poli Výchozí hodnota zadejte výchozí hodnotu pro parametr. Pokud není vrácena hodnota za běhu, použije se standardní hodnota.
c.Klepněte na OK.
Nemůžete měnit připojení k databázi a dotaz SQL u sadu záznamů. Tato pole jsou vždy nepřístupná – připojení a dotaz SQL se zobrazují jen pro informaci.
7. Klikněte na Test, abyste se připojili k databázi a vytvořili instanci sady záznamů.
Pokud výraz SQL obsahuje parametry stránky, zkontrolujte před klepnutím na tlačítko Test, zda sloupec Standardní hodnota v poli Parametry obsahuje platné testovací hodnoty.
Pokud dotaz proběhl úspěšně, tabulka zobrazí sadu záznamů. Každý řádek obsahuje jeden záznam a každý sloupec odpovídá jednomu poli v tomto záznamu.
Klepnutím na tlačítko OK vymažte dotaz CFC.
8. Klikněte na OK.
Tvorba nádherných webů v aplikaci Dreamweaver
Vytvářejte, kódujte a spravujte dynamické weby pomocí výkonného všestranného nástroje.
