2.6.1  Test, Assurance & Documentation (TAD) Standards and Procedures

2.6.1.1  (03-01-2010)
IRM Structure

  1. This manual comprises the following subsections:

    1. The subsection 2.6.1.2 "Introduction and Purpose" describes how this manual is organized, states the purpose of the manual, defines terms used in the manual, identifies personnel affected by the manual, and identifies other documents associated with the manual.

    2. The subsection 2.6.1.3 "Systems Acceptability Test (SAT)" summarizes what the SAT is, when it is conducted, where (the technical environment) it is conducted, and how it is conducted.

    3. The subsection 2.6.1.4 "Test Procedures" summarizes and then details software testing procedures.

    4. The subsection 2.6.1.5 "Testing Templates" identifies where templates for test products are stored and how to obtain copies.

    5. The subsection 2.6.1.6 "Final Integration Test (FIT)" summarizes what the FIT is, when it is conducted, where (the technical environment) it is conducted, and how it is conducted.

    6. The subsection 2.6.1.7 "TAD Interface Database" summarizes the roles and responsibilities for documenting of interface files between projects.

    7. The subsection 2.6.1.8 "TAD Test Automation Procedures" identifies how to determine uses of automation software, how to initiate a Request for Computer Services (RCS) and how to submit project status reports via TAD Status Reporting System (TSRS).

    8. The subsection 2.6.1.9 "Enterprise File Transfer Utility (EFTU)" summarizes the process necessary to move and/or exchange files from one platform to another.

    9. The subsection 2.6.1.10 "TAD Systemic Processing" summarizes activities available to process data systemically to emulate production processing.

    10. The subsection 2.6.1.11 "Source Code and Documentation Control (SCDC) Branch" identifies the process of moving new programs to different libraries (e.g., SAT, FIT and Production).

    11. The subsection 2.6.1.12 "UNISYS and IBM Naming Standards" identifies the structure used to name files needed for testing.

    12. The subsection 2.6.1.14 "National Office Directed Travel (NODT) Letter and Field Support" identifies the procedures for requesting field support from the campuses.

2.6.1.2  (03-01-2010)
Introduction and Purpose

  1. This manual defines the Systems Acceptability Test (SAT) activities and test products, and documents the testing procedures for analysts who verify that software:

    • Adheres to standards for systems development

    • Complies with approved processing requirements

    • Meets customer needs

  2. These testing procedures provide a standard frame work for Test analysts and Contractors working for Applications Development (AD) conducting a SAT where test outcomes inform decisions whether software is ready for deployment.

  3. Test, Assurance & Documentation (TAD) plans, develops schedules and conducts SAT, Governments Acceptance Test (GAT), and/or Final Integration Tests (FIT) of selected processing systems.

  4. TAD also provides source code and documentation control, integration, and system specific site builds.

  5. TAD provides an environment for testing and integrating modernizations and production systems that emulate the target environment.

    Note:

    A GAT may be conducted for selected modernization processing systems. All GAT's should be conducted according to IRM 2.6.1.

2.6.1.2.1  (03-01-2010)
Definitions

  1. The terminology used in this manual is defined in the Glossary ( See Exhibit 2.6.1-27.) and Acronyms ( See Exhibit 2.6.1-28.) .

2.6.1.2.2  (03-01-2010)
Affected Personnel

  1. The controls established in this Internal Revenue Manual (IRM) apply to Agency personnel and contractors responsible for testing Internal Revenue Service (IRS) software systems. Agency personnel who contract for testing support shall ensure contracts comply with test controls.

2.6.1.2.3  (03-01-2010)
References

  1. The following documents have been referenced in this manual:

    • IRM 2.5.2 - Applications Development, Software Testing Standards and Procedures

    • IRM 2.5.7 - Data Name Standards

    • IRM 10.8.1 - Information Technology (IT) Security, Policy and Guidance

    • IRM 10.8.8 - Information Technology (IT) Security, Live Data (LD) Protection

2.6.1.3  (03-01-2010)
Systems Acceptability Test (SAT)

  1. In a SAT, testers ensure the designed and delivered software have met all customer requirements. This is accomplished by validating that the project or system performs as expected when subjected to controlled test cases and data for both valid and invalid conditions.

  2. Ideally, SAT is conducted where scope, cost and schedule are negotiated during project planning to ensure sufficient resources for the robust test. Resources include stable requirements, a viable physical design, an environment that adequately simulates production, as well as testers who have the requisite skill sets to prepare and execute the test.

  3. The SAT environment and technology emulates the production environment to the greatest degree possible to that in which the software is to be deployed. This means that the platform for applications, data, and peripheral components managed and used by operators and end users are consistent with the Production system.

  4. The test team is comprised of TAD analysts versed in the test life cycle activities based on the skill sets required to conduct the SAT. In addition, the test team may be supplemented with business, end user, and operations support.

  5. TAD Management establishes project testing priorities and allocates test resources through the TAD Project Prioritization Workload Planning Tool.

  6. TAD employees conducting a test will:

    • Work in partnership with their customers and developers to continually improve the quality of IRS information systems, products and services

    • Independently assess the quality of the application software by testing with controlled data to determine conformance of the system to customer requirements and to aid the customer and developer in determining the system’s production readiness

  7. Testing will be conducted according to See IRM 2.6.1.3.2. Testing Life Cycle procedures. A test:

    • Verifies and validates the software requirements through all available systems documentation

    • Evaluates life cycle deliverables to ensure they are clear, correct, complete and consistent

    • Validates the application software and ensures that interfaces with other systems function properly

    • Reviews specified deliverables for conformance to approved standards

    • Ensures deliverables are consistent with current IRS rules and regulations

  8. SAT begins with the receipt of requirements document(s) (e.g., Unified Work Request (UWR), Business Systems Requirements Report (BSRR) and Statement of Work (SOW), etc.).

2.6.1.3.1  (11-05-2010)
Test Types

  1. The following are the test types that will be conducted during the test lifecycle:

    • System Testing

    • Compatibility Testing

    • External Trading Partners Testing

    • Regression Testing

    • Accessibility Testing (508 Compliance)

    • User Acceptance Testing

    • Web Testing

2.6.1.3.1.1  (03-01-2010)
System Testing

  1. System testing is conducted to ensure system components are free of logic and design errors while satisfying the customer requirements. It is conducted for new code and existing applicable code.

  2. The objective of system testing is to validate not only functions of the system, but also to ensure that the system is structurally sound and robust, and capable of responding appropriately in all conditions.

  3. System testing is conducted to validate the core and specific functions within a system to satisfy requirements and confirm that changes work correctly when receiving data from and sending data to external systems.

  4. System Testing results are traceable to customer requirements and functional design documents.

  5. Conduct a system test for new requirements and existing requirements. Effective system testing should be repeatable.

  6. The process of conducting the system test involves the following steps:

    1. Create test cases and data

    2. Execute the system test cases planned

    3. Compare the actual results to the expected result

    4. Analyze all output to ensure all test success criteria are met

    5. If no difference in the result, record the test as successful

    6. If there is a difference, record and report the discrepancy as a defect

    7. If the expected result is incorrect, correct the expected result within the test case, and rerun the test, if needed

  7. Re-execute test cases in the regression test suite to ensure no new errors are created by corrections. (For more information on regression testing See IRM 2.6.1.3.1.4.).

  8. The system test is completed when:

    • All test condition items or test cases are executed

    • The tester is satisfied the software meets the requirements and design

    • The identified errors have been retested and resolved

    • All expected results have been verified as met and documented

    • Finalize documentation and update project folder

2.6.1.3.1.2  (11-05-2010)
Compatibility Testing

  1. Compatibility testing is conducted to ensure that unit and string tested programs accurately process data received from external programs/systems and accurately pass this data forward to subsequent programs/systems. The emphasis of this testing should be on data format, physical media, blocking factors (block/record length), padding and controls.

  2. Compatibility testing is conducted if the system exchanges files with other Software systems.

  3. Parties responsible for the systems impacted by a requirement participate in Compatibility Testing.

  4. Upon a coordinated team review of requirements and design, a designee for the system sending changed data enters an agreement for data exchange with the receiving system using a SAT Interface Database ( See IRM 2.6.1.7.).

  5. The process of conducting the Compatibility test involves the following steps:

    1. Identify the requirements and design driving the data changes

    2. Prepare an interface database agreement (Where many subsequent generations of a test file are anticipated, prepare separate agreements)

    3. Execute test cases designed for Compatibility Test data exchanges

    4. Review output to ensure correct data sent

    5. Communicate the test results between the originating and impacted sections

    6. Perform compatibility testing until impacted systems concur with test results

    7. Close out the agreement and place a copy of the interface database agreement in the project folder

