Definitions, Critical Reminders, SAFS Tools, Install Instructions, Setup Notes, New Stuff
| SAFS | Software Automation Framework Support |
| SAFS Driver | The tool that initializes, opens, parses, and routes SAFS test records to available SAFS Engines. |
| SAFS Engine | A keyword-driven automation tool capable of interpreting and executing SAFS test records. |
| SAFS/DriverCommands | A SAFS Engine for tool-independent Driver Commands |
| SAFS/RobotJ | A SAFS Engine for testing using Functional Tester by IBM Rational. |
| SAFS/TC | A SAFS Engine for testing using TestComplete by AutomatedQA. |
| SAFS IBT | An embedded SAFS Engine for Image-Based Testing. (Patent Pending) |
This release of SAFS has been a long-time in the making. The primary focus of this release is to provide a simplified install process that supports STAF 3.X installing with Java 1.6. All the latest functionality of SAFS and supported tools like Rational Functional Tester and Image-Based Testing are included in this release.
The AutomatedQA TestComplete tool has not been evaluated for its support of STAF V3 and may also need to continue using STAF V2. However, the DDVariableStore.DLL presumably used by TestComplete has been refactored to support both STAF V2 and V3.
Affected customizations from previous releases:
If you have taken advantage of any of the customization capabilities of this framework, then you must take some simple precautions prior to installing this new release. Installing a new version of the framework will install new, default versions of customizable files.
SAFSTID.INI
If you have a modified SAFSTID.INI in your install directory, you should make a back-up,
then evaluate how and if you want to merge with the new file.
SAFS Batch Files
If you have previously installed the SAFS Framework then you may have manually
modified batch files or VBS scripts to handle custom project paths. You will need to
backup modified files and evaluate how and if you want to merge such changes with the new
files.
SAFS Project Files
If you have previously installed and edited any of the INI or BAT files in the SAFS\Project directory then you will need to backup these modified files and evaluate how and if you want to merge such changes with the new files.
SAFS Object Mapping Files
If you have previously installed and edited any of the following files then you will need to backup the modified files and evaluate how and if you want to merge your edits with the new (default) versions of these files:
Failure to perform any of these prescribed backups may erase your prior customizations. Hopefully, you have backed them up somewhere already as part of your normal ongoing activities. Right?!
Note: STAFWrap.DLL and DDVariableStore.DLL have been refactored in order to support both STAF V2.X and STAF V3.X
STAFWrap.DLL, ComponentFunctions.DLL, DDVariableStore.DLL and associated scripts for registering DVariableStore.DLL are included in the SAFS\bin directory. The SetupSAFS script does register and\or move files to system directories as necessary.
COM classes supporting COM access to STAF for use in VBScript and other COM-related features exist in the latest version of DDVariableStore.DLL. Consult the sourcecode in CVS or any VBA or COM object browser until more proper documentation is made available. A very rudimentary "RUTHere" test script for this COM STAF interface can be found in SAFS\bin\DDVariableStoreTest.VBS .
A Java Runtime Environment (JRE) and Windows Scripting Host V5.6 or later is required. Refer to SetupSAFS.README in the Java Runtime and Windows Scripting Host sections for more details and install information for those tools.
RRAFS (Rational Robot) users might do best to extract into their ".\Rational\Rational Test\sqabas32" directory. (Although this should not be necessary with a RRAFS release since that includes the SAFS install files already. Only do this if you are upgrading SAFS without upgrading RRAFS.)
Enable "OVERWRITE Existing Files" if you are overwriting a previous release of SAFS.
SetupSAFS.wsf will prompt to confirm for the installation of the SAFS Framework and
the version of STAF to install, if any. The user has the option to skip these installations by pressing "No" or "Cancel" when prompted.
You do not need to reinstall STAF if you already have STAF installed. However, you may wish to reinstall STAF to overwrite STAF 2.X with the new STAF V3.X version.
SetupSAFS.wsf will not install any program that will appear in Control Panel's "Add/Remove Program" application.
| SetupSAFS.README | Install STAF and SAFS Services |
| SetupRuntime.README | Runtime Setup for Testing |
| SetupRobotJ.README | Optionally, setup Rational Functional Tester to use STAF and SAFS Services. |
Carl Nagle, SAS Project Manager, SAFSDEV Subscribe to appropriate Support Forums to review support archives and ask questons.