• « Back to JsonFx.NET

JsonFx Setup Instructions

• Visual Studio Editor Setup
• JsonFx and ASP.NET MVC Setup
• IIS 6.0 Setup
  • ASP.NET MVC Project Configuration
  • ASP.NET Web Application Project (WAP) or ASP.NET Website Project Configuration

---

JsonFx Discussion Group

A newly created JsonFx Discussion Group is available as a public forum for accouncing new releases, and discussing JsonFx and its usage.

JsonFx Example Code

JsonFx example code can be found on Google Code and is available for SVN checkout.

JsonFx Source Code

JsonFx source code can be found on Google Code and is available for SVN checkout.

---

Visual Studio Editor Setup

When developing JBST templates in Visual Studio, you can improve the experience greatly by mapping the *.jbst extension to the UserControl editor. The syntax is nearly identical so syntax coloring works with JBST templates as well.

To setup syntax coloring:

1. In Visual Studio, close any open JBST templates.
2. Open the Options Dialog ("Tools" » "Options…")
3. Navigate to where you can map extensions to editors ("Text Editor" » "File Extension")
4. Add the extensions "jbst" and "jrpc" setting the editor to "HTML Editor" and hit "Apply":
   
5. Now you should see syntax coloring for all files with the *.jbst and *.jrpc extensions.

---

JsonFx and ASP.NET MVC

If you are using the MVC Template for JsonFx, make sure to also note the server requirements for ASP.NET MVC:

• Using ASP.NET MVC with Different Versions of IIS

Note: In IIS7 Integrated Mode this is automatically done for you via the project's web.config.

The only major server requirement differences between an ASP.NET Web App and an ASP.NET MVC app is setting up a wildcard script mapping to support ASP.NET MVC Routing.

---

IIS 6.0 Setup

ASP.NET MVC Project Configuration

If using the ASP.NET MVC template for JsonFx with IIS 6.0, you will want to add a wildcard script mapping. See the last section of Using ASP.NET MVC with Different Versions of IIS for details. Doing this alleviates the need for the additional script mappings below as all URLs are routed to ASP.NET.

ASP.NET Web Application Project (WAP) or ASP.NET Website Project Configuration

When hosting a JsonFx website in IIS 6.0 (or IIS 7 Classic Pipeline mode), you will need to map the following extensions to ASP.NET:

• *.merge (auto-compacted client scripts, templates, JSON-RPC proxies and stylesheets)
• *.jrpc (JSON-RPC end-points)

And optionally if you want to reference these directly outside of *.merge files:

• *.css (auto-compacted style sheets)
• *.js (auto-compacted client script)
• *.jbst (compiled client-side templates)

To setup the extension mappings:

1. Open IIS Manager ("Start" » "Run" » inetmgr)
2. Edit the properties of your JsonFx website (right-click » "Properties")
3. Open the Application Configuration Dialog ("Home Directory" tab » "Configuration…" button)
   
4. For each mapping to add, click the "Add…" button and fill out the dialog with the path to the ASP.NET asapi DLL (you can copy this from any of the other mappings)