Skip to main content
Ed-Fi.orgDocsCommunityAcademy
This is documentation for an older release that is still maintained. Latest version
Version: 6.2

Running the Postman Integration Tests

The Ed-Fi ODS / API includes several collections of Postman tests that can be executed against a Test Harness included in the ODS / API source code.

The following instructions assume that the Ed-Fi ODS / API has been successfully set up and is running in a local environment per the instructions in the Getting Started documentation. This documentation takes you through running two options for running postman test collections.

Running Postman Test Collections via PowerShell​

  1. Install Node.js 18+
tip

Many Windows users choose nvm for Windows to manage Node.js installations.

  1. As outlined in the Getting Started - Source Code Installation guide, from a PowerShell prompt run the Initialize-PowershellForDevelopment.ps1 script followed by Invoke-PostmanIntegrationTests. Guide](../getting-started/source-code-installation/readme.md) from a PowerShell prompt run Initialize-PowershellForDevelopment.ps1 script followed by Invoke-PostmanIntegrationTests PowerShell command

  2. Test results are presented as the tests run

PowerShell results

info

To capture the execution output of the Postman tests into a log file for full review (since the console window buffer may not be large enough to review the entire results of the test), you can do the following:

  1. Create a script (e.g. run-postman-tests-core.ps1) in the Ed-Fi-ODS-Implementation folder with the following content:
.\Initialize-PowershellForDevelopment.ps1
Invoke-PostmanIntegrationTests
  1. Create a second script (e.g. run-postman-tests.ps1) in the Ed-Fi-ODS-Implementation folder with the following content:
Start-Process powershell.exe .\run-postman-tests-core.ps1 -RedirectStandardOutput .\tests.log

This will capture the stdout from the process and write it to the specified log file instead. The shell window that is opened won't show any activity during the test run, so you'll just need to wait until it finishes.

Running Postman Test Collections via Postman​

  1. Install and launch Postman.

  2. Run the EdFi.Ods.Api.IntegrationTestHarness project from the ODS solution. This will create the Postman Environment file required for the tests to run.

    1. Run the EdFi.Ods.Api.IntegrationTestHarness project. Test Harness will create test API clients in the EdFi_Admin_Test database, create a Postman environment file and run a test API instance for the Postman tests to interact with.

      tip

      In Visual Studio, you can right click on the TestHarness project, then choose Debug > Start New Instance from the popup menu.

    2. After the test harness is running, open Postman and import the generated environment file located at Ed-Fi-ODS-Implementation\logistics\scripts\modules

    3. Ensure the environment is selected on the to right corner of Postman window.

      tip

      See Navigating Postman for additional help on choosing an environment in Postman

  3. Locate (or download) the Ed-Fi ODS Integration Test Suite collections from the Ed-Fi-ODS GitHub repository. Look in Ed-FI-ODS\Postman Test Suite directory.

  4. Import one or more of the collections into Postman using the Import function located in the upper left corner of the Postman window.

  5. Run the tests using the Collection Runner.

  6. Monitor test execution and review the test results.