Integrations

Preflight can be integrated with:

• Project Management tools such as Jira.
• Notification tools such as Slack.
• CI/CD pipeline tools including GitHub, Azure DevOps, Jenkins, Bitbucket, CircleCI, GitLab and Travis CI.

Slack Integration

Integrating Preflight with Slack enables you to receive detailed error messages when a test fails. These messages include:

• A link to the video of the test
• The platform the test was run on
• The screen size
• The browser
• The status
• A screenshot of the test
• An error message describing the problem

To Integrate with Slack:

1. In the Navigation bar, select your profile icon.
2. Click Account Settings > Integrations.
3. Click Connect to Slack.
4. A permissions message appears. Click Allow.

GitHub Integration

You can work with tests and workflows created in Preflight directly in GitHub by adding an automatically created script to your config file.

To Integrate with GitHub:

1. In the Navigation bar, select your profile icon.

2. Click Account Settings > Integrations.

3. Click Connect to GitHub.

4. Go to the repository you’ve connected to GitHub and create a build.yml file under .github/workflows if you haven’t got one already.

5. Click Next > Create Credentials.

6. Click Generate API Keys.

7. Copy the values of Client_ID and Secret and add them to GitHub.

8. Click Next > Configure Tests.

9. Define whether you want to run Tests or Workflows.

   • For Tests define whether to test:
     • All tests
     • A single test, and select the test from the list.
     • A group of tests, and select a group from the list.
     • Tests with specific tags, and select the tag(s) from the list.
   • For Workflows define whether to test:
     • All workflows
     • A single workflow, and select the workflow from the list.

