1"use strict";(self.webpackChunkKatalon_Docs=self.webpackChunkKatalon_Docs||[]).push([[7534],{28453:(t,e,n)=>{n.d(e,{R:()=>r,x:()=>o});var i=n(96540);const a={},s=i.createContext(a);function r(t){const e=i.useContext(s);return i.useMemo((function(){return"function"==typeof t?t(e):{...e,...t}}),[e,t])}function o(t){let e;return e=t.disableParentContext?"function"==typeof t.components?t.components(a):t.components||a:r(t.components),i.createElement(s.Provider,{value:e},t.children)}},92267:(t,e,n)=>{n.r(e),n.d(e,{assets:()=>d,contentTitle:()=>o,default:()=>h,frontMatter:()=>r,metadata:()=>i,toc:()=>l});const i=JSON.parse('{"id":"data-driven-testing/specify-iteration-names-in-data-driven-testing-reports","title":"Specify iteration names in data-driven testing reports","description":"When a test case is executed with a test data row, it is counted as an iteration. This document shows you how to differentiate iterations in test reports.","source":"@site/docs/katalon-studio/data-driven-testing/specify-iteration-names-in-data-driven-testing-reports.md","sourceDirName":"data-driven-testing","slug":"/data-driven-testing/specify-iteration-names-in-data-driven-testing-reports","permalink":"/katalon-studio/data-driven-testing/specify-iteration-names-in-data-driven-testing-reports","draft":false,"unlisted":false,"tags":[],"version":"current","lastUpdatedAt":1759486971000,"frontMatter":{"title":"Specify iteration names in data-driven testing reports"},"sidebar":"katalon-studio","previous":{"title":"Manage checkpoints","permalink":"/katalon-studio/data-driven-testing/manage-checkpoints"},"next":{"title":"Data-driven testing with RESTful Web Service requests","permalink":"/katalon-studio/data-driven-testing/data-driven-testing-with-restful-web-service-requests"}}');var a=n(74848),s=n(28453);const r={title:"Specify iteration names in data-driven testing reports"},o=void 0,d={},l=[{value:"Set iteration names in data binding",id:"set-iteration-names-in-data-binding",level:2},{value:"View data-driven testing reports",id:"view-data-driven-testing-reports",level:2},{value:"In test cases table",id:"in-test-cases-table",level:3},{value:"In other reports",id:"in-other-reports",level:3}];function c(t){const e={a:"a",admonition:"admonition",code:"code",h2:"h2",h3:"h3",li:"li",ol:"ol",p:"p",strong:"strong",ul:"ul",...(0,s.R)(),...t.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(e.p,{children:"When a test case is executed with a test data row, it is counted as an iteration. This document shows you how to differentiate iterations in test reports."}),"\n",(0,a.jsx)(e.admonition,{type:"note",children:(0,a.jsxs)(e.ul,{children:["\n",(0,a.jsxs)(e.li,{children:["This feature is available for data-driven tests with test suites. The changes only apply in the test suite reports and the ",(0,a.jsx)(e.strong,{children:"Test Case Table"}),"."]}),"\n",(0,a.jsxs)(e.li,{children:["To learn more about data-driven tests, see ",(0,a.jsx)(e.a,{href:"/katalon-studio/data-driven-testing/data-driven-testing-with-katalon-studio",children:"Data-driven Testing with Katalon Studio"}),"."]}),"\n"]})}),"\n",(0,a.jsx)(e.p,{children:"When working with data-driven tests, to quickly identify failed data inputs and parts of the application under test (AUT) that might have a problem, you can add a specific variable from the data file at the end of each iteration name. With this input for iteration name or iteration names, you can differentiate between each iteration in your data-driven testing reports at a glance."}),"\n",(0,a.jsx)(e.h2,{id:"set-iteration-names-in-data-binding",children:"Set iteration names in data binding"}),"\n",(0,a.jsx)(e.p,{children:"To set iteration names using one of the variables in the test data, do as follows:"}),"\n",(0,a.jsxs)(e.ol,{children:["\n",(0,a.jsxs)(e.li,{children:["Perform data-binding from internal data, Excel, CSV, or database data. To learn more about data binding, see ",(0,a.jsx)(e.a,{href:"/katalon-studio/data-driven-testing/data-driven-testing-in-a-test-suite",children:"Run Test Case with an external data source"}),"."]}),"\n",(0,a.jsxs)(e.li,{children:["In the ",(0,a.jsx)(e.strong,{children:"Variable binding"})," section, click on the ",(0,a.jsx)(e.strong,{children:"Select"})," toggle next to ",(0,a.jsx)(e.strong,{children:"Set Test Name"}),"."]}),"\n"]}),"\n",(0,a.jsx)("img",{src:"https://github.com/katalon-studio/docs-images/raw/master/katalon-studio/how-to-guides/specify-iteration-names/set-test-name.png",alt:"Set test name",width:"800"}),"\n",(0,a.jsxs)(e.ol,{start:"3",children:["\n",(0,a.jsx)(e.li,{children:"A list of variables appears. Choose an option to add to your iteration name."}),"\n"]}),"\n",(0,a.jsx)("img",{src:"https://github.com/katalon-studio/docs-images/raw/master/katalon-studio/how-to-guides/specify-iteration-names/select-variable-name.png",alt:"select variable name",width:"800"}),"\n",(0,a.jsxs)(e.ol,{start:"4",children:["\n",(0,a.jsx)(e.li,{children:"Save and run your test."}),"\n"]}),"\n",(0,a.jsx)(e.h2,{id:"view-data-driven-testing-reports",children:"View data-driven testing reports"}),"\n",(0,a.jsx)(e.h3,{id:"in-test-cases-table",children:"In test cases table"}),"\n",(0,a.jsxs)(e.p,{children:["After you set iteration names in data binding, locate and open your test report under ",(0,a.jsx)(e.strong,{children:"Reports"}),". In the ",(0,a.jsx)(e.strong,{children:"Test Cases Table"}),", you can see your iteration names are marked with the variable in the following syntax: ",(0,a.jsx)(e.code,{children:"\u201dTest case name\u201d/\u201dData binding value\u201d (\u201dElapsed time\u201d)"}),"."]}),"\n",(0,a.jsx)("img",{src:"https://github.com/katalon-studio/docs-images/raw/master/katalon-studio/how-to-guides/specify-iteration-names/test-cases-table.png",alt:"Test case table",width:"800"}),"\n",(0,a.jsxs)(e.p,{children:["To learn more about Test Case Table and reports, see ",(0,a.jsx)(e.a,{href:"/katalon-studio/test-reports/view-test-reports/view-test-suite-and-test-suite-collection-reports-in-katalon-studio",children:"Test Suite and Test Suite Collection Reports"}),"."]}),"\n",(0,a.jsx)(e.h3,{id:"in-other-reports",children:"In other reports"}),"\n",(0,a.jsxs)(e.p,{children:["Katalon Studio supports exporting your test suite execution to HTML, CSV, and PDF formats. The iteration names are marked with the data binding value in the following syntax: ",(0,a.jsx)(e.code,{children:'"Test Case ID" | "Data binding value"'}),"."]}),"\n",(0,a.jsx)(e.admonition,{type:"info",children:(0,a.jsxs)(e.ul,{children:["\n",(0,a.jsx)(e.li,{children:"Katalon Studio version 10.2.0 and is required to view iteration names in CSV and PDF reports."}),"\n",(0,a.jsxs)(e.li,{children:["This syntax is also supported in ",(0,a.jsx)(e.strong,{children:"Test case result table"})," of email reports. To learn more email reports, see: ",(0,a.jsx)(e.a,{href:"/katalon-studio/test-reports/share-test-reports-via-email-in-katalon-studio",children:"Share test reports via email"}),"."]}),"\n"]})}),"\n",(0,a.jsxs)(e.ul,{children:["\n",(0,a.jsxs)(e.li,{children:["\n",(0,a.jsx)(e.p,{children:"In HTML report:"}),"\n",(0,a.jsx)("img",{src:"https://tw-cdn.katalon.com/katalon-studio/ks-data-driven-specify-iteration-names/ks-html-report.png",alt:"
1View iteration names HTML report",width:"800"}),"\n"]}),"\n",(0,a.jsxs)(e.li,{children:["\n",(0,a.jsx)(e.p,{children:"In CSV report (available from 10.2.0):"}),"\n",(0,a.jsx)("img",{src:"https://tw-cdn.katalon.com/katalon-studio/ks-data-driven-specify-iteration-names/ks-csv-report-1.png",alt:"View iteration names in CSV report",width:"800"}),"\n"]}),"\n",(0,a.jsxs)(e.li,{children:["\n",(0,a.jsx)(e.p,{children:"In PDF report (available from 10.2.0):"}),"\n",(0,a.jsx)("img",{src:"https://tw-cdn.katalon.com/katalon-studio/ks-data-driven-specify-iteration-names/ks-pdf-report.png",alt:"View iteration names in PDF report",width:"600"}),"\n"]}),"\n"]}),"\n",(0,a.jsxs)(e.p,{children:["To learn how to export reports to other formats, see ",(0,a.jsx)(e.a,{href:"/katalon-studio/test-reports/view-test-reports/view-test-suite-and-test-suite-collection-reports-in-katalon-studio",children:"Export reports to other formats"}),"."]})]})}function h(t={}){const{wrapper:e}={...(0,s.R)(),...t.components};return e?(0,a.jsx)(e,{...t,children:(0,a.jsx)(c,{...t})}):c(t)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.