2.6.1.3.1.3  (11-05-2010)
External Trading Partners Testing

  1. External trading partners testing is special testing conducted on programs that exchange files with an entity outside the IRS.

  2. The External Trading Partner must create and make available external trading partner's data.

  3. The Team Lead or designee will coordinate with all External Trading Partners to ensure a thorough test is conducted between IRS and external processes.

  4. The Section Chief or designee of the Originating Section and any Impacted Section must sign off on the Files Communication Status Report (FCSR). (For an example of the FCSR, See Exhibit 2.6.1-18. ).

2.6.1.3.1.4  (11-05-2010)
Regression Testing

  1. Regression testing is conducted to ensure changes to the system applications have not adversely affected previously tested functionality.

  2. Regression testing repeats key tests performed in the past and compares results of the new tests to the recorded actual results of the previously executed tests.

  3. Regression testing demonstrates software application integrity after changes are made to the configuration or environment of a system.

  4. Perform regression testing when there are changes to:

    • Software functions

    • Called library function

    • Operating system

    • Build procedures

  5. Regression testing can be performed for the complete product or it can be selective.

  6. Data must be consistent from test to test for comparable results.

  7. Test cases for regression testing are selected based on:

    • Previous system defect fixes, enhancement or changes

    • Impact of these changes on software application functionality

  8. Only portions of the software applications affected by modifications/enhancements and/or problem corrections are tested.

  9. The process of conducting the regression test includes the following steps;

    1. Evaluate, identify and test the portions of the software applications affected by modifications/enhancements and/or problem corrections

    2. Review expected results and resolve any new errors

    3. Re-run previous test against the changed software to ensure that the changes made in the current software do not affect other functionality

    4. Verify the system produces the expected results after changes/corrections to the software application have been applied

    5. Document the regression test results

    6. Update project folder

2.6.1.3.1.5  (11-05-2010)
Accessibility Testing (508 Compliance)

  1. The Rehabilitation Act of 1973, as amended, requires Electronic and Information Technology (EIT) developed, maintained, used, or procured by the Federal government be accessible to persons with disabilities.

  2. In 1998, Congress amended the Rehabilitation Act to add Section 508, which eliminates barriers in information technology. This made available new opportunities for people with disabilities, and encouraged the development of technologies to achieve these goals. The enforceable provisions of Section 508 apply to a broad range of EIT, from computer hardware and software to office equipment, such as fax and copy machines. Under Section 508 (29 U.S.C. 794d), agencies must give disabled employees and members of the public access to information that is comparable to the access available to others.

  3. Accessibility testing is the mechanism for ensuring EIT is accessible to people with disabilities. Typical disabilities can be classified into the following four groups, each of them with different access difficulties and issues:

    • Visual impairments - such as blindness, low or restricted vision, or color blindness. User with visual impairments uses assistive technology software that reads content aloud. User with weak vision can also make text larger with browser setting or magnification setting of operating system.

    • Motor skills - such as the inability to use a keyboard or mouse, or to make fine movements.

    • Hearing impairments - such as reduced or total loss of hearing.

    • Cognitive abilities - such as reading difficulties, dyslexia or memory loss.

    Note:

    Information on available services, accommodations, testing guidance and accessibility can be found on the Information Resources Accessibility Program (IRAP) website at http://irap.no.irs.gov/default.asp

2.6.1.3.1.6  (11-05-2010)
User Acceptance Testing

  1. The goal of User Acceptance Testing is to analyze the user experience through direct observation and evaluation. A usability test ensures the collection of systematic, recorded, quantifiable data and observation of user behaviors.

  2. At its simplest level, user acceptance or usability testing will determine whether a system works from the user’s perspective or whether it requires rework.

  3. User Acceptance Testing requires specific lab configurations and testing equipment.

  4. User Acceptance Testing should ideally involve direct user feedback and indirect feedback (observed behavior).

  5. The user acceptance testing methodology is based on conducting usability activity that coincides with the enterprise lifecycle. User Acceptance Testing must occur early in the life cycle to provide adequate time to resolve identified issues to ensure the cost of changes can be minimized.

  6. The activities listed below are designed to obtain user feedback through usability testing, thereby producing elements for the Usability Review, which summarizes the results of testing:

    • Each participant receives a short overview of the project site, an explanation of the test purpose, and a statement on how he/she will be observed and taped. He/she also must sign a video release.

    • Each participant performs his/her assigned task or tasks.

    • A final interview is held with the participant.

    • The data is analyzed, both qualitatively (comments of observers) and quantitatively (metrics involving time to completion of tasks, number of errors, etc.), problems diagnosed, and recommendations made.

    • Usability Review is finalized.

  7. It is the team lead’s responsibility to ensure that all usability activities are completed, as necessary.

    Note:

    See IRM 2.25.14, Portal Environment Usability Services for guidance on Usability Testing.

2.6.1.3.1.7  (11-05-2010)
Web Testing

  1. Web testing is a computer-based test delivered via the internet and written in the "language" of the internet, HTML and possibly enhanced by scripts .

  2. The Communications and Liaison Department (C&L) is responsible for managing the IRS intranet. The content and usability standards are implemented on all IRS intranet sites and updated periodically. These standards are intended to help ensure that intranet sites present content that is properly managed and easy to use and understand. Refer to the C&L Division web site, http://cl.no.irs.gov/intranet

  3. Testing considerations for web applications may include, but are not limited to the following:

    • Testing Browser and Operating System Compatibility – Test applications with as many browsers as possible (both well-known and less-known) as well as testing with older version of the same browsers (where applicable).

    • Applets and Cookies – When the user attaches to the application, the cookies or applets may be nonexistent on the users computer, existent but an earlier release/version, existent but corrupted, or existent and at the current level. Some users have security set to levels that prevent applets and cookies from being stored on their computers.

    • Capacity Testing – Use automated testing tools to simulate production use. Test for limits of the environment, volume the system can handle, simultaneous access to critical resources, system performance at known limits, and implement real-life, worst-case scenarios.

    • Security Testing – Measures that control various types of access to the web site: external intrusion and secure transactions.

    • Usability Testing – Verify that the site is easy to use and understand, users know how to use and interpret information received, site navigation is clear and correct.

    • Testing Recoverability – Verify that system can recover lost connections and timeouts, backups can be generated, the system can be restored properly from a backup, procedures exist to recover from crashes, orders that are "in progress" or in queue are not lost.

  4. Testing tools can improve testing reusability, predictability and testing time. The IRS organization will evaluate tools, gain an understanding of the expected benefits offered by different categories of tools, ensure that selected tools are appropriate for their environment and applications, and train testers in the use of the tools.

  5. Web sites must be tested after development and periodically while in maintenance to ensure compliance to accessibility standards. Accessibility standards are established to ensure that potential users with disabilities have the comparable access to web sites as users without disabilities.

  6. IRS approved testing tools must be used to verify accessibility on MITS/AD Web sites. The following are information accessibility standards that MITS/AD enforces:

    • Sections 508 compliance and certification is required by IRS. All web pages and elements must be fully accessible to all potential users with disabilities, as defined in the 1998 Rehabilitation Act, Section 508 (29 U.S.C.’794d).

    • World Wide Web Consortium (W3C) accessibility standards are recommended by IRS. W3C provides methods and standards beyond minimal Section 508 compliance.

    • IRS requires specific testing and/or certification using AccVerify®, JAWS®, and IRAP procedures to ensure compliance with Section 508.

    • AccMonitor is an automated web-testing tool, which is now available for web and application developers to evaluate and monitor IRS Internet and Intranet web sites for Section 508 compliance.

  7. JAWS (Job Access with Speech) is an assistive technology product for people with visual impairments. It provides users with information about software and websites via speech. JAWS relies on software and web developers to make sure their products conform to accessibility standards. JAWS is used for testing the functional performance of a product and identification of accessibility issues that may not be easily caught via manual (keyboard only) or software testing (AccVerify).

    Note:

    For rules and guidelines for creating accessible web content and applications on internal and external IRS web sites, refer to IRM 2.25.5, Accessibility Guidelines for the Web or the IRAP web site at http://irap.no.irs.gov/508/testing.asp

  8. Web Services standards for the development of IRS websites include content authoring languages, programming/scripting languages, and back-end applications, along with applications that provide developing interfaces.

  9. Development Methodology standards refer to the tools, applications, and languages acceptable for use in the production and maintenance of web sites in the IRS Intranet. These standards are primarily determined by the Portal Program Management Office. The Portal Program Management Office has the responsibility for providing detailed guidance on uniform database naming conventions, script naming, and software components within the IRS Intranet environment.

