Invoking custom-made URLs in Dekho.

This page is only applicable for Dekho 4.0.x users.   Dekho 4.1.x users should refer to the latest instructions/Admin guide,

I often get asked about ways to improve customer experience with Dekho.

In this blog post, I will explain a few tricks to start Dekho with specific commands. These commands can save time, or perform complex query operations on startup.  The advanced URLs can be used in a simple shortcut or within a 3rd party application to perform basic integration.

Note that all URLs are case sensitive.  All examples will use this URL: http://myserver:8080/Dekho

Feature Load a bookmark on startup
Difficulty level Easy
Example URL http://myserver:8080/Dekho?bookmark=bookmarkname
Simply write down the bookmark name as saved in your bookmark management tool in Dekho.  Note that if you used <space> character, you will need to replace it with %20 (URL encoding restrictions).
If your bookmark is called “my bookmark” ,then the URL will look like this:


Feature Start Dekho in client debug mode
Difficulty level Easy
Example URL http://myserver:8080/Dekho?debug=y
A large debug window will appear, displaying debug messages for the Flex client of Dekho. This can assist you in debugging client-side issues such as connections, loading external tools, etc..


Feature Start Dekho with or without integration
Difficulty level Easy
Example URL http://myserver:8080/Dekho?integration=y

When integration is ON (in Dekho:Admin:Settings), every user is expected to have DekhoLink or DekhoProtocol installed on their client.  If you are looking at a Dekho map and you do not have the integration tools installed, your browser may redirect you to some unhandled URL error.  .To solve this, simply add &integration=n at the end of the Dekho URL and it will not attempt to communicate with Dekho Integration tools.On the other hand, you can force the “Integration Enabled” for only one client (usually testing purposes)..In this case, leave the Dekho:Admin:Settings:Integration_Enabled to OFF but launch your Dekho URL with ?integration=y (and make sure you have DekhoLink installed )


Feature Load a specific map on startup
Difficulty level Difficult
Example URL http://myserver:8080/Dekho?map=10
The URL is not complicated but working out the map number can be.
You need to open your Dekho database (with Sql Server Manager for example) and open the table called “MAPS”.  You will need to use the ID, matching your map name (label)..Alternatively, you can do it all from DOS prompt:> oSQL –S dbServer – U {sa_login} –P {sa_password} –d Dekho.You will get a numbered prompt :1>Enter the following command:.1> SELECT id,label FROM DBO.MAPS  [enter]2> GO [enter]You will see your map list with the relevant map number (id).  Use this ID in the Dekho URL.


Feature Load a specific map on startup and execute a query
Difficulty level Difficult
Example URL http:// myserver:8085/Dekho/?map=10&queryid=21&queryvalues=TOWN%20HALL
For this one, you will need to have a query setup; a simple search query for example.
Go to Dekho Admin Queries and edit an existing query. You will notice that the last (grayed out) field of the first page is the Query ID. It is a number automatically generated by Dekho when you create a new Query.
In our example (above), our query No. is 21, searching for railway station names in Sydney.You will also need to specify the Map ID (see above examples on how to determine what the database Map ID is).
The last parameter queryvalues will contain your search text, just like what you would normally type in your Dekho search field on the top left of the screen. In this case we search for “TOWN HALL”station.
The URL needs to have special characters escaped (ex :  <space> with %20 ).
Note : Does not work for oneSearch queries.


Feature Start Dekho using another server’s dekho database
Difficulty level Guru level
Example URL http://myserver:8080/Dekho?config=http://owl12:8080/Dekho
Under normal conditions, the Dekho server uses whatever database you have configured in the file “” (see your Tomcat Web_apps folder).With this command, you can run Dekho but use the Dekho database of another system.  It implies that you have more than one Dekho running (e.g. Test and Production).This option is mostly used for development purposes, but any Admin could use this to connect to a particular Dekho DB.Note that you will need a crossdomain xml file in both Dekho instances. (see )


Feature Start Dekho using a specific map and specify extents
Difficulty level Difficult
Example URL http://myserver:8080/Dekho/?map=10&x=16831009&y=-4010668&distance=10000
48x48_0042_Mark Coordinate
In this example, we will be launching a specific map, and zoom to a specific area.
You could also save a bookmark and reload it on start-up (see above), but this URL example could be useful in other scenarios.IMPORTANT: You must use the same coordinate systems as your configuration MXD, otherwise: “hello middle of the ocean in West Africa :)”


Feature Start Dekho and launch an integration query
Difficulty level Difficult
Example URL http://myserver:8080/Dekho?setselectionfromexterna&externalapplication=
Explanation This one will allow you to invoke an integration query (pretend you are a 3rd party application selecting features inside Dekho map).The [externalapplication] is the text your typed in the integration query, in the combo box with HP Trim, Hansen, Pathway, TechnologyOne etc..The [externallayername] is the Layer Name or Table name you first specified in your integration query definition. (case sensitive).The [externalids] is a coma-delimited string that specifies the IDs that you want to see selected in your Dekho map.  Please refer to the Dekho online help for setting up integration queries.   Everything else needs to be copied as-is (see example above)


Feature Start Dekho and run a specific query
Difficulty level Difficult
Example URL http://myserver:8080/Dekho?queryid=12&queryvalues=75611,88371|Main||Melbourne
48x48_0003_Selection Review
This trick lets you invoke a query directly, without specifying the Map ID. It assumes that the query is applied to only one map.To get the [queryid], simply edit your query in Dekho:Admin:Queries and check the last field of the first screen.The [queryvalues] are delimited by the | character and should be identical to whatever field(s) you have to fill in when using the query within Dekho.
This entry was posted in Other. Bookmark the permalink.

6 Responses to "Invoking custom-made URLs in Dekho."

Leave a Reply

Your email address will not be published. Required fields are marked *