Best practices for handling errors in Appian integrations

Hello,

I’m working on a bidirectional integration between Appian and an external system via a middleware gateway.

In this setup, we often encounter two categories of errors:

  • Technical issues

  • Data issues

  • Errors series (500 and 400)

QuestionMy question:
What are the best practices for functionally handling these types of errors on the Appian side?

Specifically:

  • Should we simply display messages to end users via pop-ups or alert banners?

  • Are there recommended design patterns or built-in Appian features we should consider (such as retry logic, logging strategies, fallback mechanisms, or dynamic UI error messages)?

  • Any advice for differentiating user-facing errors from those logged for admin troubleshooting?

Thanks in advance for your insights!

  Discussion posts and replies are publicly visible

Parents
  • 0
    Certified Lead Developer

    You can make exception swim lanes/interface rule - depending on where you are invoking the integration from - so that if integration fails (reponse has error codes instead of success code) , users are informed with a message on the interface/email about failure along with  corrective measure details like system will retry for 3-4 times and will notify user after successful re-attempts as they occur or they can retry the action again in some time.

    Along with user's Admin's should be notified as well with error codes/failure reason from the integration call. So you can use 'Send email' node to notify application administrators of the error. 

Reply
  • 0
    Certified Lead Developer

    You can make exception swim lanes/interface rule - depending on where you are invoking the integration from - so that if integration fails (reponse has error codes instead of success code) , users are informed with a message on the interface/email about failure along with  corrective measure details like system will retry for 3-4 times and will notify user after successful re-attempts as they occur or they can retry the action again in some time.

    Along with user's Admin's should be notified as well with error codes/failure reason from the integration call. So you can use 'Send email' node to notify application administrators of the error. 

Children
No Data