ABMS icon

ABMS

ABMS Node

Overview

The node integrates with the ABMS web service API to perform various operations such as creating, updating, deleting, querying, and retrieving data elements within a session context. It is useful for automating interactions with ABMS systems where you need to manage data elements programmatically.

For the Update operation specifically, the node updates an existing element in the ABMS system using a valid session. This is beneficial when you want to modify records or objects stored remotely without manual intervention.

Example use case:
You have a CRM system connected to ABMS, and you want to update customer details automatically whenever they change in your source database. Using this node's Update operation, you can send the updated element JSON to ABMS to keep data synchronized.

Properties

Name Meaning
Session Name The active session identifier string obtained from a prior login operation. Required to authenticate and authorize the update request.
Element A JSON object representing the data element to be updated in ABMS. Must conform to the expected schema of the target element.

Output

The node outputs a JSON array containing the response from the ABMS API after performing the update operation. This typically includes success status, any updated element details, or error messages returned by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the ABMS web service.
  • The node makes HTTP requests to the ABMS endpoint specified in the credentials.
  • Uses crypto-js library internally for hashing during login (not directly relevant for update but part of overall node dependencies).

Troubleshooting

  • Common issues:

    • Invalid or expired session name: Ensure the session name used is current and was obtained through a successful login operation.
    • Malformed JSON in the Element property: Validate the JSON structure before sending; invalid JSON will cause API errors.
    • Network or authentication failures: Check API host URL and credentials are correctly configured.
  • Error messages:

    • If the session is invalid or expired, the API may return an authorization error. Re-login to obtain a fresh session.
    • If the element data is incorrect, the API might respond with validation errors describing missing or invalid fields.
    • Unimplemented operation errors will not occur here since "update" is supported, but other operations like "extend_session" or "logout" throw explicit errors if attempted.

Links and References

Discussion