XTractor - Online Guide
<!-- If the browser does not support frames put the first topic content here --> <div class="WordSection1"> <h2><a name="_Toc478918658"></a><a name="_Toc478918640"><span lang= "EN-GB" xml:lang="EN-GB">Overview</span></a></h2> <div style= 'border:none;border-bottom:solid #BFBFBF 1.0pt;padding:0in 0in 2.0pt 0in'> <h3><a name="node146" id="node146"></a>Purpose</h3> </div> <h4><a name="node147" id="node147"></a>Description</h4> <p class="MsoNormal" style='page-break-after:avoid'><a name= "_Hlk516908307"><b><span style= 'color:#A6A6A6'>X</span></b></a><b><span style= 'color:#7F7F7F'>Tractor</span></b> is a desktop software allowing to setup and automate all kind of <a href= "https://www.atinternet.com/en/" target="_blank">AT Internet</a> Data extractions without writing a single line of code. With one call, it iterates all Data Queries pages over a set of Sites and Periods, and consolidates extracted results even when they contains <a href="3_Sites.htm#_Site_Custom_Indicators" target="_blank" title="A feature which is used to customise the performance analyses of an audience by integrating specific criteria into the tag code."> Custom Dimensions</a>.</p> <p class="MsoNormal" style='page-break-after:avoid'><b><span style= 'color:#A6A6A6'>X</span></b><b><span style= 'color:#7F7F7F'>Tractor</span></b> belongs to <a href= "http://www.xtagmanager.com/" target="_blank">XTagManager suite</a>, but it is free and always will be. It is made of two modules available for <a href= "8_Downloads.htm#_Downloads">download</a>:</p> <table class="Listeclaire1" border="0" cellspacing="0" cellpadding= "0" width="95%" style= 'width:95.6%;border-collapse:collapse;border:none'> <tr> <td width="26" valign="top" style= 'width:19.5pt;padding:0in 0in 0in 5.75pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="11" height="11" id="Graphic 2" src="XTractor_files/image001.png" alt= "Checkmark" name="Graphic 2" /></span> </p> </td> <td width="802" valign="top" style= 'width:601.15pt;padding:0in 5.75pt 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:-4.3pt;page-break-after:avoid'> The core engine, called <a href= "6_CommandLine.htm#_Command_Line">Command Line</a> module: it performs all operations from instructions provided in configuration files (Dataset and Sites group).</p> </td> </tr> <tr> <td width="26" valign="top" style= 'width:19.5pt;padding:0in 0in 0in 5.75pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="11" height="11" id="Graphic 3" src="XTractor_files/image001.png" alt= "Checkmark" name="Graphic 3" /></span> </p> </td> <td width="802" valign="top" style= 'width:601.15pt;padding:0in 5.75pt 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:-4.6pt;page-break-after:avoid'> The UI module: an assistant to create and maintain these configuration files.</p> </td> </tr> </table> <p class="MsoNormal"><img border="0" width="901" height="336" id= "Picture 1" src="XTractor_files/image002.png" alt="image" name= "Picture 1" /></p> <table class="Listeclaire1" border="0" cellspacing="0" cellpadding= "0" width="95%" style= 'width:95.6%;border-collapse:collapse;border:none'> <tr> <td width="34" valign="top" style= 'width:25.45pt;padding:0in 0in 0in 5.75pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="11" height="11" id="Graphic 89" src="XTractor_files/image001.png" alt= "Checkmark" name="Graphic 89" /></span><b><span style= 'color:#0070C0'> </span></b></p> </td> <td width="1348" valign="top" style= 'width:1011.05pt;padding:0in 5.75pt 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:-4.6pt;page-break-after:avoid'> <b><span style='color:#A6A6A6'>X</span></b><b><span style= 'color:#7F7F7F'>Tractor</span></b> works with ATI Data Query URLs provided by <a href= "https://apps.atinternet-solutions.com/DataQuery/Designer/#/" target="_blank">ATI Data Query Designer</a> or <a href= "https://chrome.google.com/webstore/detail/xtag-at-internet-record-c/fljcgdiejmmkldmmpnoaijajjgpcncnb" target="_blank" title="Chrome extension">XTag AT Internet</a>, then imported in <a href="1_Overview.htm#_Queries">Queries</a> list.</p> </td> </tr> <tr> <td width="34" valign="top" style= 'width:25.45pt;padding:0in 0in 0in 5.75pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="11" height="11" id="Graphic 29" src="XTractor_files/image001.png" alt= "Checkmark" name="Graphic 29" /></span> </p> </td> <td width="1348" valign="top" style= 'width:1011.05pt;padding:0in 5.75pt 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:-4.6pt;page-break-after:avoid'> It allows defining reusables <a href="3_Sites.htm#_Sites">Sites</a> groups for which these Queries will be executed, even when they contain custom dimensions or segments based on them.</p> </td> </tr> <tr> <td width="34" valign="top" style= 'width:25.45pt;padding:0in 0in 0in 5.75pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="11" height="11" id="Graphic 30" src="XTractor_files/image001.png" alt= "Checkmark" name="Graphic 30" /></span> </p> </td> <td width="1348" valign="top" style= 'width:1011.05pt;padding:0in 5.75pt 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:-4.6pt;page-break-after:avoid'> It extends data extraction thanks to a list of fixed or relative <a href="4_Periods.htm#_Periods">Periods</a>, optionally merged.</p> </td> </tr> <tr> <td width="34" valign="top" style= 'width:25.45pt;padding:0in 0in 0in 5.75pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="11" height="11" id="Graphic 94" src="XTractor_files/image001.png" alt= "Checkmark" name="Graphic 94" /></span> </p> </td> <td width="1348" valign="top" style= 'width:1011.05pt;padding:0in 5.75pt 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:-4.6pt;page-break-after:avoid'> It generates CSV files (tab delimited), then allows opening them as tables for instant <a href= "5_Assessments.htm#_Assessments">Assessments</a>.</p> </td> </tr> </table> <p class="MsoBodyText" style= 'margin:0in;margin-bottom:.0001pt;line-height:50%'><span lang= "EN-GB" xml:lang="EN-GB"> </span></p> <h4><a name="node148" id="node148"></a>Features</h4> <h5><a name="node149" id="node149"></a>Full extractor, without development nor limit</h5> <p class="MsoNormal" style='page-break-after:avoid'><b><span style= 'color:#A6A6A6'>X</span></b><b><span style= 'color:#7F7F7F'>Tractor</span></b> can iterate all results pages of each Data Query, for each given site and periods.</p> <p class="MsoNormal" style='page-break-after:avoid'>When you reach Data Query’s rows limits, just split in several Periods and ask <b><span style='color:#A6A6A6'>X</span><span style= 'color:#7F7F7F'>Tractor</span></b> to <a href= "1_Overview.htm#_Merge_Periods">Merge Periods</a>.</p> <p class="MsoNormal" style='page-break-after:avoid'>When you reach Data Query’s filters limits, just split in several Queries with the same root name (differentiated by hashtags), it will be used by <b><span style='color:#A6A6A6'>X</span><span style= 'color:#7F7F7F'>Tractor</span></b> to merge the <a href= "2_Queries.htm#_Result_File_Name">Result Files</a>.</p> <table class="MsoTableGrid" border="0" cellspacing="0" cellpadding= "0" width="100%" style= 'width:100.0%;background:#00B0F0;border-collapse:collapse;border:none'> <tr> <td width="1258" valign="top" style= 'width:943.8pt;padding:2.9pt 5.75pt 2.9pt 5.75pt'> <p class="Nodebody" style='background:transparent'><i><span style= 'font-size: 9.0pt;color:white'>There’s one limitation however: XTractor doesn’t support Data Query with comparison periods. By design, this must be achieved by declaring the two different periods.</span></i></p> <p class="Nodebody" style='background:transparent'><i><span style= 'font-size: 9.0pt;color:white'>As a result, the comparison is not provided in additional columns, but additional rows.</span></i></p> </td> </tr> </table> <h5><a name="node150" id="node150"></a>Flexible consolidator, without development nor limit</h5> <p class="MsoNormal" style='page-break-after:avoid'>At any moment, you can create your own sites group and extract any data history.</p> <p class="MsoNormal" style='page-break-after:avoid'><a href= "3_Sites.htm#_Site_Custom_Indicators">Custom Dimensions</a> (source types, metrics, site/page variables) are automatically mapped for each site, then consolidated in the same column with their understandable name. <a href="3_Sites.htm#_Segment">Segments</a> based on them can also be used in queries, when they have been declared for each Site.</p> <h5><a name="node151" id="node151"></a>Schedulable</h5> <p class="MsoNormal" style='page-break-after:avoid'>Can work silently in command line, with Windows Task Scheduler, Mac Automator or Linux Cron or any scheduling tool, thanks to operation control based on configuration files.</p> <h5><a name="node152" id="node152"></a>Multi-platforms</h5> <p class="MsoNormal" style='page-break-after:avoid'>Command line module is available for Windows, macOS and Linux.</p> <p class="MsoBodyText" style= 'margin:0in;margin-bottom:.0001pt;line-height:50%'><span lang= "EN-GB" xml:lang="EN-GB"> </span></p> <div style= 'border:none;border-bottom:solid #BFBFBF 1.0pt;padding:0in 0in 2.0pt 0in'> <h3><a name="_How_to_use"></a>How to use</h3> </div> <h4><a name="node153" id="node153"></a>Prerequisites</h4> <h5><a name="node154" id="node154"></a>UI Module</h5> <p class="MsoNormal" style='page-break-after:avoid'>This executable is an Office application: Excel 2010 or further must be installed.</p> <p class="MsoNormal" style='page-break-after:avoid'>XTractorUI32 must be used with Excel 32 bits versions, XTractorUI64 with Excel 64 bits versions: <a href="8_Downloads.htm#_Downloads">Windows Installer</a> installs the proper one, but if you’ve done a manual installation and that you have a doubt, just run one of them, it will warn if you don’t use the proper version.</p> <h5><a name="node155" id="node155"></a>Command Line Module</h5> <p class="MsoNormal" style='page-break-after:avoid'>You must provide a valid <a href="#_ATI_Credentials">AT Internet account</a> for all data extractions.</p> <h4><a name="node156" id="node156"></a>Operations</h4> <table class="MsoTableGrid" border="0" cellspacing="0" cellpadding= "0" width="100%" style= 'width:100.0%;border-collapse:collapse;border:none'> <tr> <td width="21" valign="top" style= 'width:15.95pt;padding:0in 0in 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:.5pt;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <b><span style='color:#404040'>1.</span></b></p> </td> <td width="1088" valign="top" style= 'width:816.25pt;padding:0in 0in 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> Enter the <a href="1_Overview.htm#_Dataset_name">name</a> of your Dataset configuration and its <a href= "1_Overview.htm#_Results_Folder">Result Folder</a></p> </td> </tr> <tr> <td width="21" valign="top" style= 'width:15.95pt;padding:0in 0in 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:.5pt;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <b><span style='color:#404040'>2.</span></b></p> </td> <td width="1088" valign="top" style= 'width:816.25pt;padding:0in 0in 0in 0in'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <a href="2_Queries.htm#_Import">Import</a> at least one Data Query URL in the <a href="1_Overview.htm#_Online_guide">Queries</a> tab</p> </td> </tr> <tr style='height:7.6pt'> <td width="21" valign="top" style= 'width:15.95pt;padding:0in 0in 0in 0in; height:7.6pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:.5pt;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <b><span lang="EN-GB" style='color:#404040' xml:lang= "EN-GB">3.</span></b></p> </td> <td width="1088" valign="top" style= 'width:816.25pt;padding:0in 0in 0in 0in; height:7.6pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB">Select a Site group in</span> <a href="3_Sites.htm#_Sites"><span lang="EN-GB" xml:lang= "EN-GB">Sites</span></a> <span lang="EN-GB" xml:lang= "EN-GB">tab.</span></p> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB">If there’s still no group created, download one provided by Web Analytics Team in</span> <b><span style='color:#A6A6A6'>X</span></b><b><span style= 'color:#7F7F7F'>Tractor</span></b> installation directory.</p> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> If there’s none provided, <span lang="EN-GB" xml:lang="EN-GB">enter the list of sites ID you want to address in the first column, then click on</span> <a href="3_Sites.htm#_Update"><span lang="EN-GB" xml:lang="EN-GB">Update</span></a><span lang="EN-GB" xml:lang= "EN-GB">, wait for Sites data completion and click on</span> <a href="3_Sites.htm#_Save_As_1"><span lang="EN-GB" xml:lang= "EN-GB">Save As</span></a> <span lang="EN-GB" xml:lang="EN-GB">to give this group a name.</span></p> </td> </tr> <tr style='height:7.6pt'> <td width="21" valign="top" style= 'width:15.95pt;padding:0in 0in 0in 0in; height:7.6pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:.5pt;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <b><span style='color:#404040'>4.</span></b></p> </td> <td width="1088" valign="top" style= 'width:816.25pt;padding:0in 0in 0in 0in; height:7.6pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> Select at least one period type in the <a href= "4_Periods.htm#_CTAs_assessment_1">Periods</a> tab, then enter it or adjust the proposed one.</p> </td> </tr> <tr style='height:7.6pt'> <td width="21" valign="top" style= 'width:15.95pt;padding:0in 0in 0in 0in; height:7.6pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:.5pt;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <b><span lang="EN-GB" style='color:#404040' xml:lang= "EN-GB">5.</span></b></p> </td> <td width="1088" valign="top" style= 'width:816.25pt;padding:0in 0in 0in 0in; height:7.6pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> Click on <a href="1_Overview.htm#_Run_XTractor">Run XTractor</a></p> </td> </tr> <tr style='height:7.6pt'> <td width="21" valign="top" style= 'width:15.95pt;padding:0in 0in 0in 0in; height:7.6pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:.5pt;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <b><span lang="EN-GB" style='color:#404040' xml:lang= "EN-GB">6.</span></b></p> </td> <td width="1088" valign="top" style= 'width:816.25pt;padding:0in 0in 0in 0in; height:7.6pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> Once data extraction achieved successfully, you can optionally click on <a href="1_Overview.htm#_Open_Results_Files">Open Results Files</a>, then open one or several generated file(s).</p> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> If XTractor warned an <a href= "1_Overview.htm#_Online_guide">error</a>, fix it and relaunch your data extraction.</p> </td> </tr> </table> <p class="MsoNormal" style= 'margin-top:6.0pt;page-break-after:avoid'>See <a href= "5_Assessments.htm#_Assessments">Assessment</a> for a complete illustrated example.</p> <p class="MsoBodyText" style= 'margin:0in;margin-bottom:.0001pt;line-height:50%'><span lang= "EN-GB" xml:lang="EN-GB"> </span></p> <div style= 'border:none;border-bottom:solid #BFBFBF 1.0pt;padding:0in 0in 2.0pt 0in'> <h3><a name="_Toc478918690"></a><a name= "_Toc478918691"></a><a name="_Node(s)_Selector_3"></a><a name= "_Value_indicator"></a><a name="_General_rules"></a><a name= "_General_commands"></a>General commands</h3> </div> <h4><a name="_Manage"></a>Manage</h4> <p class="MsoNormal" style='page-break-after:avoid'><span lang= "EN-GB" xml:lang="EN-GB"><img border="0" width="146" height="67" id="Picture 98" src="XTractor_files/image003.jpg" alt="image" name= "Picture 98" /></span></p> <h5><a name="node157" id="node157"></a>New</h5> <p class="MsoNormal" style='page-break-after:avoid'>After confirmation, discard all current changes and start a blank Dataset configuration.</p> <h5><a name="node158" id="node158"></a>Open</h5> <p class="MsoNormal" style='page-break-after:avoid'>After confirmation, open an existing Dataset configuration.</p> <h5><a name="_Save"></a>Save</h5> <p class="MsoNormal" style='page-break-after:avoid'>After confirmations, save all changes in [DatasetName].json. To Save As, just change the dataset name before saving.</p> <h5><a name="_Dataset_name"></a>Dataset name</h5> <p class="MsoNormal" style='page-break-after:avoid'>Enter the dataset name. That will be the name of the JSON file where dataset configuration will be saved.</p> <h5><a name="node159" id="node159"></a>AT Internet Credentials</h5> <p class="MsoNormal">Enter you AT Internet credentials, then click on OK. There’s no verification of credential validity.</p> <p class="MsoNormal"><span lang="EN-GB" xml:lang= "EN-GB"><img border="0" width="207" height="118" id="Picture 97" src="XTractor_files/image004.jpg" alt="image" name= "Picture 97" /></span></p> <table class="MsoTableGrid" border="0" cellspacing="0" cellpadding= "0" width="100%" style= 'width:100.0%;background:#00B0F0;border-collapse:collapse;border:none'> <tr> <td width="866" valign="top" style= 'width:649.2pt;padding:2.9pt 5.75pt 2.9pt 5.75pt'> <p class="Nodebody" style='background:transparent'><i><span style= 'font-size: 9.0pt;color:white'>Your credentials are stored in computer’s registry</span></i><i><span lang="EN-GB" style= 'font-size:9.0pt;color:white' xml:lang="EN-GB">, and ten reused for each Dataset</span></i></p> </td> </tr> </table> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> <span lang="EN-GB" xml:lang="EN-GB"> </span></p> <h4><a name="node160" id="node160"></a>Configure</h4> <p class="MsoNormal" style='page-break-after:avoid'><span lang= "EN-GB" xml:lang="EN-GB"><img border="0" width="236" height="67" id="Picture 99" src="XTractor_files/image005.jpg" alt="image" name= "Picture 99" /></span></p> <h5><a name="_Results_Folder"></a>Results Files Folder</h5> <p class="MsoNormal" style='page-break-after:avoid'>Enter the relative or absolute directory path used as root directory for results files generation. If this directory doesn’t exist, it will be created. See <a href="6_CommandLine.htm#_Output">here</a> for more details.</p> <h5><a name="node161" id="node161"></a>Periods Subfolders</h5> <p class="MsoNormal" style='page-break-after:avoid'>Select to create period(s) subfolder(s) under Results Folders specified above. Let unselected to create results files directly in this folder. See <a href="6_CommandLine.htm#_SubFolders">here</a> for more details.</p> <h5><a name="node162" id="node162"></a>Site Name To ID</h5> <p class="MsoNormal" style='page-break-after:avoid'>When selected, Site Name is replaced by the corresponding Site ID in all Result Files (<b><span style='color:#595959'>d_site</span></b> column). It’s useful when results are embedded in a database where Site ID is the primary key (keeping in mind that Site Name can be sometimes changed). Let unselected to keep Site Name. Si <a href= "6_CommandLine.htm#_SiteName2ID">here</a> for more details.</p> <h5><a name="node163" id="node163"></a>Overwrite Files</h5> <p class="MsoNormal" style='page-break-after:avoid'>If Selected, when result file already exists, it is overwritten. When <span style='color:#404040'>Periods SubFolders</span> is not selected with more than one period measured, result file name is appended with the begin date month to avoid each period to be overwritten by the subsequent one.</p> <p class="MsoNormal" style='page-break-after:avoid'>If not selected, result file name is completed with an unused index to avoid overwriting: …_01.csv, or …_02.csv, etc… See <a href= "6_CommandLine.htm#_Overwrite">here</a> for more details.</p> <h5><a name="_Merge_Periods"></a>Merge Periods</h5> <p class="MsoNormal" style='page-break-after:avoid'>Select to create only one <span style='color:#404040'>Result File</span> per Data Query, whatever the number of periods. If <span style= 'color:#404040'>Periods SubFolders</span> above is selected too, this unique file will be created in a subfolder.</p> <p class="MsoNormal" style='page-break-after:avoid'>When not selected, a new file is generated for each period and each query (one sub-directory per period when <span style= 'color:#404040'>Periods SubFolders</span> is selected). See <a href="6_CommandLine.htm#_MergeFiles">here</a> for more details.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'><a name= "_Overwrite_Files"></a> </p> <h4><a name="node164" id="node164"></a>Get Results</h4> <p class="MsoNormal" style='page-break-after:avoid'><span lang= "EN-GB" xml:lang="EN-GB"><img border="0" width="91" height="67" id= "Picture 100" src="XTractor_files/image006.jpg" alt="image" name= "Picture 100" /></span></p> <h5><a name="_Run_XTractor"></a>Run XTractor</h5> <p class="MsoNormal" style='page-break-after:avoid'>Save the current Dataset and run data extraction.</p> <p class="MsoNormal" style='page-break-after:avoid'>Ensure before that you have entered your ATI Credentials, otherwise you’ll be warned.</p> <p class="MsoNormal" style='page-break-after:avoid'>Ensure also there’s at least one Query selected, with at least one Site defined in selected group, and at least one Period setup. If it’s not the case, you’ll be warned.</p> <p class="MsoNormal" style='page-break-after:avoid'>If everything’s OK, data extraction is started:</p> <p class="MsoNormal" style='page-break-after:avoid'><span lang= "EN-GB" xml:lang="EN-GB"><img border="0" width="598" height="178" id="Picture 40" src="XTractor_files/image007.jpg" alt="image" name= "Picture 40" /></span></p> <p class="MsoNormal" style='page-break-after:avoid'>If no error happens during extraction, XTractor blue console is closed and you can <a href="1_Overview.htm#_Open_Results_Files_1">Open Results Files</a> or use them for your needs.</p> <p class="MsoNormal" style='page-break-after:avoid'>In case of error, it remains displayed to show you what’s wrong (see <a href= "2_Queries.htm#_How_to_solve">how to solve processing errors</a>).</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h5><a name="_Open_Results_Files"></a>Open Results Files</h5> <p class="MsoNormal" style= 'margin-top:3.0pt;margin-right:0in;margin-bottom:3.0pt; margin-left:0in;page-break-after:avoid'> Once measurement successfully achieved, select the corresponding file name:</p> <p class="MsoNormal" style= 'margin-top:3.0pt;margin-right:0in;margin-bottom:3.0pt; margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="577" height="258" id="Picture 34" src="XTractor_files/image008.jpg" alt= "image" name="Picture 34" /></span></p> <p class="MsoNormal" style= 'margin-top:3.0pt;margin-right:0in;margin-bottom:3.0pt; margin-left:0in;page-break-after:avoid'> The file is open as table, taking benefit of Table Tools Design and Data features:</p> <p class="MsoNormal" style= 'margin-top:3.0pt;margin-right:0in;margin-bottom:3.0pt; margin-left:0in;page-break-after:avoid'> <span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="661" height="198" id="Picture 35" src="XTractor_files/image009.jpg" alt= "image" name="Picture 35" /></span><br /> <br /></p> <p class="MsoNormal" style= 'margin-top:3.0pt;margin-right:0in;margin-bottom:3.0pt; margin-left:0in;page-break-after:avoid'> You can work on it and save the Excel Workbook (original CSV file will be kept as it is).</p> <p class="MsoNormal" style='page-break-after:avoid'>You can select another one, it will be open in the same workbook, so that you’ll be able to create instant <a href= "5_Assessments.htm#_Tables_Relationships">relationships</a>.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="_Open_Results_Files_1"></a>Help</h4> <p class="MsoNormal" style='page-break-after:avoid'><span lang= "EN-GB" xml:lang="EN-GB"><img border="0" width="68" height="67" id= "Picture 101" src="XTractor_files/image010.jpg" alt="image" name= "Picture 101" /></span></p> <h5><a name="_Input_Helpers"></a>Input Helpers</h5> <p class="MsoNormal" style='page-break-after:avoid'>Displays Input tips for fulfilling columns fields:</p> <p class="MsoNormal" style='page-break-after:avoid'><span lang= "EN-GB" xml:lang="EN-GB"><img border="0" width="284" height="164" id="Picture 108" src="XTractor_files/image011.jpg" alt="image" name="Picture 108" /></span></p> <p class="MsoNormal" style='page-break-after:avoid'>It is useful for XTractor beginners and deactivated by default. You can activate it permanently until you feel comfortable with required fields, and then deactivate it when you’re bored to see those messages.</p> <h5><a name="node165" id="node165"></a>Online Guide</h5> <p class="MsoNormal" style='page-break-after:avoid'>Open this guide at the proper section, depending on activated tab.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <div style= 'border:none;border-bottom:solid #BFBFBF 1.0pt;padding:0in 0in 2.0pt 0in'> <h3><a name="_Online_guide"></a><a name= "_Copy_one_tag,"></a><a name="_Tags_recorder"></a><a name= "_Queries"></a><a name="_Errors"></a>Errors</h3> </div> <h4><a name="node166" id="node166"></a>Access rights</h4> <p class="MsoNormal" style='page-break-after:avoid'><span lang= "EN-GB" xml:lang="EN-GB"><img border="0" width="546" height="254" id="Picture 49" src="XTractor_files/image012.jpg" alt="image" name= "Picture 49" /></span></p> <p class="MsoNormal" style='page-break-after:avoid'><b><span style= 'color:#0070C0'>>></span></b> Ensure you have entered correct credentials, and that you are granted on the sites you want to extract.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="node167" id="node167"></a>Malformed Queries</h4> <p class="MsoNormal" style= 'margin-left:10.0pt;page-break-after:avoid'><span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="700" height="240" id= "Picture 69" src="XTractor_files/image013.jpg" alt="image" name= "Picture 69" /></span></p> <p class="MsoNormal" style= 'margin-left:10.0pt;page-break-after:avoid'><b><span style= 'color:#0070C0'>>></span></b> Your query has been probably modified manually, and a mistake has been made. Rebuild it with AT Internet Data Query Designer.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="node168" id="node168"></a>Undefined custom variable</h4> <p class="MsoNormal" style= 'margin-left:10.0pt;page-break-after:avoid'><span lang="EN-GB" xml:lang="EN-GB"><img border="0" width="773" height="241" id= "Picture 70" src="XTractor_files/image014.jpg" alt="image" name= "Picture 70" /></span></p> <p class="MsoNormal" style= 'margin-left:10.0pt;page-break-after:avoid'><b><span style= 'color:#0070C0'>>></span></b> Ensure that your Sites Group defines the corresponding custom variable. If you’re not sure, click on <a href="3_Sites.htm#_Update">Update</a>.</p> <p class="MsoNormal" style= 'margin-left:10.0pt;page-break-after:avoid'><b><span style= 'color:#0070C0'>>></span></b> If it still doesn’t work, it means that the Site used to build this query is no longer present in Sites group, so consider one of these actions:</p> <p class="MsoListParagraph" style= 'text-indent:-17.0pt;page-break-after:avoid'><b><span style= 'color:#0070C0'>1.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> If removing this Site was a mistake, re-add it in the group (just its ID), then click on <a href= "3_Sites.htm#_Update">Update</a>.</p> <p class="MsoNormal" style= 'margin-top:1.0pt;margin-right:0in;margin-bottom:1.0pt; margin-left:18.7pt;page-break-after:avoid'> If it was voluntary:</p> <p class="MsoListParagraphCxSpFirst" style= 'text-indent:-17.0pt;page-break-after: avoid'><b><span style= 'color:#0070C0'>2.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Pick one cl_xxx value with the same name in Sites group (custom variable columns), then edit manually the query to replace the one indicated in error message (cl_27610 in example above) with picked value.</p> <p class="MsoListParagraphCxSpLast" style= 'text-indent:-17.0pt;page-break-after: avoid'><b><span style= 'color:#0070C0'>3.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Replace the faulted value (cl_27610 in example above) by the corresponding variable name defined in Sites group (custom variable columns), for example: origin.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="_Other_errors"></a><a name="_Query_errors"></a>Query errors</h4> <p class="MsoListParagraphCxSpFirst" style= 'margin-top:0in;margin-right:0in; margin-bottom:6.0pt;margin-left:.25in;text-indent:-.25in;page-break-after:avoid'> <b><span style='color:#0070C0'>1.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Click on Open Results Files.</p> <p class="MsoListParagraphCxSpMiddle" style= 'margin-top:0in;margin-right:0in; margin-bottom:6.0pt;margin-left:.25in;text-indent:-.25in;page-break-after:avoid'> <b><span style='color:#0070C0'>2.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Navigate into _logs subfolder.<br /> <span lang="FR" xml:lang="FR"><img border="0" width="566" height= "254" id="Picture 73" src="XTractor_files/image015.jpg" alt="image" name="Picture 73" /></span></p> <p class="MsoListParagraphCxSpMiddle" style= 'margin-top:0in;margin-right:0in; margin-bottom:6.0pt;margin-left:.25in;text-indent:-.25in;page-break-after:avoid'> <b><span style='color:#0070C0'>3.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Open the file named the same than your Dataset, suffixed with <span style='color:#404040'>_Errors</span>.<br /> <span lang="FR" xml:lang="FR"><img border="0" width="568" height= "254" id="Picture 74" src="XTractor_files/image016.jpg" alt="image" name="Picture 74" /></span></p> <p class="MsoListParagraphCxSpLast" style= 'margin-left:.25in;text-indent:-.25in; page-break-after:avoid'> <b><span style='color:#0070C0'>4.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> You will see all errors detailed:<br /> <span lang="FR" xml:lang="FR"><img border="0" width="914" height= "58" id="Picture 75" src="XTractor_files/image017.jpg" alt="image" name="Picture 75" /></span><br /> <br /></p> <table class="MsoTable15Plain1" border="1" cellspacing="0" cellpadding="0" width="100%" style= 'width:100.0%;margin-left:17.7pt;border-collapse:collapse;border:none'> <tr> <td width="78" valign="top" style= 'width:58.5pt;border:solid #BFBFBF 1.0pt; background:#EAF1DD;padding:0in 5.4pt 0in 5.4pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>Status</span></p> </td> <td width="1047" colspan="2" valign="top" style= 'width:785.1pt;border:solid #BFBFBF 1.0pt; border-left:none;background:#EAF1DD;padding:0in 5.4pt 0in 5.4pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>See</span> <a href= "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html" target= "_blank"><span style='font-size:9.0pt'>status code</span></a></p> </td> </tr> <tr> <td width="78" valign="top" style= 'width:58.5pt;border:solid #BFBFBF 1.0pt; border-top:none;padding:0in 5.4pt 0in 5.4pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>ATI Code</span></p> </td> <td width="1047" colspan="2" valign="top" style= 'width:785.1pt;border-top:none; border-left:none;border-bottom:solid #BFBFBF 1.0pt;border-right:solid #BFBFBF 1.0pt; padding:0in 5.4pt 0in 5.4pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>See</span> <a href= "https://developers.atinternet-solutions.com/rest-api-en/technical-specifications-rest-en/error-codes-rest-en/" target="_blank"><span style='font-size:9.0pt'>AT Internet error codes</span></a><span style='font-size:9.0pt'>.</span></p> </td> </tr> <tr> <td width="78" valign="top" style= 'width:58.5pt;border:solid #BFBFBF 1.0pt; border-top:none;background:#EAF1DD;padding:0in 5.4pt 0in 5.4pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>Error Level</span></p> </td> <td width="1047" colspan="2" valign="top" style= 'width:785.1pt;border-top:none; border-left:none;border-bottom:solid #BFBFBF 1.0pt;border-right:solid #BFBFBF 1.0pt; background:#EAF1DD;padding:0in 5.4pt 0in 5.4pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>See</span> <a href= "6_CommandLine.htm#_Error_Level_1"><span style= 'font-size:9.0pt'>Error Level</span></a></p> </td> </tr> <tr> <td width="78" rowspan="3" valign="top" style= 'width:58.5pt;border:solid #BFBFBF 1.0pt; border-top:none;padding:0in 5.4pt 0in 5.4pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>Message</span></p> </td> <td width="1047" colspan="2" valign="top" style= 'width:785.1pt;border-top:none; border-left:none;border-bottom:solid #BFBFBF 1.0pt;border-right:solid #BFBFBF 1.0pt; padding:0in 5.4pt 0in 5.4pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>When available, an understandable explanation of issue.</span></p> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>In case of connectivity issue (starting by <span style='color:#595959'>Failed to establish a new connection:...</span>) it also contains a system error code, like <span style='color:#595959'>[WinError 10060]</span>.<br /> Advanced users can interpret it with</span> <a href= "https://support.microsoft.com/en-us/help/819124/windows-sockets-error-codes-values-and-meanings" target="_blank"><span style='font-size:9.0pt'>Windows socket error codes</span></a><span style='font-size:9.0pt'>. Most common ones are:</span></p> </td> </tr> <tr style='height:2.1pt'> <td width="54" valign="top" style= 'width:40.5pt;border-top:none;border-left:none; border-bottom:solid #BFBFBF 1.0pt;border-right:solid #BFBFBF 1.0pt; background:white;padding:0in 5.4pt 0in 5.4pt;height:2.1pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>11001</span></p> </td> <td width="993" valign="top" style= 'width:744.6pt;border-top:none;border-left: none;border-bottom:solid #BFBFBF 1.0pt;border-right:solid #BFBFBF 1.0pt; background:white;padding:0in 5.4pt 0in 5.4pt;height:2.1pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>Most of time, this is an issue with your internet connection.</span></p> </td> </tr> <tr style='height:2.1pt'> <td width="54" valign="top" style= 'width:40.5pt;border-top:none;border-left:none; border-bottom:solid #BFBFBF 1.0pt;border-right:solid #BFBFBF 1.0pt; background:white;padding:0in 5.4pt 0in 5.4pt;height:2.1pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <a href= "https://support.microsoft.com/en-us/help/191143/10060-connection-timed-out-error-with-proxy-server-or-isa-server-on-sl" target="_blank"><span style='font-size:9.0pt'>10060</span></a></p> </td> <td width="993" valign="top" style= 'width:744.6pt;border-top:none;border-left: none;border-bottom:solid #BFBFBF 1.0pt;border-right:solid #BFBFBF 1.0pt; background:white;padding:0in 5.4pt 0in 5.4pt;height:2.1pt'> <p class="MsoNormal" style= 'margin-top:2.0pt;margin-right:0in;margin-bottom: 2.0pt;margin-left:0in;page-break-after:avoid'> <span style='font-size:9.0pt'>You are connected behind a proxy server or through a VPN which faces some congestion: retry later, and if it still fails, use a direct connection.</span></p> </td> </tr> </table> <p class="MsoNormal" style= 'margin-top:0in;margin-right:0in;margin-bottom:0in; margin-left:10.1pt;margin-bottom:.0001pt;line-height:6.0pt;page-break-after: avoid'> </p> <p class="MsoListParagraph" style= 'margin-top:0in;margin-right:0in;margin-bottom: 6.0pt;margin-left:.25in;text-indent:-.25in;page-break-after:avoid'> <b><span style='color:#0070C0'>5.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> If you still don’t figure out what happens, copy the Url provided, try to import it in ATI Data Query Designer, then play it.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="_Other_errors_1"></a>Other errors</h4> <p class="MsoListParagraphCxSpFirst" style= 'margin-top:0in;margin-right:0in; margin-bottom:6.0pt;margin-left:.25in;text-indent:-.25in;page-break-after:avoid'> <b><span style='color:#0070C0'>1.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Click on Open Results Files.</p> <p class="MsoListParagraphCxSpMiddle" style= 'margin-top:0in;margin-right:0in; margin-bottom:6.0pt;margin-left:.25in;text-indent:-.25in;page-break-after:avoid'> <b><span style='color:#0070C0'>2.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Navigate into _logs subfolder.<br /> <span lang="FR" xml:lang="FR"><img border="0" width="566" height= "254" id="Picture 76" src="XTractor_files/image018.jpg" alt="image" name="Picture 76" /></span></p> <p class="MsoListParagraphCxSpMiddle" style= 'margin-top:0in;margin-right:0in; margin-bottom:6.0pt;margin-left:.25in;text-indent:-.25in;page-break-after:avoid'> <b><span style='color:#0070C0'>3.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Open the file named the same than your Dataset.<br /> <span lang="FR" xml:lang="FR"><img border="0" width="568" height= "254" id="Picture 77" src="XTractor_files/image019.jpg" alt="image" name="Picture 77" /></span></p> <p class="MsoListParagraphCxSpLast" style= 'margin-top:0in;margin-right:0in; margin-bottom:6.0pt;margin-left:.25in;text-indent:-.25in;page-break-after:avoid'> <b><span style='color:#0070C0'>4.<span style= 'font:7.0pt "Times New Roman"'> </span></span></b> Filter second column on ERROR<br /> <span lang="FR" xml:lang="FR"><img border="0" width="289" height= "303" id="Picture 78" src="XTractor_files/image020.jpg" alt="image" name="Picture 78" /></span></p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'><a name= "_Hlk525931799"> </a></p> <div style= 'border:none;border-bottom:solid #BFBFBF 1.0pt;padding:0in 0in 2.0pt 0in'> <h3><a name="node169" id="node169"></a>FAQ</h3> </div> <h4><a name="node170" id="node170"></a>I get an error, how can I fix it?</h4> <p class="MsoNormal" style='page-break-after:avoid'>First consult the <a href="1_Overview.htm#_Online_guide">errors</a> section. If this is related to your credentials, queries or periods settings, you can fix it by yourself. Otherwise, copy your logs files and send them to <a href= "mailto:xtractor@xtagm.com?subject=I%20get%20an%20error"><b>XTractor</b> support</a> with your <a href= "1_Overview.htm#_How_to_copy">configuration files</a>.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="node171" id="node171"></a>Can I get XTractor sources to embed in my IT project?</h4> <p class="MsoNormal" style='page-break-after:avoid'>No, <b><span style='color:#A6A6A6'>X</span><span style= 'color:#7F7F7F'>Tractor</span></b> sources are not provided nor for sale. But basically, that would be a design error: <b><span style= 'color:#A6A6A6'>X</span><span style= 'color:#7F7F7F'>Tractor</span></b> is a control layer component, embedding an evolutive added value.</p> <p class="MsoNormal" style='page-break-after:avoid'>When you take component sources instead of the component itself, and above all when you adapt them, you make them yours: you will no longer benefit of further evolutions and fixes.</p> <p class="MsoNormal" style='page-break-after:avoid'>In IT architecture, this is a violation of the <a href= "http://wiki3.cosc.canterbury.ac.nz/index.php/Reuse_release_equivalence_principle" target="_blank">Reuse release Equivalence Principle</a> (REP).</p> <p class="MsoNormal" style='page-break-after:avoid'><b><span style= 'color:#A6A6A6'>X</span></b><b><span style= 'color:#7F7F7F'>Tractor</span></b> command line module can be installed on a server (Windows or Linux), and its periodic runs can be scheduled: your IT system or BI tool can be directly linked on result files. If it requires REST API connection, it’s really easy to create the web service just to download them, or to iterate them by pages.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="_How_to_copy"></a>How to use a provided Sites group?</h4> <p class="MsoNormal" style='page-break-after:avoid'>If your company provides ready-to-use Sites Group, for example <span style= 'color:#595959'>mySites.csv</span>, just copy it in your <b><span style='color:#A6A6A6'>X</span><span style= 'color:#7F7F7F'>Tractor</span></b> installation directory. If UI module was already open, it’s not necessary to relaunch it: just go to the <a href="3_Sites.htm#_Sites">Sites</a> tab, you will see <span style='color:#595959'>mySites</span> in the proposed list. If you were already on Sites, move to another tab, then go back to Sites.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="node172" id="node172"></a>How to copy a configuration on another machine?</h4> <p class="MsoNormal" style='page-break-after:avoid'>One <b><span style='color:#A6A6A6'>X</span><span style= 'color:#7F7F7F'>Tractor</span></b> configuration is made of one <span style='color:#404040'>.json</span> file (Dataset: settings, queries and periods) <i>and</i> one <span style= 'color:#404040'>.csv</span> file (Sites group), all stored in <b><span style='color:#A6A6A6'>X</span><span style= 'color:#7F7F7F'>Tractor</span></b> installation directory.</p> <p class="MsoNormal" style='page-break-after:avoid'>For example, if you want to copy the configuration below, you must copy <span style='color:#404040'>WebExperienceD.json</span> <i>and</i> <span style='color:#404040'>SitesWED.csv</span> on <b><span style= 'color:#A6A6A6'>X</span><span style= 'color:#7F7F7F'>Tractor</span></b> installation directory of the target machine.</p> <p class="MsoNormal" style='page-break-after:avoid'><span lang= "EN-GB" xml:lang="EN-GB"><img border="0" width="149" height="106" id="Picture 102" src="XTractor_files/image021.jpg" alt="image" name="Picture 102" /></span></p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="node173" id="node173"></a>Can Linux version use configurations generated by Windows UI module?</h4> <p class="MsoNormal" style='page-break-after:avoid'>Basically yes, just ensure that both are at the same version level.</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> <h4><a name="node174" id="node174"></a>Can I run simultaneous data extractions?</h4> <p class="MsoNormal" style='page-break-after:avoid'>Yes, several XTractor command line module instances can be run in parallel, but not more than <b>five</b> with the same credentials (AT Internet limitation to avoid Denial Of Services).</p> <p class="MsoNormal" style= 'margin-bottom:0in;margin-bottom:.0001pt;line-height: 50%'> </p> </div>
Contents
Topics
Search
Overview
Purpose
Description
Features
Full extractor, without development nor limit
Flexible consolidator, without development nor limit
Schedulable
Multi-platforms
How to use
Prerequisites
UI Module
Command Line Module
Operations
General commands
Manage
New
Open
Save
Dataset name
AT Internet Credentials
Configure
Results Files Folder
Periods Subfolders
Site Name To ID
Overwrite Files
Merge Periods
Get Results
Run XTractor
Open Results Files
Help
Input Helpers
Online Guide
Errors
Access rights
Malformed Queries
Undefined custom variable
Query errors
Other errors
FAQ
I get an error, how can I fix it?
Can I get XTractor sources to embed in my IT project?
How to use a provided Sites group?
How to copy a configuration on another machine?
Can Linux version use configurations generated by Windows UI module?
Can I run simultaneous data extractions?
Queries
Content
Commands
Import
Edit
Columns
Result File Name
Filter
Data Query
Sites
Content
Commands
Sites Group selection
New Group
Update
Reload
Save As
Columns
Site ID
Site Name
Filter
Segment
Custom Dimensions
Periods
Content
Columns
Type
Begin
End
Examples
Assessments
Measures
Common CTA
Global Traffic
Analysis
Auto Sum
Slicer
Instant charts
Pivot Table
Tables Relationships
Calculated Fields
Command Line
Usage
Data Extraction mode
Syntax
Console mode
Silent mode
Example
Results Files
JSON Dataset file
Output
SubFolders
MergeFiles
Overwrite
SiteName2ID
Periods
Queries
Sites
Sites Update mode
General syntax
Console mode
Silent mode
Examples
Input file
Result File
Error Level
Architecture and scheduling
General design
Windows scheduling
Linux scheduling
Web services
Changelog
What’s new?
Version 3.1.2
Version 3.0.0
Version 2.1.0
Version 2.0.4
Version 2.0.0
Version 1.2.1
Version 1.1.0
Previous versions
Downloads
Last stable release
XTractorUI + XTractor Command line
XTractor Command line only
Access rights
Analysis
Architecture and scheduling
Assessments
AT Internet Credentials
Auto Sum
Begin
Calculated Fields
Can I get XTractor sources to embed in my IT project?
Can I run simultaneous data extractions?
Can Linux version use configurations generated by Windows UI module?
Changelog
Columns
Columns
Columns
Command Line
Command Line Module
Commands
Commands
Common CTA
Configure
Console mode
Console mode
Content
Content
Content
Custom Dimensions
Data Extraction mode
Data Query
Dataset name
Description
Downloads
Edit
End
Error Level
Errors
Example
Examples
Examples
FAQ
Features
Filter
Filter
Flexible consolidator, without development nor limit
Full extractor, without development nor limit
General commands
General design
General syntax
Get Results
Global Traffic
Help
How to copy a configuration on another machine?
How to use
How to use a provided Sites group?
I get an error, how can I fix it?
Import
Input file
Input Helpers
Instant charts
JSON Dataset file
Last stable release
Linux scheduling
Malformed Queries
Manage
Measures
Merge Periods
MergeFiles
Multi-platforms
New
New Group
Online Guide
Open
Open Results Files
Operations
Other errors
Output
Overview
Overwrite
Overwrite Files
Periods
Periods
Periods Subfolders
Pivot Table
Prerequisites
Previous versions
Purpose
Queries
Queries
Query errors
Reload
Result File
Result File Name
Results Files
Results Files Folder
Run XTractor
Save
Save As
Schedulable
Segment
Silent mode
Silent mode
Site ID
Site Name
Site Name To ID
SiteName2ID
Sites
Sites
Sites Group selection
Sites Update mode
Slicer
SubFolders
Syntax
Tables Relationships
Type
UI Module
Undefined custom variable
Update
Usage
Version 1.1.0
Version 1.2.1
Version 2.0.0
Version 2.0.4
Version 2.1.0
Version 3.0.0
Version 3.1.2
Web services
What’s new?
Windows scheduling
XTractor Command line only
XTractorUI + XTractor Command line
