[Expand]General Information/viewarticle/88628/
 [Expand]Using Help System/viewarticle/81465/
 [Expand]Getting Started Tutorial/viewarticle/82003/
 [Collapse]Using TestComplete/viewarticle/84431/
  [Expand]TestComplete User Interface, Projects and Settings/viewarticle/87798/
  [Collapse]Creating, Recording and Running Tests/viewarticle/88044/
   [Expand]Naming Objects/viewarticle/82017/
   [Expand]Creating Tests/viewarticle/83818/
   [Expand]Managing Tested Applications/viewarticle/85827/
   [Expand]Checkpoints and Stores/viewarticle/82018/
   [Expand]Running Tests/viewarticle/83220/
   [Expand]Handling Playback Errors/viewarticle/84986/
   [Collapse]Keyword Testing/viewarticle/80985/
     Keyword Testing in TestComplete - Overview/viewarticle/81102/
     Creating and Recording Keyword Tests/viewarticle/85467/
     Running Keyword Tests/viewarticle/82503/
     Setting and Checking a Keyword Test Result/viewarticle/84662/
     Keyword Test Parameters/viewarticle/88748/
     Keyword Test Variables/viewarticle/87474/
     Converting Keyword Tests to Scripts/viewarticle/81037/
    [Expand]Creating Keyword Tests - Common Tasks/viewarticle/85045/
    [Collapse]Operations Reference/viewarticle/86157/
     [Expand]Checkpoints Category/viewarticle/80980/
     [Collapse]Logging Category/viewarticle/82051/
       Append Log Folder Operation/viewarticle/82057/
       Log Attributes Operation/viewarticle/80965/
       Log Message Operation/viewarticle/81014/
       Pop Log Folder Operation/viewarticle/82059/
       Post Screenshot Operation/viewarticle/82047/
     [Expand]Miscellaneous Category/viewarticle/86474/
     [Expand]Performance Category/viewarticle/81418/
     [Expand]Statements Category/viewarticle/82060/
     [Expand]Test Actions Category/viewarticle/82040/
     [Expand]Web Category/viewarticle/81214/
      Frequently Used Category/viewarticle/81256/
      Selecting Objects for Keyword Test Operations/viewarticle/85788/
   [Expand]Test Visualizer/viewarticle/80575/
   [Expand]Exploring Applications/viewarticle/80624/
   [Expand]Debugging Tests/viewarticle/83018/
  [Expand]Test Results/viewarticle/80579/
  [Expand]Enhancing Tests/viewarticle/83506/
  [Expand]Teamwork and Integration Into QA Process/viewarticle/84972/
  [Expand]Extending TestComplete/viewarticle/81408/
  [Expand]Automating TestComplete/viewarticle/88022/
  [Expand]Best Practices/viewarticle/87218/
 [Expand]Testing Types/viewarticle/85355/
 [Expand]Applications Testing/viewarticle/83383/
 [Expand]Working With Application Objects and Controls/viewarticle/81481/
 [Expand]Samples and Tutorials/viewarticle/81997/
 [Expand]Other Tools That Help You Test Better/viewarticle/82893/
 [Expand]TestComplete Licensing Guide/viewarticle/88365/
Updated: 10/12/2016 Applies To: TestComplete 12 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent
Keyword Testing Operations: Logging Category

Append Log Folder Operation


The Append Log Folder operation creates a new folder in the test log and makes this folder active so that all messages that are posted to the log, go to this folder.

Operation Result

The operation returns an integer value that specifies the identifier of the created folder.

Scripting Analogue

The action, which the operation performs, is analogue to the Log.AppendFolder scripting method.

Operation Parameters

The operation parameters are organized into the following pages:

Folder Caption

On this page you can specify the most frequently used parameters of the operation:


String that contains the caption of the created folder. This string will be displayed in the Message column of the test log.

Additional Info

String that specifies additional information to be associated with the folder. This information will be shown in the Additional Info pane of the test log when the folder is selected.
Operation Parameters

On this page you can specify all of the parameters of the operation:


Folder caption. This is the value that you specified in the Caption edit box of the Folder Caption page. Str can hold data of any OLE-compatible type. If it cannot be converted to text, its value is ignored.


Additional text to be displayed in the Additional Info pane of the test log (this is the same value that you specified in the Additional Information edit box of the Folder Caption page). AdditionalText can hold data of any type compatible with OLE. If it cannot be converted to text, its value is ignored.


Folder priority. You can use any integer number or any of the following constants:

Constant Value Description
pmLowest 100 The lowest priority of the folder.
pmLower 200 The folder priority which is lower than normal.
pmNormal 300 The normal (default) priority of the folder.
pmHigher 400 The folder priority which is higher than normal.
pmHighest 500 The highest priority of the folder.

For information on specifying the Priority parameter value, see Specifying Enumeration Values in Parameters.


The LogAttributes object that contains the font and color attributes to be applied to the folder in the test log.

You can create this object by using the Log Attributes operation or by using script code. In the latter case, to specify the parameter, you should use a script expression that returns a reference of the LogAttributes object or use a variable, test parameter or [Last Operation Result] value that contains the object reference.

If this parameter is omitted, default attributes will be applied.


An integer value that specifies the identifier of the test log’s folder, to which the new folder will be added as a subfolder. If this parameter refers to a non-existent folder, is omitted or is set to -1 (the default value), the operation will create the folder in the currently active folder.

The active folder is the folder that is currently at the top of the folder stack which is populated during the test execution. The Append Log Folder operation makes the newly created folder the active folder. To restore the active folder, you can use the Pop Log Folder operation or call the Log.PopLogFolder method.

See also
Logging Category | Specifying Operation Parameters | Checking Operation Result | Using Folders | AppendFolder Method | Pop Log Folder Operation | Log Attributes Operation

© 2016 SmartBear Software. All rights reserved.
Email Send feedback on this document