UtilityFree

FitNesse for Appian

by Appian Corporation

Description

FitNesse for Appian is a client-side tool that makes it easy to create automated tests on the Appian platform. Create test scripts that will run Appian as if a user was clicking through the application and filling out data. FitNesse for Appian includes easy instructions to get you started.

*Note:* Java 11 required for plugin version 23.4

Features

With FitNesse for Appian, you can: > Write easy-to-read wiki language tests for Appian applications > Speed up testing times > Set up reusable regression tests

Reusable scripts can be written to: > Create new packages > Move them to different stages in the workflow > Check that forms are being populated correctly

Release notes

IMPORTANT UPDATE: FitNesse for Appian is now available as an open-source repository! The repository can be found on Gitlab under "appian-oss/appian-selenium-api": https://gitlab.com/appian-oss/appian-selenium-api/

Users of the libraries will find a few key benefits from this change:

  • Ability to contribute to the libraries
  • Immediate access to bug fixes and new functionality
  • Improved communication between other users and library maintainers by leveraging Gitlab issues.

Updates to the framework will be immediately available in the open source package registry. Users are encouraged to leverage this instead of the App Market as we do not plan to update the App Market listing for every patch.

Version history (41)

25.1

v25.1

  • Enhancements
  • Added support for defining and using custom locales
  • Use create appian locale | PATH TO File. This method must be called AFTER setting the version!
  • File must be JSON file with the format
  • { "dateFormats": [ { "label": "dateFormat", "value": <FORMAT_STRING> }, { "label": "dateDisplayFormat", "value": <FORMAT_STRING> }, { "label": "timeFormat", "value": <FORMAT_STRING> }, { "label": "timeDisplayFormat", "value": <FORMAT_STRING> }, { "label": "datetimeFormat", "value": <FORMAT_STRING> }, { "label": "datetimeDisplayFormat","value": <FORMAT_STRING> } ], "labels": [ { "label": "acceptButton", "value": "Accept" } ], "locale": <LOCALE_CODE> }
  • Bug Fixes
  • Fixed clickOnRecordRelatedAction to function correctly when the Record Summary page contains more than three action items.

24.4.0

v24.4

  • None

24.3.0

v24.3

  • Enhancements
  • Added built-in retry to click operation in case of element not interactable exception
  • Updated the milestone locator

24.2.0

v24.2

  • Enhancements
  • Update locator for site menu links
  • Created method which supports clicking on text within an interface.
  • This is particularly useful for nested cards such as tab layouts, but can also be used as a fallback when existing methods do not work.
  • This method is available for all Appian versions.
  • Click operation on Card layout will be performed on the left side of the element instead of the right. We are not expecting any impact on existing test cases.

24.1.1

v24.1.1

  • Bug Fixes
  • Reverted change to cards that changed indexes to certain elements

24.1.1

v24.1.1

  • Bug Fixes
  • Reverted change to cards that changed indexes to certain elements

v24.1

  • Enhancements
  • Supports Appian version 24.1
  • Adds support for collapsing/opening sidebars
  • ClickOnCard updated to support clicking on cards with complex content. For example, the method can now click on cards that has a component nested in multiple layouts within the card

24.1

v24.1

  • Enhancements
  • Supports Appian version 24.1
  • Adds support for collapsing/opening sidebars
  • ClickOnCard updated to support clicking on cards with complex content. For example, the method can now click on cards that has a component nested in multiple layouts within the card

24.1

v24.1

  • Enhancements
  • Supports Appian version 24.1
  • Adds support for collapsing/opening sidebars
  • ClickOnCard updated to support clicking on cards with complex content. For example, the method can now click on cards that has a component nested in multiple layouts within the card

23.4.1

v23.4.1

  • Bug Fixes
  • Backport support for Date Range user filter

23.4

v23.4

  • Project updated to require Java 11 JRE
  • Bug Fixes
  • Honor the download directory given in custom.properties for RemoteDrivers
  • Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
  • Fixed Populate Record Type Date Range User Filter method
  • Enhancements
  • Add support for the Side navigation menu in sites
  • Add support for downloading charts
  • Add support for buttons configured with custom colors

23.3.1

  • Add support for Date Range user filters in Record Types

23.3.1

  • Update checkboxes to support CARD style for 23.3 and later Appian versions

23.3

v23.3

  • Enhancements
  • Supports Appian version 23.3
  • Added functionality to interact with new site group headers
  • Updated to Selenium 4.11.0

23.3

v23.3

  • Enhancements
  • Supports Appian version 23.3
  • Added functionality to interact with new site group headers
  • Updated to Selenium 4.11.0

23.2.1

v23.2.1

  • Bug Fixes
  • Update pickers to recognize selections with links (e.g. Record Pickers)

23.2.1

v23.2.1

  • Bug Fixes
  • Update pickers to recognize selections with links (e.g. Record Pickers)

23.2

  • Enhancements
  • Supports Appian version 23.2

23.1.2

  • Bug Fixes
  • Fixes an issue in FitNesse where VerifyText did not work on a multi-node component
  • Fixes an issue where Dropdowns with Search were not working

23.1.2

  • Bug Fixes
  • Fixes an issue in FitNesse where VerifyText did not work on a multi-node component
  • Fixes an issue where Dropdowns with Search were not working

