Project File

A project file is an XML file which stores all settings of a particular project. You should save a project file for each site you generate and back it up. You will NOT be able to create a project file backwardly from the generated scripts later.

A project file is an XML file, like other XML document, it is human-legible. You should be able to open a project file in any text editor and view the content. Each object (e.g. database, table, field, etc) is represented by an XML node in the project file. The object properties are saved as attributes of the node.

A project file is in utf-8 encoding, your text editor needs to support utf-8. Most text editors support utf-8 nowadays. You can simply use Notepad if you do not have other text editors. With basic understanding of XML, you can change the settings manually. However, If you modify a project file, make sure your keep it well-formed. To check if the file is well-formed, you can change the file extension to .xml and open it with Internet Explorer or Firefox. If the file can be loaded and displayed properly in the browser, it is well-formed.


Auto Backup

When you save a project, the old version will be saved to the subfolder <Documents folder>\<product name>\Backup folder first, you can recover older versions of your project from the backup folder in case of corrupted projects or other accidental losses. Note that only the latest 10 versions will be kept, older versions will be deleted.

Note The Documents folder is your personal folder in which you can store your personal files. For example, in Windows Vista (or later), the folder is C:\Users\<user Name>\Documents by default, where C is the drive in which Windows is installed, and <user name> is the currently logged-on user.


Project Name

Each project has a project name. By default the file name (without extension) of the project file is used as project name. Before you name your project file when saving it for the first time, a temporary name, Project<n>, where n is a number, is used. The project name is an important property, it is used in the generated codes to identify your project.

Note It is recommended that only alphanumerical characters is used in project name.

If you need to change the project name, use Advanced Settings.


Project ID

Each project has a project ID which is a GUID (globally unique identifier). The value of a GUID is represented as a 32-character hexadecimal string, such as {095F6728-DF53-4763-A372-D8F2EAC959F2}. It is used to identify the project and the scripts generated by it. Each script generated by the project has the project ID. An XML file named <GUID>.xml is also generated for each project in the subfolder named by the project name under the Application Root (see Generate Settings). The XML file contains some project information and is used to share with other projects (e.g. ASP.NET Report Maker project) with the same project name. So do not reveal the project ID to public and do not change the project ID unless absolutley necessary. If you really need to, use Advanced Settings.

If you use Dynamic User Level (see Advanced Security), the project ID is also used in the User Level Permission table as a prefix of the table name so that the table names from different projects will not clash.


Save As vs. Save A Copy

If you want to create a new project based on an existing project, use [Save As...] under the [Project] menu. If [Save As...] is used, the project name and project ID are changed in the new file. The new file is NOT the same project anymore.

If you want to create a backup copy or another version of an existing project, you should use [Save a Copy...] to save the file with another name. If [Save a Copy...] is used, the project name and project ID are NOT changed. The project name may not be same as the file name anymore. However, with the same project name and project ID, scripts generated from these project files will still work like they are generated from the same project file.


Also See

Object Properties


 ©2007-2016 e.World Technology Ltd. All rights reserved.