Automated Testing with Appian Selenium API

joel.larin — Tue, 10 Jun 2025 23:23:25 GMT

Current Revision posted to Guide by joel.larin on 6/10/2025 11:23:25 PM

Please be advised that this package has moved to a new open-source repository, as future updates on the App Market will be discontinued. We encourage all users to switch to the new repository to gain the ability to contribute, receive immediate access to bug fixes and new functionality, and improve communication with other users and maintainers via GitLab issues.

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers
If using Chrome, we recommend using Chrome For Testing for a more consistent testing experience.
An IDE, such as IntelliJ IDEA or Eclipse

Setup

The Appian Selenium API plug-in is a Java library which allows you to write automated tests for your Appian UIs. It contains methods which allow you to interact with Appian components in a browser. It provides methods and fixtures to interact with Appian applications in its various environments, e.g. Tempo or Sites. When writing tests, be sure to use methods from the correct fixture for the environment under test, e.g. use SitesFixture where possible to test Sites. Methods defined in fixtures that are intended for different environments are not guaranteed to work in future versions of the plugin.

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Appian Selenium API contains the underlying Selenium methods used by Cucumber for Appian and FitNesse for Appian, but offers you more flexibility by allowing you to define your own automated test cases. You can create your own Cucumber Step Definitions, your own testNG test, or the Java Framework of your choosing. You are no longer tied to Cucumber for Appian or FitNesse for Appian yet you get the same ease and simplicity of those respective frameworks.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

March 2025 - Release 25.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.

August 2024 - Release 24.3

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

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

Appian Max Team — Wed, 05 Mar 2025 20:51:00 GMT

Revision 34 posted to Guide by Appian Max Team on 3/5/2025 8:51:00 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers
If using Chrome, we recommend using Chrome For Testing for a more consistent testing experience.
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

March 2025 - Release 25.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.

August 2024 - Release 24.3

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

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

Appian Max Team — Wed, 05 Mar 2025 20:48:14 GMT

Revision 33 posted to Guide by Appian Max Team on 3/5/2025 8:48:14 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers
If using Chrome, we recommend using Chrome For Testing for a more consistent testing experience.
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

March 2025 - Release 25.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> }

August 2024 - Release 24.3

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

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Tue, 03 Sep 2024 15:29:20 GMT

Revision 32 posted to Guide by joel.larin on 9/3/2024 3:29:20 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers
If using Chrome, we recommend using Chrome For Testing for a more consistent testing experience.
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

August 2024 - Release 24.3

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

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:12:26 GMT

Revision 31 posted to Guide by joel.larin on 7/1/2024 5:12:26 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers
If using Chrome, we recommend using Chrome For Testing for a more consistent testing experience.
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:11:19 GMT

Revision 30 posted to Guide by joel.larin on 7/1/2024 5:11:19 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers
If using Chrome, we recommend using Chrome For Testing for a more consistent testing experience.
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:10:23 GMT

Revision 29 posted to Guide by joel.larin on 7/1/2024 5:10:23 PM

Requirements

Appian 22.2 and above.
Java Runtime Environment 11.
Chrome or Firefox browsers.
If using Chrome, we recommend using Chrome For Testing for a more consistent testing experience.
An IDE, such as IntelliJ IDEA or Eclipse.

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:08:03 GMT

Revision 28 posted to Guide by joel.larin on 7/1/2024 5:08:03 PM

Requirements

Appian 22.2 and above.
Java Runtime Environment 11.
Chrome or Firefox browsers. If using Chrome, we recommend also using Chrome For Testing for a more consistent testing experience.
An IDE, such as IntelliJ IDEA or Eclipse.

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:07:14 GMT

Revision 27 posted to Guide by joel.larin on 7/1/2024 5:07:14 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers.
If using Chrome, we recommend also using Chrome For Testing for a more consistent testing experience
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:06:23 GMT

Revision 26 posted to Guide by joel.larin on 7/1/2024 5:06:23 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers.
- If using Chrome, we recommend also using Chrome For Testing for a more consistent testing experience
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:05:56 GMT

Revision 25 posted to Guide by joel.larin on 7/1/2024 5:05:56 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
Chrome or Firefox browsers. If using Chrome, we recommend also using Chrome For Testing for a more consistent testing experience
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:03:57 GMT

Revision 24 posted to Guide by joel.larin on 7/1/2024 5:03:57 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
If using Chrome, we recommend also using Chrome For Testing for a more consistent testing experience
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:03:04 GMT

Revision 23 posted to Guide by joel.larin on 7/1/2024 5:03:04 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
If using Chrome, we recommend also using Chrome For Testing for a more consistent testing experience
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:02:48 GMT

Revision 22 posted to Guide by joel.larin on 7/1/2024 5:02:48 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
If using Chrome, we recommend also using Chrome For testing for a more consistent testing experience
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 17:01:59 GMT

Revision 21 posted to Guide by joel.larin on 7/1/2024 5:01:59 PM

Requirements

Appian 22.2 and above
Java Runtime Environment 11
If using Chrome, we recommend also using Chrome For Testing for a more consistent testing experience
An IDE, such as IntelliJ IDEA or Eclipse

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 16:59:00 GMT

