Nexacro Platform

https://docs.tobesoft.com
Admin
Nexacro Platform is a comprehensive enterprise application development framework by TOBESOFT that...
Tokens:1,004,100
Snippets:8,172
Trust Score:8
Update:1 week ago
Show doc for...
Tokens:
Raw
### Nexacro Studio Installation Command Examples

Source: https://docs.tobesoft.com/development_tools_guide_nexacro_n_v24_en/17f1694cdd98ef8e

Example commands for installing Nexacro Studio with various option combinations, such as setting the language to Japanese, combining /LANG with /SILENT, and using /SILENT or /VERYSILENT alone.

```text
NexacroN_SetupStudio.exe /LANG=Japanese
NexacroN_SetupStudio.exe /LANG=Japanese /SILENT
NexacroN_SetupStudio.exe /SILENT
NexacroN_SetupStudio.exe /VERYSILENT
```

--------------------------------

### Troubleshooting 2: install Windows Installer 3.1

Source: https://docs.tobesoft.com/TechnicalNote/c9eb962d11707e2a

Troubleshooting step 2: install Windows Installer 3.1 (only for Windows XP; for Vista/7 use Troubleshooting 4). Link provided.

```text
(Possible only on Windows XP; move to Troubleshooting 4 in case of Windows Vista, Windows 7 PC)
Install Windows Installer 3.1 (Refer to FAQ Error Code number 1)
http://www.microsoft.com/en-us/download/details.aspx?id=25
```

--------------------------------

### StartXML File Example

Source: https://docs.tobesoft.com/admin_guide_miplatform_ko/4311db3147ea09f9

This is the complete StartXML file example for MiPlatform, showing the configuration of components, ActiveX controls, protocols, and MDI forms. It includes commented-out sections for alternative configurations.

```xml
<container version="1000" url="C:\\Program Files\\TOBESOFT\\MiPlatform\\DevComponent">
    <component id="edit" name="cyedit" version="1000" image="3" title="Edit"/>
    <component id="button" name="cybutton" version="1000"  image="2" title="Button"/>
    <component id="checkbox" name="cycheckbox" version="1000"  image="4" title="Check Box"/>
    <component id="radio" name="cyradio" version="1000"  image="7" title="Radio"/>    
    <component id="TextArea" name="cyTextArea" version="1000"  image="16" title="Text Area"/>    
    <component id="Chart" name="cyChart" version="1000"  image="17" title="Chart"/>            
    <component id="List" name="cyListBox" version="1000"  image="6" title="List"/>            
    <component id="FileDialog" name="cyFileDialog" version="1000"  image="18" title="File Dialog" bitmapID="183"/>    
    <component id="TreeView" name="cyTreeView" version="1000"  image="11" title="Tree View"/>            
    <component id="Grid" name="cyGrid" version="1000"  image="1" title="Grid"/>            
    <component id="image" name="CyImage" version="1000"  image="9" title="Image" bitmapID="183"/>
    <component id="spin" name="CySpin" version="1000"  image="10" title="Spin"/>
    <component id="CalendarEx" name="cyCalendarEx" version="1000"  image="13" title="CalendarEx"/>    
    <component id="Calendar" name="cyCalendar" version="1000"  image="13" title="Calendar"/>    
    <component id="Static" name="cyStatic" version="1000"  image="8" title="Static"/>
    <component id="maskedit" name="cyMaskedit" version="1000"  image="19" title="MaskEdit"/>    
    <component id="div" name="CyDiv" version="1000"  image="20" title="Division"/>    
    <component id="Tab" name="CyTab" version="1000"  image="12" title="Tab"/>    
    <component id="file" name="CyFile" version="1000" image="18" title="File" bitmapID="183"/>
    <component id="shape" name="CyShape" version="1000" image="18" title="Shape" bitmapID="183"/>
    <component id="Combo" name="CyComboEx" version="1000"  image="5" title="ComboBoxEx"/>            
    <component id="Menu" name="CyMenuBar" version="1000"  image="5" title="MenuBar"/>    
</container>
```

```xml
<activeX version="1000" url="file://C:\\Program&#32;Files\\TOBESOFT\\MiPlatform\\DevComponent\\">
    <Component Id="AxChartFx" Progid="ChartFX.Chart" nowindow="true" Version="1000" Image="28" Title="activeX1"/>
</activeX>
```

