Open een ColdFusion-pagina in Dreamweaver.
Laatst bijgewerkt op
25 apr. 2024
Notitie
Ondersteuning voor ColdFusion is verwijderd in Dreamweaver en later.
ColdFusion-componenten
ColdFusion component (CFC) bestanden stellen je in staat om applicatie- en bedrijfslogica te kapselen in zelfstandige, herbruikbare eenheden.CFC's bieden ook een snelle, eenvoudige manier om web services te maken.
Een CFC is een herbruikbare software-eenheid geschreven in ColdFusion Markup Language (CFML), wat het hergebruiken en onderhouden van je code vergemakkelijkt.
U kunt Dreamweaver gebruiken om met CFC's te werken. Voor informatie over CFC-tags en syntaxis, raadpleeg de ColdFusion-documentatie vanuit Dreamweaver (Help > Using ColdFusion).
Notitie
U kunt CFC's alleen gebruiken met ColdFusion MX of hoger. CFC's worden niet ondersteund in ColdFusion 5.
CFC's zijn bedoeld om een eenvoudige maar krachtige manier te bieden voor ontwikkelaars om elementen van hun websites in te kapselen.Over het algemeen gebruik je onderdelen voor applicatie- of bedrijfslogica.Gebruik aangepaste tag's voor presentatie-elementen zoals gepersonaliseerde begroetingen, dynamische menu's, enzovoort.
Net als bij veel andere soorten constructie kunnen dynamische sites vaak baat hebben bij uitwisselbare onderdelen.Een dynamische site kan bijvoorbeeld dezelfde query herhaaldelijk uitvoeren, of de totaalprijs van winkelwagen pagina's berekenen en deze elke keer herberekenen wanneer een item wordt toegevoegd.Deze taken kunnen door componenten worden afgehandeld. Je kunt een onderdeel repareren, verbeteren, uitbreiden en zelfs vervangen met minimale impact op de rest van je applicatie.
Stel dat een webwinkel verzendkosten berekent op basis van de prijs van bestellingen.Voor bestellingen onder USD 20 zijn de verzendkosten USD 4; voor bestellingen tussen USD 20 en USD 40 zijn de verzendkosten USD 6, enzovoort.Je zou de logica voor het berekenen van de verzendkosten kunnen invoegen in zowel de winkelwagen pagina als de checkout pagina, maar dat zou HTML presentatiecode en CFML logicacode vermengen en over het algemeen de code moeilijk te onderhouden en hergebruiken maken.
Je besluit een CFC te maken genaamd Pricing die onder andere een functie heeft genaamd ShippingCharge.De functie neemt een prijs als argument en retourneert verzendkosten.Als de waarde van het argument bijvoorbeeld 32,80 is, retourneert de functie 6.
Zowel op de winkelwagenpagina als op de kassapagina voeg je een speciale tag toe om de functie ShippingCharge aan te roepen.Wanneer de pagina wordt opgevraagd, wordt de functie aangeroepen en worden verzendkosten aan de pagina geretourneerd.
Later kondigt de webwinkel een speciale promotie aan: gratis verzending voor alle bestellingen boven USD 100.Je brengt de wijziging aan in de verzendtarieven op één plaats—de ShippingCharge functie van het Pricing onderdeel—en alle pagina's die de functie gebruiken krijgen automatisch juiste verzendkosten.
Overzicht van het paneel CF-componenten (ColdFusion)
Gebruik het paneel Onderdelen (Window > Components) om ColdFusion onderdelen te bekijken en te bewerken, en voeg code toe op de pagina die de functie aanroept wanneer de CFM pagina wordt opgevraagd.
Notitie
Het paneel Onderdelen is alleen beschikbaar bij het bekijken van een ColdFusion pagina in Dreamweaver.
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 benodigde CFML-tags voor je toe.
Notitie
Afhankelijk van het component, moet u bepaalde code handmatig afmaken.
Selecteer in het paneel Onderdelen (Venster > Onderdelen) CF Components in het pop-upmenu.
Klik op de Plus (+)-knop en vul het dialoogvenster Onderdelen maken in. Klik op OK.
a. Voer in de sectie Componenten de details over de component in. Hier volgt een gedeeltelijke lijst:
Naam Hier geeft u de bestandsnaam van de component op. De naam mag alleen alfanumerieke tekens en onderstrepingstekens (_) bevatten. Geef de bestandsextensie .CFC niet op wanneer u de naam invoert.
Map component Hier geeft u op waar de component wordt opgeslagen. Selecteer de hoofdmap van de webtoepassing op (zoals \Inetpub\wwwroot\myapp\) of een van de submappen van deze hoofdmap.
b.Om een of meer functies voor het onderdeel te definiëren, selecteer je Functies in de lijst Sectie, klik je op de Plus (+)-knop en voer je de details van de nieuwe functie in.
Zorg ervoor dat u het type opgeeft van de waarde die wordt geretourneerd door de functie in de optie Retourtype.
Notitie
Als u in het menu Toegang de optie extern kiest, wordt de functie beschikbaar als een webservice.
c. Om een of meer argumenten voor een functie te definiëren, selecteer je Argumenten in de lijst Sectie, selecteer je de functie in het pop-upmenu, klik je op de Plus (+)-knop en voer je de details van het nieuwe argument aan de rechterkant in.
Als je een externe ontwikkelingsserver gebruikt, upload dan het CFC-bestand en afhankelijke bestanden (zoals bestanden die worden gebruikt om een functie te implementeren of include-bestanden) naar de externe server.
Door de bestanden te uploaden, zorgt u ervoor dat Dreamweaver-functies zoals Live-weergave en Voorvertoning in browser goed werken.
Dreamweaver schrijft een CFC-bestand en slaat dit op in de map die u hebt opgegeven. Het nieuwe onderdeel verschijnt ook in het Onderdelen-paneel (na het klikken op Vernieuwen).
Als je een externe ontwikkelingsserver gebruikt, upload dan het CFC-bestand en afhankelijke bestanden (zoals bestanden die worden gebruikt om een functie te implementeren of include-bestanden) naar de externe server.
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 toont informatie hierover in een gemakkelijk navigeerbare boomstructuurweergave in het deelvenster Onderdelen.
Dreamweaver zoekt naar de onderdelen op uw 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 op de testserver laadt zodat ze nauwkeurig worden weergegeven in het paneel Componenten.
Verander 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 elk component.
Bekijk de eigenschappen van functies die als webservices fungeren.
Notitie
Als u Dreamweaver wilt gebruiken om de CFC's in de hoofdmap van de server te inspecteren terwijl u ook de sitebestanden in een andere hoofdmap van de website beheert, kunt u twee Dreamweaver-sites definiëren. Stel de eerste site zo in dat deze naar de hoofdmap van de server wijst en laat de tweede naar de hoofdmap van de website wijzen. Gebruik het pop-upmenu van de site in het paneel Bestanden om snel tussen de twee sites te schakelen.
Ga als volgt te werk om CFC's in Dreamweaver weer te geven:
Open een willekeurige ColdFusion-pagina in Dreamweaver.
Selecteer in het deelvenster Onderdelen (Venster > Onderdelen) CF Components in het pop-upmenu.
Klik op de knop Vernieuwen in het paneel om de
onderdelen op te halen.
Het componentenpakket wordt op de server weergegeven. Een onderdeelpakket is een map die CFC-bestanden bevat.
Als bestaande onderdeelpakketten niet verschijnen, klik je op de knop Vernieuwen in de paneel werkbalk.
Om alleen de CFC's in uw sitemap weer te geven,
klikt u op de knop Alleen CFC's van huidige site tonen in de werkbalk van het Onderdelen-
paneel.
Notitie
Deze functie is alleen beschikbaar als u een computer met ColdFusion MX 6 of hoger hebt gedefinieerd als testserver voor Dreamweaver.
Notitie
Als de huidige site wordt vermeld in een virtuele map op de externe server, werkt het filteren niet.
Klik op de Plus (+)-knop naast de pakketnaam om
de onderdelen in het pakket te bekijken.
Om de functies van een onderdeel weer te geven, klikt u op de Plus (+)-knop naast de naam van het onderdeel.
Om de argumenten die een functie neemt te zien, evenals het type van de argumenten en of ze verplicht of optioneel zijn, opent u de tak van de functie in de boomstructuur.
Functies die geen argumenten nemen, hebben geen Plus (+)-knop ernaast.
Om snel de details van een argument, een functie, een onderdeel of een pakket te bekijken, selecteert u het item in de boomstructuur en klikt u op de knop Details ophalen in de paneelwerkbalk.
U kunt ook rechtsklikken (Windows) of Ctrl-klikken (Macintosh) op het item en Details ophalen selecteren in het pop-upmenu.
Details over het item worden weergegeven in een berichtvenster.
CFC's bewerken in Dreamweaver
Dreamweaver biedt een gestroomlijnde manier om de code te bewerken van de ColdFusion-onderdelen die voor je site zijn gedefinieerd.Je kunt bijvoorbeeld onderdeel-functies toevoegen, wijzigen of verwijderen zonder Dreamweaver te verlaten.
Om deze functie te gebruiken, moet je ontwikkelingsomgeving als volgt zijn ingesteld:
ColdFusion moet lokaal worden uitgevoerd.
In het geavanceerde dialoogvenster Site Definition in Dreamweaver moet het toegangstype dat is opgegeven in de categorie Testing Server Local/Network zijn.
In het geavanceerde dialoogvenster Site Definition moet het pad van je lokale hoofdmap hetzelfde zijn als het pad van de testing server- map (bijvoorbeeld c:\Inetpub\wwwroot\cf_projects\myNewApp\). Je kunt deze paden bekijken en wijzigen door Site > Sites bewerken te selecteren.
Het onderdeel moet worden opgeslagen in de lokale sitemap of een van de submappen op je harde schijf.
Open een ColdFusion-pagina in Dreamweaver en geef de onderdelen weer in het deelvenster Components.Om de onderdelen weer te geven, open je het deelvenster Components (Window > Components), selecteer je CF Components uit het pop-upmenu van het deelvenster en klik je op de knop Refresh op het deelvenster.
Omdat ColdFusion lokaal draait, geeft Dreamweaver onderdeelpakketten weer op je harde schijf.
Ga als volgt te werk om een component te bewerken.
Open een ColdFusion-pagina in Dreamweaver en geef de onderdelen weer in
het deelvenster Components (Window > Components).
Selecteer CF Components in het pop-upmenu van het paneel en
klik op de knop Vernieuwen in het paneel.
Omdat ColdFusion lokaal wordt uitgevoerd, toont Dreamweaver componentpakketten op je harde schijf.
Notitie
Om de CFC-recordset visueel te bewerken, dubbelklik je erop in het paneel Bindingen.
Om een onderdeelbestand in het algemeen te bewerken, open je het pakket
en dubbelklik je op de naam van het onderdeel in de boomstructuur.
Het bestand van de component wordt in de codeweergave geopend.
Om een specifieke functie, argument of eigenschap te bewerken, dubbelklik je
op het item in de boomstructuur.
Breng de wijzigingen handmatig in de codeweergave aan.
Sla het bestand op (Bestand > Opslaan).
Om nieuwe functies te zien in het paneel Components, vernieuw je
de weergave door te klikken op de knop Vernieuwen in de werkbalk van het paneel.
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. Je kunt Dreamweaver gebruiken om je te helpen bij het schrijven van deze code.
Notitie
Voor andere manieren om onderdelen te gebruiken, zie de ColdFusion-documentatie vanuit Dreamweaver (Help > Using ColdFusion).
Open in Dreamweaver de
ColdFusion-pagina die de onderdeelfunctie gaat gebruiken.
Schakel naar de codeweergave (Weergave > Code).
Open het paneel Components (Window > Components)
en selecteer CF Components in het pop-upmenu van het paneel.
Zoek het onderdeel dat je wilt en voeg het in met een van
de volgende technieken:
Sleep een functie vanuit de boomstructuur naar de pagina. De code wordt in de pagina ingevoegd om de functie te activeren.
Selecteer de functie in het paneel en klik op de knop Invoegen in de werkbalk van het paneel (de tweede knop rechts). Dreamweaver voegt de code in op de invoegpositie in de pagina.
Als je een functie invoegt die argumenten heeft, voltooi je
de argumentcode handmatig.
Voor meer informatie, zie de ColdFusion-documentatie vanuit Dreamweaver (Help > ColdFusion gebruiken).
Sla
de pagina op (Bestand > Opslaan).
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.
Notitie
Deze functie is alleen beschikbaar als u toegang hebt tot een computer waarop ColdFusion MX 7 of hoger wordt uitgevoerd. Zie De ColdFusion-verbeteringen inschakelen voor meer informatie.
Maak of open een bestaand CFC-bestand in Dreamweaver.
Klik in het deelvenster Bindingen (Venster > Bindingen)
op de plus-knop (+) en selecteer Recordset (Query) in het
pop-upmenu.
Het dialoogvenster Recordset wordt geopend. Je kunt werken in zowel het eenvoudige als het geavanceerde Recordset-dialoogvenster.
Om een bestaande functie in de CFC te gebruiken, selecteer je de functie
uit het pop-upmenu Functie en ga je door naar stap 5.
De recordset wordt in de functie gedefinieerd.
Om een nieuwe functie in de CFC te definiëren, klik je op de knop Nieuwe functie,
voer je een naam voor de functie in het dialoogvenster dat verschijnt in
en klik je op OK.
De naam mag alleen alfanumerieke tekens en onderstreepjes (_) bevatten.
Om een recordset voor de functie te definiëren, vul je de
opties van het dialoogvenster Recordset in.
De nieuwe functie wordt ingevoegd in de CFC die de recordset definieert.
Gebruik een CFC-recordset als bron voor dynamische content
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.
Notitie
Deze functie is alleen beschikbaar als u toegang hebt tot een computer waarop ColdFusion MX 7 of hoger wordt uitgevoerd. Zie De ColdFusion-verbeteringen inschakelen voor meer informatie.
Open een ColdFusion-pagina in Dreamweaver.
Klik in het paneel Bindingen (Venster > Bindingen)
op de knop Plus (+) en selecteer Recordset (Query) uit het
pop-upmenu.
Het dialoogvenster Recordset wordt geopend. Je kunt werken in het eenvoudige of het geavanceerde dialoogvenster Recordset.
Klik op de knop CFC-query.
Vul het dialoogvenster CFC-query in, klik op OK en klik
vervolgens nogmaals op OK om de CFC-recordset toe te voegen aan de lijst met beschikbare
content-bronnen in het paneel Bindingen.
Gebruik het paneel Bindingen om de recordset te binden aan verschillende
pagina-elementen.
Voor meer informatie, zie Dynamische content aan pagina's toevoegen.
Dynamische content definiëren met een CFC
Je kunt een recordset definiëren als bron van dynamische content in Dreamweaver door een CFC te gebruiken die een recordset-definitie bevat.
1.Voer in het vak Naam een naam in voor de CFC-recordset.
Het is gebruikelijk om het voorvoegsel rs toe te voegen aan recordset-namen 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 pakket uit de pakketten die al gedefinieerd zijn op de server.
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 onderdeel uit de onderdelen die gedefinieerd zijn in het momenteel geselecteerde pakket.
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 Nieuw onderdeel maken om een onderdeel te maken.
a. Voer in het vak Naam de naam voor de nieuwe CFC in. De naam mag alleen alfanumerieke tekens en het onderstrepingsteken (_) bevatten.
b.Voer in het vak Onderdeelmap de locatie voor je CFC in, of verken om de map te vinden.
Notitie
De map moet het relatieve pad naar de hoofdmap van de site zijn.
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.
Notitie
De vakken Verbinding en SQL zijn alleen-lezen.
6.Bewerk elke parameter (type, waarde en standaardwaarde) die moet worden doorgegeven als functieargument 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 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 Test om verbinding te maken met de database 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.
Prachtige websites ontwerpen in Dreamweaver
Ontwerp, codeer en beheer dynamische websites in een krachtige alles-in-één tool.