Revision 20 posted to Guide by joel.larin on 7/1/2024 4:59:00 PM

Requirements

Appian 22.2 and above

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 16:58:32 GMT

Revision 19 posted to Guide by joel.larin on 7/1/2024 4:58:32 PM

Requirements

Appian 22.2 and above

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 16:58:07 GMT

Revision 18 posted to Guide by joel.larin on 7/1/2024 4:58:07 PM

Requirements

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Mon, 01 Jul 2024 16:55:37 GMT

Revision 17 posted to Guide by joel.larin on 7/1/2024 4:55:37 PM

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Thu, 13 Jun 2024 13:14:50 GMT

Revision 16 posted to Guide by joel.larin on 6/13/2024 1:14:50 PM

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Appian 22.1 and above
Java Runtime Environment 11

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture

Automated Testing with Appian Selenium API

joel.larin — Thu, 13 Jun 2024 13:13:14 GMT

Revision 15 posted to Guide by joel.larin on 6/13/2024 1:13:14 PM

Setup

It can be used in a Java application or integrated directly into any Selenium or Java-based testing tool.

Appian 22.1 and above
Java Runtime Environment 11

Open this project in an IDE, such as IntelliJ IDEA or Eclipse.
Update configurations:
1. Open file configs/custom.properties
  1. Update automated.testing.home with the path to this installation. Examples:
    1. Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java
    2. Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java
  2. Update chrome.driver.home with the path to the Chrome driver that comes with this installation. Examples: * Windows: automated.testing.home=C:\\testFolder\\appian-selenium-api-example-java\\lib\\drivers\\chromedriver.exe * Mac: automated.testing.home=/Users/tester/Desktop/appian-selenium-api-example-java/lib/drivers/chromedriver-mac
2. Open file configs/users.properties, for each username used in a test add a line in the format of <username>=<password> to this file.
  1. If you prefer not to disclose your password in plain text, you can also choose to use com.appiancorp.ps.automatedtest.fixture.BaseFixture.loginIntoWithUsernameAndPassword fixture method to login by passing in the password from a system property value.
Open "src/main/java/com/appiancorp/example/HelloAppian.java":
1. Update TEST_SITE_URL to your Appian URL, such as protected static String TEST_SITE_URL = "https://example.appiancloud.com/suite";
2. Update TEST_USERNAME with a username, such as protected static String TEST_USERNAME = "tester.tester"; * Make sure this user exists in configs/users.properties
Run the main() method of this class:
1. You should see that a Chrome browser will open up, and the fixture commands in HelloAppian.java will execute accordingly.
2. Note that this test will fail since your site might not have an action "Create a Case" under menu "Actions" that opens up an interface that has a "Submit" button.

Features

Multiple browser support

Chrome
Firefox

Benefits

Define your own integration tests without being limited by a third-party testing tool
Selenium-based test scripts can be created for reusability throughout test suites
Methods created specifically to operate within Appian applications and Tempo
Test scripts do not need to be updated when upgrading between supported Appian versions
Test scripts are easily updated for new UI changes to a form or interface
Appian design knowledge is not required to create test scripts

Release Notes

June 2024 - Release 24.2

Enhancements
- Updated 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 don't 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're not expecting any impact on existing test cases.

March 2024 - Release 24.1

Enhancements
- Support for 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 have a component nested in multiple layouts within the card

November 2023 - Release 23.4

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Support for Appian version 23.4
- Add support for the side navigation menu in sites
- Add support for downloading charts
- Add support for buttons configured with custom colors
Bug Fixes
- Honor the download directory given in custom.properties for Remote Drivers
- Update dropdowns for versions greater than 23.3 to ignore the aria-checked value
- Fixed Populate Record Type Data Range User Filter method

August 2023 - Release 23.3

NOTE: Project has been updated to require Java 11 JRE
Enhancements
- Supports Appian version 23.3
- Added functionality to interact with new site group headers
- Updated to Selenium 4.11.0
Bug Fixes
- Update checkboxes to support CARD style for 23.3 and later Appian versions

June 2023 - Release 23.2.1

NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead
Bug Fixes
- Update pickers to recognize selections with links (e.g. Record Pickers)

June 2023 - Release 23.2

Enhancements
- Supports Appian version 23.2
  - NOTE: Updates to site navigation in the 23.2 product breaks the use of the clickOnMenu method defined in TempoFixtures for site environments. clickOnMenu, and other navigation methods defined in TempoFixtures, are guaranteed to work only in Tempo environments. Use the clickOnSitePage method defined in SitesFixtures instead

May 2023 - Release 23.1.2

Bug Fixes
- Fixes an issue where Dropdowns with Search were not working
- Fixes an Issue where verifyText did not work on multi-node components

February 2023 - Release 23.1

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

August 2022 - Release 22.3

Appian Selenium API is released and supported
Removed support for 20.3

November 2021 - Release 21.4

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

August 2021 - Release 21.3

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

June 2021 - Release 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

March 2021 - Release 21.1

Appian Selenium API is released and supported

Tags: testing, Architecture