Expecco Remote Control APP/en: Unterschied zwischen den Versionen
Matilk (Diskussion | Beiträge) (update and merge with other page) |
Alkurz (Diskussion | Beiträge) |
||
| Zeile 2: | Zeile 2: | ||
=Introduction= |
=Introduction= |
||
''expecco Remote'' is used to track and interact with a running test suite via a mobile device or browser. |
|||
It can connect to a running expecco and then shows a list of testplans as well as their state (passed/failed). |
|||
Furthermore, it supports remote control (stop/pause/run) of the test as well as responding to prompts. |
|||
''expecco Remote'' can connect to a running expecco and lists the existing test plans and their status (Passed/Failed). It is also possible to remotely control (stop / pause / start) the test run and answer prompts. |
|||
Your testsuite does not need to be modified in any way. The remote control operates transparently. |
|||
Warning- and info dialogs, Yes/No confirmations and Text input as requested by expecco |
|||
are shown in the app and can be answered either on your PC's screen (as usual) or on the mobile device. |
|||
To answer prompts, the test-suite does not need to be changed: Warning and info boxes, yes/no confirmations as well as text inputs requested by the suite also appear in ''expecco Remote'' and can be answered either on screen or on the mobile device. |
|||
This is especially useful on the factory floor, with large test machinery or with machines where additional manual interaction is required: you can move away from your expecco-PC and still interact with the testrun as required (especially answer input requests, enter comments or photos). |
|||
This allows you to move away from the expecco execution PC, especially on factory floors, large test facilities or facilities with other manually operated controls, and still interact with the test run as needed (especially adding inputs, comments or photos). |
|||
=Installation= |
|||
| ⚫ | |||
=Browser and Mobile App= |
|||
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. |
|||
''expecco Remote'' is available as an app and as a browser app. |
|||
| ⚫ | |||
Any expecco which is to be remote controllable has to have a running service client. Activate the service via the expecco menu under: |
|||
| ⚫ | |||
If the "''Start...''" item is disabled, the service is already running. Otherwise, a dialog appears, asking for a port number and an optional password for the connection. |
|||
| ⚫ | |||
Please make sure, that you mobile device can reach the PC on which expecco is running (both should be inside the same network and/or any router or firewall should open the given port number). |
|||
<!--==Android== |
|||
You can find the app for Android devices at the following link: |
|||
[http://download.exept.de/transfer/h-expeccoRemoteApp-0.9/expeccoRemoteApp-0.9.apk expeccoRemoteApp-0.9.apk]. You can download and install the file directly with your Android device. |
|||
Note, however, that this is an early version of the app that is not signed. When downloading and installing, you will therefore get some warnings about the security of the app, which you must ignore. No attention has been paid to these formalities in the creation of this app, as we do not intend to make it available to the general public via an official app store.--> |
|||
After start of the App (on the mobile), you are asked for the port number and possibly for the password. |
|||
| ⚫ | |||
Any arbitrary port can be used, in case the default port conflicts with other services of your infrastructure. |
|||
To be able to control expecco via ''expecco Remote'', the ''Expecco Remote Control & Monitoring Service (REST)'' (expecco Remote Control Service) must be started beforehand. |
|||
In addition, a password may be entered on the expecco side, which needs to be confirmed on the mobile device (to control/restrict access). |
|||
Activate the service in the expecco menu under: |
|||
| ⚫ | |||
If "''Start...''" is deactivated, the service is already running. |
|||
A dialog for starting the service appears. |
|||
| ⚫ | |||
[[Image:ExpeccoRemoteControlAndMonitoringService_en.png|framed|center|Remote Control and Monitoring Service (REST)]] |
|||
| ⚫ | |||
Set a port and optionally a password for the service here. |
|||
Checking "Open browser on web service" opens the local browser with the web application of ''expecco Remote'' by starting the service. |
|||
Make sure that your remote (mobile) device can reach the ''expecco Remote Control Service''. It should be in the same network as the expecco computer. |
|||
When starting "expecco Remote", you will be asked to enter the IP address of the "expecco Remote Control Service" and the port you specified when starting the service. If the connection is successful, you will be asked for the password (if set). |
|||
[[Image:ExpeccoRemoteWeb_connect_en.png|framed|center|expecco Remote: login]] |
|||
| ⚫ | |||
| ⚫ | |||
"''Extras''" → "''Settings''" → "''Communication''" → "''SSDP''". |
"''Extras''" → "''Settings''" → "''Communication''" → "''SSDP''". |
||
The app can find the service |
The app can then find the service via this and you save entering the address.--> |
||
=Functions of the app= |
|||
=App Functionality= |
|||
==Overview== |
==Overview== |
||
After connecting, you will see an overview of all |
After connecting, you will see an overview of all test-suites that are loaded in expecco. For each test-suite the current status is displayed. If a test is waiting for user input, you will recognise this by a corresponding icon. |
||
[[Image:ExpeccoRemoteWeb_testplans_en.png|framed|center|expecco Remote: Test Plans]] |
|||
| ⚫ | |||
==Test plan view== |
|||
| ⚫ | |||
| ⚫ | |||
[[Image:ExpeccoRemoteWeb_testplan_explained_en.png|framed|center|expecco Remote: Test Plan View]] |
|||
===Start / Stop / Pause=== |
|||
==Testsuite View== |
|||
The buttons for start, stop and pause allow you to start or continue, stop and pause the execution of a test plan. |
|||
| ⚫ | |||
=== |
===Attachments and comments=== |
||
You can enter comments during a test run, which are stored as text attachments. |
|||
| ⚫ | |||
In the mobile application, you can also take photos and save them as an attachment (log entry) in the result. |
|||
=== |
===Dialogs for user input=== |
||
| ⚫ | |||
To suspend a running test, click on "Pause"; to resume, click on "Run". |
|||
The "Stop"-button aborts the test. |
|||
[[Image:ExpeccoRemoteWeb_action_en.png|framed|center|expecco Remote: input dialog]] |
|||
===Attachments and Comments=== |
|||
You can take pictures or enter comments at any time during the test execution. |
|||
Those will be recorded as file attachments (text- or image attachment) to the test result. |
|||
=Security |
= Security warning = |
||
Please note that |
Please note that ''expecco Remote'' may only be used in a secure computer network that cannot be accessed from the outside, as we currently have no security measures built in, neither for authentication nor for transmission. The (optional) password is transmitted as readable plain text (unless you use an HTTPS connection), and is only used to keep overly witty colleagues from interfering. Do not use a password that is used elsewhere. The same applies to passwords that are requested in the tests. |
||
Under no circumstances should you |
Under no circumstances should you activate the remote client on an expecco PC that can be reached by untrusted computers (which you should not do either way). |
||
The intention of the app is to allow the tester to leave the expecco PC and operate/manipulate/configure the system under test and at the same time interact with the expecco dialogs. Especially for machine halls with long distances. |
|||
The app is NOT intended to start, stop or otherwise configure tests. Use the ALM interface (Aidymo) for this, which both takes care of synchronisation (i.e. prevents conflicts when multiple users enter) and already provides security through the web interface (usually with an SSL connection and protection through a firewall). |
|||
Version vom 13. Juni 2023, 15:14 Uhr
Inhaltsverzeichnis
Introduction[Bearbeiten]
expecco Remote is used to track and interact with a running test suite via a mobile device or browser.
expecco Remote can connect to a running expecco and lists the existing test plans and their status (Passed/Failed). It is also possible to remotely control (stop / pause / start) the test run and answer prompts.
To answer prompts, the test-suite does not need to be changed: Warning and info boxes, yes/no confirmations as well as text inputs requested by the suite also appear in expecco Remote and can be answered either on screen or on the mobile device.
This allows you to move away from the expecco execution PC, especially on factory floors, large test facilities or facilities with other manually operated controls, and still interact with the test run as needed (especially adding inputs, comments or photos).
Browser and Mobile App[Bearbeiten]
expecco Remote is available as an app and as a browser app.
The browser version is delivered as standard with expecco from version 23.1. The apps for Android and iOS are still under development. Please contact us if you are interested in the app.
Connection to expecco[Bearbeiten]
To be able to control expecco via expecco Remote, the Expecco Remote Control & Monitoring Service (REST) (expecco Remote Control Service) must be started beforehand. Activate the service in the expecco menu under:
Extras → "Webservices" → "Expecco Remote Control & Monitoring Service (REST)" → "Start...".
If "Start..." is deactivated, the service is already running.
A dialog for starting the service appears.
Set a port and optionally a password for the service here. Checking "Open browser on web service" opens the local browser with the web application of expecco Remote by starting the service.
Make sure that your remote (mobile) device can reach the expecco Remote Control Service. It should be in the same network as the expecco computer.
When starting "expecco Remote", you will be asked to enter the IP address of the "expecco Remote Control Service" and the port you specified when starting the service. If the connection is successful, you will be asked for the password (if set).
Functions of the app[Bearbeiten]
Overview[Bearbeiten]
After connecting, you will see an overview of all test-suites that are loaded in expecco. For each test-suite the current status is displayed. If a test is waiting for user input, you will recognise this by a corresponding icon.
From this list you can select a test plan to get more detailed information about the test steps or to interact with the test.
Test plan view[Bearbeiten]
Once you have selected a test plan, you will see a list of its test steps and their status.
Start / Stop / Pause[Bearbeiten]
The buttons for start, stop and pause allow you to start or continue, stop and pause the execution of a test plan.
Attachments and comments[Bearbeiten]
You can enter comments during a test run, which are stored as text attachments. In the mobile application, you can also take photos and save them as an attachment (log entry) in the result.
Dialogs for user input[Bearbeiten]
If the test has just opened a dialog or Manual Test Wizard, this window is displayed in the app. You can interact with it by making the necessary entries and pressing buttons. These entries are then forwarded to expecco and taken over there.
Security warning[Bearbeiten]
Please note that expecco Remote may only be used in a secure computer network that cannot be accessed from the outside, as we currently have no security measures built in, neither for authentication nor for transmission. The (optional) password is transmitted as readable plain text (unless you use an HTTPS connection), and is only used to keep overly witty colleagues from interfering. Do not use a password that is used elsewhere. The same applies to passwords that are requested in the tests.
Under no circumstances should you activate the remote client on an expecco PC that can be reached by untrusted computers (which you should not do either way).
The intention of the app is to allow the tester to leave the expecco PC and operate/manipulate/configure the system under test and at the same time interact with the expecco dialogs. Especially for machine halls with long distances.
The app is NOT intended to start, stop or otherwise configure tests. Use the ALM interface (Aidymo) for this, which both takes care of synchronisation (i.e. prevents conflicts when multiple users enter) and already provides security through the web interface (usually with an SSL connection and protection through a firewall).
