Bootstrap harmon.ie Mobile

harmon.ie Mobile Knowledge Base - Enterprise Edition

This article explains the steps required to bootstrap harmon.ie Mobile:

  • Activation: Use bootstrap to configure the SharePoint server you set up with the harmon.ie license file. This is required in order to activate harmon.ie.
  • Provisioning: Use bootstrap to configure the SharePoint server on which you deployed the provisioning file.

The SharePoint server can be added to harmon.ie using one of the bootstrap methods, or manually.

The bootstrap methods

There are three methods to help your users configure the first SharePoint site:

  • Send an email to all users, containing harmon.ie protocol link.
    In iOS: The user should open the email and tap the attached link. harmon.ie will launch with the site URL and username (if defined in the protocol) already filled.
    In Android: The user should open the email, tap and hold the attached link and select Share > harmon.ie. harmon.ie will launch with the site URL and username (if defined in the protocol) already filled.
    In order to connect to the site, the user should then supply their username (if not defined in the protocol) and password.
  • Using the company DNS server. Define the sharepointserver key in a TXT record.
    When the user first launches harmon.ie, they see an Add Site / Auto discover your site pane. Instruct them to supply their email address under Auto discover your site and tap Submit. harmon.ie then tries to retrieve the SharePoint URL using a DNS query. If successful, the Add Site dialog opens with the defined URL. The user should then supply their username and password, in order to connect to the site.
  • Sending the provisioning file as described in Provision harmon.ie for Mobile to all users. When using this method, it is recommended that, as a minimum, you provision the site on which you deployed the harmon.ie Enterprise solution and license file so that users will be automatically activated when they sign in for the first time.

harmon.ie protocol link

harmon.ie protocol link format is: harmonie://<url>?protocol={http|https}[&user=<user>]

  • <url> is the URL of the SharePoint site you want to add to all users, i.e. the site on which the harmon.ie Enterprise solution was deployed, or the site that was used for provisioning.
  • user is an optional parameter. If defined, it will be inserted to the Add Site dialog together with the site URL, and the users should only supply their password.

Example: harmonie://sharepoint.example.com?protocol=http

When composing the email message to your users, make sure to generate a link with the protocol as the address.
In Outlook, for example:

  1. Go to Insert and select Hyperlink.
  2. In the Address field, type the protocol URL harmonie://sharepoint.example.com?protocol=http
  3. Fill the Text to display and click OK.

The sharepointserver key

To define the sharepointserver key:

  • Add a new TXT record to the relevant domain and set it to sharepointserver=<url>.
    <url> is the URL of the SharePoint site you want to add to all users, i.e. the site on which the harmon.ie Enterprise solution was deployed, or the site that was used for provisioning.