```xml
<protocols version="1000" url="c:\\program files\\TOBESOFT\\MiPlatform">
    <protocol id="file" name="CyHttpAdp" version="1000" 
    scriptPath="script:GetReg('ScriptPath','D:\PIDScript\script')" 
    usecache="false"/>
    <!--
    <protocol id="ldb" name="CyLiteDBAdp"   version="1000"
    driver_id="ODBC" driver_name="AdaptDBOdbc" driver_ver="10000" 
    PreConnect="false"
    extapi_id="" extapi_name="" extapi_ver="10000"
        ConnectionString="DRIVER={Oracle Lite 40 ODBC Driver}; DSN=KIMJANG_Tutorial;"
       dbuser="" dbpass="" />
       -->
  </protocols>
```

```xml
<MDIInfo>
    <forms Left="20" Top="0" width="240" height="320" OpenStyle="normal">
        <!--<form id ="MDIForm1" IconID="IDB_COMBO2" Left="10" Top="10" width="240" height="320" initURL="Tutorial::GridTest.xml"   OpenStyle="max"/>
        -->
        <form id ="MDIForm1"  IconID="IDB_COMBO2" Left="10" Top="10" width="240" height="320" initURL="Tutorial::GridTest.xml"  OpenStyle="max" />
        <form id ="MDIForm2"  IconID="IDB_COMBO1"   initURL="Tutorial::test1" />
        <form id ="MDIForm3"  IconID="IDB_COMBO1"   initURL="Tutorial::test1" OpenStyle="Fixed"/>
    <!--    
        <form id ="MDIForm3" IconID="IDB_COMBO1"   initURL="Tutorial::test1" startxml="" sessionurl="" autostart="true" session="false" OpenStyle="max"/>
        <form id ="MDIForm4" IconID="IDB_COMBO1"   initURL="Tutorial::test1" autostart="true" session="false" OpenStyle="fixed"/>
        <form id ="MDIForm5" IconID="IDB_COMBO1"   initURL="Tutorial::test1" autostart="false" session="true" />
    -->
    </forms>

    <Shortcuts align="vertical" font="tahoma,9" color="black"  ImageID="IDB_COMBO1" TopMargin ="30" LeftMargin="40" Text="" >
        <Shortcut id ="icon1" ImageID="IDB_COMBO2"  Form="MDIForm2" text ="부동산" Instance="single"  Left="10" Top="10" >
          <variables>
           <var id="gv_company" value=""/> 
           <var id="gv_name" value=""/>
         </variables>
        </Shortcut>
        <Shortcut id ="icon2" text ="투비소프트" Form="MDIForm1" Instance="multi"  Left="10" Top="50" />
        <Shortcut id ="icon3" text ="1" Form="MDIForm3" Instance="multi"  Left="10" Top="90" />
    </Shortcuts>            
</MDIInfo>
```

--------------------------------

### AutomationModelTracer UserClass example

Source: https://docs.tobesoft.com/difingo_en/164e1ea23c6371d5

Example UserClass created for a Global Event targeting AutomationLogic with the start method. The class extends AutomationModelInterceptor and overrides the start method. The names of the class, method, and input arguments should not be changed.

```java
package user.globalEvent; 
 
import com.nexacro.xup.aop.intercept.interceptor.AutomationModelInterceptor; 
import com.nexacro.xup.ParameterSet; 
import com.nexacro.xup.component.automation.AutomationFailException; 
 
public class AutomationModelTracer extends AutomationModelInterceptor { 
                                                                                  
  public void start(ParameterSet globalParameterSet) throws AutomationFailException{ 

  }

}
```

--------------------------------

### main.m - UIApplicationMain setup

Source: https://docs.tobesoft.com/deployment_guide_nexacro_n_v24_en/ca8ff1806068b58d

The main.m file should contain the standard UIApplicationMain call. Verify it matches this code and modify if different.

