2022 June Release

Configuring Fabasoft app.testPermanent link for this heading

To be able to use Fabasoft app.test the following configuration settings are necessary.

EclipsePermanent link for this heading

  • Switch to the “Fabasoft app.test” perspective such that an optimized view is provided.
  • By default, the instruction pointer is visualized by a green shading. When recording a test executed lines are shaded green (OK) or red (NOK). Unfortunately, the instruction pointer will overlay this information.
    In the Eclipse preferences navigate to “General” > “Editors” > “Text editors” > “Annotations” > “Debug Current Instruction Pointer” and select “Box” in the Text as field. This way the instruction pointer will be a transparent rectangle.
  • By default, the often used “Run to Line” button is not displayed in the debug symbol bar. To add this button, open the “Window” menu, point to “Perspective” and click “Customize Perspective”. Expand the “Debug” entry and mark “Run to Line”.

Web BrowsersPermanent link for this heading

Depending on the web browsers that should be used for testing, additional configuration steps have to be carried out.

Google Chrome and Microsoft Edge

If a version of Google Chrome or Microsoft Edge is tested that was not available at the time of the release of Fabasoft  app.test a corresponding web driver binary can be downloaded automatically.

For more information see chapter “Downloading chromedriver and msedgedriver”.

Mozilla Firefox

When recording or running tests, the Fabasoft Folio Client Extension and Fabasoft Cloud Client Extension will only work if they are installed in the standard extension folder. If they are already added to the user profile remove them.

Download the extensions from your test domain. Do not use Mozilla Firefox for downloading because it will try to add the extension to the web browser but you need the file.

  • https://<webserver>/<vdir>/fscasp/content/lib/CloudFirefoxExtension.xpi
  • https://<webserver>/<vdir>/fscasp/content/lib/FolioFirefoxExtension.xpi

To add the extensions, proceed as follows:

  1. Rename the files (otherwise the extensions will not be loaded) and copy them to the standard extension folder as described above:
    • CloudFirefoxExtension.xpi to nmextmozpu@fabasoft.com.xpi
    • FolioFirefoxExtension.xpi to nmextmozpm21@fabasoft.com.xpi (whereby 21 corresponds to the version 2021 of the domain; if a different version is used, name it accordingly)
  2. Copy the renamed XPI files to the following folder (by default the folder must be created):
    Microsoft Windows: C:\Program Files\Mozilla Firefox\browser\extensions
    Linux: /usr/share/mozilla/extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}/
    Apple macOS: /Library/Application Support/Mozilla/Extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}/
  3. Launch Mozilla Firefox and approve the installation of the extension.

Apple Safari

  • Add apptest.webbrowserlaunch_<version>/jsadaptor/certs/apptestlocal.pem of the Eclipse plug-in installation directory to the keychain. Select “Always Trust” for this certificate.
  • Notification popups must be disabled for the automated server.
  • When connecting the first time with Fabasoft app.test, Fabasoft app.test requests the permission to control Apple Safari. This has to be confirmed.
  • If you want that the Tab key highlights each item on a page in Apple Safari (not only text input fields), you need to enable the following option within Apple Safari:
    “Safari” > “Preferences” > “Advanced” > “Press tab to highlight each item on a page”
    Note: This is default for all other web browsers. Safari needs this setting to behave like the others.

All Web Browsers

  • Add apptest.webbrowserlaunch_<version>/jsadaptor/certs/apptestca.pem of the Eclipse plug-in installation directory to the trusted root certification authorities.
    Google Chrome, Microsoft Edge and Apple Safari use the operating system’s certificate store whereas Mozilla Firefox provides its own store.
    When using Apple macOS add the certificate to the keychain (select “Always Trust” for the certificate).
  • The address must be reachable from the web browser and therefore must not be routed through the proxy. Fabasoft app.test uses the system proxy settings when not explicitly configured otherwise.

Apple macOS AccessibilityPermanent link for this heading

In order that app.test can fully interact with Apple macOS Accessibility make sure that the following programs are added to "System Preferences" > "Security & Privacy" > "Accessibility" and "System Preferences" > "Security & Privacy" > "Screen Recording".

  • Fabasoft app.test Agent
  • /Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home/bin/java
    Respectively, the used Java might be in a different directory depending on your system.
    Note: This can be done by drag and drop from the Finder into the right side of the dialog.
  • /bin/sh

Client RegistryPermanent link for this heading

When testing the Fabasoft Cloud the Fabasoft Cloud Client keeps the user logged in, even if the web browser is closed. This feature is annoying when recording tests because when trying something out you often do not reach the logout statement. You can disable this feature by adding following key to the registry and restarting the Fabasoft Cloud Client:

Windows Registry Editor Version 5.00

When working with Linux or Apple macOS a file named FSCPORTAL@1.1001:cfgauthexplicit with content True must be created here: