{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":2702,"path":"application-development/test-agent-exceptions.md","title":"Test Agent guidelines","bundle":null,"doc_type":null,"release":"australia","body":"\n# Test Agent guidelines\n\nLeverage the full potential of Test Agent by following these guidelines.\n\n## Supported metadata\n\nTest Agent supports the following metadata:\n\n-   sys\\_ui\\_action\n-   sys\\_ui\\_policy\n-   sys\\_ui\\_policy\\_action\n-   sys\\_ui\\_policy\\_rl\\_action\n-   sys\\_script\\_client\n-   sys\\_ui\\_script\n-   sys\\_data\\_policy2\n-   sys\\_ui\\_action\\_role\n-   sys\\_ui\\_action\\_view\n-   sys\\_ui\\_base\\_theme\n-   sys\\_ui\\_form\n-   sys\\_ui\\_formatter\n-   sys\\_ui\\_macro\n-   sys\\_ui\\_message\n-   sys\\_ui\\_related\\_list\n-   sys\\_ui\\_section\n-   sys\\_ui\\_view\n-   sys\\_ui\\_title\n-   sys\\_ui\\_style\n-   sys\\_ui\\_theme\n-   sys\\_ui\\_page\n-   sys\\_ui\\_context\\_menu\n-   sys\\_ui\\_list\n-   sys\\_ui\\_list\\_control\n-   sys\\_ui\\_list\\_control\\_embedded\n-   sys\\_ui\\_list\\_script\\_client\n-   sys\\_ui\\_list\\_script\\_server\n-   sys\\_ui\\_related\\_list\n-   sys\\_user\\_role\n-   sys\\_app\\_application\n-   sp\\_widget\n-   sp\\_instance\n-   sys\\_security\\_acl\\_role\n-   sys\\_script\n-   sys\\_app\\_module\n-   sysevent\\_email\\_action\n-   sys\\_report\n-   sys\\_security\\_acl\n-   catalog\\_ui\\_policy\n-   catalog\\_ui\\_policy\\_action\n-   sp\\_theme\n-   sp\\_widget\n-   sys\\_sg\\_universal\\_link\\_path\\_segment\n-   sys\\_sg\\_sections\\_screen\\_m2m\\_section\n-   sys\\_sg\\_location\\_tracking\\_details\n-   sys\\_highlighted\\_value\\_condition\n-   sys\\_sg\\_card\\_size\n-   sys\\_sg\\_custom\\_map\\_config\n-   sys\\_sg\\_empty\\_state\n-   sys\\_aw\\_form\\_header\\_secondary\\_values\n-   sys\\_aw\\_registered\\_scripting\\_modal\n-   sys\\_template\n-   sys\\_sg\\_alert\n-   sys\\_aw\\_form\\_header\n-   sys\\_script\\_include\n-   sys\\_scriplet\\_function\n-   sys\\_ui\\_extension\\_instance\n-   sys\\_playbook\\_experience\\_action\\_assignment\\_map\n-   sys\\_df\\_data\\_filtration\n-   sys\\_email\\_address\\_filt\\_domain\n-   sys\\_atf\\_step\n-   sys\\_atf\\_test\n-   sys\\_atf\\_step\\_config\n-   atf\\_input\\_variable\n\n## Exceptions\n\nTest Agent doesn't support the following metadata:\n\n-   Flows\n-   Configurable workspace steps\n-   Custom UI test steps\n-   Custom test steps\n\n## Scope and availability\n\nTest Agent is available in the following environments and scopes:\n\n|Dimension|Supported values|\n|---------|----------------|\n|Authoring environment|ServiceNow IDE or ServiceNow Studio|\n|Application scope|Global, custom, store|\n|Test types|ATF unit tests, ATF functional tests|\n|Execution target|Cloud runner lanes|\n\n## Example prompts\n\n-   Write an ATF test in the global scope to validate that an employee can order a laptop from the Service Catalog.\n-   Write an ATF test to validate that internal IT knowledge articles are not visible to self‑service users.\n-   Write an ATF test to validate that all mandatory fields on the Incident form are completed before submission.\n\n**Note:** The examples above are prompts for authoring ATF tests in the global scope. To run a test, prompt to execute the ATF test by specifying its name or sys\\_id. To troubleshoot a failure, prompt to triage the failed ATF test by providing the test name or the sys\\_id of the test result.\n\n"}}