Setting Options

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.

When you click the 'Set Defaults' button at the bottom of the Options window, you can select one of two options.


When the 'Set Defaults' button is clicked, some items added by the user as shown in the list below are not initialized and the added values are maintained.* Project

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

Migration

Sets the migration option for file versions lower than Nexacro Studio 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

2

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.

SDK


Option

Description

1

Version

Select the SDK version to use in your project.

- Latest Version: Use the latest version of the SDK in the SDK folder.

- [Version]: Use the selected SDK from the installed SDKs.

- User Setting: Enter the information yourself.

2

More Information

Select ""User Setting"" under Version to edit the information.

- Version: Select from the list of installed SDKs.

- Base Library: Set the Base Library folder for the selected SDK.

- Setup Runtime: Set the Setup Runtime folder for the selected SDK.

Startup

You can set the actions conducted at the time of loading a project.

Options[Environment - Startup]


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

Bootstrap

-Set defer

Sets whether to include the defer attribute within the Script tag when creating the bootstrap file.

- Set Splash Loader

Sets whether to include a script to display the Splash Loader when creating the bootstrap file.

CSS



Description

1

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.

2

Select the browser

Selects web browsers for which CSS files will be created.

The CSS files for unselected browsers will not be created.

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 Firefox if you do not create a CSS file for Firefox.

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 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.

QuickCode

It sets the storage path for the files created when using the QuickCode 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\TOBESOFT\Nexacro N\templates\user\formTemplate
C:\Users\[user]\Documents\TOBESOFT\Nexacro N\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\TOBESOFT\Nexacro N\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

%(SDKDir)

SDK path

3

%(BaseLibDir)

[Project] - [General] - Base Library Path

4

%(GenerateDir)

[Project] - [Generate] - [General] - Generate Path

5

%(GenerateRuleDir)

[SDK Path] - generate

6

%(DeployDir)

[Project] - [Deploy] - [General] - Deploy Path

7

%(ProjectDir)

Project path

8

%(ProjectExt)

Project file extension (xprj)

9

%(ProjectFileName)

Project file name (including extension)

10

%(ProjectName)

Project name

11

%(ProjectPath)

Project path (including project file name)

12

%(ActiveFilePath)

Active file path (including filename extension)

13

%(ActiveGenerateFilePath)

Activated File Generate Path (including filename extension)

The %(ActiveFilePath) and %(ActiveGenerateFilePath) macros support only the files with the following extensions among the files included in the project.

- xfdl, xjs, js, xml

Macros can be used to set paths or to set specific values in Option. The available options are as follows.

When running Nexacro Deploy, 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.

nexacrodeploy.exe  -P "C:\Test\Test.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" –GENERATERULE "C:\TestGenerate\generate"
nexacrodeploy.exe  -P "C:\Test\Test.xprj" -O "%(GenerateDir)" -B "%(BaseLibDir)" –GENERATERULE "%(GenerateRuleDir)"

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.

Options[Environment - General]


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.

Options[Environment - Startup]


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.

Options[Environment - Auto Recover]


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.

Options[Environment - Font and Color]


Option

Description

1

Display items

Selects the items whose display font and color are being changed

2

Set General

The value set as the 'General' item value in Display Items is reflected in the rest of the Display Items. It can be used when you want to set the basic Font, Color style and directly modify the rest of the Display Items.

For example, if you change the Size value of the 'General' item to 9 and click the 'Set General' button, the Size values of all other items are changed to 9.

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.

Options[Environment - Project Explorer]


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

Options[Environment - Script]


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.

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.

Some of the ES6 grammars are recognized as user-defined classes, so editing scripts may not generate errors.

For example, when using built-in objects such as Proxy, Reflect, and Promise added in ES6 within a script, even if the Version option is set to "ECMAScript 5", it is not treated as a script error and Generate file is created normally.


In the code below, const declarations are checked for script errors, but Reflect built-in objects are not treated as errors.

Generate

You can set the options for generation process.

Options[Debugging - General]



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 Add on programs or Add on that can be executed. The registered external program can specify Argument and then it can be executed directly from the toolbar or menu. Add on can be executed in the Add on window and control project information.


Setting Property

Description

1

Type

Displays the registered External Tools type.

  • windows application: Windows application program

  • nexacro application: Add on

2

Name

Sets the name to be displayed in the list.

3

Path

Sets the execution path.

  • Windows application program: The execution file path

  • Add on: start.json file 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".

  • open project: When the project is open, the first registered Add on is automatically connected.

Only one of the registered nexacro applications can be set. The rest are automatically changed to manually.

  • manually: Connects when Add on is selected directly.

When adding a new item, select whether to register the Windows application program or Add on. 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.

Options[Debugging - General]


Option

Description

1

Max Undo

The maximum number of changes than can be undone


Default Width

The default width when creating a new Form (0~12000)


Default Height

The default height when creating a new Form (0~12000)

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

Options[Debugging - General]


Option

Description

1

Measure

Determines the types of unit for the position on the design window

2

Container Selector

Set whether to display additional UI for convenience of component selection when there are components placed in a container component or Panel component.

3

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

4

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 (2~12000)


Display type

Determines the types of dot displayed on the canvas of the design window

5

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.

Layout

Set options according to the type property value of the layout object.

Options[Debugging - General]


Option

Description

1

Display table guidelines

If the type property value of the layout object is "table", set whether to display the line dividing the table cell area and the value specified as the tabletemplatearea property value.

Paste Special

Configures the availability of options under "Paste Special" in Form Design.

Options[Form Design – Paste Special]

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.

Options[Environment - Launch]


Option

Description


Display popup menu

Sets up whether to display the popup menu related to source in the launched Nexacro (NRE)

The below picture is the context menu opened when Nexacro is launched. It is not supported when a project is executed through a web browser.

Options[Environment - Launch]

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-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

Options[Debugging - General]


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.

Options[Source Control]

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)