ActiveManage Docs ← Back to activemanage.co.uk

AJAX Search (URL) Field

Same as AJAX Search (DB) but the search target is an external HTTP endpoint rather than a local datastore. Use for integrating with third-party search APIs, internal microservices, or any other JSON-returning endpoint.

Conditional options

  • Path to AJAX Script (Required) — the full URL of the external endpoint.
  • Minimum Characters (Required) — minimum chars to start a search.
  • AJAX Delay (milliseconds) (Required) — debounce delay before sending the request.
  • Output Format (Required) — how would you like the results displaying?
  • AJAX Variable Name (Required) — the request variable expected by the AJAX server. For example, if your AJAX script path is https://website.com/api/search/?q=test the variable name would be q.
  • AJAX Results Property (Required) — the property in the JSON response that contains the results from the search.
  • AJAX Results Unique Record Property (Required) — the property in the JSON answers response items that contains a unique value to identify the select value (e.g. id).
  • Javascript Callback Function — invoked on selection.

Security

The endpoint is called from the user's browser. If it requires authentication, your endpoint must either be public, accept the user's session, or use a CORS-friendly token scheme.