Adalos Test verschickt echte Nachrichten: bevor der Benachrichtigungsbutton Teil des Geschäftsablaufs wird
Wer mit Adalos Ada eine Benachrichtigungs-API anbindet, sollte zuerst Testempfänger, Beispielvariablen und Rückgabewerte festlegen. Test in Custom Actions führt echte Anfragen aus. Auch nach einer erfolgreichen Vorschau muss das externe Ergebnis geprüft werden, bevor die Funktion in den Produktivablauf kommt.
Ein Button „Verantwortliche Person benachrichtigen“ in einer internen Antrags-App wirkt wie eine zusätzliche Einzelaktion. Tatsächlich muss eine vollständige Kette funktionieren: Was übermittelt der Nutzer, wohin geht die Nachricht, welche Antwort kommt zurück und wie erklärt die Oberfläche einen Fehler? Adalos Ada kann Apps anhand natürlichsprachlicher Anweisungen ändern und über Custom Actions externe APIs anbinden. Die offizielle Dokumentation stellt jedoch klar: Test im Aktionseditor sendet eine echte Anfrage.
Bei der ersten Benachrichtigungsintegration sollte deshalb ein ausschließlich für Tests bestimmter Empfänger bereitstehen, bevor Ada die Oberfläche anbindet. Die folgende Analyse betrachtet eine Benachrichtigung nach dem Absenden eines Antrags. Die Prüfreihenfolge basiert auf der offiziellen Dokumentation des neuen Ada; es wurde weder eine App ausgeführt noch eine Nachricht verschickt.
Den Empfänger in die Anforderungen schreiben, nicht nur „Button hinzufügen“
Beschränken Sie den Umfang zunächst auf eine vollständige Aktion: In einer Test-App gibt der Nutzer eine fiktive Antragsbeschreibung ein, klickt auf den Button, sendet Beschreibung und Testdatensatz-ID an den festgelegten Testempfänger und erhält anschließend eine Erfolgs- oder Fehlermeldung. Bauen Sie beim ersten Versuch nicht gleichzeitig Genehmigungen, Zahlungen und das Löschen von Datensätzen ein. Adas Bauanleitung empfiehlt eine zusammenhängende Änderung als Ausgangspunkt. So lässt sich leichter erkennen, ob die neue Funktion die bisherige Navigation oder das Datenverhalten verändert hat.
Beschreiben Sie bei der Benennung der Aktion auch Auslöser und Zweck. „Den aktuellen Testantrag im Testkanal melden“ ist beispielsweise leichter zu prüfen als „Antrag bearbeiten“. Laut offizieller Custom-Actions-Dokumentation liest Ada die Beschreibung, um zu entscheiden, wann und wie die Aktion aufgerufen wird. Eine unklare Beschreibung kann dazu führen, dass selbst eine funktionierende API-Verbindung an der falschen Stelle der Oberfläche landet.
Ein Testkanal ist lediglich die Wahl für dieses Szenario; nicht jeder Dienst bietet eine Sandbox. Hat der empfangende Dienst keine isolierte Umgebung, richten Sie zuerst ein erlaubtes Testziel ein, das echte Kunden nicht stört. Ist das nicht möglich, bleibt die Oberfläche ein Entwurf und wird nicht mit produktiven Benachrichtigungen verbunden.
Auch Beispielwerte sind Eingaben für einen echten Vorgang
Tragen Sie Methode, Adresse und benötigte Variablen gemäß der API-Dokumentation des empfangenden Dienstes ein und prüfen Sie, ob sämtliche Beispielwerte fiktive Daten sind. Kontrollieren Sie insbesondere Zielkanal, E-Mail-Adresse oder Datensatz-ID. Nur weil Werte in einem „Beispiel“-Bereich stehen, bleiben sie nicht automatisch ungenutzt.
Adas Dokumentation erläutert, dass Test die Anfrage mit diesen Beispielwerten ausführt und bei Erfolg ein Antwortmuster speichert, damit zurückgegebene Felder mit der Oberfläche verbunden werden können. Der Button prüft also nicht bloß das Format. Notieren Sie vor dem Test, welche Nachricht bei welchem Empfänger erscheinen und was die App anzeigen soll. Prüfen Sie anschließend sowohl das externe Ergebnis als auch die Oberfläche. Meldet die API Erfolg, während die Nachricht am falschen Ort ankommt, ist der Test trotzdem nicht bestanden.
Schlüssel gehören in die dafür vorgesehene Secrets-Konfiguration, nicht in Prompts, gewöhnliche Eingabefelder oder Beispielnachrichten. Laut offizieller Beschreibung werden sie auf dem Server verschlüsselt gespeichert, beim Aufruf eingefügt und nicht mit der App ausgeliefert. Dieser Mechanismus entscheidet aber nicht, welche Geschäftsdaten an einen externen Dienst übermittelt werden dürfen. Die ausgehenden Felder müssen weiterhin einzeln ausgewählt werden.
Den gesamten Weg durchlaufen, nicht nur den Button anklicken
Nach einem erfolgreichen Aktionstest durchlaufen Sie die Vorschau vom Aufruf der Antragsseite an, statt nur den neuen Button zu betätigen. Prüfen Sie danach, ob die Hinweise bei leeren Eingaben, während des Ladens und bei API-Fehlern verständlich sind. Der offizielle Vorschau-Leitfaden verlangt die Prüfung des vollständigen Nutzerwegs und dieser Zustände. Er garantiert nicht, dass die erzeugte Oberfläche bereits jede Situation richtig behandelt.
Für die Benachrichtigungskette bieten sich drei Abnahmefragen an: Entspricht die Erfolgsmeldung einem tatsächlichen Eingang beim Empfänger? Wird bei einem Fehler trotzdem fälschlich „gesendet“ angezeigt? Führen wiederholte Klicks zu doppelten Benachrichtigungen, die das Team nicht akzeptieren kann? Haben Mehrfachsendungen geschäftliche Folgen, muss die für die API zuständige Person das Verfahren zur Vermeidung bestätigen. Gehen Sie nicht davon aus, dass Ada oder der empfangende Dienst dies bereits automatisch löst.
Geben Sie der Version nach jeder abgeschlossenen Änderung einen erkennbaren Namen, etwa „Test-Benachrichtigungskette geprüft“. Laut Ada-Dokumentation lassen sich abgeschlossene Änderungen als benennbare und wiederherstellbare Versionen speichern. Die Wiederherstellung einer App-Version darf nicht als Methode zum Zurückholen bereits extern verschickter Nachrichten betrachtet werden. Sobald eine Benachrichtigung die App verlassen hat, sind dafür die Mechanismen des empfangenden Systems nötig.
Trennen Sie abschließend die Abnahme in der Vorschau von der Abnahme im Produktivbetrieb. Dort können andere Ziele, Schlüssel und Berechtigungen gelten. Prüfen Sie nach dem Wechsel deshalb die gesamte Kette erneut mit erlaubten Testinhalten. Auch Adalos offizielle Anleitung verlangt einen separaten Test der veröffentlichten Anwendung. Erst wenn Oberflächenrückmeldung und externe Aktion zusammenpassen, ist der Button für echte Geschäftsnutzer geeignet.
Hinweis zum Inhalt:Dieser Artikel basiert auf öffentlich verfügbaren Informationen und dient als Orientierung bei der Auswahl von Tools. Funktionen, Preise und zugehörige Richtlinien können sich jederzeit ändern; maßgeblich sind die aktuellen offiziellen Angaben.
Originalquelle:ada-help.adalo.com