How to create a custom datasource dialog in the i-net Designer and report server?

If you have implemented your own class of com.inet.report.database.DataFactory and you have created a JAR file (see the sample documentation/samples/jdbc/DatabaseClassUsableInDesigner.java in the SDK for details) then you may also want a special datasource dialog. To get this you need to add 2 files to your JAR file. This is an unofficial feature and there is no documentation.

At first you need to create an XML file that describes the GUI of the datasource dialog. As starting point you can use one of the XML files of the existing datasources in ClearReports.jar/com/inet/report/config/datasource/stylesheets/. Your XML file must be stored in the folder /com/inet/report/config/datasource/stylesheets/ of your JAR file. You need to use a unique filename that does not conflict with one of the existing XML files.

The second file is StyleSheetIndex.txt. You need to create it in the folder /com/inet/report/config/datasource/widget/ of your JAR file. It must have exactly this filename. It contains the filename of your XML file without any folder.

Add your JAR file to the lib/ directory of the i-net Designer and/or report server. Now you can restart the i-net Designer and/or report server and test it. The XML file will be read only once, therefore it is necessary to restart i-net Designer and/or report server after every change of the XML file.

If there occurs any errors on parsing of your XML file, they will be printed to the logger [Reporting,ERROR]. It is recommended to enable this logger in the configuration and check the log file.