Dude you're so deep, Nintex Mobile deep linking that is..

dan_stoll
Workflow Veteran
12 10 8,680

Back in version 3 some months back, we saw the introduction of deep linking to re-load authentication details into Nintex Mobile Launch Nintex Mobile from a hyperlink and pre-populate authentication fields. Well, the team has added more functionality based on feedback from customers and partners.

988714.jpg

This month with the release of Nintex Mobile version 3.6,Nintex Mobile Apps - Release Notes you can not only pre-load the authentication details, but now navigate directly to a form within the mobile client. So lets check it out:

The following PARAMETERS can be used along with “form” as ACTION to navigate user to particular form

Parameter

Description

id

A string usually GUID to represent unique form Id on server

name

A string representing form name.

category

A string representing form category can be passed along with form name to uniquely identify a form, in case when there are two form with same name.

returnUrl

A return URI to redirect user to once user will navigate away from requested form

Notes: 

  • All parameters are optional and lower case by default. 
  • If ACTION i.e. form is not specified in URI the parameters will be ignored.
  • Id has preference over name, if the id matches, name will be ignored.
  • returnURL also appends a parameter at the end of URL e.g. action=success if user submits form or action=cancel if user does not submit form.

So let’s put this into context:

Painting the picture, I have 600 delivery drivers. None of the drivers have AD / SharePoint accounts. So I onboard them into a list list in Sharepoint.

From here I can have a workflow that sends off an email to instruct the driver to download the Nintex Mobile app from the store.. Being BYOD, they can head off to the relevant store.

Download Nintex Mobile on the App Store  Get Nintex Mobile on Google Play Download Nintex Mobile from Windows Phone Store Download Nintex Mobile from Windows Store

The first email I want to send has the download info, plus a deep link to add the authentication and server details..

Now that they have received this email, and they have gone through and setup everything, we can get them working.. As part of this process the office staff created a QR code with the drivers license number as the value. The driver can then stick this to their dash / put it in their wallet etc.. The reason for this is, that it is their unique identifier. As the drivers don't have AD / SharePoint accounts and are all using a generic account, all forms will require a QR code / License number to submit details through.

Dan License.png

On the workflow side, well it gets the license number and is able to do a lookup of the Driver Access list to validate the number and pull the name of the driver for notification and task purposes...

IMG_7144.PNG IMG_7146.PNG

To get the drivers off on the right foot. The office staff can send out an email to the drivers or it could be a task that links directly through to relevant forms deep linking them as so they open in the Nintex Mobile App. After a few times, the drivers won't require these prompts as they'll know which forms to use for the different situations.

So let's look at some examples:

  1. Navigating to particular form with Id nintexmobile://form?id=321dfaf8-e45e-49e6-9bef-b5b73c4daa51
    • This will launch the app, ask user to logon if not logged in previously, and will navigate user to particular form.
  2. Navigating to particular form name and returnUrl nintexmobile://form?name=DeepLink&returnUrl=http://alstrucking.com
    • This will launch the app, ask user to logon if not logged in previously, and will navigate user to particular form. Once user is done with it, it will take it to return URL.
  3. Pre-populating logon information, if not already logged in, then navigate to particular form nintexmobile://form?authtype=sharepoint&username=alstrucker&url=http%3a%2f%2falstrucking.com&name=Ma...
    • This will launch the app, if the user is not logged in, pre-populate the logon information and then will navigate user to particular form.

Why ?

What have we just done ? well we have just created a solution for a relatively small trucking company that allows data to be sent in from all their delivery drivers, either online or offline on either iPhones, Android or Windows Phone no matter where they are. The data can be used to provide better auditing of driver movements, equipment maintenance, audit data for state and national regulations etc. It is also saving time, no longer need to worry about taking their paperwork into the office or scan / faxing it through.

This could have been done without the deep linking, the point being that it is making a slick solution even slicker. The drivers don't need to input server names, user names etc, just the initial password. Then from there the deep linking can guide them to the relevant form to fill in. Without the driver having to navigate around to the relevant form.

Enjoy

For parameter descriptions and link examples, see Building Nintex Mobile links in the help.

Community Manager edit: For a related tutorial, please see: Tutorial: Nintex Mobile deep linking for auto-submitting scanned codes

10 Comments
Not applicable

Great post!, would you happen to know if this somehow also supports sending parameters to the form like with a querystring?

dan_stoll
Workflow Veteran

Hey Marc Riethoff, not yet, but that is a great idea.. Pop it into the user voice site,, I'll vote for that. I'd love to be able to prepopulate fields by reading a NFC tag http://nintex.uservoice.com

jonathankite
Nintex Newbie

Is there a limit to the number of paramters that can be pre-populated in form fields?  I can't seem to get it to work past 2 fields.

vahid
Design Dabbler
next_connect
Nintex Newbie

Do these techniques still work?  The references I see all seem to be older posts, but my recent tests were unsuccessful.  It didn't seem to know what to do with the protocol and popped up a web search with the provided url.  

cju
Automation Master
Automation Master

Thanks for sharing Daniel Stoll‌. Is this supported for NWC forms ? Maybe Euan Gamble‌ has the answer

EuanGamble
Nintex Employee
Nintex Employee

Let me have a look and recheck.

Cheers,

Euan

EuanGamble
Nintex Employee
Nintex Employee

Hi Caroline Jung‌,

Deep linking will be available for NWC early next year. We are still waiting for a couple of features to land.

Cheers,

Euan

EuanGamble
Nintex Employee
Nintex Employee

Hi Mike Oryszak‌,

Yes, the blog post and functionality still works. We just retested it here with the mobile and forms teams.


Cheers,

Euan

cju
Automation Master
Automation Master

Thanks a lot for your prompt answer. I will wait for this feature .