LegEasy Connect

This document gives you an overview of how to use the LegEasy connect server.

DataEase LegEasy Connect Server howto

To use this server you need enter the command line. The command line can be reached by pressing start and type cmd. In the command line you have to locate the path where LegEasy Connect is installed. If you installed using default paramters you will find it at C:\LegEasyConnect.

Commands and parameters

The command for starting LegEasyConnect is LegEasyConnect.exe.

The parameters to use are

Listen to	This is the port the server will listen to. A normal web server uses port 80 so when you write http://www.dataease.com into your browser this will automatically go to port 80. This port is usually in use by some other serverice so for you LegEasyConnect the default port is 8099. Tho reach your server when using port 8099 you will enter http://127.0.0.1:8099 into your browser. The :8099 then indicates the port number and the 127.0.0.1 is a default address used to reach your local computer from your browser.
[Repo path]	This is the path to your LegEasy application that can be created in DataEase for DOS 5.x or DataEase for Windows 5-6.5x. The same rules as for using the LegEasy application applies. Do not use to long paths, and SPACE in the path is not always working. If SPACE is used make sure to surround the paramter with "path with space".
[Repo name]	The name given to the application.
[User name]	The username prism is using to log into the application. If you use somthing else than a high user, you might get into trouble acceessing data. Restrictions for the web application should rather be defined in the web application and not in the server.
[Password]	The corresponding password for the user.
[DENAME]	This is the name identifying the prism in the application. If not set the one in environment will be used instead.
[DEPATH]	This is where the configur.dat and DENETWRK.OVL is shared. A LegEasy Connet server is actually a shared user in the same sence as any other user of the system. Make sure this is the same as set for other users. If no parameter given, the one in enviroment will be used.

Ex:

C:\LegEasyConnect>LegEasyConnect 8000 C:\\LegEasyApps\\MyLegApp TheAppName

This will start a server that will respond to any url at port 8000 and open your app at the given path with no username or password and use the environment settings for DENAME and DEPATH.

---

Where to place the files

The server have two places where it will read static files like html, js, css, png, jpg and the like. All urls with an extension will be read from these folder. It will start with the app spesfic folder then the shared folder.

First it will look for the file in a sub-directory named static in you LegEasy application folder for application specific files. Next all common files used for all your LegEasy Connect applications can be placed in a folder named static inside the C:\LegEasyConnect folder. This is where you are getting this file from.

---

How to get, put, create and delete data

LegEasy connect is a JSON based REST server. This means that is used the HTTP protocol for telling the server what to do. A GET gives you data, a PUT updates data, a POST creates new data and a DELETE removes data. To be able to do this, you must use the url in your request to tell the server what to do. For a proper description of how to do it have a look in the documentation.

Ex. of getting data

http://127.0.0.1:8099/maindata/Address/0/?Name=b*

Gives you the first record of the table Address that have a Name (the field Name) that starts on a b.