23.1.1

  • Enhancements
  • Removed bundled browser drivers
  • Correct version will automatically be downloaded at runtime
  • Specific versions can be downloaded from https://sites.google.com/chromium.org/driver/downloads or https://github.com/mozilla/geckodriver/releases
  • Added support for Selenium 4.8.2 which solves https://github.com/SeleniumHQ/selenium/issues/11750

23.1.0

  • Enhancements
  • Supports Appian version 23.1
  • Updated locator for Dropdown class
  • Bug Fixes
  • Update CVEs
  • Update scripts (start.bat, start-mac.sh, start-unix.sh, runFitNesseTest.sh) to reference the new fitnesse-20221219-standalone.jar

22.4

  • Fix Automated Testing - 22.4.zip
  • Update Chromedriver to v107
  • Add support for Appian 22.4

22.4

  • Update Chromedriver to v107
  • Add support for Appian 22.4

22.3.1

  • Update Chromedriver to v104
  • Bug Fixes
  • Fix TempoRecordTypeUserFilter's clear method to work for newer versions of Chrome

22.3

  • Enhancements
  • Supports Appian version 22.3 (Remove support for 20.3)

22.2.1

Fix usages of deprecated WebDriverWait constructor

22.2

  • Enhancements
  • Supports Appian version 22.2
  • Bug Fixes
  • Fix GridContents failures related to HTML updates in 22.2

22.1.2

Added index based selection support to click on button function.

22.1.1

Supports Selenium 4 version 4.1.2

22.1

v22.1

  • Enhancements
  • Supports Appian version 22.1

21.4.4

Address Log4J CVE: Update Log4J to version 2.17.1

21.4.3

v21.4.3

  • Bug Fixes
  • Address Log4J CVE: Update Log4J to version 2.17.0

v21.4.2

  • Bug Fixes
  • Address Log4J CVE: Update Log4J to version 2.16.0
  • Fix getGridContents when header cells do not have accessibility class

21.4.1

  • Bug Fixes
  • Address Log4J CVE: Update Log4J to version 2.15.0

21.4.1

  • Bug Fixes
  • Address Log4J CVE: Update Log4J to version 2.15.0

21.4

v21.4

  • Enhancements
  • Support new card choice components
  • Bug Fixes
  • Update CVEs
  • Update scripts (start.bat, start-mac.sh, start-unix.sh, runFitNesseTest.sh) to reference the new fitnesse-20211030-standalone.jar

21.4

  • Enhancements
  • Support new card choice components
  • Bug Fixes
  • Update CVEs

21.3

  • Bug Fixes
  • Fix bug for radio button card
  • Fix bug for date picker

21.2

  • Enhancements
  • Support new SectionLayout
  • Upgrade Selenium Server to 3.141.59
  • Bug Fixes
  • Fix bug for radio button card
  • Fix bug for icon link alt text

21.1

  • Bug Fixes
  • Fix bug for radio button card
  • Fix bug for icon link alt text

19.1.1

v19.1.1

  • Bug fixes
  • Fixed error popup caused by Chrome loading automation extension

18.4.4

nt

  • Updated test app for 18.2
  • Bug fixes
  • User pickers not selecting correct field value
  • Card click no working in Firefox

v18.2

  • Enhancements
  • Added support for 18.2
  • NEW METHOD: click on card
  • Updated select grid method to account for the row highlight selection style
  • Added test app for 18.2
  • Bug fixes
  • Fixed fragility of file upload

v18.1.4

  • Enhancements
  • Added Support for finding grid indices
  • Added the ability to delete documents downloaded by Fitnesse

v18.1.3

  • Bug fixes
  • Updated mac and linux scripts shebang to /bin/sh

v18.1.2

  • Bug fixes
  • Fixed Windows start script to run FitNesse successfully
  • Fixed the example page and default fixture to use TempoFixture instead of SitesFixture

v18.1.1

  • Enhancements
  • Updated 16.3 Test Zip
  • Bug fixes
  • Fixed issue with navigating to /logout URL
  • Fixed Multiselect dropdown on 16.3
  • Fixed Record filter clearing on 16.3

v18.1

  • Enhancements
  • Added support for 18.1
  • Added test app for 17.3 and 18.1

v17.4.1

  • Enhancements
  • Add ability to accept Tasks
  • Add ability to populate Record Type user filter
  • Add ability to download files
  • Make LinkField capturable
  • Added advanced functionality to adjust dates, including setting dates in the past
  • If url contains "/suite", remove anything after it to prevent navigation failure.
  • Bug fixes
  • Updated chromedriver to version 2.33
  • Updated startup scripts to pass FitNesseRoot properly
  • Always logout before login in case a previous test failed and didn't logout
  • Made Firefox webdrivers executable
  • Fix BarcodeField not working in 17.1+

v17.4

  • Enhancements
  • Change FitNesse usernames
  • Allow FitNesse tests to hit an arbitrary endpoint through an environment variable
  • Bug fixes
  • Mac Firefox date and dateTime field tests no longer throw an null character
  • Dropdown tests does not read duplicate values

Note: For previous releases, see attachment below.