13 STAP Jobs Management

Learn about creating, managing, and running jobs in Oracle Communications Solution Test Automation Platform (STAP) UI.

Topics in this chapter:

About the Jobs Page

The term job represents a package that combines one or more scenarios (sets of test steps) to be run against a specific environment. A job is a test suite that is configured and ready to be run as a single entity.

To access jobs, from the navigation panel, select Jobs. The Jobs page allows you to view and manage all the previously created jobs in a table. Each row represents a unique job.

Table 13-1 lists the columns for each job.

Table 13-1 Job Details

Field Description
Name Name of the job.
Description Brief information about the job.
Scenarios Number of scenarios running within the job.
Environment Linked environment.
Actions Action icons to edit, run, or delete the job.

Creating a New Job

To create a new job:

  1. On the Jobs page, click the Create New Job button on the top right corner of the page. The fields include:
    • Name
    • Tags (optional)
    • Environment
    • Description (optional)
    • Scenarios: Select each scenario that you would like to include in the job.
  2. Click Create Job to add the job.

Updating an Existing Job

To update an existing job:

  1. On the Jobs page, click the edit (Edit Icon) icon in the Actions column for the row corresponding to the job you want to modify.

    This opens the Edit Job page with the existing information for the job displayed.

  2. Edit the data as needed.
  3. Click Update to save the changes and update the jobs table accordingly.
  4. Click Cancel to terminate the changes made.

Running a Job

You can run a job in two modes:

  • Background
  • Run and visit Dashboard (for monitoring realtime execution of the job)

Deleting a Job

To delete an existing job:

  1. On the Jobs page, click the delete (Delete Icon) icon under the Actions column on the row corresponding to the job you want to delete.

    A confirmation dialog box appears.

  2. Click Delete.

Viewing Job History

To manage previously run jobs, from the navigation panel, select History.

The jobs are listed in a table. They are listed in the order of their run date, with the most recent job at the top of the page. The row for each job displays the job name, job start date and time (in the time zone of the deployment server), and the job result (passed or failed). You can also:
  • View more details about the job by clicking the view button View Icon
  • Run the job again by clicking the restart button (pic). Restart Icon

Note:

If you cannot see the view or restart buttons, you may need to click the more actions icon (More Actions) to view or restart the job.

You can access the details of a specific job by clicking its row. The row expands and you can view the details listed in Table 13-2:

Table 13-2 Viewing Job Details

Field Description
Name Name of the job.
Type Type of the job. The default job type is Instant Job.
Environment The environment in which the job was run.
Start Time The date and time that the job was started.
Duration The amount of time the job took to run, in seconds and milliseconds.
Result The status of the job: passed or failed.

Viewing the Scenarios for a Job

You can view detailed information about the scenarios in a previously run job by clicking the view icon (View Icon) at the end of the row of the respective job in the History page.

stap-jobs-management1.html#GUID-7E9EA576-BA77-4963-B942-EC4E75569BA0__TABLE_HKP_5ZN_HFC lists the information displayed for a scenario.

Table 13-3 Scenario Status

Field Description
Result Total scenarios run in percentage.
Percentage Scenarios passed in percentage.
Passed Total number of scenarios passed.
Failed Total number of scenarios failed.
Skipped Total number of scenarios skipped.

You can also view an overview of each scenario of the job in visual graphs:

  • Job Results shows the number of passed, failed, and skipped scenarios of the job in a pie chart format.
  • Failure Analysis shows the reason for failure in a pie chart format. For example, it could show the number of scenarios failed due to validation errors and the number of scenarios that failed due to configuration errors.
  • Results by Duration shows the time taken to run each individual scenario of the job in a graph format.

For more information, see "Viewing the Results of Each Scenario".

To restart the job, click on the Restart Job button on the top-right corner.

Viewing the Results of Each Scenario

You can view the results of each individual scenario under the selected job under Scenarios Result.

If you have multiple scenarios, you type its name into the Filter field.

Note:

This search bar does not support filter tags.

All scenarios in the job are listed with the details listed in the Table 13-4:

Table 13-4 Scenario Results

Field Description
Name Name of the scenario.
Duration The duration of time for which the scenario was run, in seconds and milliseconds.
Start Time The date and time that the scenario was commenced.
Result The status of the total number of tasks in the scenario: number of tasks passed, number of tasks failed, number of tasks skipped, and number of tasks containing errors.
Status The final status of the scenario: passed or failed.

Viewing the Detailed Report of Scenarios

From the Scenario Results page, click View Detailed Report. This lets you view each scenario in detail including the tasks that passed, failed, or skipped.

  1. The pane on the left lists all the scenarios. To view details of a particular scenario, click on its row.

    You can view details of each task of the scenario run on the right pane.

  2. To expand a task, click its row. You can also filter tasks using the Pass, Fail, and Skip filter tabs. By default, all filter tabs are enabled.

    When you click on a task, you can view a list of the steps it contained.

  3. Click on the row of each step to view a detailed report for the step.

    This opens a window detailing information about the step.

Table 13-5 lists the details displayed for each step:

Table 13-5 Details displayed for each step

Field Description
Name Name of the task.
Action Action performed in the task.
Type The type of task performed.
Start Time The start date and time of the task. The time for the job was displayed in the deployment server tme zone.
End Time The end date and time of the task, in the time zone set in your UI.
Duration The amount of time the step took to run, in milli seconds.
Data Displays data configured in the step's BDD. If no data is configured, this section is blank.
Validation Displays validations created under the step in BDD.
Save Displays saved variables and values present in the step.
Log Displays a detailed report of each action performed
Level The level of the action. You can switch between the log levels INFO, DEBUG, ERROR, and WARNING to view detailed logs.
Timestamp The day, date, and time at which the action was performed.
Message Details of the action performed.
Error Details of an error when the action was performed. If there is no error, the column is blank.