```objectivec
//
//  main.m
//  HelloNexacro
//

#import <UIKit/UIKit.h>
#import "AppDelegate.h"

int main(int argc, char * argv[]) { 
	NSString * appDelegateClassName; 
	@autoreleasepool { 
		// Setup code that might create autoreleased objects goes here. 
		appDelegateClassName = NSStringFromClass([AppDelegate class]); 
	} 
	return UIApplicationMain(argc, argv, nil, appDelegateClassName); 
}

```

--------------------------------

### Start X-PUSH on Unix/Linux with startup.sh

Source: https://docs.tobesoft.com/xpush-user-manual-3_0_en_kr/01c10521f33834c6

Execute startup.sh from XPUSH_HOME/bin to start the server on Unix/Linux.

```sh
/homexpush/xpush-3.0.0/bin$ ./<strong>startup.sh</strong>
```

--------------------------------

### getengineversion

Source: https://docs.tobesoft.com/launcher_service_en_kr/ffabb56bcea3c67f

Gets the engine installed version corresponding to the engine key installed on the system. Returns a string.

```APIDOC
## getengineversion

### Description
Get the engine installed version corresponding to the engine key installed on the system.

### Method
getengineversion

### Parameters
- strEngineKeyName (string) - Required - Engine Setup Key

### Result
string
```

--------------------------------

### Start X-PUSH on Windows with startup.bat

Source: https://docs.tobesoft.com/xpush-user-manual-3_0_en_kr/01c10521f33834c6

Execute startup.bat from XPUSH_HOME/bin to start the server on Windows.

```bat
D:\xpush-3.0.0\bin><strong>startup.bat</strong>
```

--------------------------------

### getengineversion

Source: https://docs.tobesoft.com/launcher_service_en_kr/ffabb56bcea3c67f

Gets the engine installed version corresponding to the engine key installed on the system. Returns a string version.

```APIDOC
## getengineversion

### Description
Gets the engine installed version corresponding to the engine key installed on the system.

### Method
getengineversion

### Parameters
- strEngineKeyName (string) - Required - Engine Setup Key

### Result
string
```

--------------------------------

### downloadresource method

Source: https://docs.tobesoft.com/launcher_service_en_kr/ffabb56bcea3c67f

Sets the server path where the start.json and SetupResource.zip files are located. When executed, the SetupResource.zip file is downloaded to the '%USERAPP%SetupResource' path.

```APIDOC
## downloadresource

### Description
Sets the server path where the start.json and SetupResource.zip files are located. When executed, the SetupResource.zip file is downloaded to the '%USERAPP%SetupResource' path.

### Method
downloadresource

### Parameters
#### Request Body
- **downloadresource.param** (array of strings) - Required - An array containing the server path (e.g., "http://127.0.0.1:8080/test/").

### Request Example
```json
{
  "downloadresource": {
    "param": ["http://127.0.0.1:8080/test/"]
  }
}
```

### Response
No response body is documented.
```

--------------------------------

### UserMessageProviderActor example: push current time every second

Source: https://docs.tobesoft.com/xpush-user-manual-2_8_en/e389fcee66314d78

This example shows an EmbeddedMessageProviderActor implementation that pushes the current time every second. It creates a thread in start() and uses provideMessage(PushMessage) to send messages. The start() method must return immediately after starting the thread, otherwise the X-PUSH Server will not operate.

```java
Import java.io.UnsupportedEncodingException;
import java.text.SimpleDateFormat;
import java.util.Date;

import com.nexacro.xpush.api.EmbeddedMessageProviderActor;
import com.nexacro.xpush.fw.service.log.LogLevel;
import com.nexacro.xpush.fw.service.provider.PushMessage;

public class UserMessageProviderActor extends EmbeddedMessageProviderActor {
	Thread thread = null;
	public void start() {
		thread = new MessageGeneratorThread();
		thread.start();
	}

	public void stop() {
		((MessageGeneratorThread)thread).stopRunning();
	}

	public class MessageGeneratorThread extends Thread {
		private boolean isRunning = true;
		public void stopRunning() {
			isRunning = false;
		}

		public void run() {
			while(isRunning) {
				try {
					PushMessage pushMessage = new PushMessage();
					pushMessage.setEncoding("utf-8");
					SimpleDateFormat formatter = 
						new SimpleDateFormat("HH:mm:ss");
					String currentTime = "PUSHED CURRENT TIME : "
						+ formatter.format(new Date());
					pushMessage.setActionType(
						Constants.ACTION_PUSH_STRING);// Action Type
					pushMessage.setProjectID("PRO#1"); // Project ID
					pushMessage.setTopicType("OPDT ");// Topic Type
					pushMessage.setTopicId ("ALL ");// Topic Id
					pushMessage.addData("ALL");// data - value
					pushMessage.addData(currentTime);// data - value

					logger.write(LogLevel.DEBUG, "message provided");
					provideMessage(pushMessage);
					sleep(1000);
				} catch (InterruptedException e) {
					logger.write(LogLevel.ERROR, 
						"embedded message provider : exception occured.", e);
				} catch (UnsupportedEncodingException e) {
					logger.write(LogLevel.ERROR, 
						"embedded message provider : exception occured.", e);
				}
			}
		}
	}
}
```

