When Opencast is down, plugin has unnecessary long loading time and doesn't display proper error but creates error log

[reiferschris]

Describe the bug
When Opencast is down, plugin has unnecessary long loading time and doesn't display proper error but creates error log.

To Reproduce
Steps to reproduce the behavior:

1. Stop opencast service or make it unavailable in some other way for ilias
2. Click on any series object within ilias
3. wait far too long to see
4. the typical ilias error message that a log easdfs_9878 has been created

Expected behavior
The plugin should instead display a helpful message to the user that currently Opencast can not be reached. The plugin should only do this for those kinds of errors where the reason is crystal clear: Opencast is down
Additionally, it would be nice to have a custom message for the users in this case e.g. to link to another website that contains useful information in cases like this.
A cherry on top would be to display some kind of warning in e.g. the description of the plugin even before clicking on it, not sure if this is possible

Log
Will add it when I get it. already gone.

Environment (please complete the following information):

• ILIAS version: [v7.30.2 2024-06-25]
• Plugin version: [7.0.3]
• Opencast version [13]
• Browser: [doesn't matter]

Additional context
This was already discussed in the matrix chatroom:
few notes by @chfsx in german were:

Hier schon mal ein Hinweis aus der "Technik-Ecke": Das Error-handling in ILIAS hat so seine Grenzen: Die bekannten Error-Codes werden erstellt, wenn sich ILIAS nicht im DevMode befindet und irgendwo eine Exception auftritt. Man wird in diesem Fall auf die Seite error.php weitergeleistet, dabei wird ein Error-Code erstellt und die effektive Exception in einer Datei gespeichert (für die Admins).

Exceptions kann man aber auch abfangen und bspw. selber einfach eine Fehlermeldung anzeigen. Beides geht aber nicht. Das heisst wir könnten zwar die Exceptions/Fehler abfangen und irgendwo etwas darstellen (bspw. in der Objekt-Liste im Magazin unterhalb des jeweiligen Objektes, NICHT aber gleichzeitig einen Error-code erstellen lassen und die eigentliche Fehlermeldung so den Admins verfügbar machen. ich denke daher dass man nur die "lesbare" Meldung für die User umsetzt/umsetzen kann.

[dagraf]

Thanks @reiferschris for creating the issue.

If we only implement a simple, hard-coded message (without the possibility of making it custom), I would suggest formulating something similar to the message for "Processing failures."

Processing failure: "Fehlgeschlagen. Melden Sie sich bei Ihrer Supportstelle." / "Publication failed. Please contact the support."
Opencast down: "Opencast ist nicht erreichbar. Bitte melden Sie sich bei Ihrer Supportstelle." / "Opencast is down. Please contact the support."