Create an Orchestration

Create an Orchestration Overview

Functionize enables users to execute multiple test cases from various projects, setting the test execution run order and creating better organization for test groups and types. These orchestrations can execute tens, hundreds, or even thousands of test cases globally, across any browser or mobile device. Users can create single or group orchestrations.

For every execution of an orchestration, users can:

  • Check the performance of the orchestration execution over time.
  • Check the stability of the test cases executed as part of an orchestration over time.

Key Features

  • Single Orchestration: Execute one bucket/group of tests in parallel or sequential mode, using filters such as projects, tags, and modules.
  • Group Orchestration: Set up multiple buckets with granular organization, such as executing one group sequentially and another in parallel.

Accessing Orchestrations

Click on Orchestrations on the header of the page.


Creating a Single Type Orchestration

  1. Open Orchestration Tab:
    • Click on Create New Orchestration.
  2. Details Tab:

    • Title: Name your orchestration.
    • Projects: Select projects to run in this orchestration.
    • Environment: Choose the environment for execution.
    • Folders: Select a folder to filter test cases.
    • Tags: Optionally filter test cases using tags.
    • Exclude Tag: Optionally exclude test cases using tags.
    • Test Cases: Select test cases based on previous filters.
    • Schedules: Choose a schedule (On-Demand, Hourly, Every 4 Hours, Every 12 Hours, Daily).
    • Select Browser: Select browsers for the orchestration (must be enabled at the individual test case level).
    • Orchestration Type: Choose between Background and TDM Run.
  3. Notifications Tab:
    • Jenkins Integration:

      • Jenkins Crumb URL: Enter the URL.
      • Jenkins Callback URL: Enter the URL.
      • Jenkins Authentication: Enter username:password.
      • Jenkins Parameters: Enter parameters as key1:value1,key2:value2.
    • Slack Integration:

      • Web-hook URL: Enter the URL.
      • Channel: Enter the channel name.
    • FogBugz Integration:

      • API Key: Enter the key.
      • API URL: Enter the URL.
      • Project Number: Enter the number.
    • Sentry.io Integration:

      • Authorization Token: Enter the token.
      • Organization Slug: Enter the slug.
      • Project Slug: Enter the slug.
      • DSN: Enter the DSN.
    • GitLab Integration:

      • Private Token: Enter the token.
      • Project Id: Enter the ID.
    • Jira Integration:

      • Domain URL: Enter the URL.
      • Username: Enter the username.
      • API Token: Enter the token.
      • Issue Key: Enter the key.
    • Rocket Chat Integration:

      • Domain URL: Enter the URL.
      • Username: Enter the username.
      • Password: Enter the password.
      • Issue Key: Enter the key.
    • Webhooks Integration:

      • Extensions Post-Hook: Enter the URL.
    • MSTeams Integration:

      • Web-hook URL: Enter the URL.
  4. Advanced Tab (Optional):

    • Run Order: Select Parallel (default) or Sequential.
    • Orchestration Type: Choose Single.
    • Re-Run: Automatically re-run incomplete or failed test cases.
    • Email Alerts: Enter email addresses.
    • Email Note: Add a message.
    • Environment Management: Override URLs.
    • Proxy String: Enter proxy server details (IP).
    • Windows Resolution: Set resolution (Width and Height in pixels).
    • Alerts Delivery: Choose alert delivery method.
    • Webhook URL: Input webhook URL if applicable.
    • Submit Linked Tests to TCM: Select On Demand or Automatic submission.
  5. Cookies Tab (Optional):

    • Click + Add new cookie and enter Parameter and Value details.
  6. Headers Tab (Optional):
    • Click + Add New Header and enter Parameter and Value details.
  7. Integration Tab:
    • Select the test run type for TestRail integration.
  8. Confirm Test Cases:
    • Click Confirm and then Submit.

  9. Execute Orchestration:
    • Locate the orchestration in the list, use the Search field if necessary, and click the Start button.

    • In the Run Orchestration window, click Confirm.

Creating a Group Type Orchestration

  1. Open Orchestration Tab:
    • Click on Create New Orchestration.
  2. Details Tab:
    • Follow the same steps as for a Single Type Orchestration.
  3. Integrations Tab:
    • Add and configure relevant integrations as per the Single Type Orchestration.
  4. Advanced Tab:

    • Run Order: Select Parallel or Sequential.
      • Parallel ( Default ): Select this to run the tests simultaneously
      • Sequential: Select this to run the test sequentially
    • Orchestration Type: Choose Group.
    • Re-Run: Automatically re-run incomplete or failed test cases.
    • Email Alerts: Enter email addresses.
    • Email Note: Add a message.
    • Environment Management: Override URLs.
    • Proxy String: Enter proxy server details (IP).
    • Windows Resolution: Set resolution (Width and Height in pixels).
    • Alerts Delivery: Choose alert delivery method.
    • Webhook URL: Input webhook URL if applicable.
    • Submit Linked Tests to TCM: Select On Demand or Automatic submission.
  5. Click Confirm:

  6. Group Orchestration Test Cases:
    • Click Add New Group to create groups of test cases.
  7. Finalize Groups:

    • Select the Run Order for each group.
    • If selecting Sequential, a checkbox for Halt on Failure appears.
    • Organize groups with specific run orders, then click Submit.
  8. Execute Orchestration:
    • Locate the orchestration in the list, use the Search field if necessary, and click the Execute icon.
    • In the Run Orchestration window, click Confirm.

Creating an Orchestration Using Test Data Management

Please see User Guide: Test Data Management (TDM) - Orchestrations