This chapter describes the environment options you can change to enhance your experience using Nexacro Studio.
From the [Tools > Option] Menu, you can configure the Nexacro Studio development environment.
Options – Project
Project-related options are visible only while a project is opened. The option values are managed separately according to projects.
General
You can set up general options for managing a project.
Option | Description | |
|---|---|---|
1 | Base Lib Path | Designates the path to default libraries used by the project. |
2 | Migration | Sets the migration option for file versions lower than Nexacro Studio 17 can support • Ask everytime: Asks you every time whether to migrate files • Do not ask & maintain version: Not conducts migration without asking you • Do not ask & update version always: Conducts migration without asking you |
3 | File Parsing | Determines what types of file contents are displayed in the Project Explorer by parsing the components and scripts included in XFDL, XJS and JS files. This option is applied when a project is opened. • None (only filename): no file contents are displayed. • All: all file contents are displayed. • Services: the file contents of designated services are only displayed. |
Loading time can be prolonged if you select "All" for the File Parsing option while the opened project includes a number of files.
You can display the file contents later after you select "None" for the File Parsing option. To this end, select a project or service in the Project Explorer and then select [Parsing Files] from the context menu.
Startup
You can set the actions conducted at the time of loading a project.
Menu | Description | |
|---|---|---|
1 | Load layout information of a business service/metadata on Startup | Determines whether to load business services and metadata and to show them on the Project Explorer when Nexacro Studio begins. |
Generate
Gereral
Description | ||
|---|---|---|
1 | Generate Path | Specifies the path for saving the files that are produced as the result of building a project. If the Generate path is equal to or located under the Deploy path, the project may not work properly. |
2 | Css Generate | Selects web browsers for which CSS files will be created. The CSS files for unselected browsers will not be created. |
3 | Use RTL | This option determines whether to generate CSS files for the use of the right-to-left (RTL) layout. You must select this option when you use an RTL-related property. If you select this option not from the beginning, you should re-generate theme and XCSS files by yourself. |
Microsoft Edge displayed like IE11 in the browser selection list means version 44 or earlier, and Microsoft Edge (Chromium) displayed like Chrome means version 80 or later.
CSS files will not be created for the web browsers not selected in the Css Generate option. Moreover, there is no guarantee that the relevant app will work properly in such unselected browsers.
For example, your app may not work properly in IE8 if you do not create a CSS file for IE8.
When the Use RTL option is selected, the sizes of the XCSS files in an app may get bigger because code for the RTL layout is added to all selectors in the process of generation. This increase in size is likely to affect the performance of the app negatively.
If XCSS code is included in a theme file, Nexacro Platform can offer an optimization scheme for processing the repetitions contained in the XCSS code. If you implement RTL, therefore, you are recommended to use a theme file instead of applying XCSS files to the app separately.
Event
It executes the specified command before or after running Generate and then displays the results in the Output window.
Property | Description | |
|---|---|---|
1 | ...before generate | Executes the specified command in the Command item before running Generate. |
2 | ...after generate | Executes the specified command in the Command item after Generate execution is completed. |
If there is a value returned after executing the specified command, then it is displayed in the Output window.
Easy UI
It sets the storage path for the files created when using the Easy UI function.
Form Template, Viewset Template
It sets the storage path for the Form template and the ViewSet template file. A folder with the template name is created, and the necessary files are created in the folder. For the ViewSet template, the default path is the viewset folder under the Form template path.
C:\Users\[user]\Documents\nexacro\17.1\templates\user\formTemplate C:\Users\[user]\Documents\nexacro\17.1\templates\user\formTemplate\viewset
The Display by Type item sets the format in which the Template is displayed in the Form Wizard. If it is the default value (true), then Form Templates and Viewset Templates are displayed separately, and if it is set to false, then they are displayed in the order of the folder name.
View Template
It sets the path where the View Template file (.xviewgen) is saved.
C:\Users\[user]\Documents\nexacro\17.1\templates\user\viewtemplate
Deploy
You can set options related to project deployment.
General
Option | Description | |
|---|---|---|
1 | Deploy Path | Designates the output path used in the Deploy menu. |
2 | Merge | - Merge JSON file Determines whether to create a single JavaScript file by combining the JavaScript files specified in the JSON file. - Merge XCSS file used by Application Determines whether to create a single XCSS file by combining the XCSS files used in an Application |
3 | Compile | Configures the settings for compiling the scripts of a project file to deploy |
The selected options will apply to deployment-related wizards as default values and also to the process of the Auto Deploy feature.
Compress
Option | Description | |
|---|---|---|
Compress Options | Sets the options for compressing and obfuscating the scripts of a project file to deploy. The configured options will represent the default values for the deployment-related wizards and be applied to the Auto Deploy feature as well. 1 removes whitespaces and comments 2 obfuscates JavaScript files 3 obfuscates JavaScript files regardless of eval functions (not recommended) | |
4 | Ignore compress files | Specifies a list of files that will be excluded in the process of compression The list will be saved in the .ignorecompress file, which is located under the directory where the relevant XPRJ file is stored. |
For the code created when Compress Options is applied, please refer to the process below. It is the script code written in the Form_Work.xfdl file.
$r_title(Form_Work.xfdl)
// Button01 Test
this.Button00_onclick = function(obj:nexacro.Button,e:nexacro.ClickEventInfo)
{
var temp_btn = "TEST";
eval("trace('test'"+temp_btn+")");
};
/************************************************************************
* Button Test
************************************************************************/
this.Button01_onclick = function(obj:nexacro.Button,e:nexacro.ClickEventInfo)
{
var temp_btn = "TEST";
trace('TEST_2'+temp_btn);
};The code below is the created JavaScript code when none of the Compress Options are selected.
$r_title(Form_Work.xfdl.js)
// Button01 Test
this.Button00_onclick = function(obj,e)
{
var temp_btn = "TEST";
eval("trace('test'"+temp_btn+")");
};
/************************************************************************
* Button Test
************************************************************************/
this.Button01_onclick = function(obj,e)
{
var temp_btn = "TEST";
trace('TEST_2'+temp_btn);
};The code below is the code with blank characters and comments removed by applying only the first option.
$r_title(Form_Work.xfdl.js / Option 1)
this.Button00_onclick=function(obj,e){var temp_btn="TEST";eval("trace('test'"+temp_btn+")");};this.Button01_onclick=function(obj,e){var temp_btn="TEST";trace('TEST_2'+temp_btn);};The code below is the code that processed obfuscation by applying up to the second option. The part with the eval function was not processed for obfuscation.
$r_title(Form_Work.xfdl.js / Option 1, 2)
this.Button00_onclick=function(obj,e){var temp_btn="TEST";eval("trace('test'"+temp_btn+")");};this.Button01_onclick=function(_a,_b){var _c="TEST";trace('TEST_2'+_c);};The code below is the code with up to the third option applied. Regardless of the eval function, it processes obfuscation throughout the code.
$r_title(Form_Work.xfdl.js / Option 1, 2, 3)
this.Button00_onclick=function(_a,_b){var _c="TEST";eval("trace('test'"+_c+")");};this.Button01_onclick=function(_a,_b){var _c="TEST";trace('TEST_2'+_c);};Build
It sets the basic options required for the app build.
NRE (Windows)
Property | Description | |
|---|---|---|
1 | Execute Module | This section is available when you choose the Windows environment. The Build App wizard locates the setup module created under the directory where Nexacro Studio is installed and then specifies the file as a default module. You can change the default module to another file if you want to or if the wizard cannot find the file. |
2 | Version | Displays the selected module version value. |
3 | Resource Path | Specifies the path to the archive files that were created in the previous stage. If there is no archive file, the process will not proceed. |
4 | Bootstrap URL | Specifies the URL of a bootstrap file. If you select Local as the update type, you should specify the name of a bootstrap file. Otherwise, you should specify a URL. |
5 | Output path | Specifies the directory where an installation file will be created. |
AppBuilder > Login
It can be entered when the Android, iOS, and macOS execution environments are selected. If "Auto Login" is set, then the login window does not appear when the menu [Deploy > BuildApp] is executed.
AppBuilder > Environment
It specifies the path to the archive file created in the previous step. If there is no file created, then the task is not processed.
Launch
Nexacro Studio provides a web server feature to allow users to test their apps on web browsers without installing a separate web server. You can select your own test web server in operation. Moreover, you can select a local environment when you use the NRE or emulator.
Option | Description | |
|---|---|---|
1 | Local | When the NRE or emulator is used, files are executed directly in a local environment without a web server. |
2 | Local Web Server | Sets the local web server provided by Nexacro Studio |
3 | Server Host Url | Determines whether to use a local web server. If you want to use a local web server, choose an option in the form of a host URL (either 127.0.0.1 or localhost). |
4 | Option | [Show details on server error message]: determines whether to display the errors that occur during an HTTP transaction. The errors are displayed on the Output pane. [Save the server log]: determines whether to save the logs of a web server into a file |
5 | Details | Sets further options. If you select "Not Used" for the [Server Host Url] option, this option will be deactivated. |
6 | Web Server | Allows you to specify the URL of a web server |
7 | excute parameters | Sets whether to specify the parameter value when executing NRE. You can specify the parameter value used in the execNexacro method. |
8 | Display run configuration | Determines whether to display Run Configuration Dialog when executing Launch/QuickView |
Option | Description | |
|---|---|---|
1 | Port Number | You can specify a port number on your own. If nothing is specified, the port number will be specified automatically. |
2 | Log Path | If you have chosen to save web server logs into a file, you can specify the path and name of the file. |
Position
Set up the units for measuring the position when generating a component in a Form. The values designated in Options serve as defaults when generating a Form.
Macros
You can check the macro name and setting value provided by default and additionally set macros.
The Macros provided by default are as follows. You can use other macros, except for the Nexacro Studio execution path, while the project is open.
Macro Name | Description | |
|---|---|---|
1 | %(StudioDir) | Nexacro Studio execution path |
2 | %(BaseLibDir) | [Project] - [General] - Base Library Path |
3 | %(GenerateDir) | [Project] - [Generate] - [General] - Generate Path |
4 | %(DeployDir) | [Project] - [Deploy] - [General] - Deploy Path |
5 | %(ProjectDir) | Project path |
6 | %(ProjectExt) | Project file extension (xprj) |
7 | %(ProjectFileName) | Project file name (including extension) |
8 | %(ProjectName) | Project name |
9 | %(ProjectPath) | Project path (including project file name) |
Macros can be used to set paths or to set specific values in Option. The available options are as follows.
Project
General - Base Library Path
Generate - Generate Path, Before/After Generate Command
Easy UI - Form Template Location, View Template Location
Deploy - Deploy Path, Ignore compress files
Build > NRE(Windows) - Execute Module, Resource Path, Bootstrap URL, Output Path
Build > AppBuilder - Server URL, ID, Resource Path
Launch - Local Web Server URL, Web Server URL, Nexacro Runtime Browser excute parameters
Advanced - Code Snippet File Path, Component Preset File Path
Environment
External Tools - Name, Path, Argument
When running Nexacro Deploy17, it can also be used in the following format. At this time, macros cannot be used for the option value or project XPRJ file path. As in the example below, you can use macros when specifying values for all options, except for the -P option shown in red.
nexacrodeploy17.exe -P "C:\Test\Test.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacro17lib" nexacrodeploy17.exe -P "C:\Test\Test.xprj" -O "%(GenerateDir)" -B "%(BaseLibDir)"
Advanced
It enables the function to use metadata in the project. The component ID is set by combining PrefixID of the component defined in TypeDefinition and the selected metadata.
Property | Description | |
|---|---|---|
1 | Metadata | [Use user-defined metadata] Sets whether to use metadata [Use metadata with prefixID] Sets the component ID by combining PrefixID of the component defined in TypeDefinition and the selected metadata |
2 | Code Snippet File Path | Sets the code snippet file location. If not set otherwise, then the file provided by default when installing Nexacro Studio is used. |
3 | Component Preset File Path | Sets the component preset file location. If not set otherwise, then the file provided by default when installing Nexacro Studio is used. |
Options – Environment
You can set up overall options for Nexacro Studio.
General
Select General to set up the general options for Nexacro Studio.
Option | Description | |
|---|---|---|
1 | Working Folder | Designates the folder where new projects will be saved |
2 | Number of recent files displayed in the list | Controls the number of files displayed in the [File – Recent Files] menu. A maximum of 16 files can be displayed. |
3 | Number of recent projects displayed in the list | Controls the number of recently used project items displayed in the [File – Recent Projects] menu. A maximum of 16 projects can be displayed. |
4 | Perspective | Determines the layout of Nexacro Studio (Developer / Designer) |
5 | Command Type | Determines the types of menu interface (Default / Ribbon) |
6 | Nexacro Studio Theme | Selects a UI theme of Nexacro Studio (Default / Black) |
Startup
Controls the behavior of Nexacro Studio when it is started.
Option | Description | |
|---|---|---|
1 | Show empty environment | Nexacro Studio will begin with nothing opened. |
2 | Show StartPage on Startup | Nexacro Studio will open the StartPage when it begins. |
3 | Reopen last project | Nexacro Studio will re-open the last project worked on when it is started |
4 | Reopen the file(s)... | Nexacro Studio will open last-opened files when it opens a certain project. |
Auto Recover
Sets up the auto recovery options.
Option | Description | |
|---|---|---|
1 | Autosave interval (temporary file) | If checked, a temporary file will be created. |
2 | Specifies the autosave interval | |
3 | Create backup (.bak) file automatically | Creates a backup file |
Font and Color
Sets up the font and font color that are used in each Nexacro Studio window.
Option | Description | |
|---|---|---|
1 | Display items | Selects the items whose display font and color are being changed |
2 | Set General | Sets the general value |
3 | Font | Select font |
Font Style | Sets font style | |
Size | Sets font size | |
Script | Sets the language scripts that can be used in the selected font | |
Foreground | Sets the font color | |
Background | Sets the font background color | |
4 | Strike Out | If checked, causes text to be displayed in "strike through" |
Underline | If checked, causes text to be underlined | |
5 | Tab Size | Sets the tab size |
Indent Size | Sets the indent size | |
6 | Insert Spaces | When selected, causes tabs to be converted to spaces |
Keep Tabs | When selected, causes tabs to be maintained as tabs | |
7 | View Indentation Guide | When selected, caused the indentation guide to be displayed |
Auto Indent | When selected, enables automatic indenting | |
8 | Preview | Displays sample text formatted as specified by the options selected |
Show Information
You can set up the option of displaying the titles of Forms.
Option | Description | |
|---|---|---|
1 | Show Title | Controls whether to display title text: • at Project Explorer: Displays the title text information in FDL on Project Explorer • at Child Tab : Displays the title text information in FDL on the tab of the editing screen |
Script
Sets up the options used in script editing screen.
General
Option | Description | |
|---|---|---|
1 | Remove Event | Determines whether to comment out an event function when the relevant event is removed through the Properties pane |
2 | IntelliSense | Determines whether to display IntelliSense Sets up the number of items displayed in the IntelliSense list |
3 | Auto Complate | Sets up whether to insert a closing brace automatically |
Version
Select the JavaScript version to use when writing the script. Depending on the version selected, the items supported by Script IntelliSense will change, and the script verification rules are applied differently for Generate.
If you select "ECMAScript 2015(ES6)" as the Version option, then a script error may occur depending on the execution environment. You need to write the code in consideration of the user environment.
For example, when running the ES6 code in the IE11 browser, a syntax error may occur and the screen may not be displayed.
This is the IntelliSense screen displayed when "ECMAScript 2015(ES6)" is selected as the Version option and "Number.e" is entered in the script edit window. The "Number.EPSILON" property, which is supported from ES6, is additionally displayed.
If you select "ECMAScript 5" as the Version option and use ES6 syntax in the script edit window, then it will be processed as a script error, and Generate will not be processed normally.
Generate
You can set the options for generation process.
Description | ||
|---|---|---|
1 | Auto Generate | Determines whether to conduct generation automatically when you save a file |
2 | Message | Selects the types of messages that will be printed in the generation process |
External Tools
You can register external application programs or External Application that can be executed. The registered external program can specify Argument and then it can be executed directly from the toolbar or menu. External Application can be executed in the External Application window and control project information.
Setting Property | Description | |
|---|---|---|
1 | Type | Displays the registered External Tools type.
|
2 | Name | Sets the name to be displayed in the list. |
3 | Path | Sets the execution path.
|
4 | Argument | Sets Argument to be added for the execution. |
5 | Use standard output | Sets when the Type property is "windows application" and is the console program that supports the standard output. Selects whether to display the result message in the Output window after execution. If the standard output is not supported, then the corresponding property item is disabled. |
Connection type | Sets when the Type property is "nexacro application".
Only one of the registered nexacro applications can be set. The rest are automatically changed to manually.
|
When adding a new item, select whether to register the Windows application program or External Application. Select the application program with the exe extension or start.json.
Advanced
This sets the mouse wheel operation option.
Property | Description |
|---|---|
Customize mouse wheel in view | Checks whether to apply the mouse wheel operation option in the text editor. Checks whether to apply the mouse wheel motion option in the text editor. This option is applied only within Nexacro Studio apart from the Windows setting. |
Number of lines to scroll at a time | Sets the number of lines to be scrolled at once for the mouse wheel scroll operation. |
One page at a time | Moves as much as the number of currently displayed screen lines for the mouse wheel scroll operation. It may vary depending on the font size or window size. |
Options – Form Design
Sets up options related to the Design Window.
General
Configures general options for Form Design.
Option | Description | |
|---|---|---|
1 | Max Undo | The maximum number of changes than can be undone |
Default Width | The default width when creating a new Form | |
Default Height | The default height when creating a new Form | |
2 | Select Type | The way of dragging a rectangle on the Form design panel to select components. Go to Selection Change for the details. |
3 | Layout | Displays the currently-edited step |
Guide
You can set up the options for the Form design editor, including Ruler, Guide Line, Grid, and Snap
Option | Description | |
|---|---|---|
1 | Measure | Determines the types of unit for the position on the design window |
2 | Display ruler | When checked, the ruler will be displayed on the Design window canvas |
Display guidelines | When checked, guidelines will be displayed on the Design window canvas | |
Let component follow the movement of guidelines | When checked, components will follow the movement of a guideline if they are set to align to the guideline | |
Display current mouse position | When checked, indicators will appear on the horizontal and vertical rulers, showing the current coordinate of a mouse pointer | |
3 | Display dot grid | When checked, the dot grid will be displayed on the canvas of the Design window |
Dot grid size | The dot grid size to be displayed on the canvas of the Design window | |
Display type | Determines the types of dot displayed on the canvas of the design window | |
4 | Snap to dots when moving Component | When checked, the magnetic function will be enabled and will align controls with dots when moving them on the canvas |
Snap to other components when moving component | When checked, the magnetic function will be enabled and will align controls with other components when moving controls on the canvas | |
Space between components | Determines the gap width between a control and components, applied when the magnetic function is implemented for the moving control |
When you select a component and move the component using an arrow key, the movement will be made as far as the pixel number specified in the Dot Grid Size property. For example, if you set Dot Grid Size at 8, you will move a component 8 pixels every time you press an arrow button. You can make an 1-pixel movement if you hit an arrow key with the Ctrl key pressed.
Paste Special
Configures the availability of options under "Paste Special" in Form Design.
Option | Description |
|---|---|
Property (Normal) | Paste general properties |
User Property | Paste user properties |
Event | Paste event(s) |
Bind Item | Paste bind item(s) |
Init Value | Paste InitValue information |
Options - Launch
General
Option used when launching a Nexacro Studio project.
Option | Description | |
|---|---|---|
Display popup menu | Sets up whether to display the popup menu related to source in the launched Nexacro Platform (NRE) |
The below picture is the context menu opened when Nexacro Platform is launched. It is not supported when a project is executed through a web browser.
Menu | Feature |
|---|---|
Reload | Refresh the current screen. You can view revised content on Nexacro Studio on a screen where Quick View is not turned on. |
View Source | Source code of the executed Nexacro Platform-based app is shown in Nexacro Studio. You can use it when manipulating several Forms with a menu. |
Always on Top | The app being executed is fixed at the highest-level area of Windows |
Browser
You can designate web browsers to which you connect your applications when initiating Launch or Quick View.
Options – Debug
Configure general options related to debugging
Option | Description | |
|---|---|---|
1 | Show message of error | Displays the error messages on the Output pane |
2 | Show message of warning | Displays the warning messages on the Output pane |
3 | Show the lowest level variables in the variables list | In the debugging mode, presents up to the variables at the lowest level of the Watch or Variables list |
4 | Use the assist tip when mouse point to the word in script editor | In the debugging mode, displays the relevant values or information when a mouse pointer hovers over a certain variable or object on the script pane |
5 | Display variable values inline while debugging | In the debugging mode, displays the relevant values or information on the right-hand side of the same line where the relevant variable or object is written on the script pane |
Options – Source Control
Set up source control options. This option is displayed only when available source control software is installed on user’s computer.
Option | Description |
|---|---|
Source Control Management Type | Selects which of the source control applications installed on the user’s computer will be applied to projects |
Options | Sets which source control options will be applied (based on the selected source control application) |