--------------------------------

### downloadresource method

Source: https://docs.tobesoft.com/launcher_service_en_kr/ffabb56bcea3c67f

Downloads the SetupResource.zip file from the specified server path to the user's PC.

```APIDOC
## downloadresource method

### Description
Downloads the SetupResource.zip file from the specified server path to the user's PC.

### Method
downloadresource

### Parameters
#### Request Body
- **downloadresource.param** (array of string) - Required - The server path where the start.json and SetupResource.zip files are located.

### Request Example
```json
{
  "downloadresource": {
    "param": ["http://127.0.0.1:8080/test/"]
  }
}
```
```

--------------------------------

### getCellCount method example

Source: https://docs.tobesoft.com/developer_guide_nexacro_n_v24_en/1497dabff6d5ffc7

Returns the number of cells in a specific band of the Grid. The example gets the count for the 'head' band.

```javascript
var nCount = this.Grid00.getCellCount( "head" );
```

--------------------------------

### StartXML File Example

Source: https://docs.tobesoft.com/admin_guide_miplatform_ko/4311db3147ea09f9

This is the complete StartXML file example. It defines a resource reference, global and share variables, several global styles, and a dataset with column definitions and sample records. The dataset includes event handlers and column change callbacks.

```xml
<resource url="D:\PIDScript\Tutorial.res" version="1000" ext="res"/>
<variables>        
    <var id="gs_id" value="" type="global" />
    <var id="test_share" value="xxxxxx" type="share" />
</variables>
<GlobalStyle>
    <style id="Mild" font="tahoma,9" fixedfont="tahoma,9" textcolor="#666666" windowcolor="#CCCC00" buttoncolor="#FFFF66" formcolor="#FFFFCC" editcolor="#FFFFFF" disablecolor="#333300" disablebkcolor="#CCCC99" bordercolor="#CCCCCC" DKSHADOWcolor="#666600" HILIGHT3Dcolor="#FFFFFF" HILIGHTTextcolor="#FFFF33" HILIGHTcolor="#FFFF33" Shadowcolor="#666600" face3dcolor="#FFFF33" Light3dcolor="#FFFFCC" Arrowcolor="red" ScrollbarColor="red" Scrollbarwidth="14"/>
    <style id="Impact" font="tahoma,9,bold" fixedfont="tahoma,9,bold" textcolor="black" windowcolor="gray" buttoncolor="#CC33CC" formcolor="#FFCC00" editcolor="#FF9999" disablecolor="red" disablebkcolor="white" bordercolor="red" DKSHADOWcolor="#330033" HILIGHT3dcolor="#CC99FF" HILIGHTTextcolor="black" HILIGHTcolor="red" Shadowcolor="#330033" face3dcolor="#CC99FF" Light3dcolor="#996699" Arrowcolor="red" ScrollbarColor="red" Scrollbarwidth="14"/>
    <style id="System" font="tahoma,9" fixedfont="tahoma,9" textcolor="BTNTEXT" windowcolor="white" buttoncolor="BTNFACE" formcolor="white" editcolor="white" disablecolor="GRAYTEXT" disablebkcolor="BTNFACE" bordercolor="black" DKSHADOWcolor="3DDKSHADOW" HILIGHT3dcolor="BTNHIGHLIGHT" HILIGHTTextcolor="HIGHLIGHTTEXT" HILIGHTcolor="HIGHLIGHT" Shadowcolor="BTNSHADOW" face3dcolor="BTNFACE" Light3dcolor="3DLIGHT" Arrowcolor="black" ScrollbarColor="SCROLLBAR" Scrollbarwidth="14"/>
    <style id="first" font="굴림,20" fixedfont="굴림체,9" textcolor="blue" windowcolor="gray" buttoncolor="red" formcolor="yellow" editcolor="cyan" disablecolor="brown" disablebkcolor="burlywood" bordercolor="beige" DKSHADOWcolor="black" HILIGHT3dcolor="bisque" Shadowcolor="blanchedalmond" face3dcolor="gray" light3dcolor="gray" HILIGHTcolor="blue" HILIGHTTextcolor="white" Arrowcolor="black" ScrollbarColor="lightgray" Scrollbarwidth="14"/>
    <style id="second" font="굴림,9" fixedfont="굴림체,9" textcolor="red" windowcolor="gray" buttoncolor="red" formcolor="blue" editcolor="cyan" disablecolor="brown" disablebkcolor="burlywood" bordercolor="beige" DKSHADOWcolor="black" HILIGHTcolor="bisque" Shadowcolor="blanchedalmond"/>
</GlobalStyle>
<Datasets>
    <Dataset Id="g_test" ServiceDSetID="output" OnColumnChanged="g_test_OnColumnChanged" CanRowPosChange="g_test_CanRowPosChange" CanColumnChange="g_test_CanColumnChange">
        <contents id="g_test">
            <colinfo id="item_cd" size="50" type="STRING"/>
            <colinfo id="Item_dt" size="8" type="DATE"/>
            <colinfo id="item_nm" size="50" type="STRING"/>
            <record>
                <item_cd>1</item_cd>
                <Item_dt>20040601</Item_dt>
                <item_nm>첫번째</item_nm>
            </record>
            <record>
                <item_cd>2</item_cd>
                <Item_dt>20040701</Item_dt>
                <item_nm>두번째</item_nm>
            </record>
            <record>
                <item_cd>3</item_cd>
                <Item_dt>20040714</Item_dt>
                <item_nm>세번째</item_nm>
            </record>
            <record>
                <item_cd>4</item_cd>
                <Item_dt>20040725</Item_dt>
                <item_nm>네번째</item_nm>
            </record>
            <record>
                <item_cd>5</item_cd>
                <Item_dt>20040725</Item_dt>
                <item_nm>다섯번째</item_nm>
            </record>
            <record>
                <item_cd>6</item_cd>
                <Item_dt>20040725</Item_dt>
                <item_nm>여섯번째</item_nm>
            </record>
            <record>
                <item_cd>7</item_cd>
                <Item_dt>20040725</Item_dt>
                <item_nm>일곱번째</item_nm>
            </record>
            <record>
                <item_cd>8</item_cd>
                <Item_dt>20040725</Item_dt>
                <item_nm>여덟번째</item_nm>
            </record>
            <record>
                <item_cd>9</item_cd>
                <Item_dt>20040801</Item_dt>
                <item_nm>아홉번째</item_nm>
            </record>
        </contents>
    </Dataset>
</Datasets>
```

