Instant JChem URLs

Overview

Instant JChem URLs is a feature that arrived in IJC 2.3. It allows you to define access to information in IJC using a URL that other people can use to obtain an identical view point. This is best illustrated by means of an example. Lets assume that you have created a shared MySQL or Oracle database, and had created a specific list of compounds that you wanted other users to be able to use. You can easily do this by:

Making the form public (sharing it) so that other people can access it
Making the query public (sharing it) so that other people can access it
Generating an IJC URL that specified the particular form and query
Sending an email to the other users containing the URL
The other users read the email, click on the link and IJC starts up, opens the form and executes the query. The user is now seeing exactly what you wanted then to see.

For reasons that should be obvious IJC URLs are of most use in a shared project environment where the URL has identical context for all users. However they can also be used in local databases or in remote databases that are not part of a shared project configuration, but they are of more limited use.

Generating URLs

An IJC URL is generated using a dialog that can be opened with Tools -> Generate URL.

At the top of the dialog is the list of actions that are available. Opening a view is currently the only action, but others may be added in the future.

Important: If you are creating the generated URL for other people to use then it is essential that any views, lists or queries that are used in the URL are shared. Without this your other users will not be able to access the information.

Creating an 'Open view' URL

Specify the exact action:

Open view: This opens the specified view and shows all the data
Open view and select query or list: This opens the specified view and applies the specified query or list. The query or list is specified using the right hand explorer. Only permanent lists or queries can be used. Temporary queries and lists are also shown as you can use the normal list and query operations to make these permanent (or to edit them or perform list logic etc. to generate new lists).
Open view and show rows: This opens the specified view and shows the specified rows. The rows that are specified are the CURRENT row numbers e.g. you can say open the view and show the rows that are currently rows 7, 11 and 18. This will open the view and show just those three rows.

In all cases the view is specified using the 'Select view' explorer.

The generated URL is displayed at the bottom of the dialog. It can be generated in HTML format for pasting into a web page by checking the 'HTML text' checkbox. Access the URL by clicking on the 'Copy to clipboard' button and then paste it wherever you need.

Opening URLs

An IJC URL can be opened using any of these approaches:

From inside IJC: Using Tools -> Open URL and paste the URL into the text box.
Using a command line option: instantjchem --openUrl <url>
Using an extra parameter to Java Web Start URL: example needed
If you are generating the URL from the Java Web Start version then the full URL that launches IJC is generated, so the URL will launch IJC when pasted into a browser or clicked on in an email.

Additional information for administrators

IJC URLs have most benefit when IJC is launched using Java Web Start and when shared projects are used. Consult the following adminstrator's documentation for details of how to set these up: