Använda ColdFusion-komponenter i Dreamweaver

Med hjälp av CFC-filer (ColdFusion Component) kan du kapsla in program- och affärslogik i självständiga, återanvändbara enheter. CFC:er är också ett snabbt och enkelt sätt att skapa webbtjänster på.

En CFC är en återanvändbar programvaruenhet som är skriven i CFML (ColdFusion Markup Language), vilket gör din kod enkel att återanvända och underhålla.

Du kan arbeta med CFC:er i Dreamweaver. Information om CFC-taggar och -syntax finns i ColdFusion-dokumentationen, som du når från Dreamweaver (Hjälp > Använda ColdFusion).

CFC:er är avsedda att fungera som ett enkelt men ändå kraftfullt sätt för utvecklare att kapsla in delar av sina webbplatser på. I allmänhet bör du använda komponenter för program- eller affärslogik. Använd anpassade taggar för presentationselement som anpassade välkomstsidor, dynamiska menyer och så vidare.

Som i många andra konstruktionsdiscipliner är det ofta en fördel att använda utbytbara delar på dynamiska webbplatser. En dynamisk webbplats kanske till exempel kör samma fråga upprepade gånger, eller beräknar summor på kundvagnssidor och beräknar om dem varje gång ett nytt objekt läggs till. Sådana åtgärder kan hanteras av komponenter. Du kan korrigera, förbättra, utöka eller till och med byta ut en komponent utan att resten av ditt program påverkas nämnvärt.

Antag att en onlinebutik beräknar fraktkostnader baserat på orderpriset. För en order under 200 kr kostar frakten 40 kr, för en order mellan 200 och 400 kr kostar frakten 60 och så vidare. Du kan infoga logiken för beräkningen av frakt på både kundvagnssidan och kassasidan, men det skulle innebära presentationslagrets HTML-kod och logiklagrets CFML-kod skulle blandas, vilket gör koden svår att underhålla och återanvända.

Du bestämmer dig i stället för att skapa en CFC med namnet Pricing som, bland annat, omfattar en funktion med namnet ShippingCharge. Funktionen tar ett pris som argument och returnerar en fraktkostnad. Om argumentets värde till exempel är 328, returnerar funktionen 60.

På kundvagnssidan och kassasidan infogar du en särskild tagg som anropar funktionen ShippingCharge. När sidan begärs, anropas funktionen och en fraktkostnad returneras till sidan.

Senare har butiken en särskild kampanj: gratis frakt för alla order över 1000 kr. Du ändrar fraktkostnaderna på ett ställe, funktionen ShippingCharge i komponenten Pricing, och då får alla sidor som använder funktionen automatiskt rätt fraktkostnad.

Översikt över panelen Komponenter (ColdFusion)

Använd panelen Komponenter (Fönster > Komponenter > Komponenter) när du vill visa och ändra ColdFusion-komponenter och lägg till kod på sidan som anropar funktionen när CFM-sidan begärs.

Skapa eller ta bort en CFC i Dreamweaver

Du kan använda Dreamweaver när du vill definiera en CFC och dess funktioner visuellt. Dreamweaver skapar en .cfc-fil och infogar de CFML-taggar som krävs.

Visa CFC:er i Dreamweaver

Med hjälp av Dreamweaver kan du visuellt undersöka de ColdFusion-komponenter (CFC:er) som finns i webbplatsmappen eller på servern. Dreamweaver läser CFC-filerna och visar information om dem i en lättnavigerad trädvy på panelen Komponenter.

Dreamweaver söker efter komponenterna på din testserver (se Ansluta till databasen i Dreamweaver). Om du skapar CFC:er eller förändrar befintliga CFC:er, måste du överföra CFC-filerna till testservern för att de ska återges korrekt på panelen Komponenter.

Om du vill visa komponenter på en annan server, ändrar du inställningarna för testservern.

Du kan visa följande information om dina CF-komponenter:

• En lista över alla ColdFusion-komponenter som definierats på servern.

• Om du använder ColdFusion MX 7 eller senare filtrerar du listan så att bara CFC:er i din webbplatsmapp visas.

• Utforska de olika komponenternas funktioner och argument.

• Granska egenskaperna för funktioner som fungerar som webbtjänster.

Så här visar du CFC:er i Dreamweaver:

Redigera CFC:er i Dreamweaver

Med hjälp av Dreamweaver kan du enkelt redigera koden i ColdFusion-komponenter som definierats för din webbplats. Du kan till exempel lägga till, ändra eller ta bort valfri komponentfunktion utan att lämna Dreamweaver.

Om du vill kunna använda den här funktionen, måste din utvecklingsmiljö vara konfigurerad på följande vis:

• ColdFusion måste köras lokalt.

• I den avancerade dialogrutan Platsdefinition i Dreamweaver måste åtkomsttypen som anges i kategorin Testserver vara Lokalt/Nätverk.

