6.1 All available settings in test data
6.1.1 Setting table
The Setting table is used to import test libraries, resource files and variable files and to define metadata for test suites and test cases. It can be included in test case files and resource files. Note that in a resource file, a Setting table can only include settings for importing libraries, resources, and variables.
| Settings available in the Setting table | |
|---|---|
| Name | Description |
| Library | Used for taking test libraries into use. |
| Resource | Used for taking resource files into use. |
| Variables | Used for taking variable files into use. |
| Documentation | Used for specifying a test suite or resource file documentation. |
| Metadata | Used for setting free test suite metadata. |
| Suite Setup | Used for specifying the suite setup. |
| Suite Teardown | Used for specifying the suite teardown. |
| Suite Precondition | A synonym for Suite Setup. |
| Suite Postcondition | A synonym for Suite Teardown. |
| Force Tags | Used for specifying forced values for tags when tagging test cases. |
| Default Tags | Used for specifying default values for tags when tagging test cases. |
| Test Setup | Used for specifying a default test setup. |
| Test Teardown | Used for specifying a default test teardown. |
| Test Precondition | A synonym for Test Setup. |
| Test Postcondition | A synonym for Test Teardown. |
| Test Template | Used for specifying a default template keyword for test cases. |
| Test Timeout | Used for specifying a default test case timeout. |
Note
All setting names can optionally include a colon at the end, for example Documentation:. This can make reading the settings easier especially when using the plain text format. This is a new feature in Robot Framework 2.5.5.
6.1.2 Test Case table
The settings in the Test Case table are always specific to the test case for which they are defined. Some of these settings override the default values defined in the Settings table.
| Settings available in the Test Case table | |
|---|---|
| Name | Description |
| [Documentation] | Used for specifying a test case documentation. |
| [Tags] | Used for tagging test cases. |
| [Setup] | Used for specifying a test setup. |
| [Teardown] | Used for specifying a test teardown. |
| [Precondition] | A synonym for [Setup]. |
| [Postcondition] | A synonym for [Teardown]. |
| [Template] | Used for specifying a template keyword. |
| [Timeout] | Used for specifying a test case timeout. |
6.1.3 Keyword table
Settings in the Keyword table are specific to the user keyword for which they are defined.
| Settings available in the Keyword table | |
|---|---|
| Name | Description |
| [Documentation] | Used for specifying a user keyword documentation. |
| [Arguments] | Used for specifying user keyword arguments. |
| [Return] | Used for specifying user keyword return values. |
| [Teardown] | Used for specifying user keyword teardown. |
| [Timeout] | Used for specifying a user keyword timeout. |