ColdFusion-componenten gebruiken in Dreamweaver

Met CFC-bestanden (ColdFusion-component) kunt u toepassings- en bedrijfslogica in zelfstandige, herbruikbare eenheden opnemen. Met CFC's kunt u snel en eenvoudig webservices maken.

Een CFC is een herbruikbare software-eenheid, geschreven in CFML (ColdFusion markup language), die het hergebruik en onderhoud van uw code eenvoudiger maakt.

U kunt Dreamweaver gebruiken om met CFC's te werken. Raadpleeg de ColdFusion-documentatie vanuit Dreamweaver (Help > ColdFusion gebruiken) voor informatie over CFC-tags en -syntaxis.

CFC's zijn bedoeld om ontwikkelaars een eenvoudige maar krachtige manier te bieden om elementen van hun websites te integreren. In het algemeen moet u componenten voor toepassings- of bedrijfslogica gebruiken. Gebruik aangepaste tags voor presentatie-elementen, zoals aangepaste begroetingen, dynamische menu's enzovoort.

Net als met vele andere typen constructies hebben dynamische sites dikwijls baat bij onderling uitwisselbare onderdelen. Een dynamische site kan bijvoorbeeld dezelfde query herhaaldelijk uitvoeren, of de totale prijs van winkelwagenpagina's berekenen en deze telkens opnieuw herberekenen wanneer een item wordt toegevoegd. Deze taken kunnen door componenten worden afgehandeld. U kunt een component herstellen, verbeteren, uitbreiden en zelfs vervangen met een minimale invloed op de rest van uw toepassing.

Stel dat een onlinewinkel de verzendkosten berekent op basis van de prijs van de bestelling. Voor bestellingen onder de 20 euro, wordt 4 euro verzendkosten berekend, voor bestellingen tussen 20 en 40 euro wordt 6 euro verzendkosten berekend enzovoort. U kunt de logica voor het berekenen van de verzendkosten zowel op de winkelpagina als op de afrekenpagina invoegen, maar in dat geval zou u HTML-presentatiecode en CFML-logica gaan mengen wat het onderhoud en hergebruik van de code doorgaans moeilijker maakt.

U besluit om een CFC met de naam Pricing te maken, die onder andere een functie bevat met de naam ShippingCharge. De functie heeft een prijs als argument en retourneert de verzendkosten. Als de waarde van het argument bijvoorbeeld 32,80 is, retourneert de functie de waarde 6.

Op zowel de winkelwagenpagina als de afrekenpagina voegt u een speciale tag in om de functie ShippingCharge te activeren. Wanneer de pagina wordt opgevraagd, wordt de functie geactiveerd en worden de verzendkosten aan de pagina geretourneerd.

Later kondigt het bedrijf een speciale aanbieding aan: geen verzendkosten voor alle bestellingen boven 100 euro. U brengt de wijziging in de verzendkosten aan op één plaats: de functie ShippingCharge van de component Pricing. Op alle pagina's die de functie gebruiken, worden nu automatisch de juiste verzendkosten weergegeven.

Overzicht van het paneel CF-componenten (ColdFusion)

Gebruik het deelvenster Componenten (Venster > Componenten) om ColdFusion-componenten weer te geven en te bewerken en om code aan de pagina toe te voegen die de functie activeert wanneer de CFM-pagina wordt opgevraagd.

Een CFC maken of verwijderen in Dreamweaver

Met Dreamweaver kunt u visueel een CFC en de bijbehorende functies definiëren. Dreamweaver maakt een CFC-bestand en voegt de noodzakelijke CFML-tags voor u in.

CFC's weergeven in Dreamweaver

