Getting Current Test Name

You can get the name of the current test case by using the aqTestCase.CurrentTestCase.Name property. The example below demonstrates this (to execute it, run the Main routine):

# To execute the example, run this routine
def Main():
  categoryName = "Furniture"
  b = OpenWebStore()
  SelectCategory(b, categoryName)
  CloseBrowser()


# Export test case results to an MHT file
def ExportTestResults(name):
  if (name != ""): 
    logName = Project.Path + "Log\\" + name + ".mht"
    Log.SaveResultsAs(logName, lsMHT);


def OpenWebStore():
  url = "http://services.smartbear.com/samples/TestComplete14/smartstore/"
  Browsers.Item[btIExplorer].Run(url)
  return Sys.WaitBrowser("iexplore", 3000)


def CloseBrowser():
  Sys.WaitBrowser("iexplore").Close();

def SelectCategory(browser, category):
  aqTestCase.Begin("Select category")
  try:
    if (browser != None):
      page = browser.WaitPage("*", 3000)
      if (page.Exists):
        c = page.FindChild(["ObjectType", "attributes.title"], ["Link", category], 100)
        if (c.Exists):
          c.Click()
        else:
          Log.Warning("Cannot find the " + category + " category.")
  except Exception as e:
    Log.Warning("Error")
    #…
  finally:
    ExportTestResults(aqTestCase.CurrentTestCase.Name)
    aqTestCase.End()

The property returns the test case name regardless of how your test case has been run. It can be:

• A test item marked as a test case in the Execution Plan editor of your project (be default, all test items are treated as test cases). The test case name will correspond to the value in the Name column of the test item in the Execution Plan editor.

  To get the name of such test cases, your tests must run as part of the project’s test item sequence. You can run them either from the project’s Execution Plan editor or by running the entire project (for example, from the command line). See To Run a Test Item or Group.

• A BDD scenario. The test case name corresponds to the scenario description.

• An arbitrary code fragment marked as a test case with the aqTestCase.Begin and aqTestCase.End methods. The test case name is specified by the aqTestCase.Begin method.

• A test selected for execution by its tag. The test case name will correspond to the test name. For keyword tests, it is the name you can see in the Project Explorer under the Keyword Tests node. For script tests, it is the routine name or a custom name specified by using tags.

If no test case is running (this can happen if your tests are not marked as test cases in the Execution Plan editor, or you run individual script routines or keyword tests from the TestComplete IDE), the aqTestCase.CurrentTestCase property will return an empty value.

Get the property value described above by using the Call Object Method, Run Code Snippet, or Run Script Routine operation.

In the Execution Plan editor of your TestComplete project, you specify a sequence of tests to run when you execute the project. To get the name of the test item that is currently running, use the Project.TestItems.Current.Name property. It is the name specified in the Name column of the test item in the Execution Plan editor.

The example below shows how to get the name of the current test item. In order for the example to run successfully:

1. Add the Main routine to the Execution Plan editor of a TestComplete project.

2. Add the Events collection to the TestComplete project, add an event control to it, and then add a handler for the OnStopTest event. For the handler, use the EventControl1_OnStopTest routine specified below. To learn more about creating event handlers, see Creating Event Handlers for TestComplete Events.

3. Run the added test item that will execute the Main routine.

# Add this routine to the Test Items page and then run it
def Main():
  categoryName = "Furniture"
  url = "http://services.smartbear.com/samples/TestComplete14/smartstore/"
  Browsers.Item[btIExplorer].Run(url)
  browser = Sys.WaitBrowser("iexplore", 3000)
  if browser.Exists:
    page = browser.WaitPage("*", 3000)
    if page.Exists:
      c = page.FindChild(["ObjectType", "attributes.title"], ["Link", categoryName], 100)
      if c.Exists:
        c.Click()
    browser.Close()

def EventControl1_OnStopTest(Sender):
  if Project.TestItems.Current != None:
    logName = Project.Path + "Log\\" + Project.TestItems.Current.Name + ".mht"
    Log.SaveResultsAs(logName, lsMHT)

Get the property value described above by using the Call Object Method, Run Code Snippet, or Run Script Routine operation.