--------------------------------

### XPlatform.exe start point error message

Source: https://docs.tobesoft.com/TechnicalNote/c9eb962d11707e2a

Error message displayed when the XPlatform.exe executable cannot find its start point, typically due to a corrupted or incomplete installation.

```text
XPlatform.exe – there is no start point
Cannot find at procedure start point.
```

--------------------------------

### Error 1316 - Example error message

Source: https://docs.tobesoft.com/TechnicalNote/68caccd719fe8c07

Example of the Error 1316 message that appears when installing OfficeWriter over a previous version. The error indicates a network error reading the old MSI file.

```text
Error 1316 - A network error occurred when attempting to read fromthe file 
C:\WINNT\Downloaded Installations\{EBF98E9A-3A6C-4B10-AB6B-3D9A746A5C35}\SoftArtisans OfficeWriter 2.0.4.msi
```

--------------------------------

### GET method data transmission

Source: https://docs.tobesoft.com/launcher_service_en_kr/d3ab7dc5483a73a8

Sends data by appending a JSON string to the URL as a query parameter. The example creates an XMLHttpRequest, sets up a callback, and sends a GET request to the launcher endpoint.

```javascript
var objNexacro = new Object();
var xhrObject = new XMLHttpRequest();
xhrObject.onreadystatechange = resultProcess;
var jsonData = JSON.stringify(objNexacro);
var openurl = "http://127.0.0.1/launcher/nexacro/"+new Date().getTime();
xhrObject.open("GET", openurl+"?"+jsonData, "true");
xhrObject.send(null);
```