Dreamweaver biedt een manier om de ColdFusion-componenten (CFC's) die zich in uw sitemap of op de server bevinden, visueel te onderzoeken. Dreamweaver leest de CFC-bestanden en geeft gegevens over de bestanden weer in een eenvoudig te manipuleren structuur in het deelvenster Componenten.

Dreamweaver zoekt naar de componenten op de testserver (zie Verbinding maken met de database in Dreamweaver). Als u CFC's maakt of bestaande CFC's wijzigt, moet u ervoor zorgen dat u de CFC-bestanden naar de testserver uploadt zodat ze nauwkeurig worden weergegeven in het deelvenster Componenten.

Wijzig de instellingen van de testserver als u de componenten op een andere server wilt weergeven.

U kunt de volgende informatie over uw CF-componenten weergeven:

• Geef een lijst weer met alle ColdFusion-componenten die op de server zijn gedefinieerd.

• Als u met ColdFusion MX 7 of hoger werkt, filtert u de lijst zodat alleen de CFC's in uw sitemap worden weergegeven.

• Verken de functies en argumenten van elke component.

• Bekijk de eigenschappen van functies die als webservices fungeren.

Ga als volgt te werk om CFC's in Dreamweaver weer te geven:

CFC's bewerken in Dreamweaver

Dreamweaver biedt een gestroomlijnde manier om de code te bewerken van de ColdFusion-componenten die voor de site zijn gedefinieerd. U kunt een componentfunctie bijvoorbeeld toevoegen, wijzigen of verwijderen zonder Dreamweaver te verlaten.

U moet de ontwikkelomgeving als volgt instellen om deze functie te kunnen gebruiken:

• ColdFusion moet lokaal worden uitgevoerd.

• In het dialoogvenster Geavanceerde sitedefinitie van Dreamweaver moet het toegangstype dat in de categorie Testserver is opgegeven, Lokaal/Netwerk zijn.

• In het dialoogvenster Geavanceerde sitedefinitie moet het pad naar de lokale hoofdmap hetzelfde zijn als het pad van de testservermap (bijvoorbeeld c:\Inetpub\wwwroot\cf_projects\myNewApp\). U kunt deze paden bekijken en wijzigen door Site > Sites bewerken te kiezen.

• De component moet zijn opgeslagen in de lokale sitemap of een van de submappen daarvan op uw vaste schijf.

Open een ColdFusion-pagina in Dreamweaver en geef de componenten weer in het deelvenster Componenten. Als u de componenten wilt weergeven, opent u het deelvenster Componenten (Venster > Componenten), kiest u CF-componenten in het pop-upmenu van het paneel en klikt u op de knop Vernieuwen in het paneel.

Omdat ColdFusion lokaal wordt uitgevoerd, geeft Dreamweaver componentenpakketten op de vaste schijf weer.

Ga als volgt te werk om een component te bewerken.

Webpagina's samenstellen die CFC's gebruiken

Een manier om een componentfunctie op uw webpagina's te gebruiken, is door code in de pagina te schrijven die de functie activeert wanneer de pagina wordt opgevraagd. Dreamweaver kan u helpen bij het schrijven van deze code.

Een recordset definiëren in een CFC

Dreamweaver kan u helpen bij het definiëren van een recordset (ook wel een ColdFusion-query genoemd) in een ColdFusion-component (CFC). Als u een recordset in een CFC definieert, hoeft u de recordset niet te definiëren op elke pagina die deze gebruikt. U definieert de recordset eenmaal in de CFC en gebruikt de CFC op verschillende pagina's.

Een CFC-recordset als een bron van dynamische inhoud gebruiken

U kunt een ColdFusion-component (CFC) als een bron van dynamische inhoud voor uw pagina's gebruiken als de component een functie bevat die een recordset definieert.

Dynamische inhoud definiëren met een CFC

In Dreamweaver kunt u een recordset als een bron van dynamische inhoud definiëren door een CFC te gebruiken die een recordsetdefinitie bevat.

1. Voer in het vak Naam een naam voor de CFC-recordset in.

Dikwijls wordt het voorvoegsel rs vóór recordsetnamen geplaatst om ze te onderscheiden van andere objectnamen in de code, bijvoorbeeld: rsPressRelease.

Recordsetnamen mogen alleen alfanumerieke tekens en het onderstrepingsteken (_) bevatten. U mag geen speciale tekens of spaties gebruiken.

2. Selecteer een van de pakketten die al op de server zijn gedefinieerd.

Als het pakket niet in het pop-upmenu voorkomt, kunt u de lijst met pakketten vernieuwen door op de knop Vernieuwen vlakbij het pop-upmenu te klikken.

Zorg ervoor dat u de CFC's eerst op de testserver laadt. Alleen de CFC's op de testserver worden weergegeven.

3. Selecteer een van de componenten die in het geselecteerde pakket zijn gedefinieerd.

Als het pop-upmenu Component geen componenten bevat, of als het menu alleen oudere componenten bevat, moet u de CFC-bestanden op de testserver laden.

4.(Optioneel) Klik op de knop Nieuwe component maken als u een component wilt maken.

a. Voer in het vak Naam de naam voor de nieuwe CFC in. De naam mag alleen alfanumerieke tekens en onderstrepingstekens (_) bevatten.

b. Voer in het vak Map van component de locatie voor de CFC in, of blader om de map te zoeken.

5. Selecteer in het pop-upmenu Functie de functie die de recordsetdefinitie bevat.

Het pop-upmenu functie bevat alleen de functies die in de geselecteerde component zijn gedefinieerd. Als dit pop-upmenu geen functies bevat of als de laatste wijzigingen niet in de vermelde functies worden weergegeven, controleert u of de laatste wijzigingen wel op de server zijn geladen.

6. Bewerk elke parameter (type, waarde en standaardwaarde) die als functieargument moet worden doorgegeven door op de knop Bewerken te klikken.

a. Voer een waarde voor de huidige parameter in door het type van de waarde in het pop-upmenu Waarde te selecteren en de waarde in het vak aan de rechterkant in te voeren. Het type van de waarde kan een URL-parameter, een formuliervariabele, een cookie, een sessievariabele, een toepassingsvariabele of een ingevoerde waarde zijn.

b. Voer een standaardwaarde voor de parameter in het vak Standaardwaarde in. Als er geen runtime-waarde wordt geretourneerd, wordt de standaardparameterwaarde gebruikt.

c. Klik op OK.  

U kunt de databaseverbinding en de SQL-query voor de recordset niet wijzigen. Deze velden zijn altijd uitgeschakeld. De verbinding en SQL-query worden alleen ter informatie weergegeven.

7. Klik op Testen om een verbinding met de database te maken en een instantie van de recordset te maken.

Als de SQL-instructie paginaparameters bevat, moet u ervoor zorgen dat de kolom Standaardwaarde van het vak Parameters geldige testwaarden bevat voordat u op Testen klikt.

Als de query met succes is uitgevoerd, wordt de recordset in een tabel weergegeven. Elke rij bevat een record en elke kolom stelt een veld in die record voor.

Klik op OK om de CFC-query te wissen.

8. Klik op OK.