פתחו דף ColdFusion ב-Dreamweaver.
עודכן לאחרונה בתאריך
25 באפריל 2024
פתק
התמיכה ב-ColdFusion הוסרה מ-Dreamweaver ואילך.
אודות רכיבי ColdFusion
קבצי רכיב ColdFusion (CFC) מאפשרים לכם לעטוף לוגיקת יישום ועסקים ביחידות עצמאיות וניתנות לשימוש חוזר.רכיבי CFC מספקים גם דרך מהירה וקלה ליצור שירותי אינטרנט.
CFC הוא יחידת תוכנה הניתנת לשימוש חוזר שנכתבת בשפת הסימון של ColdFusion (CFML), מה שמקל על שימוש חוזר ותחזוקה של הקוד שלכם.
ניתן להשתמש ב-Dreamweaver לעבודה עם קובצי CFC. למידע על תגי CFC ותחביר, עיינו בתיעוד ColdFusion מתוך Dreamweaver (עזרה > שימוש ב-ColdFusion).
פתק
ניתן להשתמש בקובצי CFC רק בשילוב עם ColdFusion MX וגרסאות מאוחרות יותר. רכיבי CFC אינם נתמכים ב-ColdFusion 5.
רכיבי CFC נועדו לספק דרך פשוטה אך עוצמתית למפתחים לעטוף אלמנטים של אתרי האינטרנט של שלהם. בדרך כלל, כדאי להשתמש ברכיבים עבור לוגיקת יישומים או עסקים.השתמשו בתגים מותאמים אישית עבור רכיבי הצגה כמו ברכות מותאמות אישית, תפריטים דינמיים וכדומה.
כמו בסוגים רבים אחרים של בנייה, אתרים דינמיים יכולים לעתים קרובות להפיק תועלת מחלקים הניתנים להחלפה.לדוגמה, אתר דינמי עשוי להפעיל את אותה שאילתה שוב ושוב, או לחשב את המחיר הכולל של דפי עגלת הקניות ולחשב אותו מחדש בכל פעם שפריט מתווסף. משימות אלה יכולות להיות מטופלות על-ידי רכיבים. אתם יכולים לתקן, לשפר, להרחיב ואפילו להחליף רכיב עם השפעה מינימלית על שאר היישום שלכם.
נניח שחנות מקוונת מחשבת דמי משלוח על בסיס מחיר ההזמנות. עבור הזמנות מתחת ל-20$, דמי המשלוח הם 4$; עבור הזמנות בין 20$ ל-40$, דמי המשלוח הם 6$, וכן הלאה. אתם יכולים לשלב את הלוגיקה לחישוב דמי המשלוח גם בדף עגלת הקניות וגם בדף התשלום, אבל זה יערבב קוד מצגת HTML וקוד לוגיקה של CFML ובדרך כלל יהפוך את הקוד לקשה לתחזוקה ולשימוש חוזר.
אתם מחליטים ליצור CFC בשם Pricing שכולל, בין השאר, פונקציה בשם ShippingCharge. הפונקציה מקבלת מחיר כארגומנט ומחזירה דמי משלוח. לדוגמה, אם הערך של הארגומנט הוא 32.80, הפונקציה מחזירה 6.
גם בדף עגלת הקניות וגם בדף התשלום, אתם מכניסים תג מיוחד להפעלת הפונקציה ShippingCharge. כאשר מבקשים את הדף, הפונקציה מופעלת ודמי משלוח מוחזרים לדף.
מאוחר יותר, החנות מכריזה על קידום מיוחד: משלוח בחינם עבור כל ההזמנות מעל 100 $.אתם מבצעים את השינוי בתעריפי המשלוח במקום אחד—הפונקציה ShippingCharge של רכיב Pricing—וכל הדפים שמשתמשים בפונקציה באופן אוטומטי מקבלים דמי משלוח מדויקים.
סקירה של החלונית Components (ColdFusion)
השתמשו בלוח הרכיבים (חלון > רכיבים) כדי להציג ולערוך רכיבי ColdFusion, והוסיפו קוד בדף שמפעיל את הפונקציה כאשר מתבקש דף CFM.
פתק
לוח הרכיבים זמין רק כאשר צופים בדף ColdFusion ב-Dreamweaver.
יצירה או מחיקה של CFC ב-Dreamweaver
ניתן להשתמש ב-Dreamweaver כדי להגדיר CFC ואת הפוקנציות שלו באופן חזותי. Dreamweaver יוצר קובץ .cfc ומכניס עבורכם את תגי ה-CFML הדרושים.
פתק
בהתאם לרכיב, ייתכן שיהיה עלייך להשלים חלק מהקוד ידנית.
בלוח Components (חלון > Components), בחרו CF Components מהתפריט הנפתח.
לחצו על הלחצן Plus (+), והשלימו את תיבת הדיאלוג Create Components ולחצו על OK.
א.באזור Components, הזן פרטים על הרכיב. רשימה חלקית:
Name ציון שם הקובץ של הרכיב. השם חייב לכלול רק תווים אלפא-נומריים וקווים תחתונים (_). בעת הזנת השם, אל תציין את הסיומת של קובץ .cfc.
Component Directory ציון המקום שהרכיב נשמר בו. בחר בתיקיית השורש של היישום (לדוגמה \Inetpub\wwwroot\myapp\) או בכל אחת מתיקיות המשנה שלה.
ב.כדי להגדיר פונקציה אחת או יותר עבור הרכיב, בחרו Functions מרשימת Section, לחצו על הלחצן Plus (+) והזינו את הפרטים של הפונקציה החדשה.
ודא שציינת את סוג הערך שיוחזר על-ידי הפונקציה באפשרות Return Type.
פתק
בעת בחירה באפשרות remote מתפריט Access, הפונקציה הופכת לזמינה כשירות אינטרנט.
ג. כדי להגדיר ארגומנט אחד או יותר עבור פונקציה, בחרו Arguments מרשימת Section, בחרו את הפונקציה מהתפריט הנפתח, לחצו על הלחצן Plus (+) והזינו את הפרטים של הארגומנט החדש בצד ימין.
אם אתם משתמשים בשרת פיתוח מרוחק, העלו את קובץ ה-CFC וכל הקבצים התלויים (כגון אלה המשמשים ליישום פונקציה או קובצי include) לשרת המרוחק.
העלאת הקבצים מבטיחה שתכונות Dreamweaver כגון Live view ו-Preview In Browser יעבדו כראוי.
Dreamweaver כותב קובץ CFC ושומר אותו בתיקייה שציינתם. הרכיב החדש מופיע גם בלוח Components (לאחר לחיצה על Refresh).
אם אתם משתמשים בשרת פיתוח מרוחק, העלו את קובץ ה-CFC וכל הקבצים התלויים (כגון אלה המשמשים ליישום פונקציה או קובצי include) לשרת המרוחק.
הצגת קובצי CFC ב-Dreamweaver
Dreamweaver מאפשר לבצע בדיקה חזותית של רכיבי ColdFusion (CFC) הממוקמים בתיקיית אתר האינטרנט או בשרת כמכלול אחד. Dreamweaver קורא את קובצי ה-CFC ומציג מידע עליהם בתצוגת עץ קלה לניווט בלוח Components.
Dreamweaver מחפש את הרכיבים בשרת הבדיקה שלכם (ראו Connecting to the database in Dreamweaver). בעת יצירת CFC חדש או שינוי CFC קיים, ודא שהעלאת את קובצי CFC לשרת הבדיקה כך שהם ישתקפו באופן מדויק בחלונית Components.
להצגת רכיבים שנמצאים בשרת אחר, שנה את הגדרות שרת הבדיקה.
ניתן להציג כל אחד מהנתונים הבאים לגבי רכיבי CF:
הצג רשימה של כל רכיבי ColdFusion שהוגדרו בשרת.
בעת שימוש ב- ColdFusion MX 7 או בגרסה מאוחרת יותר, סנן את הרשימה כדי להציג רק קובצי CFC ששמורים בתיקיית אתר האינטרנט.
חקור את הפונקציות והארגומנטים של כל אחד מהרכיבים.
בדוק את מאפייני הפונקציות המשמשות כשירותי אינטרנט.
פתק
לשימוש ב- Dreamweaver לבדיקת קובצי CFC ששמורים בתיקיית השורש של השרת ולניהול קובצי אתר האינטרנט בתיקיית שורש של אתר אחר בו-זמנית, ניתן להגדיר שני אתרי Dreamweaver. הגדר את האתר הראשון כך שיצביע על תיקיית השורש של השרת והגדר את האתר השני כך שיצביע על תיקיית השורש של אתר האינטרנט. כדי לעבור במהירות מאתר לאתר, השתמש בתפריט הנפתח לבחירת האתר בחלונית Files.
להצגת CFC ב- Dreamweaver, בצע את הצעדים הבאים:
פתח דף ColdFusion כלשהו ב-Dreamweaver.
בלוח Components (חלון > Components),
בחרו CF Components מהתפריט הנפתח.
לחצו על הלחצן Refresh בלוח כדי לאחזר את
הרכיבים.
חבילת הרכיבים מוצגת בשרת. חבילת רכיב היא תיקייה המכילה קובצי CFC.
אם חבילות רכיבים קיימות לא מופיעות, לחצו על הלחצן Refresh בסרגל כלים של הלוח.
כדי להציג רק את קובצי ה-CFC הממוקמים בתיקיית האתר שלכם,
לחצו על הלחצן Show Only Current Site's CFCs בסרגל הכלים
של לוח Components.
פתק
תכונה זו זמינה רק אם הגדרתם מחשב שמריץ ColdFusion MX 6 או גרסה מאוחרת יותר כשרת בדיקה עבור Dreamweaver.
פתק
אם האתר הנוכחי רשום בתיקייה וירטואלית בשרת המרוחק, הסינון לא עובד.
לחצו על לחצן ה-Plus (+) ליד שם החבילה כדי להציג את הרכיבים השמורים בחבילה.
כדי להציג את הפונקציות של רכיב, לחצו על הלחצן Plus (+) ליד שם הרכיב.
כדי לראות את הארגומנטים שפונקציה מקבלת, כמו גם את סוג הארגומנטים ואם הם נדרשים או אופציונליים, פתחו את ענף הפונקציה בתצוגת העץ.
לפונקציות שלא מקבלות ארגומנטים אין לחצן Plus (+) לידן.
כדי להציג במהירות את הפרטים של ארגומנט, פונקציה, רכיב או חבילה, בחרו את הפריט בתצוגת העץ ולחצו על הלחצן Get Details בסרגל הכלים של הלוח.
באפשרותכם גם לבצע לחיצה באמצעות הלחצן הימני (Windows) או Control-click (Macintosh) על הפריט ולבחור Get Details מהתפריט הנפתח.
פרטים על הפריט מוצגים בתיבת הודעה.
עריכת קובצי CFC ב-Dreamweaver
Dreamweaver מספק דרך יעילה לעריכת הקוד של רכיבי ColdFusion המוגדרים עבור האתר שלכם.לדוגמה, תוכלו להוסיף, לשנות או למחוק כל פונקציית רכיב מבלי לעזוב את Dreamweaver.
כדי להשתמש בתכונה זו, סביבת הפיתוח שלכם חייבת להיות מוגדרת באופן הבא:
ColdFusion חייב לפעול במחשב המקומי.
בתיבת הדו-שיח המתקדמת של הגדרת האתר ב-Dreamweaver, סוג הגישה שצוין בקטגוריית שרת הבדיקה חייב להיות Local/Network.
בתיבת הדו-שיח המתקדמת של הגדרת האתר, הנתיב של תיקיית השורש המקומית שלכם חייב להיות זהה לנתיב של תיקיית שרת הבדיקה (לדוגמה, c:\Inetpub\wwwroot\cf_projects\myNewApp\). תוכלו לבדוק ולשנות נתיבים אלה על ידי בחירה ב-Site > Edit Sites.
הרכיב חייב להיות מאוחסן בתיקיית האתר המקומי או בכל אחת מתת-התיקיות שלו בכונן הקשיח שלכם.
פתחו כל עמוד ColdFusion ב-Dreamweaver והציגו את הרכיבים בלוח הרכיבים.כדי להציג את הרכיבים, פתחו את לוח הרכיבים (Window > Components), בחרו CF Components מהתפריט הקופץ של הלוח, ולחצו על לחצן הרענון בלוח.
מכיוון ש-ColdFusion פועל מקומית, Dreamweaver מציג חבילות רכיבים בכונן הקשיח שלכם.
לעריכת רכיב, בצע את הפעולות הבאות.
פתחו כל עמוד ColdFusion ב-Dreamweaver והציגו את הרכיבים
בלוח הרכיבים (Window > Components).
בחרו CF Components מהתפריט הקופץ של הלוח,
ולחצו על לחצן הרענון בלוח.
מכיוון ש-ColdFusion פועל מקומית, Dreamweaver מציג חבילות רכיבים בכונן הקשיח שלכם.
פתק
כדי לערוך את רשומות ה-CFC באופן ויזואלי, לחצו לחיצה כפולה עליו בלוח הקישורים.
כדי לערוך קובץ רכיב באופן כללי, פתחו את החבילה
ולחצו לחיצה כפולה על שם הרכיב בתצוגת העץ.
קובץ הרכיב נפתח בתצוגת Code.
כדי לערוך פונקציה, ארגומנט או מאפיין ספציפיים, לחצו לחיצה כפולה
על הפריט בתצוגת העץ.
בצע את השינויים באופן ידני בתצוגת Code.
שמור את הקובץ (File > Save).
כדי לראות כל פונקציה חדשה בלוח הרכיבים, רעננו
את התצוגה על ידי לחיצה על לחצן הרענון בסרגל הכלים של הלוח.
בניית דפי אינטרנט המשתמשים ב-CFC
דרך אחת לשימוש בפונקציה של רכיב בדפי אינטרנט היא כתיבת קוד בדף שמפעיל את הפונקציה בעת בקשת הדף. תוכלו להשתמש ב-Dreamweaver כדי לעזור לכם לכתוב קוד זה.
פתק
לדרכים נוספות להשתמש ברכיבים, עיינו בתיעוד של ColdFusion מתוך Dreamweaver (Help > Using ColdFusion).
ב-Dreamweaver, פתחו את
עמוד ה-ColdFusion שישתמש בפונקציית הרכיב.
עבור לתצוגת Code (View > Code).
פתחו את לוח הרכיבים (Window > Components),
ובחרו CF Components מהתפריט הקופץ של הלוח.
מצאו את הרכיב הרצוי והכניסו אותו באמצעות אחת
מהטכניקות הבאות:
גררו פונקציה מתצוגת העץ אל העמוד.קוד להפעלת הפונקציה נוסף לדף.
בחרו את הפונקציה בלוח ולחצו על לחצן הכנס בסרגל הכלים של הלוח (הלחצן השני מימין).Dreamweaver מכניס את הקוד בעמוד בנקודת ההכנסה.
אם אתם מכניסים פונקציה שיש לה ארגומנטים, השלימו את קוד הארגומנטים באופן ידני.
למידע נוסף, עיינו בתיעוד של ColdFusion מתוך Dreamweaver (עזרה > שימוש ב‑ColdFusion).
שמרו
את העמוד (קובץ > שמירה).
הגדרת ערכת רשומות ב-CFC
Dreamweaver יכול לסייע בהגדרת ערכת רשומות (הנקראת גם שאילתת ColdFusion) ברכיב ColdFusion (CFC). בעת הגדרת ערכת רשומות ב-CFC, אין צורך להגדיר את ערכת הרשומות בכל אחד מהדפים המשתמשים בה. ניתן להגדיר את ערכת הרשומות פעם אחת ב- CFC ולהשתמש ב- CFC בעמודים שונים.
פתק
תכונה זו זמינה רק אם יש לך גישה למחשב שפועל בו ColdFusion MX 7 או גרסה מתקדמת יותר. למידע נוסף, ראה הפעלת שיפורי ColdFusion.
צור קובץ CFC או פתח קובץ CFC קיים ב-Dreamweaver.
בלוח הקישורים (חלון > קישורים),
לחצו על הלחצן פלוס (+) ובחרו Recordset (שאילתה) מהתפריט
המוקפץ.
מופיעה תיבת הדו-שיח RecoRDSet. אתם יכולים לעבוד בתיבת הדו‑שיח של Recordset הפשוטה או המתקדמת.
כדי להשתמש בפונקציה קיימת ב‑CFC, בחרו את הפונקציה
מהתפריט המוקפץ Function ודלגו לשלב 5.
ערכת הרשומות מוגדרת בפונקציה.
כדי להגדיר פונקציה חדשה ב‑CFC, לחצו על הלחצן New Function,
הזינו שם לפונקציה בתיבת הדו‑שיח שתופיע
ולאחר מכן לחצו על OK.
השם חייב להכיל רק תווים אלפא‑נומריים וקווים תחתונים (_).
כדי להגדיר recordset לפונקציה, השלימו את
האפשרויות בתיבת הדו‑שיח Recordset.
הפונקציה החדשה מוכנסת ל‑CFC שמגדיר את ה‑recordset.
השתמשו ב‑CFC recordset כמקור לתוכן דינמי
ניתן להשתמש ברכיב ColdFusion (CFC) כמקור תוכן דינמי לעמודים אם הרכיב כולל פונקציה המגדירה ערכת רשומות.
פתק
תכונה זו זמינה רק אם יש לך גישה למחשב שפועל בו ColdFusion MX 7 או גרסה מתקדמת יותר. למידע נוסף, ראה 'הפעלת שיפורי ColdFusion'.
פתח דף ColdFusion כלשהו ב-Dreamweaver.
בלוח הקישורים (חלון > קישורים),
לחצו על הלחצן פלוס (+) ובחרו Recordset (שאילתה) מהתפריט
המוקפץ.
מופיעה תיבת הדו-שיח RecoRDSet. אתם יכולים לעבוד בתיבת הדו‑שיח של Recordset הפשוטה או המתקדמת.
לחץ על הלחצן CFC Query.
השלימו את תיבת הדו‑שיח CFC query, לחצו על OK ולאחר מכן
לחצו על OK שוב כדי להוסיף את ה‑CFC recordset לרשימת
מקורות התוכן הזמינים בלוח הקישורים.
השתמשו בלוח הקישורים כדי לקשור את ה‑recordset לאלמנטים
שונים בעמוד.
למידע נוסף, עיינו בהוספת תוכן דינמי לעמודים.
הגדירו תוכן דינמי באמצעות CFC
אתם יכולים להגדיר recordset כמקור לתוכן דינמי ב‑Dreamweaver באמצעות CFC שמכיל הגדרת recordset.
1.בתיבת השם, הזינו שם ל‑CFC recordset.
נוהג נפוץ הוא להוסיף את הקידומת rs לשמות recordset כדי להבדיל בינם לבין שמות אובייקטים אחרים בקוד, לדוגמה: rsPressRelease.
שם ערכת הרשומות חייב לכלול רק תווים אלפא-נומריים וקווים תחתונים (_). לא ניתן להשתמש בתווים מיוחדים או ברווחים.
2.בחרו חבילה מבין החבילות שכבר הוגדרו בשרת.
אם החבילה אינה מופיעה בתפריט הנפתח, ניתן לרענן את רשימת החבילות על-ידי על הלחצן Refresh ליד התפריט הנפתח.
ודא שהעלאת את קובצי CFC לשרת הבדיקה תחילה. רק קובצי CFC שנמצאים בשרת הבדיקה מוצגים.
3.בחרו רכיב מבין הרכיבים שהוגדרו בחבילה שנבחרה כעת.
אם התפריט הנפתח Component אינו מכיל רכיבים כלשהם, או אם אף אחד מהרכיבים שיצרת קודם לכן מוצג בתפריט, עלייך להעלות את קובצי CFC לשרת הבדיקה.
4.(אופציונלי) כדי ליצור רכיב, לחצו על הלחצן Create New Component.
א.בתיבה Name, הזן שם ל-CFC החדש. השם חייב לכלול רק תווים אלפא-נומריים וקווים תחתונים (_).
ב.בתיבת Component Directory, הזינו את המיקום עבור ה‑CFC שלכם או עיינו כדי לאתר את התיקייה.
פתק
התיקייה חייבת להיות הנתיב היחסי לתיקיית השורש של אתר האינטרנט.
5.מהתפריט הקופץ Function בחרו את הפונקציה שמכילה את הגדרת recordset.
התפריט הנפתח Function כולל רק את הפונקציות שהוגדרו ברכיב הנוכחי שנבחר. אם התפריט הנפתח אינו מכיל פונקציות כלשהן, או אם השינויים האחרונים שביצעת אינם משתקפים בפונקציות הנוכחיות הרשומות, ודא ששמרת את השינויים האחרונים והעלאת אותם לשרת.
פתק
התיבות Connection ו- SQL מיועדות לקריאה בלבד.
6.ערכו כל פרמטר (סוג, ערך וערך ברירת מחדל) שצריך להעביר כארגומנט לפונקציה על ידי לחיצה על הלחצן Edit.
א.הזן ערך לפרמטר הנוכחי על-ידי בחירת סוג הערך בתפריט הנפתח Value והזנת הערך בתיבה מימין. סוג הערך חייב להיות פרמטר URL, משתנה טופס, cookie, משתנה מופע, משתנה יישום או ערך שהוזן.
ב.הזן ערך ברירת מחדל לפרמטר בתיבה Default Value. אם לא מוחזר ערך כלשהו בזמן ריצה, יעשה שימוש בערך ברירת המחדל של הפרמטר.
c.לחצו על OK.
לא ניתן לשנות את החיבור למסד הנתונים ואת שאילתת SQL של ערכת הרשומות. שדות אלה אינם פעילים לעולם - החיבור ושאילתת SQL מוצגים לעיונך בלבד.
7.לחצו על Test כדי להתחבר למסד הנתונים וליצור מופע של ה-recordset.
אם הצהרת SQL כוללת פרמטרי עמוד, ודא שהעמודה Default Value בתיבה Parameters כוללת ערכים חוקיים לבדיקה לפני שתלחץ על הלחצן Test.
אם השאילתה הופעלה בהצלחה, ערכת הרשומות מוצגת בטבלה. כל אחת מהשורות כוללת רשומה וכל אחת מהעמודות מייצגת שדה ברשומה.
לניקוי CFC Query, לחץ על OK.
8.לחצו על Ok.
בניית אתרי אינטרנט יפהפיים ב-Dreamweaver
עיצוב כתיבת קוד וניהול אתרי אינטרנט דינמיים בכלי רב עוצמה כולל.
