If Hana, Hawaii is famous for one thing, it is the road to Hana. It is a twisty road that wraps around the mountainous island from the central valley of Maui to the north-eastern shore where Hana is located. It is a thrilling adventure of a drive.
Making your web-app available for usage in Hana is way easier though. It is as simple as an HTML Anchor tag using our simple URI syntax. (Click here for the builder!)
The URI syntax:
hana://[a]//[b]//[c]//[[d];[d];...]//[e]
a is the short name for your web-app, this is what shows up in the tab. Keep it short!
b is the protocol to use for the URI for the web-app. This should be http or https.
c is the URI for your web app. We recommend presenting this to the user after their account is set up so that this is the page that is loaded in Hana when they launch it. If this ends with a slash, either remove it or URI encode that slash since it will cause the link to be rejected by Hana.
d are alternative root URIs for your app that could be used for links and other communications between the Hana client and your server. For example: Google Mail uses www.gmail.com and www.google.com/mail. You will want to identify all root URIs (server....domainname.topleveldomain,) and include these in the connected URIs section, these are SEMI-COLON (;) separated. This section is optional, but the slashes must still be included.
e is the User Agent your web-app prefers. If this is left blank, Hana will be used. You should support Hana (it is using the same rendering engine as Safari!.) If not, then specify your preference in this order: Safari 3, Safari 2, Firefox 2, Firefox 1.5, Camino 1, Internet Explorer 7 or Internet Explorer 6. You should use Hana or Safari 3 though.
So, your code will look something like this (be sure to remove spaces and encode all special characters!):
<a href='hana://My%20web%20app//http//mwa.alloutsoftware.com/ /mwa.alloutsoftware.us;mwa.alloutsoftware.net;mwa2.alloutsoftware.com//Hana'>Add to Hana</a>
a= My%20web%20app
b= http
c= mwa.alloutsoftware.com
d= mwa.alloutsoftware.us;mwa.alloutsoftware.net; mwa2.alloutsoftware.com
e= Hana
UPDATES:
9 April 2007: Published
10 April 2007: Fixed error where we referred to the Connected URI delimiter as COLONs and used colons in the examples. This is now fixed to use semi-colons. Otherwise known as Super-Commas.
19 January 2008: Added note about Connected URI bug and plans to add more features. (http vs https, default UA, and maybe a string for that UA.)
31 January 2008: Updated to reflect Hana 1.1.1 Hana URI Protocol.
7 February 2008: Added link to Link Builder.