{"id":5341,"date":"2015-08-28T11:51:42","date_gmt":"2015-08-28T10:51:42","guid":{"rendered":"https:\/\/help.instantatlas.com\/dashboard-builder-desktop\/desktop-user-guide\/multiple-geography-reports\/creating-the-data-files\/"},"modified":"2021-12-08T14:03:04","modified_gmt":"2021-12-08T14:03:04","slug":"creating-the-data-files","status":"publish","type":"page","link":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/desktop-user-guide\/multiple-geography-reports\/creating-the-data-files\/","title":{"rendered":"Creating the Data Files"},"content":{"rendered":"<p>This section describes the process for generating data files for a multiple geography report. We recommend that you manage the indicator data for each base geography in a separate Excel workbook. You will then export the data from each workbook separately and perform a merge. You can have the same or different datasets for each geography. If you have the same datasets then the data selection will be preserved when you change geography, whereas if you do not have the same datasets then there will be a mismatch between which data is selected when you change geography.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2015\/08\/image7.png\" alt=\"image7\" class=\"alignnone wp-image-7021 size-full\" width=\"22\" height=\"20\" \/>\u00a0Note that the geography names given in cell B2 of the Geography and Filters worksheet must be unique, e.g. each base geography needs a unique name.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2015\/08\/image27.jpeg\" alt=\"image27\" class=\"alignnone wp-image-7291 size-full\" width=\"16\" height=\"16\" \/> If the areas in your geographies nest, you may wish to include filters that reflect this nesting. In this way, geographies lower in the hierarchy can be filtered according to which area in a higher geography they nest within. For example in a report with Edinburgh post code districts and post code sectors it makes sense to include a Districts filter in the post code sectors workbook. A filter that is available at multiple geographies will stay applied as you switch between these geographies.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2015\/08\/image27.jpeg\" alt=\"image27\" class=\"alignnone wp-image-7291 size-full\" width=\"16\" height=\"16\" \/>\u00a0If you want the map palettes to vary based on the visible base geography and its associated data, please see section \u2018<a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/desktop-user-guide\/the-instantatlas-excel-data-manager\/the-metadata-worksheet\/adding-indicator-display-metadata\/#Setting_Custom_Legends\">Setting Custom Legends<\/a>\u2019 in the Excel Data Manager area or section <a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/support-articles\/access-data-manager-user-guide\/#Setting_Custom_Legends\">3.8.2 of the Access Data Manager User Guide<\/a>.<\/p>\n<p>As a first step, you need to export a data file from each workbook separately.<\/p>\n<p>If you are using the <a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/desktop-user-guide\/the-instantatlas-desktop-publisher\/publishing-a-report\/starting-your-dynamic-report\/#Using_the_atlas-launchhtml\">atlas-launch.html file to view your report locally<\/a>, there are a few things to be aware of:<\/p>\n<ul>\n<li>At the point of exporting each workbook separately, you do not need to create the data files for local use as these files are not used directly by the report but are merely an intermediate step.<\/li>\n<li>It is important that you untick the box &#8216;Use Theme Files&#8217; on the &#8216;Advanced&#8217; tab as otherwise the report will not load locally when using the atlas-launch.html file.<\/li>\n<\/ul>\n<p><a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/Nolocaldatafilenothemefile.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/Nolocaldatafilenothemefile.png\" alt=\"\" width=\"579\" height=\"360\" class=\"alignnone size-full wp-image-34168\" srcset=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/Nolocaldatafilenothemefile.png 579w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/Nolocaldatafilenothemefile-300x187.png 300w\" sizes=\"auto, (max-width: 579px) 100vw, 579px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>It is imperative that the data files for the geographies are named in a way that matches their order on the \u2018Choose Your Base Geography\u2019 screen of the Publisher. We recommend you name them \u2018data1.js\u2019, \u2018data2.js\u2019, \u2018data3.js\u2019,\u2026 where \u2018data1.js\u2019 is the JSON file for the uppermost geography, \u2018data2.js\u2019 is for the next one down and so on.<\/p>\n<p>The next step is to merge these files into a single data.js file. The Excel Data Manager add-in provides an \u2018IA Merge Files\u2019 button for this.<\/p>\n<p><a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2019\/05\/IAMergeFiles.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2019\/05\/IAMergeFiles.png\" alt=\"\" class=\"alignnone size-full wp-image-33667\" width=\"427\" height=\"109\" srcset=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2019\/05\/IAMergeFiles.png 427w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2019\/05\/IAMergeFiles-300x77.png 300w\" sizes=\"auto, (max-width: 427px) 100vw, 427px\" \/><\/a><\/p>\n<p>Click this button. The \u2018Select files to be appended\u2019 dialog allows you to browse to the folder containing your data files. Select the files by clicking and holding down the \u2018Shift\u2019 or \u2018Ctrl\u2019 keys on your keyboard. Then click \u2018Open\u2019.<\/p>\n<p><a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/123.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/123.png\" alt=\"\" width=\"427\" height=\"110\" class=\"alignnone size-full wp-image-34170\" srcset=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/123.png 427w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/123-300x77.png 300w\" sizes=\"auto, (max-width: 427px) 100vw, 427px\" \/><\/a><\/p>\n<p>The files will be appended in the order they are named (alphanumeric) and, as mentioned above, this must match the order of the geographies on the \u2018Choose Your Base Geography\u2019 screen of the Publisher.<\/p>\n<p>The Excel Data Manager will ask you to save the merged data.js file. Browse to the folder containing your report and overwrite the existing data.js file. You will then be asked if you wish to create the local data file.<\/p>\n<p><a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/Createlocalfile.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/12\/Createlocalfile.png\" alt=\"\" width=\"202\" height=\"133\" class=\"alignnone size-full wp-image-34171\" \/><\/a><\/p>\n<p>If you are still in the process of creating and designing your dynamic report and you are using the atlas-lauch.html file to open the report locally, you should select &#8216;Yes&#8217;. As mentioned above this local file will only work if you had the &#8216;Use Theme Files&#8217; option on the &#8216;Advanced&#8217; tab of the &#8216;Output Options&#8217; dialog unticked.<\/p>\n<p>You can now start the report locally (double click the atlas-launch.html file) to view the result.<\/p>\n<p>Once you are happy with your report and you wish to prepare it for upload to a webserver, you should consider running through the above process again. This time you may wish to activate the &#8216;Use Theme Files&#8217; option on the &#8216;Advanced&#8217; tab of the &#8216;Output Options&#8217; dialog. At the step of merging the individual data files together,\u00a0 select the &#8216;No&#8217; option when asked if you wish to &#8216;Create Local Data File&#8217;. This will ensure that the report uses theme files when opened from a webserver using the atlas.html file. Using theme data files improves the initial loading time of you report as the report only needs to load the data of the first theme when it is first opened. Please see <a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/desktop-user-guide\/the-instantatlas-excel-data-manager\/exporting-data-files\/\">Exporting Data Files<\/a> for further information on theme data files.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This section describes the process for generating data files for a multiple geography report. We recommend that you manage the indicator data for each base geography in a separate Excel workbook. You will then export the data from each workbook separately and perform a merge. You can have the same or different datasets for each &hellip; <a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/desktop-user-guide\/multiple-geography-reports\/creating-the-data-files\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Creating the Data Files<\/span><\/a><\/p>\n","protected":false},"author":22,"featured_media":0,"parent":5311,"menu_order":1,"comment_status":"open","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-5341","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/5341","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/comments?post=5341"}],"version-history":[{"count":0,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/5341\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/5311"}],"wp:attachment":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/media?parent=5341"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}