You can create an AB Suite test project by using the sample AB Suite application from the templates provided in the New Project dialog box for testing the functionality of the AB Suite Developer. You can then set the configuration properties, create a test database, build, and run the application.
To create an AB Suite project by using the sample AB Suite application, perform the following:
On the File menu, point to New, and then click Project.
The New Project dialog box appears.
In the Project Types pane, expand Templates, expand Agile Business Suite, and then click Samples.
In the Templates pane, select Sample Application.
Click Next.
The Configure your new project window appears.
In the Name box, enter the project name.
In the Location box, enter the path or browse to the location where you want to store the new project.
Click OK.
The New Application Wizard appears.
From the Server Name list, select the SQL server. By default, this list box displays the system name.
In the Database Name box, enter the model name. By default, this test box displays the solution name.
In the Model Name box, enter the model name. By default, this text box displays the solution name.
Click Next.
The project creation confirmation message appears in the wizard.
Click Finish.
The sample AB Suite application is restored.
Click Close.
The AB Suite project is created in the specified location and the sample AB Suite model node appears in the Class View window.
Creating a Deployment Folder
The SAMPLE.model file contains a deployment folder with pre-defined configuration properties. If you are using a model file without a deployment folder you must perform the following:
Right-click the model node in the Class View window, point to Add, and then select Folder from the context menu.
A folder with the default name “Folder1” is created under the model node. This folder can be used as a container for configuration properties.
Drag the segment into the deployment folder to apply these configuration properties to the segment.
A newly created deployment folder contains default settings. These settings must be modified to allow the sample application to be deployed successfully.
Rename the deployment folder from “Folder1” to an appropriate name. For example, “SampleDeploy”.
Configuring the Deployment Folder
You must configure the deployment folder before you build the application.
To configure the deployment folder, perform the following:
Right-click the deployment folder and select Properties from the context menu.
The <Deployment Folder Name> Property Pages dialog box appears.
From the Configuration list, select Release.
From the Platform list, select Windows. By default, this property is set to MCP.
Under the Build Target Filter section, set the Deployable property to True.
This enables the other configuration properties.
Under Builder Target Filter section, set the Deploy Application Components, Deploy Database, Deploy Reports, and Deploy Winform User Interface properties to True.
Under Installation section, set the Deployment Host property to “localhost” for local deployment (where Runtime and System Modeler are installed on the same physical machine).
Browse to and select the Package Installation Directory where the deployable unit should be installed on the runtime server. For example, “C:\Program Files (x86)\Unisys\AB Suite 7.0\Sample”. This is the location of all executable files for the deployed system.
Browse to and select the Package Intermediate Directory where you want to store the temporary installation files. For example, “C:\NGENSystems\Temp”.
Click OK.
Configuring the Segment
To configure the segment, perform the following:
Right-click the segment and select Properties from the context menu.
The <Segment Name> Property Pages dialog box appears.
From the Configuration list, select Release.
From the Platform list, select Windows. By default, this property is set to MCP.
Set the Database Name to specify the runtime database name for the application. For example, “SAMPLEDB”.
Set the Database Server Registration to specify the database server instance alias name defined in the Administration Tool. You can use a default instance named “default”.
You must then create a runtime database (for example, “SAMPLEDB”) by using the Runtime Administration Tool.
Creating a Runtime Test Database
To create a runtime test database, perform the following:
Point to and click the Start icon in the bottom-left corner of the screen.
Right-click a blank part of the Start screen and then select All apps. Select Administration Tool under Agile Business Suite 7.0 or type Administration Tool on the desktop.
The AdminTool window appears.
Right-click Favorites and select Add Server….
The Add Server to Favorites dialog box appears.
Enter the local server name in the Server name box.
The server name appears under Favorites.
Expand the server you added and locate the “default” server registration node. If the “default” server registration node does not exist, perform the following:
Right-click the server node, point to All Tasks, and then select Register Database Server.
The Register DB Server dialog box appears.
In the DBMS registration alias name box, enter “default”.
In the Server machine box, enter the name of your local server.
In the Instance name box, enter the SQL named instance. If you are using a default instance.
Click OK.
Right-click the “default” server node, point to New, and then select Database…, to add a new SQL Server database. For example, enter “SAMPLEDB” as the database name.
Note: You must install SQL Server Management Studio (SSMS) and add the application administrative user to the MSSQL Server login as sysadmin before creating the runtime test database. If you do not perform this the authentication fails and you are prompted to add the application administrative user to the MSSQL Server login as sysadmin.
Building the Application
To build the application, perform the following:
Open the Class View window and select the top-level deployment folder.
Right-click the deployment folder, and select Build.
You must enter the Application User Name and password to build the application. Refer to Preparing for Installation of Agile Business Suite for more information on setting up an administrator account. If deploying locally, enter the Domain as “.”. The progress of the build operation appears in the Output window.
The build places all the deployed executable files in a series of sub-folders within the folder defined in the “Package Installation Directory” property. If this property is not defined, the executable files are stored in the default location, which is in a folder within the folder where the Agile Business Suite software is installed. For example, C:\Program Files (x86)\Unisys.
The contents of these folders are as follows:
Database tables – The database tables are created within the SQL Server database.
Winform dlls – The Winform dlls (one per ispec) can be located in
..\Sample\Interfaces\Winforms\Bin\<language number> within the folder structure.
Application Component dll – The application component dll can be located in
..\Sample\Core\Bin.
The application is installed as a COM+ application.
Testing the Application
Refer to the Agile Business Suite Developer User Guide to run debugger and test that the application works correctly.
If you want to run the sample application by using the Winform client installed with AB Suite Developer, you must edit the ispec.xml file that is generated by the system. Refer to Configuring Winform for more information. The config.xml file is located at <Developer installation folder>\Unisys\AB Suite 7.0\Bin.