But can't I already use Javascript in the Content View?

New source editing enhancements

New menu items in the view's Tools menu:

• "Use native browser"
  
  This affects how the HTML page content is rendered, after it has been evaluated (e.g. applying any formula insertion or script pre-processing).
  
  This is deselected by default, matching 2.7 behaviour, meaning the page is displayed using Omniscope's built-in rich text display (via Java, based on HTML 3.2, without any support for in-page Javascript).
  
  When selected, the page is displayed by embedding the system web browser (typically IE on Windows), allowing "client-side" scripts to be executed in the browser's Javascript engine, with full access to the HTML DOM, etc. This allows you to build Javascript interactivity and do other native browser behaviours such as embed media.
  
  
• "View in external browser"
  
  Click this to open the same page in an external browser. This allows you to debug your page in a full separate browser; we recommend Google Chrome for its developer tools out-of-the-box. The embedded browser, if IE, has very limited support for debugging.
  
  Note that Javascript native dialogs (alert/confirm/prompt) are disabled in the embedded browser, because it can often lead to a complete freeze of the application. You should use alternative Javascript frameworks instead.
  
  
• "Refresh on change"
  
  By default, the page content is rebuild and the browser refreshed when cell edits or filtering occur. Untick this option to disable. You will need to code in a different means of triggering updates to any data you may have loaded via API / AJAX calls.
  
  Even if ticked, viewing in an external browser will never refresh automatically on change; you will need to manually reload the external browser.
  
  

AJAX requests

Low-level API

• page.html
  
  Returns the page content as text/html after applying pre-processing and evaluating formulas.
  
  No request parameters.
  
  
• eval.json
  
  Evaluates a JS expression on the back-end, with access to formula functions.
  
  Accepts a POST request with text/plain upload body (NOT regular key/value form data), containing a Javascript expression to evaluate against the Content View's dataset as per "script pre-processing". This can be used to query arbitrary formula functions such as subset_max("fieldname"), for example.
  
  Returns JSON { "result": value } where value is the result of the expression; can be a complex object or array.
  
  
• meta.json
  
  Retrieves metadata about the view's data.
  
  No request parameters.
  
  Returns JSON { "fieldCount" : 13, "recordCount": 1052, "fieldNames": ["field1","field2",...], "fieldTypes": ["text","text","date","integer","decimal",...] }
  
  
• cells.json
  
  Retrieves one or more cell values.
  
  Accepts a POST request with the following form key/value pairs:
  "fields": a JSON array of field names; if omitted, all fields are retrieved
  "firstRow": The first row to retrieve, 0-indexed, must be in-bounds; if omitted, zero is used
  "numberOfRows": The number of rows to retrieve; if omitted, all remaining rows are retrieved; automatically capped by the last row in the dataset
  
  Returns JSON { "result": [ [cell00, cell10, cell20], [cell01, cell11, cell21], [cell20, cell21, cell22] ] }
  (where the 2-dimensional array's dimensions reflect the filtered data results, doesn't contain a row for field names, and is indexed [column][row]).
  
  
• edit.json
  
  Writes back one or more cell edits to the data table.
  
  Accepts a POST request with the same key-value pairs as "cells.json", plus:
  "data": a JSON two-dimensional array, in the same format as returned by "cells.json" under the "result" property.
  
  Returns the empty JSON {} to indicate success.
  
  This will only work in licensed editions where editing cell data is permissioned - i.e. not in the free Viewer. It will propagate a change to all views, and you will immediately see the result. You will need to untick "Refresh on change" if you want to avoid the same Content View (which originated the call) from reloading your page.
  
  

<p><b>Total:</b> {{ SUBSET_SUM("Coupon") }}</p>

<#
  if (x==5) {
    y = 3;
  } else {
    y = 2;
  }
  out.println("Write some text into the document, programmatically");
  var array = subset_uniquesList("Category");
  for (var i in array) {
    #>
    <b>Some text and HTML with <#=array[i]#> (inserted values)</b>
    <#
  }
#>

1. Firstly we have the Javascript code itself, which includes the use of a variable called "text1"
2. Then, in the last line, we have the declaration of "text1" (this can be called anything, and needs to be the same name here as inside the script itself, and passing the value of our [Postcode] field into this variable, for use in the script