Expecco Remote Control App: Unterschied zwischen den Versionen
K (Mawalch verschob die Seite Expecco Remote Control APP nach Expecco Remote Control App: proper spelling) |
Matilk (Diskussion | Beiträge) (Aktualisierung und Zusammenführung) |
||
| Zeile 1: | Zeile 1: | ||
{{SEITENTITEL:expecco Remote Control App}} |
|||
=Einführung= |
=Einführung= |
||
Die |
Die expecco Remote Control App dient zur Verfolgung und Interaktion mit einer laufenden Testsuite auf einem Mobilgerät (Telefon oder Tablet). Sie kann sich zu einem laufenden expecco verbinden und listet dann die vorhandenen Testpläne sowie deren Status (Passed/Failed) auf. Außerdem ist die Fernsteuerung (Stopp/Pause/Run) des Testlaufs, sowie das Beantworten von Eingabeaufforderungen möglich. |
||
Zur Beantwortung von Eingabeaufforderungen muss die Testsuite nicht geändert werden: Warn- und Infoboxen, Ja/Nein Bestätigungen sowie Texteingaben die von der Suite erfragt werden, erscheinen auch auf dieser App, und können entweder am Bildschirm oder auf dem Mobilgerät beantwortet werden. |
Zur Beantwortung von Eingabeaufforderungen muss die Testsuite nicht geändert werden: Warn- und Infoboxen, Ja/Nein Bestätigungen sowie Texteingaben die von der Suite erfragt werden, erscheinen auch auf dieser App, und können entweder am Bildschirm oder auf dem Mobilgerät beantwortet werden. |
||
Damit können Sie sich insbesondere in Fabrikhallen, großen Testanlagen oder Anlagen mit anderen, manuell zu bedienenden Steuerelementen vom expecco-Ausführungs-PC wegbewegen, und dennoch mit dem Testlauf bei Bedarf interagieren (insbesondere Eingaben, Kommentare oder Fotos hinzufügen). |
|||
Dies ist besonders praktisch, wenn technische Geräte, die eine manuelle Interaktion (Schalten, Ablesen oder Einstecken) erfordern, und dazu normalerweise der PC-Arbeitsplatz verlassen werden muss. |
|||
=Installation= |
|||
Mit der Remote Control App können Sie nun die den Testlauf fortsetzen, ohne den Weg zurück zum PC gehen zu müssen. |
|||
Bislang steht keine offizielle Version der App zur Verfügung, es befinden sich aber Versionen für Android und iOS in Entwicklung. Diese werden ab expecco 23.1 einsetzbar sein. Melden Sie sich gerne, wenn Sie bereits jetzt Interesse an der App haben. |
|||
<!--==Android== |
|||
Unter folgendem Link finden Sie eine die App für Android-Geräte: |
|||
[http://download.exept.de/transfer/h-expeccoRemoteApp-0.9/expeccoRemoteApp-0.9.apk expeccoRemoteApp-0.9.apk]. Sie können die Datei direkt mit Ihrem Android-Gerät herunterladen und installieren. |
|||
Beachten Sie aber, dass es sich hierbei um eine frühe Version der App handelt, die nicht signiert ist. Beim Download und der Installation werden Sie daher einige Warnungen zur Sicherheit der App bekommen, die Sie ignorieren müssen. Bei der Erstellung dieser App wurde nicht auf diese Formalitäten geachtet, da wir nicht beabsichtigen, diese für das Allgemeinpublikum über einen offiziellen App-Store zugänglich zu machen.--> |
|||
=Guide= |
|||
# Installieren Sie die expecco Remote Control App (via Google Play) auf Ihr Android Device |
|||
# starten Sie die App und verbinden sich mit einem laufenden expecco durch Eingabe des Hostnamen sowie Port. |
|||
Sie können den Port in expecco beliebig konfigurieren, falls die Voreinstellung zu Konflikten mit anderen Diensten führt. |
|||
Außerdem können Sie auf der Expecco-Seite ein Passwort vereinbaren, so dass dieses im Mobilgerät zuerst eingegeben werden muss (Pairing zu einem bestimmten Gerät). |
|||
=Verbindung zu expecco= |
|||
=Hauptansicht= |
|||
Für jedes laufende expecco, das über die App gesteuert werden soll, muss diese Funktion zuvor gestartet werden. |
|||
Die Hauptansicht liefert Ihnen einen Überblick über den gerade ausgeführten Testplan, sowie den darin gerade ausgeführten Testfall. |
|||
Aktivieren Sie den Dienst im expecco Menu unter: |
|||
"''Extras''" → "''Web-Dienste''" → "''expecco Remote Service (REST)''" → "''Start...''". |
|||
Falls "''Start...''" deaktiviert ist, läuft der Dienst bereits. |
|||
Folgend erscheint ein Dialog zum Starten des Dienstes. Legen Sie hier den Port und optional ein Kennwort für den Dienst fest. |
|||
Stellen Sie sicher, dass Ihr mobiles Gerät den expecco Remote Service erreichen kann. Dazu sollte sich das Mobilgerät im selben Netz wir der expecco-Rechner befinden. |
|||
| ⚫ | |||
Beim Starten der App werden Sie zur Eingabe der IP (des expecco Remote Services) und des Ports (welchen Sie beim Starten des Dienstes festgelegt haben) gebeten. Bei erfolgreicher Verbindung werden Sie (wenn festgelegt) nach dem Kennwort gefragt. |
|||
==Verbinden mit SSDP== |
|||
Ab expecco 23.1 besteht die Möglichkeit, dass der expecco Remote Service über SSDP seine Adresse bekannt gibt. Das müssen Sie vor dem Start des Services in den Einstellungen aktivieren: |
|||
"''Extras''" → "''Einstellungen''" → "''Kommunikation''" → "''SSDP''". |
|||
Die App kann darüber dann den Service finden und Sie sparen sich die Eingabe der Adresse. |
|||
=Funktionen der App= |
|||
==Übersicht== |
|||
Nach dem Verbinden sehen Sie eine Übersicht aller Testsuiten, die in expecco geladen sind, sowie Bausteine, die ohne Testsuite ausgeführt wurden oder werden. Zu jedem Eintrag sehen sie den aktuellen Status. Falls ein Test auf eine Benutzereingabe wartet, erkennen Sie das an einem entsprechenden Icon. |
|||
Aus dieser Liste können Sie einen Eintrag auswählen, um genauere Informationen zu den Testschritten zu bekommen oder um mit dem Test zu interagieren. |
|||
==Testplan-Ansicht== |
|||
Haben Sie einen Testplan (oder Einzelbaustein) ausgewählt, sehen Sie eine Auflistung seiner Testschritte und deren Status. |
|||
===Dialoge zur Benutzereingabe=== |
|||
Hat der Test gerade einen Dialog oder Manual Test geöffnet, wird dieses Fenster in der App abgebildet. Sie können damit interagieren indem Sie Eingaben machen und Buttons drücken, was dann an expecco weitergeleitet und dort übernommen wird. |
|||
| ⚫ | |||
Ein Klick auf Pause suspendiert den Lauf. Mit Run wird die Ausführung fortgesetzt. |
Ein Klick auf Pause suspendiert den Lauf. Mit Run wird die Ausführung fortgesetzt. |
||
Durch klick auf Stopp kann er abgebrochen werden. |
Durch klick auf Stopp kann er abgebrochen werden. |
||
=Anhänge und Kommentare= |
===Anhänge und Kommentare=== |
||
Sie können während dem Lauf ein Photo machen, und dieses als Anhang (Logeintrag) im Resultat ablegen. |
Sie können während dem Lauf ein Photo machen, und dieses als Anhang (Logeintrag) im Resultat ablegen. |
||
Ebenso können Sie Kommentare eingegeben, die als Textanhang abgelegt werden. |
|||
= Warnung zur Sicherheit = |
|||
Bitte beachten Sie, dass die Mobile Remote App nur in einem gesicherten, und von außen nicht erreichbaren Rechnernetz eingesetzt werden darf, da wir aktuell keine Sicherheitsmaßnahmen (weder in der Authentifizierung, noch in der Übertragung) eingebaut haben. Das Password wird als lesbarer Plaintext übertragen (es sei denn, sie nutzen eine HTTPS-Verbindung), und dient lediglich dazu, allzu witzige Kollegen von Störungen abzuhalten. Nutzen Sie kein anderweitig genutztes Passwort. Das selbe gilt für Passworte, die in den Test abgefragt werden. |
|||
Auf keinen Fall sollten sie den Remote-Client auf einem expecco-PC aktivieren, welcher von nicht vertrauenswerten Rechnern erreicht werden kann (was Sie so-oder-so nicht tun sollten). |
|||
Version vom 16. Mai 2023, 15:39 Uhr
Inhaltsverzeichnis
Einführung[Bearbeiten]
Die expecco Remote Control App dient zur Verfolgung und Interaktion mit einer laufenden Testsuite auf einem Mobilgerät (Telefon oder Tablet). Sie kann sich zu einem laufenden expecco verbinden und listet dann die vorhandenen Testpläne sowie deren Status (Passed/Failed) auf. Außerdem ist die Fernsteuerung (Stopp/Pause/Run) des Testlaufs, sowie das Beantworten von Eingabeaufforderungen möglich.
Zur Beantwortung von Eingabeaufforderungen muss die Testsuite nicht geändert werden: Warn- und Infoboxen, Ja/Nein Bestätigungen sowie Texteingaben die von der Suite erfragt werden, erscheinen auch auf dieser App, und können entweder am Bildschirm oder auf dem Mobilgerät beantwortet werden.
Damit können Sie sich insbesondere in Fabrikhallen, großen Testanlagen oder Anlagen mit anderen, manuell zu bedienenden Steuerelementen vom expecco-Ausführungs-PC wegbewegen, und dennoch mit dem Testlauf bei Bedarf interagieren (insbesondere Eingaben, Kommentare oder Fotos hinzufügen).
Installation[Bearbeiten]
Bislang steht keine offizielle Version der App zur Verfügung, es befinden sich aber Versionen für Android und iOS in Entwicklung. Diese werden ab expecco 23.1 einsetzbar sein. Melden Sie sich gerne, wenn Sie bereits jetzt Interesse an der App haben.
Verbindung zu expecco[Bearbeiten]
Für jedes laufende expecco, das über die App gesteuert werden soll, muss diese Funktion zuvor gestartet werden. Aktivieren Sie den Dienst im expecco Menu unter:
"Extras" → "Web-Dienste" → "expecco Remote Service (REST)" → "Start...".
Falls "Start..." deaktiviert ist, läuft der Dienst bereits. Folgend erscheint ein Dialog zum Starten des Dienstes. Legen Sie hier den Port und optional ein Kennwort für den Dienst fest.
Stellen Sie sicher, dass Ihr mobiles Gerät den expecco Remote Service erreichen kann. Dazu sollte sich das Mobilgerät im selben Netz wir der expecco-Rechner befinden.
Beim Starten der App werden Sie zur Eingabe der IP (des expecco Remote Services) und des Ports (welchen Sie beim Starten des Dienstes festgelegt haben) gebeten. Bei erfolgreicher Verbindung werden Sie (wenn festgelegt) nach dem Kennwort gefragt.
Verbinden mit SSDP[Bearbeiten]
Ab expecco 23.1 besteht die Möglichkeit, dass der expecco Remote Service über SSDP seine Adresse bekannt gibt. Das müssen Sie vor dem Start des Services in den Einstellungen aktivieren:
"Extras" → "Einstellungen" → "Kommunikation" → "SSDP".
Die App kann darüber dann den Service finden und Sie sparen sich die Eingabe der Adresse.
Funktionen der App[Bearbeiten]
Übersicht[Bearbeiten]
Nach dem Verbinden sehen Sie eine Übersicht aller Testsuiten, die in expecco geladen sind, sowie Bausteine, die ohne Testsuite ausgeführt wurden oder werden. Zu jedem Eintrag sehen sie den aktuellen Status. Falls ein Test auf eine Benutzereingabe wartet, erkennen Sie das an einem entsprechenden Icon.
Aus dieser Liste können Sie einen Eintrag auswählen, um genauere Informationen zu den Testschritten zu bekommen oder um mit dem Test zu interagieren.
Testplan-Ansicht[Bearbeiten]
Haben Sie einen Testplan (oder Einzelbaustein) ausgewählt, sehen Sie eine Auflistung seiner Testschritte und deren Status.
Dialoge zur Benutzereingabe[Bearbeiten]
Hat der Test gerade einen Dialog oder Manual Test geöffnet, wird dieses Fenster in der App abgebildet. Sie können damit interagieren indem Sie Eingaben machen und Buttons drücken, was dann an expecco weitergeleitet und dort übernommen wird.
Start/Stopp/Pause[Bearbeiten]
Ein Klick auf Pause suspendiert den Lauf. Mit Run wird die Ausführung fortgesetzt. Durch klick auf Stopp kann er abgebrochen werden.
Anhänge und Kommentare[Bearbeiten]
Sie können während dem Lauf ein Photo machen, und dieses als Anhang (Logeintrag) im Resultat ablegen. Ebenso können Sie Kommentare eingegeben, die als Textanhang abgelegt werden.
Warnung zur Sicherheit[Bearbeiten]
Bitte beachten Sie, dass die Mobile Remote App nur in einem gesicherten, und von außen nicht erreichbaren Rechnernetz eingesetzt werden darf, da wir aktuell keine Sicherheitsmaßnahmen (weder in der Authentifizierung, noch in der Übertragung) eingebaut haben. Das Password wird als lesbarer Plaintext übertragen (es sei denn, sie nutzen eine HTTPS-Verbindung), und dient lediglich dazu, allzu witzige Kollegen von Störungen abzuhalten. Nutzen Sie kein anderweitig genutztes Passwort. Das selbe gilt für Passworte, die in den Test abgefragt werden.
Auf keinen Fall sollten sie den Remote-Client auf einem expecco-PC aktivieren, welcher von nicht vertrauenswerten Rechnern erreicht werden kann (was Sie so-oder-so nicht tun sollten).
