{
    "componentChunkName": "component---src-templates-doc-page-js",
    "path": "/docs/en/common/bot_structure/xml/",
    "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"ae7dcec0-0547-5775-808d-414de62986a9","excerpt":"Test files?>  are automatic test files written in the XML language. Tests have the following structure: In most cases, tests are step-by-step descriptions of a…","html":"<h1>Test files</h1>\n<hr>\n<p class='warn'><code class=\"language-text\">.xml</code> are automatic test files written in the XML language.</p>\n<p>Tests have the following structure:</p>\n<div class=\"gatsby-highlight\" data-language=\"xml\"><pre class=\"language-xml\"><code class=\"language-xml\"><span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;</span>test</span><span class=\"token punctuation\">></span></span>\n    <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;</span>test-case</span><span class=\"token punctuation\">></span></span>\n        <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;</span>q</span><span class=\"token punctuation\">></span></span>User request<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;/</span>q</span><span class=\"token punctuation\">></span></span>\n        <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;</span>a</span><span class=\"token punctuation\">></span></span>Bot response<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;/</span>a</span><span class=\"token punctuation\">></span></span>\n    <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;/</span>test-case</span><span class=\"token punctuation\">></span></span>\n\n    <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;</span>test-case</span><span class=\"token punctuation\">></span></span>\n        <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;</span>q</span><span class=\"token punctuation\">></span></span>User request<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;/</span>q</span><span class=\"token punctuation\">></span></span>\n        <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;</span>a</span><span class=\"token punctuation\">></span></span>Bot response<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;/</span>a</span><span class=\"token punctuation\">></span></span>\n    <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;/</span>test-case</span><span class=\"token punctuation\">></span></span>\n<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\">&lt;/</span>test</span><span class=\"token punctuation\">></span></span></code></pre></div>\n<p>In most cases, tests are step-by-step descriptions of a conversation between a user and a bot where expected responses of the bot are specified.</p>\n<p>Test cases are specified within the <code class=\"language-text\">&lt;test>...&lt;/test></code> root tag. Each test case describes a new session and a new client, so the <a href=\"/1.10.5/docs/en/JS_API/variables/session\"><code class=\"language-text\">$session</code></a> and <a href=\"/1.10.5/docs/en/JS_API/variables/client\"><code class=\"language-text\">$client</code></a> variables are reset before each test.</p>\n<p class='warn'><a href=/1.10.5/docs/en/Content_testing/tests_xml/tests_xml  >Learn more about script testing</a></p>\n<p class='tip'>Please note that symbols like <code class=\"language-text\">\\&amp;</code> <a href=https://stackoverflow.com/questions/1091945/what-characters-do-i-need-to-escape-in-xml-documents target=\"_blank\" rel=\"noopener noreferrer\">must be escaped in xml</a>.</p>\n</br>\n<h4>Including tests</h4>\n<p>Any tests located in the <code class=\"language-text\">test</code> folder run automatically when you deploy your bot. You can override this behavior in the <code class=\"language-text\">chatbot.yaml</code> file in the <code class=\"language-text\">tests</code> section.</p>\n<p>The <code class=\"language-text\">tests</code> section can contain two subsections, <code class=\"language-text\">include</code> and <code class=\"language-text\">exclude</code>, each of them being the list of <a href=\"http://ant.apache.org/manual/dirtasks.html#patterns\" target=\"_blank\" rel=\"noopener noreferrer\">ant templates</a> with file names.</p>\n<ul>\n<li><code class=\"language-text\">include</code> — only the tests from the files that match the templates listed in this section will be executed.</li>\n<li><code class=\"language-text\">exclude</code> — all the files matching the templates listed in this section will be excluded from execution.</li>\n</ul>\n<p>For example:</p>\n<div class=\"gatsby-highlight\" data-language=\"yaml\"><pre class=\"language-yaml\"><code class=\"language-yaml\"><span class=\"token key atrule\">tests</span><span class=\"token punctuation\">:</span>\n  <span class=\"token key atrule\">include</span><span class=\"token punctuation\">:</span>\n    <span class=\"token punctuation\">-</span> tests.xml\n    <span class=\"token punctuation\">-</span> delivery.xml\n    <span class=\"token punctuation\">-</span> order.xml\n    <span class=\"token punctuation\">-</span> cart.xml\n    <span class=\"token punctuation\">-</span> otherCities.xml\n    <span class=\"token punctuation\">-</span> sauces.xml\n  <span class=\"token key atrule\">exclude</span><span class=\"token punctuation\">:</span>\n    <span class=\"token punctuation\">-</span> time.xml</code></pre></div>","frontmatter":{"title":"","description":null},"headings":[{"value":"Test files"}]}},"pageContext":{"slug":"/docs/en/common/bot_structure/xml/","previous":{"fields":{"slug":"/docs/en/common/bot_structure/yaml/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/en/common/bot_structure/sys_modules/"},"frontmatter":{"title":"","description":null}}}},
    "staticQueryHashes": ["1209419333"]}