In Handyman Mobile 2.6, we have introduced the possibility to control the app with our own commands. The technique is called "deep linking". The app can be controlled using shortcuts starting with "handyman: //".
We have initially created a set of commands that can be used via QR codes and NFC tags. In addition, you can type the same commands into the internet browser you use. The commands are used to find orders or equipment, configure settings or keep hours on orders.
You can use the phone's QR code scanner or scan inside Handyman Mobile wherever the scan feature is available. Handyman does not need to be active. The app will launch automatically when a Handyman command is scanned.
When you use programming of NFC chips with info about equipment in the app, the corresponding command is now written to the chip so that reading is automatic.
Available Commands
Settings
These commands replace the current settings and sync immediately. This is how you can quickly start up new users.
With the client name (clientname) and employee number (userid) parameters, you can create a URL for a single client or a completely personal URL.
- handyman://settings?syncaddress=xxx.xxx&port=1300
- handyman://settings?syncaddress=xxx.xxx&port=1300&clientname=xx+y&userid=zz
-
clientname and userid is available from version 2.12
- clientname is used only when multiclient is active. The value is the name of the client. Use + for blank characters in name.
- userid is Employee number for user
-
clientname and userid is available from version 2.12
Equipment
- handyman://equipment?id=xxxx
- handyman://equipment?serialnumber=xxxx
- handyman://equipment?scanningvalue=xxxx
If the equipment list is active, it is searched there, otherwise the order list is displayed and it is searched there. If the result is only one item, details for this are displayed.
Order
- handyman://order?id=xxxx
Search for orders with the specified order number. If only one order is found, the order menu for the order is displayed. If more than one is found, the order list is filtered by order number. This can happen if several orders have the same ERP number.
Hours & Costs
- handyman://hours?code=xx&quantity=9.9
- handyman://hours?code=xx&quantity=9.9&orderid=yy
- handyman://hours?code=xx&quantity=9.9&grouping1=123&grouping2=abc&grouping3=1AC&orderid=yy
- handyman://hours?quicklist=xx+y&grouping1=123&grouping2=abc&grouping3=1AC&orderid=yy
Register hours / costs on active order. "code" is the salarycode-ID. If no order is active, the order selector is displayed. If "orderid" is used, this is Handyman's internal order number.
Quick list can also be used. "quicklist" is then the name of the list. Blank characters are indicated by +.
(As of version 2.12)
The grouping fields may have other names in Handyman. e.g. eg Cost bearer, Phase, Item. These names should not be used here. The order's settings determine whether the grouping fields are used.
Materials (Available from version 2.11)
- handyman://material?search=xxx+yy
- handyman://material?search=xxx+yy&orderid=zz
Register material on active order. "search" is search pattern use + to have multiple AND criterias. If no order is active, the order selector is displayed. If "orderid" is used, this is Handyman's internal order number.
App
- handyman://
If you do not send a command, the app will be activated without anything special happening.
QR-code generator report
We have created a special report to generate QR codes with the commands shown above. For help installing the report, please contact Support. You can download this report here.
