Click here to Skip to main content
15,868,349 members
Articles / Web Development / HTML
Article

TDL: Protocol for .dan.g.'s ToDoList, Useful for SVN Users

Rate me:
Please Sign up or sign in to vote.
4.43/5 (3 votes)
25 Apr 2008CPOL3 min read 55.6K   509   44   11
Register a fake protocol of TDL: to make tdl:///filename.tdl?tid available

Application Edition

Script Edition

Requirement

Goal

Many users use TortoiseSVN (a Subversion Client for Windows) to control source code, and use .dan.g.'s ToDoList to manage issues and bugs.

If a user uses a Web application bug/issue tracker, SVN can set its URL in the projects' property. Then the user can click bug/issue ID in the log window to open the bug/issue page.

But how to do that with ToDoList, a Windows application?

We must implement a URL protocol to call ToDoList.exe. There are two ways:

  1. Have APPS implement a real URL protocol
  2. Register a fake protocol in Windows registry

This article follows the second way.

Sample image
Application edition screenshot.

Sample image

Script edition screenshot.

Difference Between Application Edition and Script Edition

App Edition Script Edition
URL Patterntdl:filename?tid
tdl:/filename?tid
tdl://filename?tid
tdl:///filename?tid
tdl:///filename?tid
RequirementWSH
Internet Explorer 6.0+
User InterfaceWindows FormHTML Page
Configuration StorageRegistry or INIOnly INI

Introduction

The program registers a fake protocol named TDL in Windows, by writing to the registry. The registered things are as follows (contents of an exported *.reg file):

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\tdl]
@="\"URL: ToDoList protocol\""
"URL Protocol"=""

[HKEY_CLASSES_ROOT\tdl\shell]

[HKEY_CLASSES_ROOT\tdl\shell\open]

[HKEY_CLASSES_ROOT\tdl\shell\open\command]
@="wscript \"C:\\Program Files\\TodoList\\Tdl\\todolist.wsf\" \"%1\""

After registering, the user can run the URL tdl:///blabla in the address bar of Internet Explorer or Run Dialog (Start Menu->Run, or [Win]+[R]) and Windows should call the registered command with the URL as the first argument. For example:

If you run the URL:

tdl:///C:\My%20Documents\todo.tdl?10

Then the system will call:

wscript C:\\Program Files\\TodoList\\Tdl\\todolist.wsf 
    "tdl:///C:\My%20Documents\todo.tdl?10"

So, it should be OK to write a WSH script named todolist.wsf and put it into C:\Program Files\TodoList\Tdl.

Application Source Code

The application is built by Turbo C++ Explorer with VCL.

There is a class named HyperlinkWrapper. The class is used to make a hyperlink from a TLabel object.

HyperlinkWrapper takes over a label and sets its style when the mouse enters or leaves.

TIniFile and TRegistry classes are used to read/store configuration.

WScript Components

tdl:///C:\My%20Documents\todo.tdl?10 is the first argument which is passed into todolist.wsf. WScript.Arguments object can get it:

JavaScript
var url = WScript.Arguments(0)

After parsing the URL, WshShell object can run todolist with filename and tid as arguments.

JavaScript
var commandLine = ...
var wshShell = WScript.CreateObject("WScript.Shell");
// or
// var wshShell = new ActiveXObject("WScript.Shell");
wshShell.Run(commandLine);

FileSystemObject Components

The script can get filename and tid from arguments. How to get the path of todolist.exe? It's a good way to write a configure file. So FileSystemObject should be used to read/write the configure file:

JavaScript
var fso = new ActiveXObject("Scripting.FileSystemObject");

Read:

JavaScript
var ts = fso.OpenTextFile("tdl.ini");
var line;
while (!ts.AtEndOfStream) {
    line = ts.ReadLine();
    if (parseLineToGetExecutable()) break;
}
ts.Close();

Write:

JavaScript
var ts = fso.CreateTextFile("tdl.ini", true);
ts.WriteLine("todolist=" + executable);
ts.Close();