--------------------------------

### Troubleshooting: uninstall XPLATFORM9.**_SetupEngine

Source: https://docs.tobesoft.com/TechnicalNote/c9eb962d11707e2a

Troubleshooting steps: uninstall the existing XPLATFORM9.**_SetupEngine via Control Panel, then retry installation.

```text
1. Control Panel > Programs and Features > delete XPLATFORM9.**_SetupEngine
2. Go to the Installation page
```

--------------------------------

### connection Example

Source: https://docs.tobesoft.com/xpush-user-manual-2_8_en/1b03176ae90b0148

Connects to the X-PUSH server. Sets the IP/port list from an input field, then calls connect with a user ID and password.

```javascript
{
	var value = this.IpPort.value;
	this.XPush00.set_iplist(value);

	this.XPush00.connect("user00","pw");
}
```

--------------------------------

### Find Button00 element with FindElementByAccessibilityId

Source: https://docs.tobesoft.com/advanced_development_guide_nexacro_n_v24_en/228d960c3cd152ee

C# example using FindElementByAccessibilityId to get the element of a Button component with id 'Button00'.

```csharp
WindowsElement element = session.FindElementByAccessibilityId("mainframe.ChildFrame00.form.Button00");
```

--------------------------------

### AppDelegate.m - Set start_ios.json URL

Source: https://docs.tobesoft.com/deployment_guide_nexacro_n_v24_en/ca8ff1806068b58d

In AppDelegate.m, set the projectUrl and bootstrapUrl to point to the server's _ios_ directory and start_ios.json file. Replace [URL] with your server address. The commented line shows the local file option.

```objectivec
//
//  AppDelegate.m
//  HelloNexacro
//

#import "AppDelegate.h"
#import "ViewController.h"

@interface AppDelegate ()

@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application 
	didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    self.viewController = [[ViewController alloc] init];
    
    // Update Type: Server, Update
    self.viewController.projectUrl = @"http://[URL]/_ios_/";
    self.viewController.bootstrapUrl = @"http://[URL]/_ios_/start_ios.json";
    
    // Update Type: Local
    // self.viewController.bootstrapUrl = @"file:///ios_asset/archive/start_ios.json";
    
    return [super application:application didFinishLaunchingWithOptions:launchOptions];
}

@end

```

--------------------------------

### Command and error output for missing server JVM

Source: https://docs.tobesoft.com/xpush-user-manual-2_9_en/8e5eed13c46c8ffe

Example command and error output when Java is installed as JRE instead of JDK. The error indicates the server JVM is missing. Reset JAVA_HOME and PATH, install JDK 1.8.x, and set up again.

```text
E:\xpush\bin>startup.bat 
Error: no `server' JVM at `C:\Program Files\Java\jre1.8.0\bin\server\jvm.dll'.
```

--------------------------------

### Get DeviceAdaptor by ID

Source: https://docs.tobesoft.com/development_tools_guide_nexacro_n_v24_en/cdc70866fc2746fc

Use this script to obtain device information by referencing the adaptor ID. The example retrieves the 'VoiceRecognition' adaptor.

```javascript
var voicerecognition = nexacro.getEnvironment().getDeviceAdaptor("VoiceRecognition");
```

--------------------------------

### Start X-PUSH with DB/SSL encryption using startup.bat encrypt

Source: https://docs.tobesoft.com/xpush-user-manual-3_0_en_kr/01c10521f33834c6

Run startup.bat with the 'encrypt' key to start with encrypted DB/SSL information. The key must be 7 characters or less and must be the same for both DB and SSL certificate.

```bat
D:\xpush-3.0.0\bin><strong>startup.bat encrypt</strong>
```
Tokens:
Raw