1. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Sicherungskasten 3.0 (Fusebox 3.0) Michael Smith, TeraTech Inc MDCFUG michael@teratech.com Sandra Clark, Shayna Productions LACFUG slclark@shayna.com

2. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Intro Who am I? Michael Smith President of TeraTech, Inc Rockville MD USA –http://www.teratech.com/http://www.teratech.com/ –ttWebReportServer, CFXGraphicserver MDCFUG, CFUNK2, Fusebox Conf Articles in CFDJ, Fusion Authority

3. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Overview General Concepts and Demo Benefits of Standardization What makes Fusebox 3, Fusebox 3? How Fusebox Works Pros and Cons of Fusebox 3 Transitioning from FB2 to FB3 Links of Interest

4. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org General Concepts There are two ways of constructing a software design: One way is to make it so simple that there are obviously no deficiencies, and the other way is to make it so complicated that there are no obvious deficiencies. The first method is far more difficult. C.A.R. Hoare

5. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Overview Fusebox is a programming methodology (=way to organize code and projects) Not language specific - CF, ASP, PHP Fusebox is „Sicherungskasten“

6. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Demo - overview Mortgage app No DSN required Drag and drop a loan schedule component into the app 1.Show Mortgage site and calculators circuit 2.Show loan app component 3.Drag and drop loan app into calculator circuit

7. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Demo - Wiring in the component 1.Edit /fuses/fbx_circuits.cfm 2.Edit /calculators/fxb_switch.cfm add 3. Edit /calculators/fuses/dsp_calchome.cfm add HTML for new link

8. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Demo - summary That is it! Only two standard files had to be edited to wire in the component. No editing the internals of the code required. Can hand off the HTML to a design for “prettifying” Will explain how this works in the rest of presentation.

9. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org State of the Art: Failure 70% Failure Rate! Not completed Buggy Needs not met Maintenance headaches Cost overruns

10. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Point-to-Point Routing New York Tampa

11. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Hub-and-Spoke System Tampa New York Chicago Seattle Los Angeles

12. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Point-to-Point Programming Module A Module B Module D Module E Module F Module C

13. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Fusebox Programming Module AModule BModule D Module EModule FModule C Fusebox

14. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Benefits of Standardization Better team communication Cheaper maintenance Can pick up others code faster Fewer bugs due to different styles Can think about the fun stuff instead of code structure

15. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Fuses always make requests of the fusebox <input type=“hidden” name=“fuseaction” value=“Tampa”> Fusebox the fusebox a fuse

16. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org The fusebox

17. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Including a fuse The fusebox with a lot of fuseactions …. dsp_anotherFuse.cfm dsp_yetAnotherFuse.cfm act_aFuse.cfm “doSomething” The fuseaction The fuses

18. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org What makes Fusebox? Route Fuseaction via index.cfm Separate fuses in CFINCLUDEs by type –dsp, act, qry, url, fbx Well documented (Fusedoc) for reuse and easier maintenance Group code into circuits Tools and community

19. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org What makes Fusebox 3 Nested Circuits Nested Layouts Compound Fuseactions Exit Fuseactions (XFA’s) XML Fusedocs

20. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Fusebox Project Cycle Wireframe HTML Prototype Prototype + Devnotes Final Code + Devnotes Formal Sign off

21. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Assumptions Basic FB knowledge i.e. –Fuseaction – –Naming of FB files, act_, dsp_, qry_ –Fusebox separates out SQL, CF, HTML and flow control

22. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Bring on FB3 20 October 2001 at 2 nd Fusebox Conference, Orlando. Keynoted by Jeremy Allaire, Hal Helms Two day conference planned for next year, weekend preceeding DevCon 2002 Big change from FB2 Several revisions since launch to produce stable code (NO MAJOR CHANGES!)

23. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Nested Circuits One module is a circuit Parent-child - nested

24. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Nested Layouts

25. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Compound Fuseactions A request made of the server to perform some action is known as a fuseaction. Fuseactions are made up of the circuit name, a dot separator, and the actual request. –Cart.addItem –Users.login –Scheduler.requestMeeting

26. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Exit Fuseactions (XFAs) A hardcoded value for the next fuseaction... – …is replaced with a variable: –

27. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Setting XFAs XFAs represent exit points for a fuseaction. XFA values are set in FBX_Switch.cfm

28. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org XML Fusedocs Fusedocs are now in XML Makes typing them easier – CF Studio help Makes parsing them by programs easier – eg Jeff Peter’s fuse harness program, Bjorkman’s site inspector Makes reading them easier – color coding

29. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Fusedoc A standardized documentation/program definition language for use with Fusebox XML-based (DTD available) Fusedoc tools (in the works)

30. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org How Fusebox Works – A Fusebox Request A fuseaction request is sent to the web server’s default page: Register Now

31. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org A Fusebox Request The default page includes the core Fusebox file:

32. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org A Fusebox Request The fusebox file determines which circuit the request belongs to and includes that circuit’s FBX_Switch.cfm file. This switch file includes one or more fuses needed to fullfill the request:

33. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org A Fusebox Request The circuit is completed by the fuse making a new fuseaction request:...

34. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Transitioning from Fusebox to Fusebox3 A New Prefix – fbx “app_” denotes “application” “fbx_” denotes “fusebox” Our settings only apply to a fusebox, not the entire application, so we’re going with fbx_

35. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org THE FBX FILES fbx_fusebox_cfxx.cfm fbx_settings.cfm fbx_layouts.cfm fbx_switch.cfm fbx_circuits.cfm

36. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org What CHANGED IN index.cfm?

37. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Typical FB2 index.cfm

38. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Typical FB2 index.cfm… App_Locals.cfmfbx_settings.cfm (MyGlobals.cfm = fbx_settings.cfm)

39. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org fbx _ settings.cfm Takes the place of app_globals and app_locals. One fbx_settings file per circuit Let’s take a look…

40. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Typical FB2 index.cfm cf_bodycontent app_layout.cfm fbx_fusebox_cfxx.cfm fbx_layouts.cfm

41. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org fbx _ layouts.cfm Layout settings for the circuit Let’s take a look at a layout file…

42. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Typical FB2 index.cfm Fusebox code in the cfswitch fbx_switch.cfm

43. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Fbx _ switch.cfm Contains the code, nothing else.

44. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Typical FB2 index.cfm

45. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Typical FB2 index.cfm

46. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Typical FB2 index.cfm

47. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Typical FB2 index.cfm

48. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org So what’s in index.cfm? Index.cfm contains the core Fusebox file cfinclude the fbx_fusebox30_cfxx.cfm file -or- copy/paste the code from fbx_fusebox into index.cfm

49. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Fbx _ Fusebox30 _ CFXX.cfm Contains the “guts” of fusebox. Combines several FB2 tags (and then some) You never need to touch this file.

50. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org All Done! That was easy! Transitioning from FB2 to FB3 is not as intimidating as it may sound! If you (or your boss) have strong resistance to change, try doing it in phases…

51. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org FB TRANSITION Phases In the real world, not every organization will switch to FB3 instantly. If this is you, you can transition your methodology in phases: 1.XFAs 2.Fusedocs 3.Plunge in 100%

52. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Migrating Fb2 to Fb3 App_locals.cfm & app_globals > FBX_settings.cfm Application.cfm can go in FBX_Settings.cfm Index.cfm is not strictly the same thing as the ‘Fusebox’ anymore Include core file CFSWITCH into FBX_Switch.cfm Typicallayout.cfm

53. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org FB3 Component Files Core Fusebox files begin with FBX_ prefix –FBX_Settings.cfm –FBX_Circuits.cfm –FBX_Switch.cfm –FBX_Layouts.cfm –FBX_Savecontent.cfm –FBX_Fusebox3XX_CF50.cfm –FBX_Fusebox3XX_CF45.cfm –FBX_Fusebox3XX_CF40.cfm

54. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org FBX_Settings.cfm Optional – although need to modify suppresserrors=true, (best to have empty fbx_settings.cfm for future use) Sets variables needed by the application Each circuit may have its own FBX_Settings.cfm Called from top down, ie Child over rides Parent Replaces myGlobals.cfm, app_Globals.cfm and app_locals.cfm

55. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org FBX_Circuits.cfm REQUIRED in home circuit Maps circuit aliases to physical paths Circuit alias is a key within a structure called Circuits within reserved structure Fusebox Fusebox.Circuits.home=Grandparent; Fusebox.Circuits.parent=Grandparent/Parent; Fusebox.Circuits.child=Grandparent/Parent/Child; …

56. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org FBX_Switch.cfm Placed in every circuit that will handle fuseactions. statement with a for each fuseaction the circuit will handle

57. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org FBX_Layouts.cfm Required in any circuit that implements a separate layout file Sets variables, Fusebox.layoutDir and Fusebox.layoutFile Fusebox.layoutfile should output Fusebox.layout (minimum)

58. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org FBX_Savecontent.cfm Only used if CF version not 5 Is basically the tag Macromedia implemented in CF5

59. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org FBX_Fusebox3XX_CFXX.cfm Only one will be called Specific version for each CF version Optimised for app server version _nix versions added recently to overcome platform issues (CFRETHROW on nix) SHOULD NOT BE EDITED!

60. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Core Files? Performs all jobs FB2 custom tags did –CF_bodycontent –CF_formUrl2Attributes –CF_nesting –Etc… Exposes public API variables

61. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Public API variables Fusebox.isCustomTag Fusebox.isHomeCircuit Fusebox.isTargetCircuit Fusebox.fuseaction Fusebox.circuit Fusebox.homeCircuit Fusebox.targetCircuit Fusebox.thisCircuit

62. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Public API variables (cont…) Fusebox.thisLayoutFile Fusebox.thisLayoutDir Fusebox.CurrentPath Fusebox.RootPath Fusebox.layout Fusebox.SupressErrors

63. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Resources Fusebox core files are freely available from www.fusebox.org Various sites have free tutorials, white papers, sample code, etc. –www.halhelms.com –www.grokfusebox.com –www.bjork.net –www.beynon.org.uk –www.bombusbee.com –php version Hal Helms articles in CFDJ magazine

64. More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org More on Fusebox at www.halhelms.com Fusebox Development Methodology : www.fusebox.org Questions? michael@teratech.com Fusebox book Fusebox classes – in Rockville and onsite