Adobe AIR Help

UPDATE September 2016
Whilst AIR Help remains an output offered within RoboHelp, it is no longer being developed. I would not recommend starting any new projects with this output.

What's covered?

AIR help is a form of help introduced by Adobe in RoboHelp 7 using .AIR technology.

What is Adobe AIR?

It is a development tool that is used to create many cross platform browser independent applications. What Adobe have done is use this tool to create help as an application. The help gets installed in Program Files and requires the AIR Runtime to be installed.

You can learn more about Adobe AIR as a development tool here.

Why introduce this new format?

Platform and browser independence is the short answer.

Locally installed AIR help

The .AIR file that RoboHelp generates is not what the user accesses when they view the help. The .AIR file is an installer that installs an application that is the help. The help is opened by running the exe file that the .AIR file installs. In the same way that AIR is used to produce applications, RoboHelp uses it to create the help as an application.

Key Features

Browser Based AIR Help

To meet the needs of web applications and avoid the logistics of installing help locally for large numbers of users, a browser based version of AIR help is available. Essentially it is webhelp with an AIR theme and skin.

What is different?

Comments

One of the key features of AIR Help is that users can record comments on topics and they can share these with other users. Locally installed AIR help was originally designed with two distinct groups in mind, users and reviewers and commenting had to be set up in specific ways for each group. As I had hoped, this distinction was removed in RoboHelp 9 and the setting up comments is easier and moderation has been introduced. See the RoboHelp 9 AIR page for information.

If you are using RoboHelp 7 or 8, then you need to be aware of the differences. Click here for information.

Comments in RoboHelp 7 and 8

Users

The idea was that users would click the Comment icon to make a comment visible only to themselves, although they can export them to other users one by one. Typically the comments would be a note to expand on something the user did not understand in the topic on first reading or how some procedure is undertaken in their organisation.

Reviewers

Comments made by reviewers work in a different way. The author can specify a network location that the reviewers can see. How that is done is described in Adobe AIR Help in RoboHelp 8. Essentially it involves entering a network drive using the server name rather than mapping and then a path. Reviewers can choose to send their comments to a file, in the same way as users, but typically they will send them to the server from where all reviewers can import them. There is no moderation.

Users Sharing Comments

For reviewers to be able to share comments, they have to be able to see a common drive that has to be specified when you create the AIR file. That is the result of sharing comments being thought of as something for reviewers but what if you want users to be able to do the same thing? To use the same functionality and send your help to say 100 different companies, you would have to generate 100 AIR files as each company would have different server names and paths for the comments. Effectively that ruled out using that method and restricted commenting for users to each user sending their comments to each user individually.

Thanks to my developer colleague, Mike Hempenstall, it is possible to generate one AIR file and send it to each of those 100 companies. With some straightforward work by their System Administrator, all users within each company with be able to share comments in the same way as reviewers. The comments will not be visible to users in other companies. Setting this up is described in Adobe AIR Help in RoboHelp 8.

Note that comments cannot be moderated with AIR Help generated from RoboHelp 7 or 8.

Sorting Comments

When a user makes a comment, the date of the comment, the user name and the topic are automatically recorded and can be used for sorting the comments.

Comment Moderation

RoboHelp 9 introduced moderation of comments. Moderation is controlled by the use of a password. If RoboHelp Server is used then moderators can be authenticated through their logon.

AutoUpdating

This feature is only applicable to locally installed AIR help as browser based AIR help will be updated by the author or a system administrator.

When the author generates the help, they can set it to check a specified location for an updated version.

This creates some practical issues.

  1. The user has to have admin rights to install the update. Not all users will have admin rights.
  2. The specified location has to be accessible to the user and not blocked by a corporate firewall.

What if users do not have admin rights?

Their system administrator will need to install the update.

What if a firewall prevents access?

If you have users who will be behind a firewall, the only solution is to generate a special AIR file for them where the specified location is behind their firewall.

If your application is one that is sold to numerous organisations who all operate behind their own firewalls, you may need to consider using browser based AIR help installed behind their firewalls. This is a design limitation and what is needed is the ability for system administrators to specify the update location during installation.

Donations

If you find the information and tutorials on my site save you time figuring it out for yourself and help improve what you produce, please consider making a small donation.

Topic Revisions

Date

Changes to this page

05 Sep 2016 Note added cautioning against creating new AIR Help outputs.
14 Jan 2014 Minor revisions amending "9 and 10" to "9 and above".
16 Dec 2012 Updated to cover "no changes made to RoboHelp 10".
26 Mar 2011 Updated to reflect changes in RoboHelp 9.
31 Jan 2010 Commenting section further revised. Reviewer method can be used for end users without having to generate separate AIR files.
04 Jan 2010 Commenting section revised to describe when and how Reviewer Comment functionality can be used by Users.
20 Oct 2009 New Topic