U Man Genius docs
Pages
Ninext documentation
Native JS
Jacques TUR
Native JS allows you to execute JavaScript code within a Ninox script and share functions and variables with it. This way, Native JS can access Ninox variables and call both local and global functions.
Limitations
Modifying a Ninox variable in NativeJS does not affect the Ninox variable.
JavaScript is executed only locally. Adding JavaScript to code that runs on the server has no effect. Likewise, calling a global function that contains JavaScript from code executed on the server has no effect.
See here for the codes that are executed locally and on the server :
Syntax
Execution
To specify to Ninox that you are switching to JavaScript, you need to enclose the code within #{ ... }#.:
#{ alert("hello world") }#;
Remember, Ninox is a pre-compiled language that needs to know the type of each variable and function in advance. The same applies to Native JS: you must specify the type returned by the JavaScript code. By default, Native JS returns text, but you can indicate the type of variable you want to return by specifying it at the very beginning of the code with the notation :[type]. :
Return value
#{:text return "hello world"}#;
The possible types are the same as those used for function calls: text, number, date, datetime, time, timeinterval, appointment, boolean, html, color, icon, email, phone, location, file, user, and any.
Array types
To return an array, use the following syntax :
#{:number(array) return [1,2,3] }#;
Record types
To return records, use the table name followed by nid or rid:
If you use nid, you must return an array of text values containing the full record identifier, which includes the table identifier + record number:
#{:nid(customer) return ['A1','A2','A3'] }#
If you use rid, you should return the record number :
#{:rid(customer) return [1,2,3] }#
For compound table names, do not add ‘ as in Ninox, but simply use the full name of the table :
#{:rid(my long name table) return [1,2,3] }#
By using this syntax, Native JS returns variables that behave the same way as Ninox code. This means you can use the following syntax as if it were a select :
(#{:rid(customer) return [1,2,3] }# order by 'Last Name').'First Name';
Record modification
Record-type variables are passed in JSON format, with a key-value pair for each field of the record.
var r := first(select Customer);
#{:text return r['First Name'] }#;
Here, the content of the variable r in JavaScript looks like this :
{
"Created on": 1648910817206,
"Id": "A1",
"Last modified": 1714817525840,
"Modified by": "7zBqhAKXxfQAPmH7Y",
"First Name": "Sofia",
"Last Name": "Young",
"Company": "Kollwitz GmbH",
"Postal Code": "12345",
"City": "New Jersey",
"Address": "11,South Commerce Street",
"Email": "sofi@kollwitz-gmbh.com",
"Customer No": "K0001",
"Title": "2",
"Invoices": [
1,
16,
17
],
"Photo": "shutterstock_307218608.jpg",
"Category": "1",
"Position": "Marketing head",
"Checked": true,
"ID": "A1",
"id": "A1"
}
Important
Depending on whether the code is executed on the Mac application or on the web, the ID may have different casing.
To address this and avoid conflicts between different platforms, the ID is repeated with all possible casing variations.
Modifying the record in JavaScript does not update it in Ninox.
Asynchronous Execution
Sometimes, it is useful to synchronize the execution of Ninox code with JavaScript.
For example, when using a timer, it is important that the code only completes after the timer has finished executing.
Without this synchronization, the code following the JavaScript execution would run immediately, potentially causing unexpected behavior.
In this first case, the value “I don’t know” is returned immediately, and the alert function displays the result before the question is even presented to the user.
var r:= #{:text
setTimeout( () => {
if (confirm("Are you ok ?"))
return "of course";
else
return "Never !";
}, 2000);
return "I don't know";
}#;
alert( "Your answer is : "+r );
By switching to mode, callback, the Ninox alert function executes only after the JavaScript code has called the callback function, meaning after the question has been presented to the user.
var r:= #{:text:callback
setTimeout( () => {
if (confirm("Are you ok ?"))
callback( "of course" );
else
callback( "Never !" );
}, 2000);
return "I don't know";
}#;
alert( "Your answer is : "+r );
Function Call
It is possible to call Ninox functions from JavaScript. The procedure can be local or global; it just needs to be within the scope of the JavaScript code.
function display( message : text ) do
alert( message );
end;
#{ display('hello world') }#;
To retrieve the return value of a function, you must again use callback mode (see above :) :
function add( a : number, b : number ) do
a + b;
end;
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.