# Sahi Pro Documentation > Sahi Pro is a test automation tool for web, web services, mobile (Android and iOS), Windows desktop, SAP GUI and Java applications. Scripts are written in Sahi Script using built-in Sahi functions, and run from the Sahi Pro desktop application, the command line or CI tools. Every link below points to a plain-Markdown version of the page. The full text of all pages is in one file at https://resources.sahipro.com/docs/llms-full.txt. Notes for agents: - The "Function Reference" in the Sahi Script section lists every built-in Sahi function (formerly called "Sahi APIs"; they are not REST APIs): each function lists the product versions it is available in, the modes it supports (Browser, Windows, Java, Android, iOS, SAP), its arguments and return value. - To write Sahi scripts, read https://resources.sahipro.com/docs/llms-sahi-script.txt: best practices, language basics and every function in one file. - Accessor functions (for example _button, _textbox) identify UI elements; actions (for example _click, _setValue) operate on them. - Sahi Pro Flowcharts is retired. Its pages are listed under "Flowcharts (archived)" for users of the last release (v12) and are no longer updated; prefer the Sahi Pro Classic pages for current behaviour. ## Introduction - [Welcome to Sahi Pro](https://resources.sahipro.com/docs/introduction.md): Automate functional tests of web, Rest API, mobile, Windows desktop, Java and SAP GUI applications, all from one platform. - [Sahi Pro Atlas](https://resources.sahipro.com/docs/introduction/sahi-pro-atlas.md): Sahi Pro Atlas, in beta preview, turns how your application should behave into reviewed, ready-to-run Sahi Pro tests. - [Sahi Pro Web Engine](https://resources.sahipro.com/docs/introduction/sahi-pro-web-engine.md): Sahi Pro Web Engine automates functional testing of web applications and Rest APIs, across browsers and operating systems. - [Sahi Pro Rest API](https://resources.sahipro.com/docs/introduction/sahi-pro-rest-api.md): Test Rest APIs from the Editor: build an API call, check its response and save it as a test step. - [Sahi Pro Desktop Engine](https://resources.sahipro.com/docs/introduction/sahi-pro-desktop-engine.md): Sahi Pro Desktop Engine adds automation of Windows desktop and Java applications to Sahi Pro. - [Sahi Pro Mobile Engine](https://resources.sahipro.com/docs/introduction/sahi-pro-mobile-engine.md): Sahi Pro Mobile Engine adds automation of Android and iOS applications to Sahi Pro. - [Sahi Pro SAP Engine](https://resources.sahipro.com/docs/introduction/sahi-pro-sap-engine.md): Sahi Pro SAP Engine adds automation of SAP GUI for Windows to Sahi Pro. - [Sahi Pro Visual Assist Engine](https://resources.sahipro.com/docs/introduction/sahi-pro-visual-assist-addon.md): Sahi Pro Visual Assist Engine uses computer vision and machine learning to add Image Recognition and Optical Character Recognition (OCR) to the Web, Desktop and Mobile Engines. - [Sahi Pro Runner](https://resources.sahipro.com/docs/introduction/sahi-pro-runner.md): Sahi Pro Runner is a lean version of Sahi Pro that only runs tests, built for CI servers and automated builds. - [Sahi License Hub](https://resources.sahipro.com/docs/introduction/sahi-license-hub.md): Sahi License Hub is where your organization views its Sahi Pro product keys, manages leases and MAC addresses, and controls who can get a license. - [Architecture](https://resources.sahipro.com/docs/introduction/architecture.md): The design goals behind Sahi, and how its architecture meets them. - [Sahi Script](https://resources.sahipro.com/docs/introduction/sahi-script.md): What Sahi Script is, what a script looks like, and how Sahi runs it. - [Download Center](https://resources.sahipro.com/docs/introduction/installers.md): Download the installers for Sahi Pro, Sahi Pro Runner and the Engines, for the latest release and earlier versions. - [Sahi Pro Documentation (Previous Versions)](https://resources.sahipro.com/docs/introduction/all-versions.md): Links to the documentation of earlier Sahi Pro versions, including the documentation as it was before this site, for users who have not moved to the new version yet. ## Release Notes - [Release Notes](https://resources.sahipro.com/docs/release-notes.md): What changed in each release of Sahi Pro, its engines and add-ons, newest first. - [What is new in Sahi Pro v12.0.0.10](https://resources.sahipro.com/docs/release-notes/v12-0-0-10.md): Sahi Pro v12.0.0.10 introduces the No-Code Test Editor, a redesigned Controller and Reports, and Sahi Pro Atlas as a beta preview. - [What is new in Sahi Pro v11.5.0.0](https://resources.sahipro.com/docs/release-notes/v11-5-0-0.md): Sahi Pro v11.5.0.0 is a minor release with significant feature additions and modifications. - [What is new in Sahi Pro v11.2.0.0](https://resources.sahipro.com/docs/release-notes/v11-2-0-0.md): Sahi Pro v11.2.0.0 is a minor release with features and improvements primarily in Sahi Pro Flowcharts. - [What is new in Sahi Pro v11.1.0.0](https://resources.sahipro.com/docs/release-notes/v11-1-0-0.md): Sahi Pro v11.1.0.0 is a minor release with features and improvements in Sahi Pro Flowcharts. - [What is new in Sahi Pro v11.0.1.4](https://resources.sahipro.com/docs/release-notes/v11-0-1-4.md): Sahi Pro v11.0.1.4 is a minor release with features and improvements in Sahi Pro Flowcharts. - [What is new in Sahi Pro v11.0.0.8](https://resources.sahipro.com/docs/release-notes/v11-0-0-8.md): Sahi Pro v11.0.0.8 is a major release with introduction of Flowcharts, bug fixes and improvements. - [What is new in Sahi Pro v10.0.0](https://resources.sahipro.com/docs/release-notes/v10-0-0.md): Sahi Pro v10.0.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro v10.0.0. - [What is new in Sahi Pro Desktop Add-on v10.0.0](https://resources.sahipro.com/docs/release-notes/v10-0-0/desktop-engine.md): Sahi Pro Desktop Add-on v10.0.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro Desktop Add-on v10.0.0. - [What is new in Sahi Pro Mobile Add-on v10.0.0](https://resources.sahipro.com/docs/release-notes/v10-0-0/mobile-engine.md): Sahi Pro Mobile Add-on v10.0.0 is a release with significant bug fixes. - [What is new in Sahi Pro SAP Add-on v10.0.0](https://resources.sahipro.com/docs/release-notes/v10-0-0/sap-engine.md): Sahi Pro SAP Add-on v10.0.0 is a release with significant bug fixes. - [What is new in Sahi Pro AI Assist Add-on v10.0.0](https://resources.sahipro.com/docs/release-notes/v10-0-0/ai-assist-add-on.md): Sahi Pro AI Assist Add-on (now renamed to Sahi Pro Visual Assist) v10.0.0 marks its first major release. - [What is new in Sahi Pro v9.7.0](https://resources.sahipro.com/docs/release-notes/v9-7-0.md): Sahi Pro v9.7.0 is a minor release with bug fixes and improvements. - [What is new in Sahi Pro v9.5.0](https://resources.sahipro.com/docs/release-notes/v9-5-0.md): Sahi Pro v9.5.0 is a major release with significant feature additions. - [What is new in Sahi Pro v9.2.1](https://resources.sahipro.com/docs/release-notes/v9-2-1.md): Sahi Pro v9.2.1 is a minor release with bug fixes and modifications. - [What is new in Sahi Pro v9.2.0](https://resources.sahipro.com/docs/release-notes/v9-2-0.md): Sahi Pro v9.2.0 is a minor release with bug fixes and modifications. - [What is new in Sahi Pro v9.1.2](https://resources.sahipro.com/docs/release-notes/v9-1-2.md): Sahi Pro v9.1.2 is a minor release with performance improvement and bug fixes. - [What is new in Sahi Pro v9.1.1](https://resources.sahipro.com/docs/release-notes/v9-1-1.md): Sahi Pro v9.1.1 is a minor release with bug fixes and modifications. - [What is new in Sahi Pro v9.1.0](https://resources.sahipro.com/docs/release-notes/v9-1-0.md): Sahi Pro v9.1.0 is a minor cumulative release that includes v9.0.1, v9.0.2 and bug fixes with modifications. - [What is new in Sahi Pro v9.0.2](https://resources.sahipro.com/docs/release-notes/v9-0-2.md): Sahi Pro v9.0.2 is a minor update release with bugfixes and modifications predominantly related to resolve latest browser restrictions. Some popup related scripts may not work. Please refer modifications section for more details. - [What is new in Sahi Pro v9.0.1](https://resources.sahipro.com/docs/release-notes/v9-0-1.md): Sahi Pro v9.0.1 is a minor update release with bugfixes and modifications. Sahi Pro v9.0.1 can be updated from Sahi Pro v9.0.0 through the Update Sahi Pro web UI. - [What is new in Sahi Pro v9.0.0](https://resources.sahipro.com/docs/release-notes/v9-0-0.md): Sahi Pro v9.0.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro v9.0.0. - [What is new in Sahi Pro Desktop Add-on v9.0.0](https://resources.sahipro.com/docs/release-notes/v9-0-0/desktop-engine.md): Sahi Pro Desktop Add-on v9.0.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro Desktop Add-on v9.0.0. - [What is new in Sahi Pro Mobile Add-on v9.0.0](https://resources.sahipro.com/docs/release-notes/v9-0-0/mobile-engine.md): Sahi Pro Mobile Add-on v9.0.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro Mobile Add-on v9.0.0 - [What is new in Sahi Pro SAP Add-on v9.0.0](https://resources.sahipro.com/docs/release-notes/v9-0-0/sap-engine.md): Sahi Pro SAP Add-on v9.0.0 is its first major release. - [What is new in Sahi Pro v8.0.0](https://resources.sahipro.com/docs/release-notes/v8-0-0.md): Sahi Pro v8.0.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro v8.0.0. - [What is new in Sahi Pro Desktop Add-on v8.0.0](https://resources.sahipro.com/docs/release-notes/v8-0-0/desktop-engine.md): Sahi Pro Desktop Add-on v8.0.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro Desktop Add-on v8.0.0. - [What is new in Sahi Pro Mobile Add-on v8.0.0](https://resources.sahipro.com/docs/release-notes/v8-0-0/mobile-engine.md): Sahi Pro Mobile Add-on v8.0.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro Mobile Add-on v8.0.0 - [What is new in Sahi Pro v7.5.0](https://resources.sahipro.com/docs/release-notes/v7-5-0.md): Sahi Pro v7.5.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro v7.5.0. - [What is new in Sahi Pro Desktop Add-on v7.5.0](https://resources.sahipro.com/docs/release-notes/v7-5-0/desktop-engine.md): Sahi Pro Desktop Add-on v7.5.0 is a major release with significant feature additions and modifications. The following summarizes features and enhancements in Sahi Pro Desktop Add-on v7.5.0. - [What is new in Sahi Pro Mobile Add-on v7.5.0](https://resources.sahipro.com/docs/release-notes/v7-5-0/mobile-engine.md): Sahi Pro Mobile Add-on v7.5.0 is its first major release. - [What is new in Sahi Pro v7.0.1](https://resources.sahipro.com/docs/release-notes/v7-0-1.md): Sahi Pro v7.0.1 is a minor release and contains bugfixes. - [What is new in Sahi Pro Desktop Add-on v7.0.1](https://resources.sahipro.com/docs/release-notes/v7-0-1/desktop-engine.md): Sahi Pro Desktop Add-on v7.0.1 is minor release and contains bugfixes. - [What is new in Sahi Pro v7.0.0](https://resources.sahipro.com/docs/release-notes/v7-0-0.md): Sahi Pro v7.0.0 is a major release with significant feature additions and modifications. Please read this page fully before upgrading. - [What is new in Sahi Pro Desktop Add-on v7.0.0](https://resources.sahipro.com/docs/release-notes/v7-0-0/desktop-engine.md): Sahi Pro Desktop Add-on v7.0.0 is its first major release. - [What is new in Sahi Pro v6.3.2](https://resources.sahipro.com/docs/release-notes/v6-3-2.md): Sahi Pro v6.3.2 is a minor release and contains bugfixes. - [What is new in Sahi Pro v6.3.1](https://resources.sahipro.com/docs/release-notes/v6-3-1.md): Sahi Pro v6.3.1 is a minor release and contains one new feature and bugfixes. - [What is new in Sahi Pro v6.3.0](https://resources.sahipro.com/docs/release-notes/v6-3-0.md): Sahi Pro v6.3.0 is a major release and contains many new features and bugfixes. - [What is new in Sahi Pro v6.2.1](https://resources.sahipro.com/docs/release-notes/v6-2-1.md): Sahi Pro v6.2.1 is a minor release. It contains various small feature enhancements and bugfixes requested by customers - [What is new in Sahi Pro v6.2.0](https://resources.sahipro.com/docs/release-notes/v6-2-0.md): Sahi Pro v6.2.0 is a major release and contains many new features and bugfixes. Sahi Pro Runner has been introduced since this version (v6.2.0) - [What is new in Sahi Pro v6.1.0](https://resources.sahipro.com/docs/release-notes/v6-1-0.md): Sahi Pro v6.1.0 is a major release and contains many new features and bugfixes. - [What is new in Sahi Pro v6.0.1](https://resources.sahipro.com/docs/release-notes/v6-0-1.md): Sahi Pro v6.0.1 is a bugfix release. - [What is new in Sahi Pro v6.0.0](https://resources.sahipro.com/docs/release-notes/v6-0-0.md): Sahi Pro v6.0.0 is a major release and contains many new features and fixes. The focus of this release is tester productivity enhancement. - [What is new in Sahi Pro v5.1.2](https://resources.sahipro.com/docs/release-notes/v5-1-2.md): Sahi Pro 5.1.2 is a bugfix release. - [What is new in Sahi Pro v5.1.1](https://resources.sahipro.com/docs/release-notes/v5-1-1.md): Sahi Pro 5.1.1 is a significant bugfix release. - [What is new in Sahi Pro v5.1.0](https://resources.sahipro.com/docs/release-notes/v5-1-0.md): Sahi Pro v5.1.0 is a major release and contains many new features and bug fixes. - [What is new in Sahi OS v5.0](https://resources.sahipro.com/docs/release-notes/sahi-os/v5-0.md): Sahi OS v5.0 is a major release and contains many new features and bug fixes. ## Using Sahi - [Install and Set Up Sahi Pro](https://resources.sahipro.com/docs/using-sahi/quick-tutorial.md): Install Sahi Pro, start the Dashboard and add your license, the first step of Getting Started. - [Create Your First Test Scenario](https://resources.sahipro.com/docs/using-sahi/getting-started/first-test-scenario.md): Create a project, a scenario file, a test case and keywords, then record, run and edit your first test in Sahi Pro. - [Parameters and Data Generators](https://resources.sahipro.com/docs/using-sahi/getting-started/parameters-and-data-generators.md): Turn a keyword's recorded values into parameters, so each test run can use new data from a data generator or a test data file. - [Loop Through a Test Data File](https://resources.sahipro.com/docs/using-sahi/getting-started/test-data-files.md): Attach a test data file to a test case or keyword, so it runs once for each row of data. - [Run Tests in a Suite](https://resources.sahipro.com/docs/using-sahi/getting-started/test-suites.md): Create a test suite that holds scenario files, run it with Run Configuration, and read the suite report. - [Business-Driven Test Automation (BDTA)](https://resources.sahipro.com/docs/using-sahi/business-driven-test-automation.md): Business-Driven Test Automation is how Sahi Pro is built: write tests as business steps first, and automate each step when the application is ready. - [Best Practices](https://resources.sahipro.com/docs/using-sahi/best-practices.md) - [Upgrade Sahi Pro](https://resources.sahipro.com/docs/using-sahi/upgrade.md): Upgrade Sahi Pro by installing the new version over the existing one; your configuration is kept and the changed settings files are backed up. - [Sahi Configuration (Basic)](https://resources.sahipro.com/docs/using-sahi/sahi-configuration-basic.md): Sahi may need a few configuration tweaks to make it work on your system. - [Restrict Remote Access to Sahi](https://resources.sahipro.com/docs/using-sahi/restrict-remote-access.md): Restrict which computers can use Sahi Pro as a master or node, change its settings or see its reports, by IP address and with a login. - [Restrict Files Access](https://resources.sahipro.com/docs/using-sahi/restrict-files-access.md): This section describes how we can restrict Sahi Pro's access to different files. It is available since Sahi Pro V6.3.1. - [Securing Sahi for Enterprise](https://resources.sahipro.com/docs/using-sahi/securing-sahi-for-enterprise.md) - [Sahi GUI Less (Silent) Installation](https://resources.sahipro.com/docs/using-sahi/sahi-gui-less-silent-installation.md) - [Manage External JAR Files and Configure Nodes](https://resources.sahipro.com/docs/using-sahi/configure-nodes.md): Add or delete external JAR files and Sahi Pro support JAR files, and sync them to the nodes of distributed suite runs. - [Auto Threading](https://resources.sahipro.com/docs/using-sahi/auto-thread.md): Auto thread intelligently prevents your browser from launching if CPU usage exceeds a configurable threshold value. It allows to launch browser only if enough CPU is available. This ensures stability for your script execution. - [Manage Sahi Pro Version Updates, Rollbacks, Engines and Support Patches](https://resources.sahipro.com/docs/using-sahi/check-for-updates.md): Update Sahi Pro to a new version, roll back to an earlier one, install engines and apply support patches. - [Test Scenario Editor](https://resources.sahipro.com/docs/using-sahi/sahi-script-editor.md): Build and organise tests in the Test Scenario Editor: projects, the Navigator, scenario files in the No-Code Test Editor, running a scenario file, the Sheet View, scenarios with Java, and the Tools menu. - [Sahi Controller](https://resources.sahipro.com/docs/using-sahi/sahi-controller.md): Record a keyword's steps, identify elements, try steps before you add them, and run your test case from the Controller. - [Test Data Files](https://resources.sahipro.com/docs/using-sahi/test-data-files.md): Keep test data in groups in a .csv test data file, edit it as a sheet, and attach it to a test case or keyword with Data Drive. - [Test Suites](https://resources.sahipro.com/docs/using-sahi/data-driven-suites.md): Group scenario files into a test suite (.dd.csv) to run them together, with tags, dependencies, values to pass, prerequisites and timeouts. - [Java Controller](https://resources.sahipro.com/docs/using-sahi/java-controller.md): Sahi's Controller allows you to interact with Sahi and easily experiment and debug on the browser. This section explains using the Controller in Java mode, for writing scripts in Java instead of Sahi script (javascript) - [REST Client - Getting Started](https://resources.sahipro.com/docs/using-sahi/rest-api/getting-started.md): Test Rest APIs with the REST Client: add a REST step to a keyword, or generate Sahi Script from a request. - [Build a Request](https://resources.sahipro.com/docs/using-sahi/rest-api/build-a-request.md): Set the method, URL, parameters, body, headers, authorization and settings of a REST request, import one, or reuse one from History. - [Authorization](https://resources.sahipro.com/docs/using-sahi/rest-api/authorization.md): Authenticate REST requests with Basic Auth, OAuth 1.0 or OAuth 2.0. - [Read the Response](https://resources.sahipro.com/docs/using-sahi/rest-api/read-the-response.md): Send a request and read its body, status and headers in the REST Client. - [Assertions and Variables](https://resources.sahipro.com/docs/using-sahi/rest-api/assertions-and-variables.md): Check values in a REST response, keep them in variables for later steps, and add the REST step to the keyword. - [REST Steps in Reports](https://resources.sahipro.com/docs/using-sahi/rest-api/reports.md): See which assertions passed or failed and which variables were stored. - [Run Tests](https://resources.sahipro.com/docs/using-sahi/playback.md) - [Run Tests via Editor](https://resources.sahipro.com/docs/using-sahi/run-tests-via-editor.md): Run scenario files, keyword files and suites from the Test Scenario Editor: the Run Configuration, parallel and distributed suite runs, advanced settings, scheduling, export to Ant or Gradle, and debugging. - [Run Tests via Controller](https://resources.sahipro.com/docs/using-sahi/run-tests-via-controller.md): Run a keyword, part of a test case or all of it from the Sahi Controller while you build it, step through a run, fill in missing variables and see the result. - [Run Tests via Ant](https://resources.sahipro.com/docs/using-sahi/playback-via-ant.md): Run Sahi Pro tests and suites with Apache Ant, on one machine or across several, with the Ant XML exported from the Run Configuration. - [Run Tests via Gradle](https://resources.sahipro.com/docs/using-sahi/playback-via-gradle.md): Run Sahi Pro tests and suites with Gradle, on one machine or across several, with the Gradle script exported from the Run Configuration. - [Run Tests via Maven](https://resources.sahipro.com/docs/using-sahi/playback-via-maven.md): This section describes how to run tests from Apache Maven - [Email Properties and Templates](https://resources.sahipro.com/docs/using-sahi/email-during-playback.md): This section describes sending status emails during suite execution. - [Autoheal](https://resources.sahipro.com/docs/using-sahi/autoheal.md): Autoheal allows automatic healing and recovery of failing scripts based on the data from previous runs. - [Integrate with Jenkins](https://resources.sahipro.com/docs/using-sahi/integrate-with-jenkins.md): Jenkins and other Continuous Integration systems can trigger Sahi scripts as part of the build process using Sahi's ANT and Gradle target. - [Integrate with Azure DevOps](https://resources.sahipro.com/docs/using-sahi/integrate-with-azure-devops.md): Azure DevOps and other Continuous Integration systems can trigger Sahi scripts as part of the build process using Sahi's ANT target. - [Integrate with TeamCity](https://resources.sahipro.com/docs/using-sahi/integrate-with-teamcity.md): TeamCity and other Continuous Integration systems can trigger Sahi scripts as part of the build process using Sahi's ANT target. - [Sahi headless execution with PhantomJS](https://resources.sahipro.com/docs/using-sahi/sahi-headless-execution-with-phantomjs.md) - [Sahi headless execution with Google Chrome](https://resources.sahipro.com/docs/using-sahi/sahi-headless-execution-with-chrome.md) - [Sahi headless execution with Mozilla Firefox](https://resources.sahipro.com/docs/using-sahi/sahi-headless-execution-with-firefox.md) - [Configuring Sahi with Xvfb](https://resources.sahipro.com/docs/using-sahi/configuring-sahi-with-xvbf.md) - [Running Sahi Scripts from Java](https://resources.sahipro.com/docs/using-sahi/running-sahi-scripts-from-java.md) - [Run Tests from the Command Line](https://resources.sahipro.com/docs/using-sahi/playback-commandline.md): Run tests and suites from the command line with testrunner, or across machines with drun and drun_different_master, using the batch and shell files in userdata/bin. - [Sahi Integration Support](https://resources.sahipro.com/docs/using-sahi/sahi-integration.md) - [Reports](https://resources.sahipro.com/docs/using-sahi/sahi-reports.md): Every test run creates a report. Learn how to open reports, how they are organised, and what each status means. - [Reports List](https://resources.sahipro.com/docs/using-sahi/reports-list.md): Find a test run in the reports list, filter and arrange its columns, and compare, consolidate, download, sync or delete reports. - [Suite Report](https://resources.sahipro.com/docs/using-sahi/suite-report.md): Read a suite report: the navigator, Suite Details, the result charts, the time each scenario file took, and every scenario file and test case in the run. - [Script Report](https://resources.sahipro.com/docs/using-sahi/script-report.md): Read a script report: each test case, keyword and step, the error and screenshot for a failed step, healed steps, data sets and retries. - [Javascript Code Coverage](https://resources.sahipro.com/docs/using-sahi/javascript-code-coverage.md): Sahi Pro can measure how much of the web application's JavaScript your tests run, by function and by decision point, for each JavaScript file. - [Suite Analysis](https://resources.sahipro.com/docs/using-sahi/suite-analysis.md): Suite Analysis shows which steps caused the failures and healed steps in a suite run, which scenario files they affected, and how each file has done across earlier runs. - [Customize Reports](https://resources.sahipro.com/docs/using-sahi/customize-reports.md): How Sahi Pro builds reports, and how to change a report type, add your own, add custom fields, set a pass threshold, keep offline reports and delete old reports. - [Storing Log Reports in MySQL](https://resources.sahipro.com/docs/using-sahi/storing-reports-in-mysql.md) - [Storing Reports in MSSQL Database](https://resources.sahipro.com/docs/using-sahi/storing-reports-in-mssql.md) - [Storing Reports in ORACLE Database](https://resources.sahipro.com/docs/using-sahi/storing-reports-in-oracle.md) - [Storing Reports in PostgreSQL Database](https://resources.sahipro.com/docs/using-sahi/storing-reports-in-postgresql.md) - [Sync Reports to Central Database](https://resources.sahipro.com/docs/using-sahi/sahi-syncdb.md) - [Record Tests for Mobile Browsers](https://resources.sahipro.com/docs/using-sahi/recording-for-mobile-browser.md): Record tests for a mobile browser from a desktop browser, by giving it a phone's screen size and user agent from the Sahi Pro start page. - [Run Tests on Mobile Browsers](https://resources.sahipro.com/docs/using-sahi/playback-mobile-browser.md) - [Run Sahi Script on iPad](https://resources.sahipro.com/docs/using-sahi/run-sahi-on-ipad.md) - [Sahi Pro Desktop Engine](https://resources.sahipro.com/docs/using-sahi/desktop-engine.md): Getting started with Sahi Pro Desktop Engine Automation. - [Windows Desktop Automation](https://resources.sahipro.com/docs/using-sahi/windows-desktop.md): This section details how to test Windows Desktop Applications. If you are not familiar with Sahi Pro, see Quick Tutorial on Sahi Pro To automate windows desktop applications using Sahi Pro Flowcharts, refer Windows Desktop Automation. - [Java Web Start Automation](https://resources.sahipro.com/docs/using-sahi/javaws.md): This section details how to test Java Web Start Automation. If you are not familiar with Sahi Pro, see Quick Tutorial on Sahi Pro To automate java applications using Sahi Pro Flowcharts, refer Java Web Start Automation. - [Java GUI Application Automation](https://resources.sahipro.com/docs/using-sahi/java-application.md): This section details how to test Java Application. If you are not familiar with Sahi Pro, see Quick Tutorial on Sahi Pro To automate java applications using Sahi Pro Flowcharts, refer Java GUI Application Automation. - [Applet Automation](https://resources.sahipro.com/docs/using-sahi/applet-new.md): This section details how to test Java Applets. If you are not familiar with Sahi Pro, refer Quick Tutorial on Sahi Pro - [Sahi Pro Mobile Engine](https://resources.sahipro.com/docs/using-sahi/mobile-engine.md): Getting started with Sahi Pro Mobile Engine Automation. - [Android Automation - Getting Started](https://resources.sahipro.com/docs/using-sahi/android-getting-started.md): This section helps you quickly get started with Android Automation. To automate an Android Devices/Simulators using Sahi Pro Flowcharts, refer Android Automation - Getting Started. - [Automating Android Apps - Details](https://resources.sahipro.com/docs/using-sahi/android-details.md): This page describes Android Automation in detail. If you wish to get a quick start, read Android Automation - Getting Started. - [iOS Automation - Getting Started](https://resources.sahipro.com/docs/using-sahi/ios-getting-started.md): This section helps you quickly get started with iOS Automation. To automate an IOS Devices/Simulators using Sahi Pro Flowcharts, refer iOS Automation - Getting Started. - [Automating iOS Apps - Details](https://resources.sahipro.com/docs/using-sahi/ios-details.md): This page describes iOS Automation in detail. If you wish to get a quick start, read iOS Automation - Getting Started. - [Sahi Pro SAP Engine](https://resources.sahipro.com/docs/using-sahi/sap-engine.md): Getting started for automation with Sahi Pro SAP Engine Automation. - [SAP GUI Automation - Getting Started](https://resources.sahipro.com/docs/using-sahi/sap-gui-getting-started.md): This section details how to test SAP GUI Applications. If you are not familiar with Sahi Pro, see Quick Tutorial on Sahi Pro To automate SAP GUI applications using Sahi Pro Flowcharts, refer SAP GUI Automation - Getting Started . - [Sahi Pro Visual Assist Engine](https://resources.sahipro.com/docs/using-sahi/visual-assist-add-on.md): Getting started for automation with Sahi Pro Visual Assist Engine Automation. - [Visual Assist Automation - Getting Started](https://resources.sahipro.com/docs/using-sahi/visual-assist-getting-started.md): Find and act on elements by how they look on screen, using image recognition and OCR with the Visual Assist Engine. - [Sahi Flex Support](https://resources.sahipro.com/docs/using-sahi/flex.md) - [Salesforce Test Automation](https://resources.sahipro.com/docs/using-sahi/salesforce.md) - [Load Testing with Sahi Pro](https://resources.sahipro.com/docs/using-sahi/load-testing.md): Sahi Pro lets you run load tests on your application. There are 2 Sahi scripts involved in this. One is used to generate the load. This script is called the noise and is run on a headless browser. The steps in the noise file are generally in an infinite loop so that they never terminate. The other script is called the subject. The subject is the script whose steps you would like to measure periodically at different loads. - [Other Language Drivers](https://resources.sahipro.com/docs/using-sahi/other-language-drivers.md): Apart from Sahi Script, Sahi has functions available in Java to drive the browser. - [Sahi Java Driver](https://resources.sahipro.com/docs/using-sahi/java.md) - [TypeScript Support](https://resources.sahipro.com/docs/using-sahi/typescript-support.md): Sahi allows scripts to be written in TypeScript. TypeScript .ts files need to be first compiled to JS and then executed via Sahi. - [Complex Use Cases](https://resources.sahipro.com/docs/using-sahi/complex-usecases.md): Even though Sahi Pro looks simple, it is very powerful and can handle a lot of complex use cases. - [Record and Run Tests on CEF-Based Browsers (Experimental Feature)](https://resources.sahipro.com/docs/using-sahi/recording-on-chromium-embedded-framework.md) - [Automate Browser Extensions](https://resources.sahipro.com/docs/using-sahi/automate-browser-extensions.md): This section describes how to automate browser extensions using Sahi Pro in BROWSER mode. - [Create Virtual Machines with AWS Cloud Formation](https://resources.sahipro.com/docs/using-sahi/aws-cloud-formation.md): AWS Cloud Formation helps creating virtual machines (EC2 Instances - Windows) with minimal effort. Sahi provides custom Cloud Formation template inorder to launch the EC2 Instances fully loaded with Sahi Pro Runner installed and running. - [Mobile Automation integration with AWS Device Farm](https://resources.sahipro.com/docs/using-sahi/mobile-integration-device-farm.md): This section helps you for integration Sahi with AWS Device Farm. - [Sahi Robot Bridge](https://resources.sahipro.com/docs/using-sahi/robot-sahi.md) - [Sahi MTM Bridge](https://resources.sahipro.com/docs/using-sahi/mtm-sahi-integration.md) - [Integration with Git](https://resources.sahipro.com/docs/using-sahi/git-sahi-integration.md): This section helps you to integrate Sahi Pro with Git using Sahi Editor. ## Using Atlas - [How Atlas Works](https://resources.sahipro.com/docs/using-atlas/how-atlas-works.md): How Sahi Pro Atlas turns the application behaviour you describe into Sahi Pro tests, and where AI is used along the way. - [Running and Maintaining Atlas Tests](https://resources.sahipro.com/docs/using-atlas/running-and-maintaining-tests.md): How tests generated by Sahi Pro Atlas run on the Sahi Pro engine, stay up to date, and build up your keyword library. - [AI and Your Data](https://resources.sahipro.com/docs/using-atlas/ai-and-your-data.md): The ways to run Sahi Pro Atlas so your application data stays under your control: your own AI keys, your own infrastructure, or local models. ## Sahi Script - [Sahi Script Overview](https://resources.sahipro.com/docs/sahi-script.md): Sahi Script is the scripting language of Sahi Pro. Its built-in functions, formerly called Sahi APIs, find elements with accessors, act on them, check results with assertions, and work with data, files, logs and screenshots. - [Write Keywords in Sahi Script](https://resources.sahipro.com/docs/sahi-script/script-view.md): Write and refactor keyword code in the Test Scenario Editor's script view: the toolbar, the Context panel, Create Function, Find and Replace, Find Usage and Create AR. - [Write Scripts with AI](https://resources.sahipro.com/docs/sahi-script/write-scripts-with-ai.md): Give an AI assistant such as Claude, ChatGPT or Copilot the Sahi Script reference so it can write, explain and fix Sahi scripts. - [Sahi Script Best Practices](https://resources.sahipro.com/docs/sahi-script/best-practices.md): Rules for writing Sahi scripts that are reliable and easy to maintain, whether you write them yourself or an AI assistant writes them. - [Sahi Scripting Basics](https://resources.sahipro.com/docs/sahi-script/sahi-scripting-basics.md) - [Some Basic Data Types and Data Structures](https://resources.sahipro.com/docs/sahi-script/data-types.md) - [Exception Handling and Recovery](https://resources.sahipro.com/docs/sahi-script/exception-handling.md) - [Including Sahi Script Globally](https://resources.sahipro.com/docs/sahi-script/including-sahi-script-globally.md) - [Multiple Modes in a Single Script](https://resources.sahipro.com/docs/sahi-script/multiple-modes.md) - [Log javascript dialog messages in reports](https://resources.sahipro.com/docs/sahi-script/working-with-javascript-dialogs.md) - [401 Authentication](https://resources.sahipro.com/docs/sahi-script/401-authentication.md): This section describes how to handle 401 authentication with Sahi Pro. - [Client Certificate Authentication](https://resources.sahipro.com/docs/sahi-script/client-certificate-authentication.md): This section describes how to handle client certificate authentication in Sahi. - [Parsing XML in Sahi Scripts](https://resources.sahipro.com/docs/sahi-script/parsing-xml.md) - [Calling Java](https://resources.sahipro.com/docs/sahi-script/calling-java.md) - [Adding Jars to Sahi's Classpath](https://resources.sahipro.com/docs/sahi-script/adding-jars-to-sahis-classpath.md) - [Working with SSH from Sahi](https://resources.sahipro.com/docs/sahi-script/working-with-ssh-from-sahi.md) - [Working with Telnet from Sahi](https://resources.sahipro.com/docs/sahi-script/working-with-telnet-from-sahi.md) - [Reading PDF Files in Sahi](https://resources.sahipro.com/docs/sahi-script/reading-pdf-files.md) - [Sending Emails](https://resources.sahipro.com/docs/sahi-script/sending-emails.md): Sahi can send emails at the end of a suite, or from anywhere inside a script. To email test run reports at the end of a suite run, refer to Run Tests via Editor. This section explains how to send out emails from within a script. - [Working with Polymer](https://resources.sahipro.com/docs/sahi-script/working-with-polymer.md) - [Tweaking Sahi Functions](https://resources.sahipro.com/docs/sahi-script/tweaking-sahi-functions.md) - [Function Reference](https://resources.sahipro.com/docs/sahi-script/functions.md): All the functions built into Sahi Script, which used to be called Sahi APIs. Use them to find elements, act on them, check results, and work with files, data and logs. - [Accessor Basics](https://resources.sahipro.com/docs/sahi-script/functions/accessor-basics.md) - [Browser Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/browser-accessors.md) - [Generic Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/generic-accessors.md) - [Polymer Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/polymer-accessors.md) - [Salesforce Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/salesforce-accessors.md) - [Relation Functions](https://resources.sahipro.com/docs/sahi-script/functions/relations.md) - [Action Functions](https://resources.sahipro.com/docs/sahi-script/functions/actions.md): Sahi's Action functions simulate user actions on the application screen. - [Fetch Functions](https://resources.sahipro.com/docs/sahi-script/functions/fetch.md): While working on scripts, we often need to fetch content from the application screen. Examples may be: Fetching and storing a generated userId for later use in script Getting the value of form field for verification Getting the text from a UI element for assertion Getting some particular attribute of a UI element, like href of a link - [Assertion Functions](https://resources.sahipro.com/docs/sahi-script/functions/assertions.md): Assertions compare runtime behaviour against expected behaviour. Assertions are used for "verification" or "checking" of functionality - [JavaScript Dialogs](https://resources.sahipro.com/docs/sahi-script/functions/javascript-dialogs.md) - [Secondary Windows (Popup Windows)](https://resources.sahipro.com/docs/sahi-script/functions/popup-windows.md): Applications may open secondary windows as a new window or in a new tab. This section shows how to automate secondary windows. - [Frames and IFrames](https://resources.sahipro.com/docs/sahi-script/functions/frames.md) - [Multiple Domains in a Page](https://resources.sahipro.com/docs/sahi-script/functions/multiple-domains.md) - [Multiple Browser Instances in Single Script](https://resources.sahipro.com/docs/sahi-script/functions/multiple-browsers.md) - [Multi Language Support](https://resources.sahipro.com/docs/sahi-script/functions/multi-language.md): Websites may be enabled in multiple languages like English, Spanish, Chinese etc. Sahi Pro's multi-language support allows testing of websites in any language using the same scripts as long as translations are available. In most applications, Internationalization (I18N) and Localization (L10N) are done by specifying constant keys in web application code, and then having another layer substitute these constant keys with the correct language translations provided via resource files. These translations are normally kept in resource files. Eg. en.properties (english), de.properties (german), Resources.de.resx (german), resources.fr.xaml (french), etc. Since Sahi Pro scripts rely on visible text, the scripts may be recorded with English text. To play it on the German version, the script needs to be passed the English and German resource files. For example, when Sahi encounters an English string, it will look up the corresponding key in en.properties, then lookup the German value for that key in de.properties file and then use that value during execution. - [Rich Text Editors (RTE)](https://resources.sahipro.com/docs/sahi-script/functions/rich-text-editors.md): Rich Text Editors (RTEs) are iframes/divs whose designMode or contentEditable property is set to true. Such components allow input of text and formatting them (making text bold, inserting images etc.) - [Alignment Functions](https://resources.sahipro.com/docs/sahi-script/functions/alignment.md): Alignment functions can be used for checking alignment of one element with respect to the other. With which one can check alignment of different elements on different screen sizes i.e. to check responsiveness. A sample test page is added at Sahi_Pro\htdocs\demo\alignmentTestPage.htm and a sample test script is added at Sahi_Pro\userdata\scripts\demo\testAlignmentAPIs.sah to give a better understanding of these APIs. - [Layout Verification Functions](https://resources.sahipro.com/docs/sahi-script/functions/layout-verification.md): The following functions are used for testing the layout of a webpage. It is useful to test responsive design. - [Web Crawler Functions](https://resources.sahipro.com/docs/sahi-script/functions/web-crawler.md): Web Crawler functions are used to navigate to all pages of a website to check if the links are working. - [URL Functions](https://resources.sahipro.com/docs/sahi-script/functions/url.md): functions for reading content from URLs - [URL Mock Functions](https://resources.sahipro.com/docs/sahi-script/functions/url-mocks.md) - [HTTP Header Functions](https://resources.sahipro.com/docs/sahi-script/functions/http-headers.md): These functions help manipulate HTTP headers to test behaviour of modified browsers or devices. - [HTTP Response Functions](https://resources.sahipro.com/docs/sahi-script/functions/http-responses.md): These functions help manipulate HTTP response of browsers or devices. - [Windows Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/windows-accessors.md) - [Windows Functions](https://resources.sahipro.com/docs/sahi-script/functions/windows.md) - [Java Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/java-accessors.md) - [Java Functions](https://resources.sahipro.com/docs/sahi-script/functions/java.md) - [Flex Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/flex-accessors.md) - [Flex Functions](https://resources.sahipro.com/docs/sahi-script/functions/flex.md): Sahi supports Flex applications via the Sahi Flex Library (SFL) Information on usage can be found here - [Oracle Applet Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/oracle-applet-accessors.md) - [Mobile Functions](https://resources.sahipro.com/docs/sahi-script/functions/mobile.md): Mobile functions help automate Android and iOS apps. This page lists information about Non Accessor Mobile functions. Refer to Android Accessor functions and iOS Accessor functions for details on Mobile Accessor functions. - [Mobile Common Functions](https://resources.sahipro.com/docs/sahi-script/functions/mobile-common.md): This page lists the functions common to both Android and iOS. These functions have a _m prefix in camel case, example: _mSwipeLeft. These functions work on an Android device/simulator as well as on an iOS device/simulator. - [Android Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/android-accessors.md) - [Android Functions](https://resources.sahipro.com/docs/sahi-script/functions/android.md): This page lists the functions specific to Android. These functions have an _a prefix in camel case, example: _aPressBack. These functions will work only on an Android device/emulator. - [iOS Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/ios-accessors.md) - [iOS Functions](https://resources.sahipro.com/docs/sahi-script/functions/ios.md): This page lists the functions specific to iOS. These functions have an _i prefix in camel case, example: _iRotate. These functions will work only on an iOS device/simulator. - [Multiple Mobile Device Instances in Single Script](https://resources.sahipro.com/docs/sahi-script/functions/multiple-mobile-devices.md) - [SAP Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/sap-accessors.md) - [SAP Functions](https://resources.sahipro.com/docs/sahi-script/functions/sap.md): SAP GUI automation is supported since Sahi Pro SAP Engine. - [Visual Assist Accessor Functions](https://resources.sahipro.com/docs/sahi-script/functions/visual-assist-accessors.md): Sahi Pro Visual Assist Accessor functions provide Artificial Intelligence capabilities to automate applications by using computer vision and machine learning algorithms. It is supported since Sahi Pro Visual Assist Engine. - [Visual Assist Functions](https://resources.sahipro.com/docs/sahi-script/functions/visual-assist.md): Visual Assist automation is supported since Sahi Pro Visual Assist Engine. - [File Functions](https://resources.sahipro.com/docs/sahi-script/functions/files.md) - [Excel Functions](https://resources.sahipro.com/docs/sahi-script/functions/excel.md) - [Database Functions](https://resources.sahipro.com/docs/sahi-script/functions/database.md) - [Data Drive Functions](https://resources.sahipro.com/docs/sahi-script/functions/data-drive.md): Data driver refers to running a series of steps repeated with multiple sets of data This can be accomplished using the function _dataDrive. - [Data Generator Functions](https://resources.sahipro.com/docs/sahi-script/functions/data-generator.md): The Data Generator functions create random test data such as text, phone numbers, numbers, email addresses, dates, and booleans, for use anywhere in a script. - [REST API Functions](https://resources.sahipro.com/docs/sahi-script/functions/rest-api.md): Sahi exposes RESTRequest and RESTResponse APIs to work with REST APIs - [Include Functions](https://resources.sahipro.com/docs/sahi-script/functions/include.md): To reuse a function from one script in another, we include the relevant script using the include APIs. You may also like to see Including Sahi script globally - [Logging Functions](https://resources.sahipro.com/docs/sahi-script/functions/logging.md): Logging functions allow adding additional information to test run reports. - [Screenshot Functions](https://resources.sahipro.com/docs/sahi-script/functions/screenshots.md): Sahi's Screenshot functions takes the screen/browser screen-shot while running the sahi scripts. - [Debug Helper Functions](https://resources.sahipro.com/docs/sahi-script/functions/debug-helpers.md): Some functions are good for debugging Sahi scripts. They are mostly removed once debugging is done. - [Script and Suite Info Functions](https://resources.sahipro.com/docs/sahi-script/functions/script-suite-info.md) - [Script Execution Control Functions](https://resources.sahipro.com/docs/sahi-script/functions/script-execution-control.md): These functions control the way a script executes - [Execute External Programs](https://resources.sahipro.com/docs/sahi-script/functions/execute-external-programs.md): Sahi allows calling external programs via _execute or by calling Java directly - [Utility Functions](https://resources.sahipro.com/docs/sahi-script/functions/utilities.md) - [Documentation Functions](https://resources.sahipro.com/docs/sahi-script/functions/documentation.md): Create documentation with screenshots from existing scripts: use the _startDocumentation and _stopDocumentation functions in your script, and run it. ## FAQs - [Evaluation Questions](https://resources.sahipro.com/docs/faq/evaluation-questions.md) - [Using license file](https://resources.sahipro.com/docs/faq/using-license-data.md) - [Miscellaneous](https://resources.sahipro.com/docs/faq/misc-questions.md) - [Other Resources](https://resources.sahipro.com/docs/faq/other-resources.md) - [How does Sahi identify elements?](https://resources.sahipro.com/docs/faq/how-are-elements-identified.md) - [How is _under different in 5.x.y?](https://resources.sahipro.com/docs/faq/_under-in-5-x-y.md) - [Getting the text of a tool tip](https://resources.sahipro.com/docs/faq/get-tooltip-text.md) - [Getting cell data from a table](https://resources.sahipro.com/docs/faq/get-cell-data.md) - [How do I extract visible text of a div that changes dynamically?](https://resources.sahipro.com/docs/faq/extract-dynamic-text.md) - [How do I extract partial text that changes dynamically?](https://resources.sahipro.com/docs/faq/extract-partial-text.md) - [How to scroll](https://resources.sahipro.com/docs/faq/how-to-scroll.md) - [File Downloads](https://resources.sahipro.com/docs/faq/downloads.md) - [How to delete cookies](https://resources.sahipro.com/docs/faq/delete-cookies.md) - [Handling streaming responses](https://resources.sahipro.com/docs/faq/handling-streaming-responses.md) - [How can I access a Microsoft Outlook email from a Sahi script?](https://resources.sahipro.com/docs/faq/access-outlook-email.md) - [How can I automate FTP file transfer?](https://resources.sahipro.com/docs/faq/how-can-i-automate-ftp-file-transfer.md) - [Accessing Web Services through REST APIs](https://resources.sahipro.com/docs/faq/webservices.md) - [Writing Unit tests - A Use Case](https://resources.sahipro.com/docs/faq/unit-tests.md) - [Debugging slowness - Using Diagnose](https://resources.sahipro.com/docs/faq/diagnose.md) - [Multiple Scripts folders and Network Share](https://resources.sahipro.com/docs/faq/multiple-scripts-folders-and-network-share.md) - [UserDefinedId](https://resources.sahipro.com/docs/faq/userdefinedid.md) - [How to login automatically on windows](https://resources.sahipro.com/docs/faq/auto-logon.md) - [Working with Minimised and Closed Remote Desktop Connections](https://resources.sahipro.com/docs/faq/remote-desktop-connection.md) - [Steps to run Sahi Pro from Windows Task Scheduler](https://resources.sahipro.com/docs/faq/how-to-start-runner-as-service.md) - [How to show custom fields in reports](https://resources.sahipro.com/docs/faq/how_to_show_custom_fields_in_reports.md) - [How to customize HTML reports](https://resources.sahipro.com/docs/faq/how-to-customize-html-reports.md) - [How to collect Javascript Code Coverage for multiple domain?](https://resources.sahipro.com/docs/faq/javascript-code-coverage-for-multiple-domain.md) - [Eclipse configuration for Syntax Highlighting, Template proposals and Refactoring in Sahi scripts](https://resources.sahipro.com/docs/faq/eclipse-integration.md) - [Sahi with Notepad++](https://resources.sahipro.com/docs/faq/sahi-with-notepad++.md) - [Sahi with TextPad](https://resources.sahipro.com/docs/faq/sahi-with-textpad.md) ## Troubleshooting - [Startup Issues](https://resources.sahipro.com/docs/troubleshooting/startup-issues.md) - [Troubleshooting Page Loading or Rendering Problems](https://resources.sahipro.com/docs/troubleshooting/page-rendering.md) - [Editor opening issues](https://resources.sahipro.com/docs/troubleshooting/https-localhost-issues.md) - [Drag and drop issues](https://resources.sahipro.com/docs/troubleshooting/drag-drop-issues.md) - [Eclipse integration issues](https://resources.sahipro.com/docs/troubleshooting/eclipse-integration-issues.md) - [Email related issues](https://resources.sahipro.com/docs/troubleshooting/send-email-issues.md) - [Flex Issues](https://resources.sahipro.com/docs/troubleshooting/flex-issues.md) - [Calling custom Java code](https://resources.sahipro.com/docs/troubleshooting/calling-custom-java-code.md) - [Windows Automation Issues](https://resources.sahipro.com/docs/troubleshooting/windows-automation-issues.md) - [Oracle Forms Issues](https://resources.sahipro.com/docs/troubleshooting/oracle-forms-issues.md) - [Proxy Issues](https://resources.sahipro.com/docs/troubleshooting/proxy-issues.md) - [SSL Issues](https://resources.sahipro.com/docs/troubleshooting/ssl-issues.md) - [File upload with full path in Internet Explorer](https://resources.sahipro.com/docs/troubleshooting/fileupload-with-fullpath-ie.md) - [Performance Issues in Test Runs](https://resources.sahipro.com/docs/troubleshooting/playback-performance-issues.md) - [Miscellaneous Issues](https://resources.sahipro.com/docs/troubleshooting/misc-issues.md) - [Issues in Microsoft Edge versions 44.19041 and below](https://resources.sahipro.com/docs/troubleshooting/microsoft-edge-issues.md) - [Issues in Safari browser](https://resources.sahipro.com/docs/troubleshooting/safari-issues.md) - [Screenshot Issues in Mac OS](https://resources.sahipro.com/docs/troubleshooting/mac-screenshot-issues.md) - [Issues in Chromium based browsers](https://resources.sahipro.com/docs/troubleshooting/chrome-issues.md) - [Issues in Firefox browser](https://resources.sahipro.com/docs/troubleshooting/firefox-issues.md) ## Flowcharts (archived) - [Introduction to Sahi Pro Flowcharts](https://resources.sahipro.com/docs/flowcharts/introduction-to-flowcharts.md): Sahi Pro Flowcharts is a no-code, visual way of representing and automating test flows. - [Install Sahi Pro](https://resources.sahipro.com/docs/flowcharts/install-sahi-pro.md) - [Create a Flowchart](https://resources.sahipro.com/docs/flowcharts/create-flowchart.md): Create your first flowchart - [Automate the Flowchart](https://resources.sahipro.com/docs/flowcharts/automate-flowchart.md): To automate a flow, we need to map the flowchart node to the actions performed on the application. - [Data Drive](https://resources.sahipro.com/docs/flowcharts/data-drive.md) - [Example: User Registration](https://resources.sahipro.com/docs/flowcharts/example-registration.md): Set up an example to showcase Data Drive concepts of Flowcharts - [Organize Automation Artifacts using Quick Extract](https://resources.sahipro.com/docs/flowcharts/quick-extract.md): For maintainable automation, we need to organize UI Element identifiers, the data values being passed etc. meaningfully. Quick Extract extracts UI Elements and data values and stores them with the relevant Entity Attribute. - [Repeatable Tests - Data Generator](https://resources.sahipro.com/docs/flowcharts/data-generator.md): We can create unique data for repeated execution using Data Generators. - [Positive Validations](https://resources.sahipro.com/docs/flowcharts/positive-validations.md): Positive Validations are test flows that verify that the application works correctly for specific valid data. - [Negative Validations](https://resources.sahipro.com/docs/flowcharts/negative-validations.md): Applications should correctly reject invalid data and show meaningful error messages. Negative Validations are test flows that input such invalid data and verify the error messages. - [Negative Validations](https://resources.sahipro.com/docs/flowcharts/validation-boundary.md): Setting up Validation Boundary allows validation checks only on the specified keywords. - [Loop over Dataset](https://resources.sahipro.com/docs/flowcharts/dataset.md): Datasets allow running the same path with multiple sets of data. This is useful for: Data setup Verifying against calculations - [Flowchart Paths and Branches](https://resources.sahipro.com/docs/flowcharts/flowchart-paths.md): There can be multiple paths/flows in a Flowchart. This allows grouping of similar test flows together. - [Run/Execute Flows](https://resources.sahipro.com/docs/flowcharts/run.md): Run Settings dialog has various settings options which can be used in different scenarios. - [Types of Run](https://resources.sahipro.com/docs/flowcharts/types-of-run.md): Flowcharts can be run at the Path, Flowchart or Project level. - [Playback via Ant](https://resources.sahipro.com/docs/flowcharts/playback-via-ant.md): This section describes playing back Sahi Flowcharts via Apache Ant. - [Playback via Gradle](https://resources.sahipro.com/docs/flowcharts/playback-via-gradle.md): This section describes playing back Sahi Flowcharts via Gradle. - [Integrate with Jenkins](https://resources.sahipro.com/docs/flowcharts/integrate-with-jenkins.md): Jenkins and other Continuous Integration systems can trigger Sahi Pro Flowcharts as part of the build process using Sahi's ANT target. - [Playback via Command Line](https://resources.sahipro.com/docs/flowcharts/playback-commandline.md): During development, paths will be played back from the Run Settings dialog. For Continuous Integration systems, create an ANT target and trigger from there. This section describes a way of triggering paths from the command line via bat files or shell scripts. - [Reports](https://resources.sahipro.com/docs/flowcharts/reports.md) - [Suite Analysis](https://resources.sahipro.com/docs/flowcharts/suite-analysis.md): Suite Analysis is designed to help identify and quickly fix the steps causing most failures in flowcharts execution. Historical results for each flowchart which have at least one failure history are also provided. This feature is available since Sahi Pro V11.5.0. - [Flowcharts Controller](https://resources.sahipro.com/docs/flowcharts/flowcharts-controller.md): The Flowcharts Controller helps identify elements, interact with the Application Under Test and implement automation steps. - [Raw Script Step](https://resources.sahipro.com/docs/flowcharts/raw-step.md): Raw Script allows calling custom Sahi script code as part of a Keyword implementation. - [Automate REST API Calls](https://resources.sahipro.com/docs/flowcharts/rest-api.md): As part of a test flow, we may need to call some webservice via REST APIs. The REST API Call Step in Flowcharts allows calling and verifying REST API calls. - [Callbacks](https://resources.sahipro.com/docs/flowcharts/callbacks.md): Callbacks are user-defined keywords that are automatically executed at various points of the path life cycle. - [Test Case](https://resources.sahipro.com/docs/flowcharts/testcase.md) - [Salesforce Test Automation](https://resources.sahipro.com/docs/flowcharts/salesforce.md) - [Integrate with Existing Sahi Pro Classic Codebase](https://resources.sahipro.com/docs/flowcharts/existing-sahi.md): Existing Sahi Pro users may want to move to Sahi Pro Flowcharts for newer projects. Flowcharts allows re-use of existing functions, scripts and suites from existing Sahi Pro Classic codebase. - [Version Control and Collaboration](https://resources.sahipro.com/docs/flowcharts/version-control.md): When working on any big software project, we need version control of automation artifacts. Version Control allows individuals to work independently with their own copy of files/artifacts and prevents overwriting or clobbering another person's work. It also helps us associate specific artifacts with specific versions of the application under test. We recommend using Git for version control. - [Entity Attributes](https://resources.sahipro.com/docs/flowcharts/entity-attributes.md): Entity Attributes are simple but powerful. There are 3 kinds of Entity Attributes Data Attributes Constant Attributes State Attributes - [Precondition Matching](https://resources.sahipro.com/docs/flowcharts/precondition-matching.md): Precondition Matching is a powerful feature of Flowcharts. When dealing with complex flows, Precondition Matching allows us to separate the setup steps from the business rules. - [Override Behaviour](https://resources.sahipro.com/docs/flowcharts/overrides.md): Automation may need to support variations in implementation based on various factors. - [Dynamic/Runtime Conditions](https://resources.sahipro.com/docs/flowcharts/dynamic-conditions.md): Dynamic Conditions can be used to detect the runtime state of the application UI and branch accordingly. - [Variable Templates](https://resources.sahipro.com/docs/flowcharts/variable-templates.md): Variable Templates allow the user to reference variable values in string parameters. During execution of the flow, the referenced variable will be resolved and replaced with its current value. This allows the user to focus on the form of input, instead of worrying about correct syntax for concatenating variables in parameters. - [Sahi Pro Desktop Engine](https://resources.sahipro.com/docs/flowcharts/desktop-engine.md): Getting started with Sahi Pro Desktop Engine Automation. - [Windows Desktop Automation](https://resources.sahipro.com/docs/flowcharts/windows-desktop.md): This section details how to test Windows Desktop Applications. If you are not familiar with Sahi Pro Flowcharts, see Introduction to Sahi Pro Flowcharts To automate windows desktop applications using Sahi Pro Classic, refer Windows Desktop Automation. - [Java Web Start Automation](https://resources.sahipro.com/docs/flowcharts/javaws.md): This section details how to test Java Web Start Automation. If you are not familiar with Sahi Pro Flowcharts, see Introduction to Sahi Pro Flowcharts To automate java applications using Sahi Pro Classic, refer Java Web Start Automation. - [Java GUI Application Automation](https://resources.sahipro.com/docs/flowcharts/java-application.md): This section details how to test Java Application. If you are not familiar with Sahi Pro Flowcharts, see Introduction to Sahi Pro Flowcharts To automate java applications using Sahi Pro Classic, refer Java GUI Application Automation. - [Applet Automation](https://resources.sahipro.com/docs/flowcharts/applet-new.md): This section details how to test Java Applets. If you are not familiar with Sahi Pro Flowcharts, see Introduction to Sahi Pro Flowcharts. - [Sahi Pro Mobile Engine](https://resources.sahipro.com/docs/flowcharts/mobile-engine.md): Getting started with Sahi Pro Mobile Engine Automation. - [Android Automation - Getting Started](https://resources.sahipro.com/docs/flowcharts/android-getting-started.md): This section helps you quickly get started with Android Automation. To automate an Android Devices/Simulators using Sahi Pro Classic, refer Android Automation - Getting Started. - [Automating Android Apps - Details](https://resources.sahipro.com/docs/flowcharts/android-details.md): This page describes Android Automation in detail. If you wish to get a quick start, read Android Automation - Getting Started. - [iOS Automation - Getting Started](https://resources.sahipro.com/docs/flowcharts/ios-getting-started.md): This section helps you quickly get started with iOS Automation. To automate an IOS Devices/Simulators using Sahi Pro Classic, refer iOS Automation - Getting Started. - [Automating iOS Apps - Details](https://resources.sahipro.com/docs/flowcharts/ios-details.md): This page describes iOS Automation in detail. If you wish to get a quick start, read iOS Automation - Getting Started. - [Sahi Pro SAP Engine](https://resources.sahipro.com/docs/flowcharts/sap-engine.md): Getting started for automation with Sahi Pro SAP Engine Automation. - [SAP GUI Automation - Getting Started](https://resources.sahipro.com/docs/flowcharts/sap-gui-getting-started.md): This section details how to test SAP GUI Applications. If you are not familiar with Sahi Pro Flowcharts, see Introduction to Sahi Pro Flowcharts To automate SAP GUI applications using Sahi Pro Classic, refer SAP GUI Automation - Getting Started. - [Sahi Pro Visual Assist Engine](https://resources.sahipro.com/docs/flowcharts/visual-assist-add-on.md): Getting started for automation with Sahi Pro Visual Assist Engine Automation. - [Visual Assist Automation - Getting Started](https://resources.sahipro.com/docs/flowcharts/visual-assist-getting-started.md): This section helps you quickly get started with Visual Assist Automation. To automate computer vision and machine learning algorithms using Sahi Pro Classic, refer Visual Assist Automation - Getting Started. - [Action APIs](https://resources.sahipro.com/docs/flowcharts-actions/action-apis.md): Sahi Pro Flowchart's Actions simulate user actions on the application screen. - [Assertions](https://resources.sahipro.com/docs/flowcharts-actions/assertions.md): Assertions compare runtime behaviour against expected behaviour. Assertions are used for "verification" or "checking" of functionality - [Screenshot APIs](https://resources.sahipro.com/docs/flowcharts-actions/screenshot-apis.md): Sahi's Screenshot APIs takes the screen/browser screen-shot while running the sahi scripts. - [Include APIs](https://resources.sahipro.com/docs/flowcharts-actions/include-apis.md): To reuse a function from one script in another, we include the relevant script using the include APIs. You may also like to see Including Sahi script globally - [Fetch APIs](https://resources.sahipro.com/docs/flowcharts-actions/fetch-apis.md): While working on scripts, we often need to fetch content from the application screen. Examples may be: Fetching and storing a generated userId for later use in script Getting the value of form field for verification Getting the text from a UI element for assertion Getting some particular attribute of a UI element, like href of a link - [Data Generator APIs](https://resources.sahipro.com/docs/flowcharts-actions/data-generator-apis.md): The Data Generator APIs create random test data such as text, phone numbers, numbers, email addresses, dates, and booleans, for use anywhere in a script. - [Logging APIs](https://resources.sahipro.com/docs/flowcharts-actions/logging-apis.md): Logging APIs allow adding additional information to playback logs. - [APIs used in Debugging Sahi Scripts](https://resources.sahipro.com/docs/flowcharts-actions/debug-helper-apis.md): Some APIs are good for debugging Sahi scripts. They are mostly removed once debugging is done. - [File Manipulation APIs](https://resources.sahipro.com/docs/flowcharts-actions/file-apis.md) - [Excel Sheet Manipulation APIs](https://resources.sahipro.com/docs/flowcharts-actions/excel-apis.md) - [URL APIs](https://resources.sahipro.com/docs/flowcharts-actions/url-apis.md): APIs for reading content from URLs - [Script Suite Info APIs](https://resources.sahipro.com/docs/flowcharts-actions/script-suite-info-apis.md) - [Script Execution Control APIs](https://resources.sahipro.com/docs/flowcharts-actions/script-execution-control-apis.md): These APIs control the way a script executes - [HTTP Header Manipulation APIs](https://resources.sahipro.com/docs/flowcharts-actions/http-header-manipulation-apis.md): These APIs help manipulate HTTP headers to test behaviour of modified browsers or devices. - [HTTP Response Manipulation APIs](https://resources.sahipro.com/docs/flowcharts-actions/http-response-manipulation-apis.md): These APIs help manipulate HTTP response of browsers or devices. - [URL Mock APIs](https://resources.sahipro.com/docs/flowcharts-actions/url-mock-apis.md) - [Javascript Dialogs](https://resources.sahipro.com/docs/flowcharts-actions/javascript-dialogs.md) - [Rich Text Editors (RTE)](https://resources.sahipro.com/docs/flowcharts-actions/rte-apis.md): Rich Text Editors (RTEs) are iframes/divs whose designMode or contentEditable property is set to true. Such components allow input of text and formatting them (making text bold, inserting images etc.) - [Secondary Windows (Popup Windows)](https://resources.sahipro.com/docs/flowcharts-actions/popup-windows.md): Applications may open secondary windows as a new window or in a new tab. This section shows how to automate secondary windows. - [Multiple Domains in a Page](https://resources.sahipro.com/docs/flowcharts-actions/multiple-domains.md) - [Frames and IFrames](https://resources.sahipro.com/docs/flowcharts-actions/frames-domains.md) - [Multiple Browser Instances in Single Script](https://resources.sahipro.com/docs/flowcharts-actions/multiple-browsers.md) - [Multi Language Support](https://resources.sahipro.com/docs/flowcharts-actions/multi-language.md): Websites may be enabled in multiple languages like English, Spanish, Chinese etc. Sahi Pro's multi-language support allows testing of websites in any language using the same scripts as long as translations are available. In most applications, Internationalization (I18N) and Localization (L10N) are done by specifying constant keys in web application code, and then having another layer substitute these constant keys with the correct language translations provided via resource files. These translations are normally kept in resource files. Eg. en.properties (english), de.properties (german), Resources.de.resx (german), resources.fr.xaml (french), etc. Since Sahi Pro scripts rely on visible text, the scripts may be recorded with English text. To play it on the German version, the script needs to be passed the English and German resource files. For example, when Sahi encounters an English string, it will look up the corresponding key in en.properties, then lookup the German value for that key in de.properties file and then use that value during execution. - [Execute External Programs](https://resources.sahipro.com/docs/flowcharts-actions/execute-external-programs.md): Sahi allows calling external programs via _execute or by calling Java directly - [Utility APIs](https://resources.sahipro.com/docs/flowcharts-actions/util-apis.md) - [Alignment APIs](https://resources.sahipro.com/docs/flowcharts-actions/alignment-apis.md): Alignment APIs can be used for checking alignment of one element with respect to the other. With which one can check alignment of different elements on different screen sizes i.e. to check responsiveness. A sample test page is added at Sahi_Pro\htdocs\demo\alignmentTestPage.htm and a sample test script is added at Sahi_Pro\userdata\scripts\demo\testAlignmentAPIs.sah to give a better understanding of these APIs. - [Layout verification APIs](https://resources.sahipro.com/docs/flowcharts-actions/layout-verification.md): The following APIs are used for testing the layout of a webpage. It is useful to test responsive design. - [Web Crawler APIs](https://resources.sahipro.com/docs/flowcharts-actions/web-crawler-apis.md): Web Crawler APIs are used to navigate to all pages of a website to check if the links are working. - [Documentation APIs](https://resources.sahipro.com/docs/flowcharts-actions/document-creation.md): Sahi As Documentation Tool describes how to create documentation while recording a new Sahi script. But what if we wanted to create documentation for previously created scripts? Sahi's Documentation APIs allow you to do just that. Use the _startDocumentation and _stopDocumentation APIs in your script, and execute the script to create documentation with screenshots. - [Windows APIs](https://resources.sahipro.com/docs/flowcharts-actions/windows-apis.md) - [Java APIs](https://resources.sahipro.com/docs/flowcharts-actions/java-apis.md) - [Mobile APIs](https://resources.sahipro.com/docs/flowcharts-actions/mobile-apis.md): Mobile APIs help automate Android and iOS apps. This page lists information about Non Accessor Mobile APIs. Refer to Android Accessor APIs and iOS Accessor APIs for details on Mobile Accessor APIs. - [Mobile Common APIs](https://resources.sahipro.com/docs/flowcharts-actions/mobile-common-apis.md): This page lists the APIs common to both Android and iOS. These APIs have a _m prefix in camel case, example: _mSwipeLeft. These APIs work on an Android device/simulator as well as on an iOS device/simulator. - [Android APIs](https://resources.sahipro.com/docs/flowcharts-actions/android-apis.md): This page lists the APIs specific to Android. These APIs have an _a prefix in camel case, example: _aPressBack. These APIs will work only on an Android device/emulator. - [iOS APIs](https://resources.sahipro.com/docs/flowcharts-actions/ios-apis.md): This page lists the APIs specific to iOS. These APIs have an _i prefix in camel case, example: _iRotate. These APIs will work only on an iOS device/simulator. - [Multiple Mobile Device Instances in Single Script](https://resources.sahipro.com/docs/flowcharts-actions/multiple-mobile-devices.md) - [SAP APIs](https://resources.sahipro.com/docs/flowcharts-actions/sap-apis.md): SAP GUI automation is supported since Sahi Pro SAP Engine. - [Visual Assist APIs](https://resources.sahipro.com/docs/flowcharts-actions/visual-assist-apis.md): Visual Assist automation is supported since Sahi Pro Visual Assist Engine. - [Sahi Accessor API Basics](https://resources.sahipro.com/docs/ui-elements/accessor-api-basics.md) - [Relation APIs](https://resources.sahipro.com/docs/ui-elements/relation-apis.md) - [Browser Accessor APIs](https://resources.sahipro.com/docs/ui-elements/accessor-apis.md) - [Generic Accessor APIs](https://resources.sahipro.com/docs/ui-elements/generic-accessor-apis.md) - [Accessor APIs - Polymer Elements](https://resources.sahipro.com/docs/ui-elements/polymer-accessor-apis.md) - [Salesforce Accessor APIs](https://resources.sahipro.com/docs/ui-elements/salesforce-accessor-apis.md) - [Java Accessor APIs](https://resources.sahipro.com/docs/ui-elements/java-accessor-apis.md) - [Oracle Accessor APIs](https://resources.sahipro.com/docs/ui-elements/oracle-applet-accessor-apis.md) - [Windows Accessor APIs](https://resources.sahipro.com/docs/ui-elements/windows-accessor-apis.md) - [Android Accessor APIs](https://resources.sahipro.com/docs/ui-elements/android-accessor-apis.md) - [iOS Accessor APIs](https://resources.sahipro.com/docs/ui-elements/ios-accessor-apis.md) - [SAP Accessor APIs](https://resources.sahipro.com/docs/ui-elements/sap-accessor-apis.md) - [Visual Assist Accessor APIs](https://resources.sahipro.com/docs/ui-elements/visual-assist-accessor-apis.md): Sahi Pro Visual Assist Accessor APIs provide Artificial Intelligence capabilities to automate applications by using computer vision and machine learning algorithms. It is supported since Sahi Pro Visual Assist Engine. ## Other pages - [F.A.Q.](https://resources.sahipro.com/docs/faq.md): This section lists some frequently asked questions. - [Title Missing](https://resources.sahipro.com/docs/flowcharts.md) - [Title Missing](https://resources.sahipro.com/docs/flowcharts-actions.md) - [Applet Automation Using Browser And Desktop Automation](https://resources.sahipro.com/docs/flowcharts/applet-automation-using-browser-and-desktop-automation.md): This section details how to automate Java Applets using Browser And Desktop Automation. If you are not familiar with Applet Automation, refer Applet Automation. To automate a java applets using Sahi Pro Classic, refer Applet Automation Using Browser And Desktop Automation. - [Applet Automation Using Only Desktop Automation](https://resources.sahipro.com/docs/flowcharts/applet-automation-using-desktop-automation.md): This section details how to automate Java Applets using only Desktop Automation. If you are not familiar with Applet Automation, refer Applet Automation. To automate a java applets using Sahi Pro Classic, refer Applet Automation Using Only Desktop Automation. - [Automate Database Calls](https://resources.sahipro.com/docs/flowcharts/database.md) - [Migrate from Test Flow Charts](https://resources.sahipro.com/docs/flowcharts/migrate-from-tfc.md): Test Flow Charts (app.testflowcharts.com) was the online version of Sahi Pro Flowcharts. TestFlowCharts has been discontinued and will no longer be available. Existing users can migrate their projects from app.testflowchart.com to Sahi Pro Flowcharts. - [Miscellaneous Topics](https://resources.sahipro.com/docs/flowcharts/misc.md) - [File Missing](https://resources.sahipro.com/docs/flowcharts/missing.md) - [Sahi Pro Starter](https://resources.sahipro.com/docs/introduction/sahi-pro-starter-index.md): Sahi Pro Starter is a free version of Sahi Pro with a limited set of features. - [Title Missing](https://resources.sahipro.com/docs/ui-elements.md) - [Using Sahi](https://resources.sahipro.com/docs/using-sahi.md) - [Applet Automation Using Browser And Desktop Automation](https://resources.sahipro.com/docs/using-sahi/applet-automation-using-browser-and-desktop-automation.md): This section details how to automate Java Applets using Browser And Desktop Automation. If you are not familiar with Applet Automation, refer Applet Automation. To automate a java applets using Sahi Pro Flowcharts, refer Applet Automation Using Browser And Desktop Automation. - [Applet Automation Using Only Desktop Automation](https://resources.sahipro.com/docs/using-sahi/applet-automation-using-desktop-automation.md): This section details how to automate Java Applets using only Desktop Automation. If you are not familiar with Applet Automation, refer Applet Automation. To automate a java applets using Sahi Pro Flowcharts, refer Applet Automation Using Only Desktop Automation.