10. For both tests and workflows define:

    • The environment to run the test on. Either select one from the list or select Use Default Settings to use the environment(s) that were used to record the test(s).
    • The browser(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select browsers from the list.
    • The screen size(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select screen sizes from the list.

    A script corresponding to your selections appears in the Configuration field.

11. Click Copy to copy the script and paste it into the config file in your GitHub account.

12. Click All Done.

Azure DevOps Integration

You can work with tests and workflows created in Preflight directly in Azure DevOps by adding an automatically created script to your config file.

To Integrate with Azure DevOps:

1. In the Navigation bar, select your profile icon.

2. Click Account Settings > Integrations.

3. Click Connect to Azure DevOps.

4. Log into Azure DevOps and go to the pipeline you want to add tests to.

5. Click Edit in the top right.

6. In Preflight, click Next > Create Credentials.

7. Click Generate API Keys.

8. Copy the values of Client_ID and Secret and add them to the corresponding fields in the sidebar in Azure DevOps.

9. Click Next > Configure Tests.

10. Define whether you want to run Tests or Workflows.

    • For Tests define whether to test:
      • All tests
      • A single test, and select the test from the list.
      • A group of tests, and select a group from the list.
      • Tests with specific tags, and select the tag(s) from the list.
    • For Workflows define whether to test:
      • All workflows
      • A single workflow, and select the workflow from the list.

11. For both tests and workflows define:

    • The environment to run the test on. Either select one from the list or select Use Default Settings to use the environment(s) that were used to record the test(s).
    • The browser(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select browsers from the list.
    • The screen size(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select screen sizes from the list.

    A script corresponding to your selections appears in the Configuration field.

12. Click Copy to copy the script and paste it into the config file in your Azure DevOps account.

13. Click All Done.

Jenkins Integration

You can work with tests and workflows created in Preflight directly in Jenkins by adding an automatically created IDs and texts into Jenkins.

To Integrate with Jenkins:

1. In the Navigation bar, select your profile icon.

2. Click Account Settings > Integrations.

3. Click Connect to Jenkins button.

4. Log into your Jenkins account.

5. Click Manage Jenkins in the Jenkins sidebar then click Plugin Manager and search for Preflight under Available plugins.

6. In Preflight click Next > Build Step.

7. In your Jenkins project, under General Settings, cick Add Build Step and then click Run Preflight Test.

8. Click Next > Create Credentials.

9. Click Generate API Keys.

10. Copy the values of Client_ID and Secret and add them to the build step.

11. Click Next > Configure Tests.

12. Define whether you want to test:

    • All tests - In Jenkins, leave Group ID and Test ID blank.
    • A group of tests, and select a group from the list. Click Copy and paste the ID into the Group ID field in Jenkins.
    • A single test, and select the test from the list. Click Copy and paste the ID into the Test ID field in Jenkins.

13. Define the environment to run the test on:

    • Leave Use Test Settings to use the environment(s) that were used to record the test(s). In Jenkins, leave the Environment ID field empty.
    • Select an environment from the list. Click Copy and paste the ID into the Environment ID field in Jenkins.

14. Define the browser(s) you want to test:

    • Leave Use Default for Test to test according to the global defaults or test settings you defined.
    • Select browsers from the list. Click Copy and paste the text into the Platforms field in Jenkins.

15. Define the screen(s) you want to test:

    • Leave Use Default for Test to test according to the global defaults or test settings you defined.
    • Select browsers from the list. Click Copy and paste the text into the Sizes field in Jenkins.

16. Click All Done.

Bitbucket Integration

You can work with tests and workflows created in Preflight directly in Bitbucket by adding an automatically created YAML script into a .yml file in your repository.

To Integrate with Bitbucket:

1. In the Navigation bar, select your profile icon.

2. Click Account Settings > Integrations.

3. Click Connect to Bitbucket.

4. Go to the repository you’ve connected to Bitbucket and create a bitbucket-pipelines.yml file if you haven’t got one already.

5. In Preflight, click Next > Create Credentials.

6. Click Generate API Keys.

7. Copy the values of PF_Client_ID and PF_Client_Secret and add them to and add them to Bitbucket.

8. Click Next > Configure Tests.

9. Define whether you want to run Tests or Workflows.

   • For Tests define whether to test:
     • All tests
     • A single test, and select the test from the list.
     • A group of tests, and select a group from the list.
     • Tests with specific tags, and select the tag(s) from the list.
   • For Workflows define whether to test:
     • All workflows
     • A single workflow, and select the workflow from the list.

10. For both tests and workflows define:

    • The environment to run the test on. Either select one from the list or select Use Default Settings to use the environment(s) that were used to record the test(s).
    • The browser(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select browsers from the list.
    • The screen size(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select screen sizes from the list.

    A script corresponding to your selections appears in the Configuration field.

11. Click Copy to copy the script and paste it into the bitbucket-pipelines.yml file in your repository.

12. Click All Done.

CircleCI Integration

You can work with tests and workflows created in Preflight directly in by adding an automatically created YAML script to CircleCI.

To Integrate with CircleCI:

1. In the Navigation bar, select your profile icon.

2. Click Account Settings > Integrations.

3. Click Connect to CircleCI.

4. Log into your CircleCI account and go to the Settings for the Project you want to add Preflight to.

5. Go to Environment Variables.

6. In Preflight, click Next > Authentication.

7. Click Generate API Keys.

8. Copy the values of PF_Client_ID and PF_Client_Secret and in CircleCI click Add Variable and add them to the environment variables.

9. Click Next > Configure Tests.

10. Define whether you want to run Tests or Workflows.

    • For Tests define whether to test:
      • All tests
      • A single test, and select the test from the list.
      • A group of tests, and select a group from the list.
    • For Workflows define whether to test:
      • All workflows
      • A single workflow, and select the workflow from the list.

11. For both tests and workflows define:

    • The environment to run the test on. Either select one from the list or select Use Default Settings to use the environment(s) that were used to record the test(s).
    • The browser(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select browsers from the list.
    • The screen size(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select screen sizes from the list.

    A script corresponding to your selections appears in the Configuration field.

12. Click Copy to copy the script and paste it into the build's YAML file.

13. Click All Done.

GitLab Integration

You can work with tests and workflows created in Preflight directly in GitLab by adding an automatically created YAML script to your GitLab account.

To Integrate with GitLab:

1. In the Navigation bar, select your profile icon.

2. Click Account Settings > Integrations.

3. Click Connect to GitLab.

4. Log into GitLab and go to the project you want to connect to Preflight.

5. Selected your project and on the Details page click Set up CI/CD on the right side of the Options bar.

6. In Preflight click Next > Create Credentials.

7. Click Generate API Keys.

8. Copy the values of Client_ID and Secret and add them to GitLab.

9. Click Next > Configure Tests.

10. Define whether you want to run Tests or Workflows.

    • For Tests define whether to test:
      • All tests
      • A single test, and select the test from the list.
      • A group of tests, and select a group from the list.
      • Tests with specific tags, and select the tag(s) from the list.
    • For Workflows define whether to test:
      • All workflows
      • A single workflow, and select the workflow from the list.

11. For both tests and workflows define:

    • The environment to run the test on. Either select one from the list or select Use Default Settings to use the environment(s) that were used to record the test(s).
    • The browser(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select browsers from the list.
    • The screen size(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select screen sizes from the list.

    A script corresponding to your selections appears in the Configuration field.

12. Click Copy to copy the script and paste it into the config file in your GitLab account.

13. Click All Done.

Travis Integration

You can work with tests and workflows created in Preflight directly in Travis by adding an automatically created YAML script to your Travis .yml file.

To Integrate with Travis:

1. In the Navigation bar, select your profile icon.

2. Click Account Settings > Integrations.

3. Click Connect to Travis CI.

4. Enter the name for the .yml file you want to connect to.

5. Click Next > Create Credentials.

6. Click Generate API Keys.

7. Copy the values of PF_Client_ID and PF_Client_Secret and add them to Travis.

8. Click Next > Configure Tests.

9. Define whether you want to run Tests or Workflows.

   • For Tests define whether to test:
     • All אests
     • A single test, and select the test from the list.
     • A group of tests, and select a group from the list.
     • Tests with specific tags, and select the tag(s) from the list.
   • For Workflows define whether to test:
     • All 'W'orkflows
     • A single workflow, and select the workflow from the list.

10. For both tests and workflows define:

    • The environment to run the test on. Either select one from the list or select Use Default Settings to use the environment(s) that were used to record the test(s).
    • The browser(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select browsers from the list.
    • The screen size(s) you want to test. You can leave the test defaults, test according to the global defaults that you defined, or select screen sizes from the list.

    A script corresponding to your selections appears in the Configuration field.

11. Click Copy to copy the script and paste it into your YAML file.

12. Click All Done.