Statical

Supervision

Supervision is a free software program which can transform C/AL object text files into color-coded hyper-linked interactive HTML files.

The purpose of Supervision is to give Microsoft Dynamics NAV developers an easy and intuitive way to browse C/AL source code which provides better insight into the semantics of C/AL programs.

Sample screenshot

Supervision is tested against Microsoft Dynamics NAV 2009 and NAV 2013.

Status

Features

License

Statical Supervision is provided free and as-is (no warrenties).

You can freely distribute the software as long as it is for free and you do not re-package or re-brand the software.

You are not allowed to reverse-engineer the software and you are not allowed to build and distribute software that processes the output produced by Statical Supervision.

Supervision uses the following 3rd party components licensed as follows:

F# PowerPack is licensed under Apache License 2.0.

Rx (Reactive Extensions) is licensed under Apache License 2.0

Installation

Download and install:

Please note that the previous version may need to be uninstalled before running the installer.

  1. Microsoft .NET Framework 4.5 (Full)
  2. Supervision 1.0.1 (MSI)

Then follow these steps:

  1. Start Supervision
  2. Export the objects you want to supervise via Microsoft Dynamics NAV - you must choose export to text format
  3. In Supervision select the object text file as the source file
  4. In Supervision select an output directory (or create a new one)
  5. Press Process
  6. When the process has finished go to the output directory
  7. Open the index.html file in one of the supported browsers (see Browser Compatibility)

Export an object source text file from Dynamics NAV

Browser Compatibility

Our browser testing has been as follows:

We invite the community to submit Javascript/HTML fixes for improved x-browser compatibility. This is possible because the Javascript files are not compacted or otherwise obfuscated (except jQuery).

How to customize code coloring

We have provided a dark code colour scheme resembling the one provided by Visual Studio 2012. We encourage developers to experiment with different colour schemes. To do that, follow these steps:

  1. Process a C/AL text file exported from NAV
  2. Locate the Cascading Style Sheet (CSS) file dark.css in the folder assets of the output directory
  3. Experiment with colours by adapting the file dark.css and reloading
  4. Once you are happy with the colours, copy dark.css to the installation folder of Supervision, overriding the existing file which is located in the assets folder

If you think your stylesheet may be of use to others, please e-mail the sheet to us, and we may distribute the sheet with future version of to download from our web-site.

Limitations & known bugs

Submitting bug reports

Please note that this is a hobby project and so we do not provide support as such. Nonetheless we are very interested in bug reports so we can add them to the list of known bugs and resolve them when we have the time to do so.

supervision-bugs@stati-cal.com

Other Feedback

Send other feedback to:

feedback@stati-cal.com

What's under the hood

The processing code is written in F#, which is a multi-paradigm language provided by Microsoft. We have almost exclusively used the functional features of F#.

Roughly, the processing consists of this:

For more details, please take a look at our whitepaper, Supervision—F# for Static Analysis.

Staticalon Google+