Count Property

Applies to TestComplete 14.40, last modified on April 22, 2021

Description

The Count property returns the number of tasks in the task collection represented by the Tasks object.

Declaration

TasksObj.Count

Read-Only Property Integer
TasksObj An expression, variable or parameter that specifies a reference to a Tasks object

Applies To

The property is applied to the following object:

Property Value

An integer value that denotes the number of tasks in the task collection.

Example

The following code snippet obtains the tasks that belong to the specified network suite’s jobs and posts the tasks’ names to the test log.

JavaScript, JScript

function Test()
{

  var JobName, Tasks, Task, Count, i;
  // Specifies the name of a job
  JobName = "Job1";
  // Obtains the tasks that belong to the specified job
  Tasks = NetworkSuite.Jobs.ItemByName(JobName).Tasks;

  // Defines how many tasks the job contains
  Count = Tasks.Count;

  if (Count > 0)
    {
    Log.AppendFolder("The " + JobName + " job contains the following tasks:");
    for (i = 0; i < Count; i++)
      {
      // Obtains a task
      Task = Tasks.Items(i);
      // Posts the task's name to the test log
      Log.Message(Task.Name);
      }
    Log.PopLogFolder();
    }
  else
    Log.Message("The " + JobName + " job contains no tasks.");

}

Python

def Test():
  # Specifies the name of a job
  JobName = "Job1"
  # Obtains the tasks that belong to the specified job
  Tasks = NetworkSuite.Jobs.ItemByName[JobName].Tasks
  # Defines how many tasks the job contains
  Count = Tasks.Count
  if Count > 0:
    Log.AppendFolder("The " + JobName + " job contains the following tasks:")
    for i in range(0, Count):
      # Obtains a task
      Task = Tasks.Items[i]
      # Posts the task's name to the test log
      Log.Message(Task.Name)
    Log.PopLogFolder()
  else:
    Log.Message("The " + JobName + " job contains no tasks.")

VBScript

Sub Test

  Dim JobName, Tasks, Task, Count, i
  ' Specifies the name of a job
  JobName = "Job1"
  ' Obtains the tasks that belong to the specified job
  Set Tasks = NetworkSuite.Jobs.ItemByName(JobName).Tasks

  ' Defines how many tasks the job contains
  Count = Tasks.Count

  If Count > 0 Then
    Log.AppendFolder("The " & JobName & " job contains the following tasks:")
    For i = 0 To Count - 1
      ' Obtains a task
      Set Task = Tasks.Items(i)
      ' Posts the task's name to the test log
      Log.Message(Task.Name)
    Next
    Log.PopLogFolder
  Else
    Log.Message("The " & JobName & " job contains no tasks.")
  End If

End Sub

DelphiScript

procedure Test();
var JobName, Tasks, Task, Count, i;
begin

  // Specifies the name of a job
  JobName := 'Job1';
  // Obtains the tasks that belong to the specified job
  Tasks := NetworkSuite.Jobs.ItemByName(JobName).Tasks;

  // Defines how many tasks the job contains
  Count := Tasks.Count;

  if Count > 0 then
    begin
    Log.AppendFolder('The ' + JobName + ' job contains the following tasks:');
    for i := 0 to Count - 1 do
      begin
      // Obtains a task
      Task := Tasks.Items[i];
      // Posts the task's name to the test log
      Log.Message(Task.Name);
      end;
    Log.PopLogFolder();
    end
  else
    Log.Message('The ' + JobName + ' job contains no tasks.');

end;

C++Script, C#Script

function Test()
{

  var JobName, Tasks, Task, Count, i;
  // Specifies the name of a job
  JobName = "Job1";
  // Obtains the tasks that belong to the specified job
  Tasks = NetworkSuite["Jobs"]["ItemByName"](JobName)["Tasks"];

  // Defines how many tasks the job contains
  Count = Tasks["Count"];

  if (Count > 0)
    {
    Log["AppendFolder"]("The " + JobName + " job contains the following tasks:");
    for (i = 0; i < Count; i++)
      {
      // Obtains a task
      Task = Tasks["Items"](i);
      // Posts the task's name to the test log
      Log["Message"](Task["Name"]);
      }
    Log["PopLogFolder"]();
    }
  else
    Log["Message"]("The " + JobName + " job contains no tasks.");

}

See Also

Distributed Testing
Tasks.Items
Tasks.ItemByName

Highlight search results