• I den avancerade dialogrutan Platsdefinition måste sökvägen till din lokala rotmapp vara samma som sökvägen till testservermappen (till exempel, c:\Inetpub\wwwroot\cf_projekt\mittNyaProg\). Du kan granska och ändra de här sökvägarna genom att välja Plats > Redigera platser.

• Komponenten måste lagras i den lokala webbplatsmappen eller någon av dess undermappar på hårddisken.

Öppna en ColdFusion-sida i Dreamweaver och visa komponenterna på panelen Komponenter. Om du vill visa komponenterna öppnar du panelen Komponenter (Fönster > Komponenter), väljer CF-komponenter på panelens snabbmeny och klickar på Uppdatera.

Eftersom ColdFusion körs lokalt, visar Dreamweaver komponentpaketen på din hårddisk.

Du redigerar en komponent med hjälp av följande procedur.

Bygga webbsidor som använder CFC:er

Ett sätt att använda en komponentfunktion på dina webbsidor är att skriva kod på en sida, som anropar funktionen när sidan begärs. Den koden kan du skriva med hjälp av Dreamweaver.

Definiera en postmängd i en CFC

Dreamweaver kan hjälpa dig att definiera en postmängd (kallas även för en ColdFusion-fråga) i en ColdFusion-komponent (CFC). Om du definierar en postmängd i CFC:n slipper du definiera den på alla sidor som använder den. Du definierar postmängden en gång i CFC:n och använder sedan CFC:n på olika sidor.

Använda en CFC-postmängd som källa för dynamiskt innehåll

Om en ColdFusion-komponent (CFC) innehåller en funktion som definierar en postmängd, kan du använda komponenten som källa för dynamiskt innehåll på dina sidor.

Definiera dynamiskt innehåll med hjälp av en CFC

Genom att använda en CFC som innehåller en definition av en postmängd kan du definiera en postmängd som källa för dynamiskt innehåll i Dreamweaver.

1. Ange ett namn för CFC-postmängden i rutan Namn.

Ett vanligt tillvägagångssätt är att lägga till prefixet rs i postmängdernas namn för att skilja dem från andra objektnamn i koden, till exempel: rsPressRelease.

Namn på postmängder får bara bestå av alfanumeriska tecken och understreck (_). Du får inte använda specialtecken eller mellanslag.

2. Markera ett av de redan definierade paketen på servern.

Om paketet inte visas på snabbmenyn, kan du uppdatera paketlistan genom att klicka på Uppdatera nära snabbmenyn.

Glöm inte att överföra dina CFC:er till testservern först. Endast CFC:er på testservern visas.

3. Markera en av de redan definierade komponenterna i det för närvarande markerade paketet.

Om snabbmenyn Komponent inte innehåller några komponenter, eller om ingen av dina tidigare komponenter visas på menyn, överför du CFC-filerna till testservern.

4.(Valfritt) Vill du skapa en komponent klickar du på Skapa ny komponent.

a. Ange namnet på den nya CFC:en i rutan Namn. Namnet får bara bestå av alfanumeriska tecken och understreck (_).

b. Ange var CFC:n ska sparas i rutan Komponentkatalog eller bläddra till mappen.

5. Markera den funktion som innehåller postmängdsdefinitionen på snabbmenyn Funktion.

Snabbmenyn Funktion innehåller bara de funktioner som är definierade i den för närvarande markerade komponenten. Om ingen funktion visas på snabbmenyn, eller om dina senaste ändringar inte visas i de för närvarande visade funktionerna, kontrollerar du att dina senaste ändringar har sparats och överförts till servern.

6. Redigera de olika parametrarna (typ, värde och standardvärde) som måste skickas som funktionsargument genom att klicka på Redigera.

a. Ange ett värde för den aktuella parametern genom att markera värdetypen på snabbmenyn Värde och ange värdet i rutan till höger. Värdetypen kan vara en URL-parameter, en formulärvariabel, en cookiefil, en sessionsvariabel, en programvariabel eller ett angivet värde.

b. Ange ett standardvärde för parametern i rutan Standardvärde. Om inget körtidsvärde returneras, används parameterns standardvärde.

c. Klicka på OK.  

Du kan inte förändra postmängdens databasanslutning eller SQL-fråga. De här fälten är alltid inaktiverade. Anslutningen och SQL-frågan visas bara i informationssyfte.

7. Anslut till databasen och skapa en instans av postmängden genom att klicka på Testa.

Om SQL-satsen innehåller sidparametrar, kontrollerar du att kolumnen Standardvärde i rutan Parametrar innehåller giltiga testvärden innan du klickar på Testa.

Om frågan kördes utan fel visas postmängden i en tabell. Varje rad innehåller en post och varje kolumn motsvarar ett fält i posten.

Rensa CFC-frågan genom att klicka på OK.

8. Klicka på OK.