NAC3 + Automation Anywhere integration guide

NAC3 version: 2.2 (with v2.3 interop preview) Tested against: Automation Anywhere A2019 + A360.

Two paths -- pick by your AA edition

Path A -- A360 + Web Recorder + Run JavaScript

AA's Run JavaScript Function action injects into the active browser tab.

// payload variable: NAC_ID = "invoice.save"
async function nacClick(id) {
  await window.NAC.click(id);
  return 'ok';
}
return nacClick($NAC_ID$);

Bind input variables ($NAC_ID$, $VALUE$) at design time; the action returns a string the bot branches on.

Path B -- A2019 + Object Cloning with custom attribute

A2019's Object Cloning traditionally targets via DOM properties. Configure the property selector:

HTML.Attribute: data-nac-id
Search value: invoice.save

Less robust than Path A (depends on DOM tree timing), but lets veteran A2019 bots adopt NAC3 without rewriting flows.

Canonical 8-action bot template

For the v21 invoice demo:

| Step | Action | Payload | |------|--------|---------| | 1 | Open Browser | https://your-app.example.com/ | | 2 | Wait | for window.NAC ready (poll JS) | | 3 | Loop CSV | rows | | 4 | Run JS | await window.NAC.click_by_verb('invoice','new') | | 5 | Run JS | await window.NAC.fill('invoice.client',$row.client$) | | 6 | Run JS | await window.NAC.fill('invoice.amount',$row.amount$) | | 7 | Run JS | await window.NAC.click_by_verb('invoice','save') | | 8 | End Loop | -- |

8 actions regardless of UI complexity. Compare to typical 30-60 actions for CSS-selector flows.

Discovery via NAC.describe()

return JSON.stringify(window.NAC.describe());

Returns the manifest tree. AA can parse it with JSON Parse and build dynamic flowcharts.

Provenance + isTrusted

AA dispatches synthetic clicks. The host app may refuse sensitive verbs (delete, payment) unless explicitly whitelisted. See RPA_UIPATH.md section "Provenance" for the host-side opt-in pattern. Same applies to AA.

Error handling

Wrap every JS call in try/catch returning JSON:

try {
  await window.NAC.fill('@id@', '@value@');
  return JSON.stringify({ok: true});
} catch (e) {
  return JSON.stringify({ok: false, code: e.code, message: e.message});
}

If action branches on the parsed JSON.

License + see also

Apache-2.0. See RPA_UIPATH.md for the deeper treatment; the patterns transfer 1:1.