Client for an Existing Custom DA Server

This article is a continuation of Data Abstract New Project Wizard (Delphi)

After choosing to connect your Delphi project to a custom server, the next step is to provide details on the server you wish to use.

At the minimum, you need to provide the address, also referred to as Target URL of the server. Custom servers by default run on port 8099, and the default address will usually end on /bin.

If your server uses a different channel or message type, you can also adjust the respective setting, and you can provide an optional AES password, if your server is set up to use the AES Encryption Envelope.

After you click "Next", the wizard will connect to the server and retrieve the list of available Data Services. By default, most servers that expose a single data service use the name "DataService", but if your server uses different names or exposes more than one data service, you can select the appropriate name from the drop-down.

The wizard will also determine if your server needs login and show the respective settings, if necessary. If your server uses the default login infrastructure, Login will be done via a service named "LoginService", and you can provide either a username/password combination or a custom login string to authenticate.

If you are connecting to the PCTrade Sample Server, that server will accept any username/password combination where username and password are identical (for example "test"/"test").

Next, the project wizard will show you a list of all tables exposed by the data service selected before. You can select which tables you plan to access to have the wizard automatically generate the proper code stubs for the tables in question.

Don't worry: you can always add access to more tables later on; there is also no harm in simply selecting all tables from the start, even if you don't need them yet.

As the last step, you can choose between some options for the generated client project.

Data Streamers define how data is encoded for transfer between your client and the server. Bin2 is generally the best choice and should be selected unless you have explicit reasons not to. The choice you make here needs to reflect what is exposed by the server.

You can also enable support for running Business Rules Scripting on the client side, where available, allowing your client application to do local data validating and provide information on invalid data without additional server roundtrips assuming such business rules are defined on the server.

On the final page, you can provide a name and destination folder for your project:


Click Finish, and you are done; the wizard will create your project(s) and open them in the IDE, ready to build and run.

You may want to continue reading about The Client Project generated by the Data Abstract New Project Wizard.