2.6.1.3.2  (11-05-2010)
Testing Life Cycle

  1. A SAT follows a basic precept - the "Testing Life Cycle" a "one size fits all" set of activities for software/system tests that includes four major phases ( See Exhibit 2.6.1-1.).

    1. Initiation Phase - Begins the test planning process to determine the test scope, cost, and schedule including logical requirements analysis. Activities below follow a general sequencing, some may occur concurrently:

      1. Review Lessons Learned and implement corrective action from a Post Implementation Review (PIR), if applicable

      2. Review requirement documents (UWR, SOW, etc) to evaluate, prioritize, assign or obtain resources for Mid-Year SAT, Annual SAT, or those tests that do not fall within Mid-Year or Annual Test

      3. Conduct requirements analysis and develop the Work Request Analysis Form (WRAF), Project Impact Assessment (PIA), Requirements Traceability Verification Matrix (RTVM) and Initiate Test Cases

      4. Define test scope, cost, requisite skills, and roles and responsibilities

      5. Establish the test environment ( See IRM 2.6.1.4.1.4.)

      6. Develop the SAT Plan and Work Breakdown Structure - Including a detailed Test Prep Schedule

      7. Submit request for Enterprise File Transfer Utility (EFTU) support, if applicable ( See IRM 2.6.1.9. Enterprise File Transfer Utility (EFTU))

      8. Submit Request for Computer Services (RCS), if applicable ( See IRM 2.6.1.8., TAD SAT Automation Procedures)

      9. Conduct Work Product Reviews ( See IRM 2.6.1.4.1.3. )

      10. Initiate Project Folder

      Note:

      Successful Exit Criteria: stable requirements; compliant design; agreed upon scope of test; test environment; test team; funding source.

    2. Preparation Phase - Refines test scope, develops test, tracks progress against schedule including physical design analysis against requirements. Activities below follow a general sequencing, some may occur concurrently.

      1. Conduct documentation review and complete requirements analysis

        • Review physical data and design documentation

        • Confirm physical design delivers to logical requirements

        • Develop and complete test cases

        • Develop and complete test data

        • Update RTVM

      2. Coordinate Interface Database Agreements with sending and receiving systems ( See IRM 2.6.1.7., TAD Interface Database)

      3. Coordinate Files Communication Status Report (FCSR), if applicable

      4. Work Product Review of the RTVM with Developers and customer to ensure agreement with requirements & test conditions

      5. Update the SAT Plan and Work Breakdown Structure, including a detailed Test Execution Schedule

      6. Issue SAT Plan

      7. Conduct Test Readiness Review (TRR) ( See IRM 2.6.1.4.1.6.)

      8. Develop and distribute Weekly Test Status Report - Monitor Test Case Development

      9. Provide input for Release Readiness Reporting ( See IRM 2.6.1.4.2.9.)

      10. Conduct Work Product Reviews ( See IRM 2.6.1.4.1.3. )

      11. Update Project Folder

      12. Confirm Test Environment

      Note:

      Successful Exit Criteria: agreed upon requirements translation to design: test cases and data suite; define the threshold (number of test cases passed verses days left in schedule) to report the SAT effort "at risk" when the test has fallen behind schedule.

    3. Execution Phase - Validates designed and delivered software products and requirements including test case disposition and reporting. Activities below follow a general sequencing, some may occur concurrently.

      1. Conduct test processing using test data to execute test cases

      2. Review output to validate test cases and identify defects

      3. Disposition all test cases

      4. Validate external data processing with sending and/or receiving systems

      5. Conduct Problem Reporting

      6. Update RTVM to capture test results

      7. Update and distribute Weekly Test Status Report - Monitor Test Case Execution

      8. Provide input for Release Readiness Reporting

      9. Finalize Interface Database Agreements

      10. Finalize FCSR, if applicable

      11. Create End of Test Status Report (EOTSR)

      12. Update Project Folder

      13. Update Work Breakdown Structure

      Note:

      Successful Exit Criteria: test cases completed and dispositioned within schedule; data changes processed by external sending and receiving systems; regular status reports for full transparency into test.

    4. Conclusion Phase - Closes out test. This phase includes issuing final test report. Activities below follow a general sequencing, some may occur concurrently.

      1. Monitor and support Mock Cycle and Production Startup, if applicable

      2. Disposition outstanding test cases

      3. Finalize RTVM

      4. Finalize Work Breakdown Structure

      5. Issue EOTSR

      6. Conduct and document Lessons Learned

      7. Conduct and document PIR

      8. Close out Project Folder

      9. Disposition outstanding issues and update the EOTSR, if applicable

      Note:

      Successful Exit Criteria: minor functional software Production issues reported; enriched Lessons Learned and PIR.

2.6.1.4  (11-05-2010)
Testing Procedures

  1. Software applications developed and maintained within the IRS or developed or maintained by contractors for the IRS that are subject to SAT will use these procedures to identify and resolve as many defects as possible before project deployment.

  2. These procedures cover:

    1. Test Activities:

      • Conduct Requirements Analysis

      • Perform Documentation Review and complete Requirements Analysis

      • Conduct Work Product Reviews

      • Establish Test Environment

      • Coordinate Interface Database Agreements and FCSR

      • Conduct Test Readiness Review (TRR)

      • Conduct Problem Reporting

      • Conduct Post Implementation Review (PIR)

    2. Test Products:

      • Work Breakdown Structure ( See Exhibit 2.6.1-2. )

      • Work Request Analysis Form ( See Exhibit 2.6.1-3.)

      • Project Impact Assessment Form (see the URL: http://wrts.web.irs.gov/Index.cfm and See Exhibit 2.6.1-4.)

      • Project Folder

        • Project Folder Checklist ( See Exhibit 2.6.1-5. )

      • Requirements Traceability Verification Matrix (RTVM) ( See Exhibit 2.6.1-6.)

      • Test Case

      • Test Data

      • Test Results

      • Test Readiness Review ( See Exhibit 2.6.1-11.)

      • SAT Plan ( See Exhibit 2.6.1-7.)

      • End of Test Status Report (EOTSR) ( See Exhibit 2.6.1-8.)

      • Weekly Test Status Report - TSRS ( See IRM 2.6.1.8.3.)

      • Release Readiness Reporting

      • Post Implementation Review Discussion Sheet ( See Exhibit 2.6.1-17.)

2.6.1.4.1  (03-01-2010)
Test Activities

  1. The following are the test activities conducted during the test.

2.6.1.4.1.1  (11-05-2010)
Conduct Requirements Analysis

  1. Requirements analysis is the cornerstone activity of a SAT. A requirement at its lowest decomposed level, provides specific information for a single function that is to be performed by the software application. A finite process exists by which a person or machine can verify that the system built meets the requirement (that is, the requirement is testable). Taken collectively, requirements completely define all system capabilities.

  2. Functional requirements describe capabilities that meet user needs; non-functional requirements address other capabilities, such as performance, security, and availability capabilities that must be included in the new system. A RTVM is developed to ensure that all requirements can be traced to specific capabilities identified in the applicable test cases for completeness and accuracy.

  3. High-level requirements are usually provided via a UWR using the following procedure:

    1. UWRs are generated in the Work Request Tracking System (WRTS)

    2. The Branch POC is responsible for ensuring each UWR is analyzed to provide a Project Impact Assessment (PIA) to the Primary Supplier or input directly into the UWR management system. (For an example of the Project Impact Assessment See Exhibit 2.6.1-4.)

    3. UWRs are assigned to test analysts for further analysis and testing

    4. The test analyst uses the Work Request Analysis Form (WRAF) ( See Exhibit 2.6.1-3.) to clarify and articulate their understanding of the high-level requirements documented in the UWR

    5. To ensure a complete understanding of the high-level requirements, the test analyst schedules and conducts a Work Product Review ( See IRM 2.6.1.4.1.3.) of the WRAF to address any outstanding questions or issues

    6. The test analyst determines the key high-level requirements to ensure the system continues to work as intended after the change is implemented. ( See IRM 2.6.1.3.1.4. for more information on Regression Testing)

    .

  4. The RTVM ( See IRM 2.6.1.4.2.5.) is created to track requirements and test conditions that must be validated by the end of the test.

  5. For location of the PIA, WRAF and RTVM templates See IRM 2.6.1.5., Testing Templates.

2.6.1.4.1.2  (11-05-2010)
Perform Documentation Review and Complete Requirements Analysis

  1. Documentation Review is the process of confirming the translation of requirements into documentation associated with the system development effort. The review serves to ensure test case requirements are mapped to functional documentation processes. The review also confirms operations for the system prior to the test execution phase.

  2. The following describes the documentation review activities to be performed by the test analyst:

    • Test analyst reviews several types of documents such as the Programming Requirements Package (PRP), Functional Specifications Package (FSP), Design Specification Package (DSP), Core Record Layout (CRL), Computer Operator Handbook (COH), RTVM, and other requirements and design document materials received from the Development organization to create test cases and test data

    • The RTVM ( See IRM 2.6.1.4.2.5.) is updated to include test cases and the associated test data information

    • An RTVM Review is conducted to ensure accuracy, testability and completeness of the test cases and test data

2.6.1.4.1.3  (03-01-2010)
Conduct Work Product Reviews

  1. Work product reviews are performed to ensure accuracy, completeness, and consistency in the test life cycle work products such as the WRAF, RTVM, SAT Plan, WBS, and EOTSR.

  2. Work product reviews are to be conducted as needed throughout the testing life cycle.

  3. Types of Work Product Reviews:

    1. Desk Checking - An individual assessment technique is used by the tester to improve his or her project, for example: tester checks his/her work product to ensure it meets specified objectives.

    2. Team Reviews/Walkthrough - An informal review is held in which the author of a work product describes it to a group of peers and solicits their comments. The participants receive materials several days prior to the meeting, and are expected to review the materials on their own. The team collects data on the review effort and the numbers of defects found. The overview and follow-up stages of the work product review is simplified or omitted.

    3. Inspections - The tester or meeting facilitator leads the meeting/inspection and presents the material to the reviewers. A designated individual will record issues as they are brought up during the meeting/inspection. At the end of the meeting/inspection, the team agrees on what items are actually defects that are to be reworked by the author.

    4. Ad hoc Reviews - An ad hoc review typically has no major structure or planning. They are usually held when the need arises and involves the product owner walking through a work product with one or more participants in an effort to solve a particular issue.

  4. The test project manager will assign an analyst to coordinate the following activities:

    • Work Product Review Process:

      1. Planning - Identifies the participants, work product, and type of review to be conducted and sets the review schedule.

      2. Overview - Members of the work product review team who are unfamiliar with the work product to be inspected receive orientation. This stage is always optional.

      3. Preparation - The work product is sent to the stakeholders for individual review.

      4. Meeting - Members meet to discuss possible defects in the work product.

      5. Rework - The work product is revised based on deficiencies that need to be resolved.

      6. Follow-up - The rework is verified, final work product review data is collected and summarized, and the work product review is closed.

    • Work Product Review Steps:

      1. Coordinate the work product review by designating the reviewer(s);

      2. Provide the reviewer(s) with the designated work product,

      3. Inspect the work product to ensure it meets specified objectives.

      4. Record work product review finding(s).

      5. Track work product review finding(s) until resolved.

      6. Verify corrections and modifications identified in the work product review are carried out.

  5. To document comments and/or questions generated from a work product review, ( See Exhibit 2.6.1-9., Work Product Review Form)

  6. For location of the Work Product Review Form template, See IRM 2.6.1.5., Testing Templates.

2.6.1.4.1.4  (03-01-2010)
Establish Test Environment

  1. To ensure a testing environment is available and ready, coordination of the testing environment is made with the following organizations POCs:

    • Modernization Information and Technology Services (MITS) Enterprise Operations (EOps), go to the following URL: http://mits.web.irs.gov/EOPS/

    • Information Technology Infrastructure (ITI) Division, go to the following URL: http://mits.web.irs.gov/EOPS/ITI/index.htm

    • MITS Enterprise Services (ES), Support Services, go to the following URL: http://mits.web.irs.gov/ES/About/ESSupportServices.htm

    Support is also provided by project POCs and test participants.

  2. Determine support resources assigned roles to ensure environment is fully established and viable for testing. All participants are invited to any coordination meetings to ensure accuracy of environment information and environment build out scheduling.

  3. The test environment needs to emulate the production environment to the greatest degree possible in which the software is implemented. If the required test environment is in existence, verify that the environment is correct. Coordination of the testing environment will vary depending on the degree of complexity of the software changes, type(s) of testing required, practices of the customer, methodologies used to develop the software, and impact of the software being tested.

  4. Identify the type of equipment, operating system (OS), software (SW), configuration tools, portal and all communications media used in the test environment.

  5. The Test Environment Checklist will help to determine if the test environment is already established or needs to be established. ( See Exhibit 2.6.1-10., Test Environment Checklist.)

  6. For location of the Test Environment Checklist template See IRM 2.6.1.5., Testing Templates.

  7. Test environment coordination steps:

    1. Obtain any/all documentation that supports the environment details. These may include formal or informal documents and may include but are not limited to: Configuration Item/Configuration Unit (CI/CU) Physical Listing; Storage and Equipment listings; Infrastructure System Component Reports; Infrastructure Notional Design documents; Government Equipment Listings (GEL); Infrastructure Functional Baseline Designs; and System Test Plans

    2. Verify all software items listed in the test plan are available, which includes: operating systems, internal and external interfaces, control language, test tools, and test data files

    3. Coordinate with EOps & ES POC’s and determine availability of both hardware (HW) and software and license requirements

    4. Verify participants are prepared and provide them with any required documents. Prepare duplicate copies of items such as test tools or test data files, if necessary

    5. Ensure each participant has a copy of the Test Plan for reference, if necessary

      Note:

      For new products/projects, especially Tier II systems, Web-based applications and modernization projects, does the software application already have a testing platform in the SCDC Branch to move software from Development to the Test Environment then to the Production Environment; if so, ensure adequate time in your test plan to coordinate with SCDC Branch that the testing environment is set up per requirements.

    6. Verify all hardware items listed in the test plan(s) are available, which includes: application and/or database servers, communication devices, storage devices, and workstations

    7. Ensure the test proceeds without external problems

    8. Ensure all hardware and software items required for testing are installed and functional at the appropriate scheduled date and time; verify participants are prepared and provided with any required documents

    9. Ensure environment back-up and restoring procedures are known

    10. Ensure all hardware items required for testing are functional and available at the appropriate schedule date and time

    11. Contact each participant prior to the test to ensure that they are able to carry out their assigned role in the testing activities

    12. Ensure each test participant's system accesses are established and access is obtained

    13. Ensure required checklists or approval sheets are prepared and available if necessary

    14. If a shared environment is established, obtain environmental downtime notification procedures

  8. Environment Descriptions:

    1. Development, Integration and Testing Environment (DITE) is a segment that supports all pre-production activities, from application development to integration and acceptance testing. It is made up of dispersed groups of computing platforms and other equipment used and maintained by IRS' system development and operations organizations and engaged contractors. It includes development and test environments at Computing Centers and new environments created by the Modernization program: Software Development Lab (SDL), Virtual Development Environment (VDE) and Enterprise Integration and Testing Environment (EITE)

      • The Enterprise Integration and Testing Environment (EITE) provides the Systems Integration Testing (SIT) environment of the Modernization program as well as the modernized portions of the Systems Acceptability Test (SAT) and Final Integration Testing (FIT) environment of the IRS. It provides the environment in which modernization systems are assembled for end-to-end prototypes and integrated with other modernization and production systems, tested, accepted, and evaluated prior to their release for use in the production environment. The EITE emulates the IRS production environment in order to enable applications to be tested in a manner that will mimic the production world

2.6.1.4.1.5  (03-01-2010)
Coordinate Interface Agreements

  1. The test analyst should coordinate interface database agreements with other test teams and projects. ( See IRM 2.6.1.7. TAD Interface Database for more information to initiate an Interface Database Agreement).

2.6.1.4.1.6  (03-01-2010)
Conduct Test Readiness Review (TRR)

  1. A Test Readiness Review (TRR) is a milestone signifying the transition from the programmer's test to the SAT and ensures that all stakeholders agree that requirements, design, software, environment, and test products are at a level of readiness to commence SAT.

  2. Two weeks prior to the scheduled TRR, the initiator sends a TRR Agenda and Checklist to all participants.

  3. A TRR is conducted five workdays before scheduled program delivery and serves to validate entries in or to complete the TRR Checklist. ( See Exhibit 2.6.1-11.)

  4. A TRR is a formal review that is conducted in partnership with the Applications Development, Business Customer, TAD and other stakeholders key to the test effort, which may include operations, networks and infrastructure. Collectively the group determines the readiness of the system to proceed with testing. The decision to proceed with testing is made based on a successful TRR outcome. If the TRR is not successful, follow-up meetings are conducted to address all outstanding items and new revised dates must be updated in the SAT Plan. ( See IRM 2.6.1.4.2.6. Systems Acceptability Test (SAT) Plan for more information)

  5. Participants in the TRR includes:

    • Programmers

    • Test Analysts

    • Customers

    • Project Managers

    • Requirements Managers

    • Database/System Administrators

    • System Architects

    • Configuration Managers

  6. The following documentation is delivered by the participants at least five workdays prior to the TRR, which includes but is not limited to:

    • Inventory of documentation delivered

    • List of all known problems

    • SAT Plan

    • Testing schedule

    • Problem Reporting information

    • Status Reporting information

  7. TRR participants are to review all documentation prior to the TRR meeting.

  8. For location of the TRR template See IRM 2.6.1.5., Testing Templates.

2.6.1.4.1.6.1  (03-01-2010)
Test Readiness Review (TRR) Findings Memorandum

  1. The TRR initiator prepares a TRR findings memorandum and issues it within five workdays to all participants. For sample see the exhibits:

    • See Exhibit 2.6.1-12., TRR Memorandum - System is Ready

    • See Exhibit 2.6.1-13., TRR Memorandum - System Not Ready

  2. For location of the TRR Findings Memorandum's templates See IRM 2.6.1.5., Testing Templates.

2.6.1.4.1.7  (03-01-2010)
Conduct Problem Reporting

  1. A Problem Ticket describes a problem or discrepancy that is detected during documentation review, test execution, or output review. These problem tickets will be reported using the Information Technology Asset Management System (ITAMS). The problem may be one of the following:

    • Design flaw

    • Discrepancy among the system hardware, software, or documentation

    • Non-adherence to documentation standards

    • Processing error

    • Control language error

    • Software version control problem

    • System performance issue

    • Non-delivery of anticipated documentation

  2. When a problem is detected, the analyst will:

    • Define the problem

    • Contact the developer/customer or designated POC

    • Prioritize the problem

    • Report the problem

    • Monitor the reported problem,

    • Verify the resolution received from the developer/customer or POC by reviewing the documentation and/or retesting

    • Close, reopen or reissue the problem as appropriate

    Note:

    Priority 1 and 2 tickets cannot be reopened.

2.6.1.4.1.7.1  (03-01-2010)
Define the Problem

  1. For each problem detected, the test analyst will write a Problem Ticket that:

    • Provides a descriptive title

    • Lists all references

    • States the problem identifying inputs and conditions, user actions on the process or process actions on the data, and outputs and results that differ from the expected results

    • Ensures sufficient information is documented for recreating the sequence of events which identified the problem

  2. If applicable, label and attach all documentation and/or printed output relevant to the problem.

2.6.1.4.1.7.2  (03-01-2010)
Contact the Developer/Customer/Designated POC

  1. After discussing the potential problem with the TAD team leader, the analyst contacts the developer, customer or designated POC by phone or E-mail to:

    • Discuss the problem identified to determine if this is a SAT error or a program

    • If the developer returns information that it is a data or other SAT created error, make corrections and continue processing

    • If the developer agrees there is a problem or if no feedback is received within one day, issue an ITAMS problem ticket

    • Let the developer, customer or designated POC know that an ITAMS is being issued along with the ITAMS number

2.6.1.4.1.7.3  (03-01-2010)
Prioritize the Problem

  1. Refer to the table to prioritize problems:

    PRIORITIZE PROBLEMS
    If the defect And Then Resolution required within
    Caused a work stoppage Has a critical impact on test processes and schedules Issue the Problem Ticket as Priority 1 Five calendar days
    Impacts test processes, but the test can continue Timely resolution is required to stay on schedule Issue the Problem Ticket as Priority 2 Ten calendar days
    Impacts notices/letters sent to taxpayers Resolution is required prior to production date Issue the Problem Ticket as Priority 2 Ten calendar days
    Has no major impact on test processes or schedules   Issue the Problem Ticket as Priority 3 15 calendar days

2.6.1.4.1.7.4  (03-01-2010)
Report the Problem

  1. Report problems during the earliest phase of the testing life cycle to ensure the earliest possible correction.

  2. Document all problems detected using the ITAMS.

  3. For first time users of ITAMS go to http://getitservices.web.irs.gov to open a Problem Ticket to have the ITAMS application installed on their computers.

  4. To obtain an ITAMS password, submit an application on the Online 5081 system at https://online5081.enterprise.irs.gov to initiate a Personal 5081 for ITAMS-SC (Problem Management).

  5. To request a SAT Identification Number (SAT ID) or change an existing SAT ID number, go to the TAD web-site http://tad.web.irs.gov/ and click on the SAT ID Creation link.

  6. Query the on-line Help for assistance in inputting the problem or refer to the ITAMS User Reference Guide.

2.6.1.4.1.7.4.1  (03-01-2010)
Performance/Capacity Problem Reporting

  1. TAD has encountered several instances of environmental issues during testing. Environmental issues may consist of performance deficiencies, capacity issues, configuration differences, telecommunications, or other concerns that are related to the testing environment.

  2. TAD does not conduct performance or capacity testing activities as a rule. However, occasional performance and capacity issues have occurred during TAD’s testing of Tier II systems, web-based applications, and some Modernization projects.

  3. A SAT Plan states performance and capacity testing are not part of the test in Section 3.1, Scope of the Test. When a problem with performance, capacity, or the testing environment is encountered during the test of a Tier I or Tier II system, web-based applications, or Modernization projects, contact the Enterprise Operations, Information Technology Infrastructure (ITI).

  4. Issue a Problem Ticket to the developer organization only after it is determined that the problem is beyond the scope of the Systems Administrator (SA). If the developers response indicates:

    • The issue is not within their span of control

    • The size/configuration of the TAD test bed/platform is causing the error

    • The cause of the problem is outside their ability/authority to deal with

    • The problem/condition will not occur during production

    • Potential environmental implications are suggested in any other way

  5. Then re-issue the Problem Ticket to:

    • IT Infrastructure Division (ITI) for configuration issues

    • Capacity Management (CM) for capacity or performance issues

    • Enterprise Networks

  6. Notify the business customer when the issue is redirected to Distributed Systems Software Branch (DSSB) or Capacity Management Branch (CMB), and upon final resolution of the Problem Ticket. Document any environmental issues/concerns in the EOTSR in the Executive Summary and the Outstanding Issues sections.

    • Identify when and to whom the problem was reported and the actions (if any) taken to correct the problem

    • Identify any possible risks for production implementation

2.6.1.4.1.7.5  (03-01-2010)
Monitor the Reported Problem

  1. The Issued Log, which is generated on ITAMS, is accessed as directed by the Section Chief or Team Leader for Problem Ticket resolutions.

  2. The problem is overage if the problem is a:

    • Priority 1 and the resolution has not been received within 5 calendar days from date of issuance

    • Priority 2 and the resolution has not been received within 10 calendar days from date of issuance

    • Priority 3 and the resolution has not been received within 15 calendar days from date of issuance

  3. Once the Problem Ticket has been identified as overage, the initiator notifies the assignee in an attempt to secure a resolution. If the Problem Ticket is not resolved promptly, TAD management must contact the management of the responsible organization and attempt to obtain a solution.

  4. The counts and status of Problem Tickets issued are included in the ITAMS Problem Reports and the Overage Report generated by the Internal Management Branch. These reports can be found on the TAD web-site by using the following URL: http://tad.web.irs.gov/metrics/Status%5Faccounting/ .

2.6.1.4.1.7.6  (03-01-2010)
Verify the Resolution

  1. Once software, control language, or documentation corrections are transmitted, verify the corrections within project time-frames. To accomplish this task:

    • Verify the software or documentation transmittal memorandum addresses the reported problem

    • Verify the software transmittal has been loaded

    • Retest the function using test data identified in the Problem Ticket

    • Review system output to verify the correction

    • Review the revised documentation to verify the correction

2.6.1.4.1.7.7  (03-01-2010)
Close, Reopen, or Reissue the Problem Ticket

  1. Close a Problem Ticket only if the solution corrects the original problem, which is verified by regression testing, or the resolution satisfactorily explains why the problem occurs.

  2. TAD analysts are allowed to reopen SAT ITAMS tickets which have been closed within the last 30 days and are classified priority 3. However, Priority 1 and 2 SAT tickets cannot be reopened.

  3. SAT ITAMS tickets which have been closed longer than 30 days cannot be reopened regardless of priority.

  4. Respond to resolutions using the Problem Ticket Resolution Guide. ( See Exhibit 2.6.1-14.).

    Note:

    The reopen button will only appear if the SAT ITAMS ticket is a priority 3 and the closed date is within 30 days.

2.6.1.4.1.7.8  (03-01-2010)
ITAMS Problem Reports

  1. The ITAMS Problem Report, which is generated by the TAD Internal Management Branch, identifies projects with documented Problem Tickets on ITAMS. The current ITAMS Problem Reports can be found through the following URL: http://tad.web.irs.gov/metrics/status%5Faccounting/ .

    Note:

    Once you are at the TAD site, you must click on Testing Status to get the reports.

  2. The report contains the following ( See Exhibit 2.6.1-15.):

    • Project description and SAT ID

    • Functional organization to whom the Problem Ticket is assigned

    • Open, SAT Pending, and Closed Status totals (by priority code)

    • "No Trouble Found (NTF)" resolution code totals

  3. Closed or non-active projects are archived in ITAMS.

2.6.1.4.1.7.9  (03-01-2010)
Overage Report

  1. The Overage Report, which is generated by the TAD Internal Management Branch, identifies Problem Tickets that have not been responded to timely ( See IRM 2.6.1.4.1.7.5.). The current Overage Report can be found through the following URL: http://tad.web.irs.gov/metrics/status%5Faccounting/ .

    Note:

    Once you are at the TAD site, you must click on Test Status to get the report

  2. The Overage Report contains the following ( See Exhibit 2.6.1-16.):

    • Functional organization to whom the Problem Ticket is assigned

    • Total Problem Tickets (by priority code)

    • SAT ID

    • SAT Description

    • ITAMS Number

    • Description - Problem Ticket title

    • Priority

    • Opened Date

    • Days Late

2.6.1.4.1.8  (03-01-2010)
Conduct Post Implementation Review (PIR)

  1. Post-Implementation Review (PIR) is a formal end-of-test meeting held with developers, customers, and TAD representatives to review the test and identify process improvement areas. A PIR meeting will be held within 60 days after the completion of each test to allow sufficient time to assess the status of Production start-up.

  2. Items to be discussed with customers, developers and TAD Management include, but are not limited to:

    • Deliverables (i.e., UWR, FSP/PRP/DSP, programs, design documents, etc.)

    • Testing issues

    • Communication

    • Lessons Learned

    • Upcoming tests

  3. An open forum will be provided to discuss any other concerns or issues.

  4. Two weeks prior to the scheduled PIR meeting, the initiator will send an agenda and discussion sheet to all participants. ( See Exhibit 2.6.1-17.)

  5. The PIR Discussion Sheet will be used to document any findings and will be placed in the project folder.

  6. For location of the PIR Agenda and Discussion Sheet template See IRM 2.6.1.5., Testing Templates.

2.6.1.4.2  (03-01-2010)
Test Products

  1. The following are the test products to be created during the test.

2.6.1.4.2.1  (03-01-2010)
Work Breakdown Structure (WBS)

  1. The Work Breakdown Structure is a tool used to aid in planning and monitoring each TAD test through its life cycle. Use the current standard software application for project planning to prepare the Work Breakdown Structure. The use of the WBS is dependent upon the guidelines of each TAD Branch.

  2. Each SAT project has phases and tasks that occur during the test. The Work Breakdown Structure is used to identify, schedule and track activities performed during each TAD test. ( See Exhibit 2.6.1-2.), which provides the phases and significant tasks and contains the dates noted in (c) below.

    1. The four phases of the testing life cycle (See IRM 2.6.1.3.2.,Testing Life Cycle) are designated as the high level tasks in the WBS

    2. Tasks in the WBS are grouped chronologically and/or logically. The exhibit identified above depict the minimum tasks required for a test

    3. Planned Start Date, Actual Start Date, Planned End Date, and Actual End Date, once determined and finalized, do not change throughout the life cycle of the test. Actual Start Date and Actual End Date reflect the activity dates as they occur

  3. For location of the WBS template See IRM 2.6.1.5., Testing Templates.

2.6.1.4.2.2  (03-01-2010)
Work Request Analysis Form (WRAF)

  1. The creation of the Work Request Analysis Form (WRAF) begins in the Initiation Phase, as applicable per the project, when any of the following requirements document(s) listed below, but not limited to, are received:

    • UWR (Unified Work Request),

    • CR (Change Requests)

    • CRL (Candidate Requirements Listing)

  2. The WRAF is prepared by the SAT analyst assigned to a particular UWR.

  3. The purpose of this form is to ensure the analyst is familiar with the requirements document(s), understands the requirements and what changes or additions/deletions of functionality are being requested.

  4. The WRAF is used to clarify and articulate the analysts complete understanding of the requirements documented in the UWR/CR/CRL.

  5. The analyst reviews and analyzes the assigned requirements document(s) and any attachments. Based on their analysis answers the 11 questions in the WRAF (See Exhibit 2.6.1-3.).

  6. Completion of the WRAF occurs before testing begins. The analyst may need to consult with their developers and other test areas that may interface with the project and UWR to complete the form.

  7. The completed WRAF is then reviewed by the Team Lead and technical or senior analyst, for accuracy and to verify the analyst is clear on what they are being asked to test. A Work Product Review of the WRAF is then conducted to address any outstanding questions or issues.

  8. Once the analyst has competed the WRAF, then the analyst is ready to create the Requirements Traceability Verification Matrix (RTVM).

  9. For location of the WRAF and RTVM templates See IRM 2.6.1.5., Testing Templates.

2.6.1.4.2.3  (03-01-2010)
Project Impact Assessment (PIA) Form

  1. The Project Impact Assessment (PIA) Form is used to document the impact of a UWR on each project, documented by staff day and internal order number or program code.

  2. When a UWR is sent through the branches in the TAD domain, each project within the branch will input the estimated staff days needed to test the UWR if impacted, and enter them in the appropriate fiscal year and internal order number or program code. ( See Exhibit 2.6.1-4. )

  3. The PIA's are then sent back to the primary supplier or input directly into the UWR management system.

  4. The Project Impact Assessment (PIA) is primarily used to provide the estimated number of staff days that are required to effectively test the systems impacted by the UWR.

  5. The PIA is required when final analysis of the UWR has taken place. Completion needs to occur upon final acceptance of the UWR.

  6. For location of the PIA template See IRM 2.6.1.5., Testing Templates.

2.6.1.4.2.4  (03-01-2010)
Project Folder

  1. The project folder baseline is the completed folder, which has been reviewed and approved by the Program/Project Manager, Section Chief, or designee, and contains all the required items pertinent to the specific test. The project folder provides a history of the test. It is a useful source document for auditing purposes, project planning, and allocation of resources, and proves improvement. The project folder contains copies of all critical test documentation and products.

  2. The project folder contains all project and program documentation, correspondence and provides pointers to the location of all current project related information.

  3. The project folder may vary in volume depending on the size and/or complexity of the project. Information that cannot be incorporated into the project’s on-line DocIT project folder, such as boxes of printed output computer files, interface tape(s) and/or file backups must be cross-referenced in the project folder checklist to expedite location and access.

  4. The project folder is a requirement for every test and must be stored in the DocIT. It must be retained for 240 days beyond the scheduled program implementation date.

  5. The project folder is reviewed by the Program/Project Manager, Section Chief, or Team Leader prior to the receipt of programs for testing. Subsequent reviews are conducted as needed for test monitoring and oversight, and to verify the folder is updated on a regular basis to reflect tasks accomplished.

2.6.1.4.2.4.1  (03-01-2010)
Project Folder Checklist

  1. The Project Folder Checklist must be used to review the project folder contents for completeness and accuracy. ( See Exhibit 2.6.1-5.).

  2. When deficiencies are identified during the initial or subsequent reviews, follow-up reviews must be conducted to ensure corrective action was taken. Each time a review is conducted a copy of the revised checklist is updated in DocIT and/or added to the project folder.

  3. Each item on the checklist must have a check in the appropriate box and DocIT number if applicable. For some items, specific information (such as location or target completion date) should be added to the Dates/comments section:

    • DocIT # - Enter the corresponding DocIT number, if applicable. If the item cannot be stored electronically, mark the box as YES and cross reference its location in Dates/comments section.

    • Yes – Checklist item in question is represented in the folder. If item is not in the folder, cross reference it's location in Dates/comments section.

    • No - Checklist item in question is not represented in the folder, explanatory comment(s) are required

  4. Additional items specific to the project, or directed by management to be included in the project folder, should be listed in the Miscellaneous section of the checklist.

  5. For location of the Project Folder Checklist template See IRM 2.6.1.5., Testing Templates.

2.6.1.4.2.5  (11-05-2010)
Requirements Traceability Verification Matrix (RTVM)

  1. Requirements Traceability maps requirements to business processes, system development documents test cases and test results.

  2. The first five columns of the RTVM (ISAT) worksheet or the RTVM (SAT) worksheet are populated by the applications development organizations. This information must be provided by the development organizations 30 days prior to the scheduled delivery of applications to the organization performing systems acceptability testing. Instructions for what is input to these columns are listed in the Instructions spreadsheet of the RTVM Workbook.

  3. When systems acceptability testing is performed by the Test, Assurance and Documentation organization, the remaining columns of the RTVM (SAT) worksheet will be completed to document system acceptability testing results. Otherwise, the organization performing the independent systems acceptability test must complete the remaining columns of the RTVM (ISAT) worksheet to document system acceptability testing results.

  4. For an example of the RTVM (SAT) worksheet, See Exhibit 2.6.1-6

  5. For location of the RTVM Workbook template See IRM 2.6.1.5., Testing Templates.

    Note:

    See IRM 2.5.2, Tridoc, 2.5.2.2.3 for additional information on the RTVM workbook.

2.6.1.4.2.6  (11-05-2010)
Test Cases

  1. Test cases are created to specify and document the conditions to be tested and to validate that system functions meet customer requirements as translated into documented functional design. Test cases also test outside the normal or expected functions in order to find defects.

  2. Each test case must:

    • Test requirement as identified in the software requirement documents

    • Reference specific test data and its expected results associated with specific program criteria and/or UWR requirements

    • Match the documented expected output results in order to pass the test

      Note:

      If the requirement were to provide a particular logon screen, there would not be test data required as part of the test case to validate that logon screen.

  3. To provide an adequate test audit trail, and to perform problem resolution, test cases must meet the following attributes to be usable in retesting:

    • Repeatable - Each time the test case is run against the same configuration of code, under the same controls, it must produce the same result

    • Controllable - All variables in the test, including test data and procedures, must be documented so they are known and can remain as controls for each execution of the test

    • Observable - The tester must be able to assess, by looking at the designated results element(s), whether the specifications being tested have a defect or meet the requirements. Therefore, the expected results must be included in the test case design

    • Objectivity - There must be an identified, objective way to determine the results of the process being tested.

  4. Create test cases for:

    • Invalid, valid and boundary conditions

    • Every executable path in new applications

    • Modified applications

    • Special formulas and extreme conditions

  5. Verify test cases are complete and consistent with software requirements.

  6. Disposition of all test cases is required by the end of the test. Disposition by any of the following:

    • Pass/Fail

    • Defer/Waive

2.6.1.4.2.7  (11-05-2010)
Test Data

  1. Confirm all systems documentation has been received and requirements have been reviewed and accepted prior to test data creation.

  2. Test data is developed or acquired to verify that all conditions are met.

  3. Test data is consistent with the software requirements to be tested.

  4. Test data emulates inputs as required by modules, programs, applications, or systems.

  5. Test data must be protected as "Official Use Only" information and is intended solely for testing purposes.

  6. Determine which of the following test data types are appropriate for the test:

    • Compatibility Data - Represents data passed through a contiguous run stream during SAT

    • External Trading Partner Data - The external trading partner must create and make data available. For output, data is produced by the program and transmitted electronically to the external entity

    • Manufactured Data - Is created or collected and maintained by the tester. The volume is usually low and allows for easier manipulation of records and for complete review of specific results

    • Production Data - Represents data from production files. It is unmodified, non-sanitized data extracted from taxpayer files, which identifies specific individual or corporate taxpayers. Production data can be sanitized or unsanitized and is often used for volume test and file compares. The use of live data must have a justification and its use is strictly prohibited without approval. (See IRM 10.8.8 ,Information Technology (IT) Security, Live Data (LD) Protection

    • Sanitized Data - Is live data which has been altered after being extracted from production files to obscure the identification and location of the taxpayers. Sanitized data is treated as live data and, at a minimum, involve changes to the following: taxpayer names, taxpayer identification number (TIN), and addresses and zip codes

    • Simulated Data - Does not contain live data, and imitates data as it appears on actual taxpayer files

  7. Develop/Acquire Test Data steps:

    • Identify multiple data sources to ensure adequate test data is available for the test, (e.g., production sites, TAD, and data created by developers)

    • If live data is required for verification of test conditions, then acquire the data according to IRM 10.8.8 , Information Technology (IT) Security, Live Data (LD) Protection

    • Create new data or modify data from existing files accumulated and stored from previous testing activities

    • Prepare new data or modified data for valid and invalid test conditions

    • Identify a list detailing exact files to be captured to evaluate the outcome of each test

    • Identify interface files

    • Verify data has sufficient quality that it can be used to verify whether the programs will or will not produce the expected results

2.6.1.4.2.8  (11-05-2010)
Test Results

  1. To ensure test results are accurate, test results must be reviewed. These results must be consistently recorded, documented and verified during test execution. The complexity of the requirements will determine the level of testing. Testers should encourage customers to assist in reviewing the test results. Perform the following steps to review test results:

    • Examine the test cases to ensure all tests were executed

    • Create problem log to track ownership and status of each problem to resolution

    • Perform/review file compare results, visual inspection of data, or visual inspection of printed output such as reports, notices/letters

    • Record any issues/problems detected on the issue/problem log

    • If expected results are not met:

      • Review input test data and test case to ensure accuracy

      • Revise input test data and test case, if needed

      • Document defect for developer to correct and retest or verify corrected program code and/or applicable documentation

    • Examine the completed test case to ensure all tests were executed successfully

2.6.1.4.2.9  (03-01-2010)
Systems Acceptability Test (SAT) Plan

  1. A SAT Plan describes the project/system to be tested, the scope of the test, and the requisite skills, roles and responsibilities required to successfully complete the test. Additionally a SAT plan defines the various types of tests that are performed during a SAT. See IRM 2.6.1.3.1. Test Types, defines the type of tests that are addressed in a SAT Plan.

  2. A SAT Plan:

    • Must be written whenever it is determined that a test will be performed

    • Is a TAD/ELC deliverable, which is part of the project folder

    • Must be submitted to the Program/Project Manager, Section Chief and Branch Chief for approval and concurrence, with sufficient time to allow distribution of the final signed copy, including the disposition of comments, to all stakeholders at least 14 calendar days before program delivery

    • Must be submitted electronically to all stakeholders after the SAT Plan is approved and posted to the TAD web-site

  3. SAT Plan Revisions, if necessary, should only be made if the test execution phase has not started.

    Note:

    If testing has started and a revision(s) to a SAT Plan is needed, the change(s) should be noted in the EOTSR. The EOTSR identifies applicable environmental, test approach, test design, test planning and test execution variances from the original SAT Plan.

    • Revisions must be submitted to the Program/Project Manager, Section Chief and Branch Chief for review and approval. A SAT Plan is reissued in its entirety with a new SAT Plan Memorandum and Revision History page

    • Do not issue a new revision for editorial changes. Include editorial changes when revising the plan for changes with major impact on the test

  4. A SAT Plan must be revised and a new version distributed for one or more of the following reasons:

    • Significant information becomes available which is missing at the time the original SAT Plan was issued

    • Significant events occur which alter the scope of the test

    • Significant events occur which alter the Work Breakdown Structure (i.e., revised dates)

    • Adding items previously omitted

    • Deleting items erroneously included

  5. The baseline of a SAT Plan is the initial version, Version 1.0 each subsequent revision establishes a new baseline.

  6. The Work Breakdown Structure is a critical component of a SAT Plan. The WBS defines the time-line that drives the completion of activities and tasks to performed throughout the test life cycle.

  7. For an example of a SAT Plan and Cover Memorandum, ( See Exhibit 2.6.1-7.).

  8. For location of the SAT Plan template See IRM 2.6.1.5., Testing Templates.

  9. Electronic copies of SAT Plans are stored on the TAD web-site at http://tad.web.irs.gov/.

2.6.1.4.2.10  (03-01-2010)
End of Test Status Report (EOTSR)

  1. The End of Test Status Report (EOTSR) provides information regarding test results to allow customers and developers the ability to assess the quality of the product. The EOTSR is a TAD/ELC deliverable, that is part of the project folder. The EOTSR addresses:

    • All issues in a SAT Plan

    • All issues identified after a SAT Plan was issued

  2. The EOTSR is submitted to the TAD Program/Project Manager, Section Chief and Branch Chief for approval and concurrence. The EOTSR is submitted with sufficient time to allow distribution to all stakeholders within five workdays after the scheduled test completion date.

    • If the test completion occurs prior to the scheduled completion date, an EOTSR is expected within five workdays after the actual test completion

    • If the production date occurs before the end of test, an EOTSR may be issued within five workdays of the production date or as directed by management

    • After a EOTSR is approved and posted to the TAD web-site it must be submitted electronically to all stakeholders

  3. A revised EOTSR will be prepared if a project has reached its test completion date and the EOTSR has been written, but a significant number of open Problem Tickets remain to be retested. A revised report will be issued upon completion of the test.

  4. The EOTSR should be revised and a new version distributed if significant information becomes available that was missing at the time the original EOTSR was written.

  5. Revisions to the EOTSR should be submitted to the TAD Section Chief, Program/Project Manager and Branch Chief for review and approval as soon as completed.

  6. The revised EOTSR Memorandum, Revision History Page, and EOTSR should be distributed to all stakeholders.

  7. For an example of an EOTSR, ( See Exhibit 2.6.1-7.).

  8. For location of the EOTSR template See IRM 2.6.1.5., Testing Templates.

  9. Electronic copies of the EOTSR are stored on the TAD web-site at http://tad.web.irs.gov/.

2.6.1.4.2.11  (03-01-2010)
Weekly Test Status Report

  1. The Weekly Test Status Report is driven by the RTVMs and used to reflect the status of test data preparation and test execution throughout the test. It includes the significant dates in the test life cycle, counts of problem reports and current status narrative. (For more information on the TAD Status Reporting System (TSRS), See IRM 2.6.1.8.3. )

2.6.1.4.2.12  (03-01-2010)
Release Readiness Schedule and Status Report

  1. The Release Readiness portfolio in the ProSight tool monitors projects throughout the development and testing life cycle. The Release Readiness portfolio identifies projects the TAD and Development Organizations have committed to test.

  2. The TAD and Development Organizations negotiate critical milestone delivery dates, including the following:

    • Documentation to SAT

    • Data Preparation completion

    • Programs to SAT

    • Test Execution start

    • Test Execution end

  3. The Development Organization is responsible for initiating a project on the Release Readiness Schedule and Status Report.

  4. The Release Readiness Schedule and Status Report is updated as necessary in ProSight by TAD, Development, and the Program Management and Release Readiness Organization (PM & RRO).

  5. The Release Readiness portfolio also produces Weekly Exception Reports which identifies projects which could be in jeopardy due to missing information, or milestone dates that have not been met. It is critical for TAD to promptly enter actual dates into ProSight for each milestone as it occurs.

  6. The Release Readiness portfolio tracks automated (based on milestone) and manual status "color-coded" values.

  7. Prior to manually adjusting the status of any project in ProSight, the test team must clear the manual status update through their management, and pre-coordinate all manual status over-rides with the appropriate project office, or programming team. When entering a manual status update a narrative explanation must also be entered into ProSight.

2.6.1.5  (11-05-2010)
Testing Templates

  1. The software testing procedures are controlled and driven by the testing templates, a high level reference and audit trail that must be used to track movement of the testing process from preparing the product through transmitting the software.

  2. The testing templates are stored in DocIT in the cabinet - Test Assurance and Documentation/TA-ALL (Test Assurance and Documentation)/Forms and Templates/2010 IRM 2.6.1 Templates folder. DocIT is a centrally controlled repository for documents, organized by IRS domains, and provides version control, an audit trail for changes, storage management capabilities, off-site storage for disaster recovery, full text searching, and security. DocIT also provides document routing and workflow capabilities that save time in the document approval process.

  3. The testing templates consist of the following:

    • Exhibit 2.6.1-2 Work Breakdown Structure (DocIT #801bd50f)

    • Exhibit 2.6.1-3 Work Request Analysis Form (DocIT #801bd510)

    • Exhibit 2.6.1-4 Project Impact Assessment (DocIT #801bd511 )

    • Exhibit 2.6.1-5 Project Folder Checklist (DocIT #801bd512 )

    • Exhibit 2.6.1-6 Requirements Traceability Verification Matrix (DocIT #80216056 )

    • Exhibit 2.6.1-7 SAT Plan (DocIT #801bd514 )

    • Exhibit 2.6.1-8 End of Test Status Report (DocIT #801bd515 )

    • Exhibit 2.6.1-9 Work Product Review Form (DocIT #801bd516 )

    • Exhibit 2.6.1-10 Test Environment Checklist (DocIT #801bd517)

    • Exhibit 2.6.1-11 Test Readiness Review Checklist (DocIT #801bd53b )

    • Exhibit 2.6.1-12 TRR Memorandum - System is Ready (DocIT #801bd53e)

    • Exhibit 2.6.1-13 TRR Memorandum - System is not Ready (DocIT #801bd53f )

    • Exhibit 2.6.1-17 Post Implementation Review (DocIT #801bd540)

    • Exhibit 2.6.1-18 Files Communication Status Report (FCSR) (DocIT #801bd541)

    • Exhibit 2.6.1-19 Form 13605 (DocIT #801bd542)

    • Exhibit 2.6.1-20 Form 12038 (DocIT #801bd543)

    • Exhibit 2.6.1-21 Form 12038A (DocIT #801bd544)

    • Exhibit 2.6.1-22 Request for Lab Access (DocIT #801bd545)

    • Exhibit 2.6.1-23 FY-09 Sample NODT Letter (DocIT #801bd546)

    • Exhibit 2.6.1-25 Weekly Exception Report (DocIT #801bd547)

  4. In order to access the testing templates, an "Advances Search" in DocIT will need to be performed. Click on the "Advanced" button enter the DocIT # in the "Containing Text" box and click search.

  5. All of the templates are centrally located in DocIT Test Assurance and Documentation/TA-ALL (Test Assurance and Documentation)/Forms and Templates/2010 IRM 2.6.1 Templates folder.

  6. Testing templates may be tailored for project needs while ensuring the integrity of each template is preserved.

    Note:

    Help for using DocIT is provided through on-line help at http://docit.web.irs.gov/docit/help/en/default.htm and the TAD home page at http://tad.web.irs.gov/docIT/docIT.htm .

2.6.1.6  (03-01-2010)
Final Integration Test (FIT)

  1. Final Integration Test (FIT) is the integrated end-to-end testing of multiple systems that support the high-level business requirements of the IRS.

  2. FIT is designed to ensure that IRS systems inter-operate correctly prior to production start-up utilizing copies of production data in a near production environment.

  3. FIT is performed from the perspective that all IRS application systems are sub-systems to an overall Tax Processing System (TPS). The TPS consists of hundreds of sub-systems operating on many unique hardware and software platforms. FIT verifies that data is transferred correctly between the systems within the TPS.

2.6.1.6.1  (03-01-2010)
Scope of FIT Procedures

  1. This section of the IRM defines and documents the process for planning and conducting FIT:

    • Defines and documents the process for planning and conducting a FIT

    • Provides a standard framework for Test, Assurance & Documentation (TAD) personnel, and other personnel supporting a FIT, to follow and complete before software is released to production

    • Describes the processes for definition and management of a FIT project through execution and close-out. Subsequent sections describe ongoing management ( See IRM 2.6.1.6.3., Managing FIT) and common processes ( See IRM 2.6.1.6.4., FIT Common Processes) which are to be utilized by every FIT project

2.6.1.6.2  (03-01-2010)
Define FIT Project

  1. FIT provides verification that interrelated systems and hardware platforms can collectively support the enterprise-level business functions. FIT can extend beyond the scope of the new and modified system. (e.g., Taxpayer forms, notices, and queries trigger FIT test runs). The taxpayer forms will ultimately produce a refund, letter, notice, etc., as output back to the taxpayer.

  2. TAD management decides when a FIT project is established or when existing FIT projects are rescored based on the analysis of the UWR(s) and FIT Requests.

  3. These processes define the scope and high-level objectives of a FIT and identify project deliverables.

2.6.1.6.2.1  (03-01-2010)
Review Work Request

  1. Major projects create a UWR to enlist TAD support in planning and scheduling a FIT. The Responses to the UWR need to be coordinated between all of TAD before it is sent out.

  2. When a UWR is received in TAD for FIT support, it is assessed based on the following criteria:

    • Is the system mission critical? Mission critical systems are usually part of the mainline tax processing and have a higher priority than systems not part of tax processing

    • Is the system critical for another reason? The system may be new or highly visible

    • Is the system independent of specific tax-processing cycles? A system that is not cycle-specific is easier to schedule and test than one that requires a specific cycle

    • Does the system receive data directly from or supply data to taxpayers? A system that does not meet this criterion is still reviewed to determine how it impacts established threads

    • Does the system directly support IRS Submission Processing and/or Customer Account Services activities? If yes, the request is given a high priority. However, it is already likely to be within the scope of the Annual FIT

    • Is the system independent of additional data requirements? A system that requires unique data capture or data creation requires more resources and time to prepare for testing

    • Is updated system documentation available? Without current system documentation, test and data preparation time is increased

    • Is the system available within the FIT window? All systems requesting a FIT are evaluated to determine the feasibility of a FIT. There are times during the year when FIT is preparing the test environment that the logistics of testing at that time could negatively impact the test schedule and/or test environment

    • Can the system be tested using the FIT environment without modifications or additional equipment? Modifying or enhancing the test environment increases the cost and resources required

    • Can the system be tested without additional training? Additional training requirements increases the cost and time required for supporting the system's inclusion into FIT

  3. Respond to each UWR indicating the status of the request as either "FIT" or " No FIT" .

2.6.1.6.2.2  (03-01-2010)
Evaluate FIT Requests

  1. Review and evaluate information contained in the FIT Requests submitted by the projects requesting their inclusion into FIT.

  2. Ensure the following information is contained in the FIT Requests:

    • Names of the project/systems with application(s) to be included in FIT

    • Brief description of the interface changes between the application(s) and other IRS application systems to be tested during FIT

    • Scheduled implementation date

    • Expected software delivery date

    • Expected documentation delivery date

    • Expected SAT completion date for the software

    • Appropriate UWR number(s) and title(s) (if any, otherwise reference requirements documentation)

    • Identification of the documentation affected by the changes

    • Listing of hardware and application software configuration items, including name/title/release dates

  3. Respond to FIT Requests indicating the status of the request.

  4. The FIT Request process is documented on the FIT web-site and can be accessed by using the following URL: http://tad.web.irs.gov/systbr/fit .

2.6.1.6.2.3  (03-01-2010)
FIT Determination

  1. The FIT Project Manager decides when to establish a special FIT project and directs team members to begin the planning process.

  2. All FIT personnel provides input to the scope of the Annual FIT, however, the FIT Project Manager makes the final determination when there is not a clear consensus.

  3. The determination to support FIT for each request is documented in the corresponding response to the request. Additionally, for every FIT project there is a FIT Plan indicating the requests included in a FIT.


More Internal Revenue Manual