Appian Selenium API

Overview

The library contains methods which allow you to interact with Appian components in a browser. It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Appian Selenium API contains the methods that are at the core of both Cucumber for Appian and FitNesse for Appian. If you are familiar with either Appian’s FitNesse or Cucumber tools then you are already familiar with the methods provided by the Appian Selenium API. For example, the table below shows the corresponding FitNesse and Cucumber methods for the same underlying Appian Selenium API method.

Appian Selenium API

loginWithUsernameAndPassword(jString userName, String password)

FitNesse for Appian

| login with username | USERNAME | and password | PASSWORD |

Cucumber for Appian

Given I login with username "USERNAME" and password "PASSWORD"

Note: Java 11 required for plugin version 23.4

Key Features & Functionality

The Appian Selenium API plug-in package includes:

  • The Appian Selenium API jar
  • Javadocs
  • An example of how to use the API in a Java application
  • An example of how to use the API in a Cucumber test 

The Appian Selenium API plug-in supports both Chrome and Firefox browsers. See the Appian Playbook for more information: Automated Testing with Appian Selenium API

Note on Appian Versions:

With each Appian release, a new version of the plug-in is also released to support the latest Appian components. This plug-in is backwards compatible, ensuring that you do not need to update your test cases when upgrading to new Appian versions.

Anonymous
  • v24.2.0 Release Notes
    • 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.
  • Appian support team, Our team using Appian version of 22.4 and all our Automation scripts are working with Appian Selenium API v23.1 

    Currently we have upgraded the platform to 24.1. all the automation scripts are failing
    We have downloaded Appian Selenium API release V24.1 as well and still we are facing scripts failure
    Please let us know if we need to upgrade Java version / JVM or any other supporting version to be added to the jar file. 
  • v24.1.1 Release Notes
    • Bug Fixes
    • Reverted change to cards that changed indexes to certain elements

  • v24.1.1 Release Notes
    • Bug Fixes
    • Reverted change to cards that changed indexes to certain elements

  • v24.1 Release Notes
    • 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

  • some of the Appian feature not covered predefine method , so this time we are forced to customize some script in both Appian selenium and API as well 
    ex  

    dr.findelement(locatortype(locator)).click()

    Thanks 

  • some of the Appian feature not covered predefine method , so this time we are forced to customize some script in both Appian selenium and API as well 
    ex  

    dr.findelement(locatortype(locator)).click()

    Thanks 

  • How to click on StampField link? Thanks.

  • v23.4.1 Release Notes
    • Bug Fixes
    • Backport support for Date Range user filter

  • v23.4 Release Notes
    • 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