We need a friendly user interface. An HTML page is a right way since JavaScript can also run in the Web page browser. When you write an HTML page, please note that there are some differences between WSH script and script in HTML.

Differences Between WSH Script and Script in HTML

WSH script can use a default object named WScript but the object isn't in HTML.

If you want to do something in WSH, you can write code as follows:

JavaScript
// create WshShell object
var wshShell = WScript.CreateObject("WScript.Shell");
// popup a message box
WScript.Echo("message");
// get the full filename of the running script
var filename = WScript.ScriptFullName

But in HTML, you must write:

JavaScript
// create WshShell object
var wshShell = new ActiveXObject("WScript.Shell");
// popup a message box
alert("message");
// get the URL of current HTML page in which the script is
var filename = window.location.href

TDL Application Edition History

  • Beta1
    • Can save configure into one of registry and INI
    • Can parse tdl:///..., tdl://..., tdl:/... and tdl:... in URL;

TDL Script Edition History

  • Beta2
    • Added description for installing, uninstalling and configuring manually
    • Added a *.reg file template to make registering TDL protocol easy
    • Fixed some spelling errors
  • Beta1
    • Made it available for tdl:///... to open todolist
    • Support to install, uninstall and configure by script

ToDoList's tdl:// Protocol Setting

.dan.g's ToDoList support tdl:// url protocol from version 5.2. If you want enable tdl:// url protocol, you can just check on a options in ToDoList's preference. Follow screenshot show you how to enable ToDoList's tdl:// url protocol.

tdl_config.png

Links

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
China China
James Fancy, is a software engineer from China. He enjoys and familiar with Java, C++ and some script languages.

If you can read Chinese word, here is one of James Fancy's BLOG:
http://hi.baidu.com/jamesfancy

Comments and Discussions

 
QuestionConfused Pin
Diarrhio24-Feb-07 8:28
Diarrhio24-Feb-07 8:28 
AnswerRe: Confused Pin
jamesfancy24-Feb-07 23:11
jamesfancy24-Feb-07 23:11 
GeneralRe: Confused Pin
Diarrhio25-Feb-07 6:37
Diarrhio25-Feb-07 6:37 
GeneralRe: Confused Pin
jamesfancy25-Feb-07 15:01
jamesfancy25-Feb-07 15:01 
GeneralConfiguration Does Not Work Pin
Hoppfrosch4-Feb-07 20:06
Hoppfrosch4-Feb-07 20:06 
GeneralRe: Configuration Does Not Work Pin
jamesfancy4-Feb-07 20:26
jamesfancy4-Feb-07 20:26 
GeneralRe: Configuration Does Not Work Pin
Hoppfrosch4-Feb-07 20:39
Hoppfrosch4-Feb-07 20:39 
GeneralRe: Configuration Does Not Work Pin
jamesfancy4-Feb-07 20:49
jamesfancy4-Feb-07 20:49 
GeneralRe: Configuration Does Not Work Pin
Hoppfrosch4-Feb-07 20:51
Hoppfrosch4-Feb-07 20:51 
>> After clicking Browse button, a Open File dialog should be opened.
>That's not the case on my Firefox 2.0.0.1 ...
...
> BTW: After creating the INI-File manually and reloading the tdl.html in my browser, the "Configure" section does not show up the manually configured path to todolist.exe ...

Think I found it - it's on my side:

ActiveXObject is not defined
TdlShell()TdlShell.js (line 8)
load()tdl.html (line 124)
onclick(click clientX=0, clientY=0)tdl.html (line 1)
[Break on this error] this.fso = new ActiveXObject("Scripting.FileSystemObject");

This is the debug output, when pressing "load configuration" on tdl.html
GeneralRe: Configuration Does Not Work Pin
jamesfancy4-Feb-07 21:01
jamesfancy4-Feb-07 21:01 
GeneralRe: Configuration Does Not Work Pin
Hoppfrosch4-Feb-07 21:08
Hoppfrosch4-Feb-07 21:08 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.