Rapid Information Systems

Administration Support

Full Administration Technical Support Available

phone: +44 208 123 9508
email: info@rapid-is.co.uk
skype: rapidinformationsystems

Contact Rapid Support

Rapid server administration

Administration allows you to manage your Rapid server and applications.

At the top of the administration screen are features with affect your Rapid Server:

- Create button

To create a new application use the Create… button. You will be prompted to enter a name and title for your application with an optional description. The name is used to create a prefix unique to your application which is used for all resource files. It’s recommended that the name is as short as possible, but should also include a version number. You’ll notice only the characters A-Z, a-z, 0-9, -, and _ are allowed. The title is presented to users. Finally the description is an optional free text field.

- Import button

To import a previously exported Rapid application use the Import button. You will be prompted to browse to the exported .zip file and specify a name for the imported app. The name must be unique and only the characters A-Z, a-z, 0-9, -, and _ are allowed. Your imported application will assume the new name, but will retain the same title.

- Page dropdown

This will default to the first page alphabetically by page name. Use this to select the page you want to work on.

- Application dropdown

To select a Rapid application to manage in detail use the Application drop down. Only Rapid applications in which you have the “RapidAdmin” security role will appear. Once you select an application the administration tabs will appear.

- Design button

To open Rapid Design to the application you have selected use the Design… button.

- Controls, actions & adapters

Rapid is highly extendable and you are able to create your own controls, actions, and adapters. Should you modify any of these and wish to reload them into a running Rapid server use the corresponding reload button. Should you modify any controls, or actions you will also have to reload the applications as this will regenerate the application source files, and incorporate your changes.

Application administration tabs

Once an application is selected from the Application dropdown the application administration tabs will become visible. Here you can manage any settings that affect your whole Rapid application.

General

- Name box

Use the Name box to change the name of your application. This will regenerate all resource files and change any urls to your application.

- Title box

Use the Title box to change the title of your application as it appears to your users.

- Description box

Use the Description box to change the description of your application.

- Start page dropdown

Change the default start page with the Start page dropdown.

- Id numbers

Advanced users might like to see the engine generated control and action ids amongst a control’s properties in the designer. Use the Show control id numbers and Show action id numbers checkboxes to turn this feature on or off.

- Save button

Save any changes you have made to any of the above features with the save button. You will see the message “application saved” once this has been successful.

- New version button

The New version… button allows you to create a new version of the current Rapid application. This is useful for experimenting with possible new features that you may not wish to be publicly available yet or features that may need refining. You will be prompted for a name, title, and description of the version you are about to create. As usual only A-Z, a-z, 0-9, -, and _ are allowed.

- Export button

The Export button allows you to export your Rapid application for backup purposes, or for importing into a different Rapid server. Once you click the button a file called rapid.zip will start to download. It contains all off the files required to import your application.

- Delete application button

Finally you can delete any applications with the Delete application button.

Application styles

Write any css rules which you want to be applied globally throughout your application. This is especially useful for overriding the default styling for controls.

Save any changes you have made with the save button

Database connections

Use the add connection… button to add any database connections to your application. You will be prompted to:

- Name

Specify a Name for this database connection

- Driver

Choose a jdbc Driver for this database connection. By default Rapid ships with SQLite and Oracle jdbc connection libraries. More can be added in the databaseDrivers.xml file. This is covered in the Advanced topics.

- Connection string

Specify the jdbc Connection string for your database connection. Have a look at the sample application for an example.

- Connection adapter

Choose the Connection adapter to use for this database connection. Creating more advanced database connection adapters with connection pooling, and advanced security features such as trusted authentication is covered in advanced topics.

- User name

Specify the User name for the database connection, if required

- Password

Specify the Password for the database connection, if required

Once you have saved the connection settings, clicking on the connection you have made in the Database connection list will show the settings for that connection. Here you are able to change any of the settings and use the test button to test the connection. Use the save button to make the changes permanent.

Finally the settings you have entered can be tested with the test button before

When retrieving data using a database action you will prompted to select a connection.

SOA webservices

Rapid supports Service Oriented Architecture and this tab is used to create and manage SOAP webservices used for SOA.

Click add webservice to create a new webservice. You will be prompted for the following:

- Name

The Name of this webservice

- Type

The Type of this webservice. By default only sql webservices are supports. Creating your own webservice types such as using Java reflection is covered in advanced topics

Once the webservice is saved click on its name in the SOA webservices and this will bring up its detailed properties where, for sql-type webservices, you are ablw to:

- Name

Change the Name

- Database connection

Specify the Database connection (these are specified in the Database connections tab)

- Request root element

Specify the name of the request root element, its child elements and their validation rules

- Sql

Specify the sql to run against the database connection when the webservice is invoked, the value of each child element is specified with a ? Values are passed into the sql in the order in which they appear in the list of child elements

- Response root element

Specify the name of the response root element, whether the response is an array or single element, its child elements and their validation rules. Rapid will expect the fields to be present in the sql results and will produce the xml response accordingly.

Use the view wsdl link to view the wsdl for this webservice. Save any changes with the save button.