Start automatically a job in Ermeo from another application using Universal Link

Do you have a CMMS application with your work orders and want to enable your technicians to automatically start a job on Ermeo?

Thanks to the "Universal Link" feature, you can add a button in any application that launches the Ermeo app and automatically starts work on

• the right form
• the right equipment
• and automatically pre-fill certain fields, such as the work order number

1. How does it work?

The Universal Link will allow you to launch the ermeo application and thus start an intervention from another mobile application. For this link to redirect you to ermeo, it must be only used from an external application.

Universal Link base’s nomenclature:

In addition to this base, it is possible to add parameters such as the job main resource or job attributes values.

• document_code Code of the form used for the intervention → Mandatory
• asset_code Code of the asset used for the intervention → Optional
• attribute_code Code of the attribute used for the intervention → Optional
• intervention_id : Id of a planned / already existing intervention → Optional, but cannot be used with the other parameters

2- Where the Codes can be find ?

For the form code, you will find this code to copy in Documents → Desired form → in the form at the top right next to the “Open in studio” button of the screen.

For the resource the code will be accessible from:

From the Database page → Click on the desired resource from the database that contains it.

Or

From the Database page → Resource tree → click on the desired resource → accessible at the top right of the screen.

For intervention attributes, an export of existing attributes is necessary to know the code.

Interventions tab → Attributes

Check all the available attributes or those that interest you, then click on the exportation button. The attribute codes will be in the export tabulated file.

3- Examples of use

Example of universal link from Windows / Apple IOS web browser, or Email received : 
ermeoapp://start_intervention?document_code=maintenance_15668936708936&asset_code=engine_15530980996366&wo_no_15530977997851=1256

Example of universal link for Ermeo Androïd APP / Ermeo WebAPP, or Email received:
https://app.ermeo.com/start_intervention?document_code=maintenance_15668936708936&asset_code=engine_15530980996366&wo_no_15530977997851=1256

• maintenance_15668936708936 is the code of the form with which the intervention must be carried out
• engine_15530980996366 is the code of the asset on which the intervention must be carried out
• wo_no_15530977997851 is the code of an intervention attribute and 1256 its value.

Simply add & at the end of the url to add other parameters. Another attribute, for example

→ Here an universal link embeded in an Email to use with Ermeo App for Androïd :

If you want a task on a form to be automatically pre-filled with a value passed as a parameter, remember to link the task to the corresponding task attribute and tick the "Pre-fill" option from the Form document to use.