EXO URL Protocol

EXO Business records can be opened from a URL/hyperlink using the exo:// protocol. The link can be on a webpage, in an email, in a third-party application, or in the EXO Business interface itself.

Note: EXO Business grid displays support clickable URLs for the TEXT and NTEXT data types. This feature can be used in Grid widgets, to allow drilling to a URL directly from the data. In combination with EXO Business URLs, it allows drilldown to any of the EXO Business records that support URLs.

Setting up the EXO URL Protocol

A separate application, exoprotocolhandler.exe, processes all EXO Business URLs. This application is installed with EXO Business, and must be present on all PCs where you want to use EXO Business URLs.

To set up support for EXO Business URLs, double-click on this application to run it once (every time it runs, it checks if it is registered as the exo:// handler in local registry, and registers itself if it is not).

URL Format

EXO Business URLs are formatted as follows:

exo://[connection/]command[(#)][/][?param=value&param=value...]

Each URL has the following components:

connection - specifies the EXO Business database connection to use.
command - specifies the EXO Business procedure/window to launch.
(#) - some commands allow you to open a specific record by entering the record’s ID number (SEQNO or ACCNO) in brackets. If an ID number is not supplied, the search screen for that kind of record is displayed.
?param=value - some commands support additional parameters, such as a search string. Multiple parameters are separated with an ampersand (&).

A command must be specified; all other components are optional.

Supported Commands

Supported commands are listed in the table below. All commands open in the core EXO Business module, unless stated otherwise.

Note: Commands must be available as a menu item in the relevant module; users will be prevented from opening any screen that they would not normally have access to when using an EXO Business module. This ensures that the security of the EXO Business system is preserved.

Command	Description
activity	Opens the Activities window in the EXO Business Core module.
campaign(x)/?search=xyz	Opens the Campaign record with the ID number x in the EXO Business CRM module, or searches for the text specified by the ?search parameter.
company/?search=xyz	Opens the Company search window in the EXO Business Core module, searching for the text specified by the ?search parameter.
contact(x)/?search=xyz	Opens the Contact record with ID number x in the core EXO Business module, or searches for the text specified by the ?search parameter.
core_campaign(x)/?search=xyz	Opens the Campaign record with the ID number x in the core EXO Business module, or searches for the text specified by the ?search parameter.
core_opportunity(x)	Opens the Opportunity record with ID number x in the core EXO Business module.
core_serviceunit(x)/?search=xyz	Opens the Serviceable Unit record with the ID number x in the EXO Job Costing module, or searches for the text specified by the ?search parameter.
craccount(x)/?search=xyz	Opens the Creditor account with the Account ID number x, or searches for the text specified by the ?search parameter.
crinvoice	Opens the Creditors Invoices window.
crm_contact(x)/?search=xyz	Opens the Contact record with ID number x in the EXO Business CRM module, or searches for the text specified by the ?search parameter.
document(x)	Opens the document stored in the Document Manager with the document ID x.
draccount(x)/?search=xyz	Opens the Debtor account with the Account ID number x, or searches for the text specified by the ?search parameter.
invoice(x)	Opens the Debtor invoice with ID number x.
job(x)/?search=xyz	Opens the Job record with the ID number x in the EXO Job Costing module, or searches for the text specified by the ?search parameter.
opportunity(x)/?search=xyz	Opens the Opportunity record with ID number x in the EXO Business CRM module, or searches for the text specified by the ?search parameter.
purchaseorder(x)/?search=xyz	Opens the Purchase Order with ID number x, or searches for the text specified by the ?search parameter.
prospect(x)/?search=xyz	Opens the Non Account x with the Account ID number x, or searches for the text specified by the ?search parameter.
report/?paramaters	Opens a Clarity report. All report parameters are supported, e.g. exo://report/?DR_Control.CLR&d=Printer&a=N
saleorder(x)/?search=xyz	Opens the Sales Order with ID number x, or searches for the text specified by the ?search parameter.
serial/?stockcode=xyz&search=xyz	Opens the Serial Number Tracking window.
serviceunit(x)/?search=xyz	Opens the Serviceable Unit record with the ID number x in the core EXO Business module, or searches for the text specified by the ?search parameter.
stockitem/?stockcode=xyz	Opens the Stock item with the stock code specified by the ?stockcode parameter.
statement	Opens the Debtors statements window.

Examples

exo://draccount(2) – opens the Debtor account with the ID number (SEQNO) 2.

exo://crm_contact(3) – opens the Contact with the ID number (SEQNO) 3 in the EXO CRM module.

exo://contact/?search=smith – opens the Contact search window, showing results for a search on “smith”.

exo://stockitem/?stockcode=AIRFIL01 – opens the Stock item with the code AIRFIL01.