{"id":34098,"date":"2021-11-30T13:59:22","date_gmt":"2021-11-30T13:59:22","guid":{"rendered":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/?page_id=34098"},"modified":"2021-12-07T11:09:31","modified_gmt":"2021-12-07T11:09:31","slug":"the-iapackager-tool","status":"publish","type":"page","link":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/desktop-user-guide\/the-instantatlas-desktop-publisher\/the-iapackager-tool\/","title":{"rendered":"The iapackager Tool"},"content":{"rendered":"<p>The iapackager.exe is a command line tool that is included in the installation of InstantAtlas Desktop 6.12.0. It can be used to create the necessary files to open a locally saved report directly in an Internet browser. Please refer to the <a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/getting-started\/starting-your-dynamic-report\/\">Starting Your Dynamic Report<\/a> page for general information on how to open your dynamic report.<\/p>\n<p>There are two main reasons why you may wish to use this tool:<\/p>\n<ul>\n<li>You have a report that was published with a version of the InstantAtlas Publisher prior to 6.12.0 and you wish to create the necessary files to be able to open it from a local or shared drive<\/li>\n<li>You have made changes to one or more of the following files using third-party software, such as a text editor, and want to transfer those changes to their respective local variant of the file(s).<\/li>\n<\/ul>\n<p>To use the iapackager tool you should do the following:<\/p>\n<ol>\n<li>Use Windows Explorer to browse to the InstantAtlas installation folder. By default, this is <strong>C:\\Program Files\\EsriUK\\InstantAtlas<\/strong>. You should see a file called iapackager.exe in this folder. Do NOT double-click this file.<a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/installationFolder.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/installationFolder.png\" alt=\"\" width=\"664\" height=\"464\" class=\"img-space alignnone wp-image-34106 size-full\" srcset=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/installationFolder.png 664w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/installationFolder-300x210.png 300w\" sizes=\"auto, (max-width: 664px) 100vw, 664px\" \/><\/a><\/li>\n<li>Ensure that no file or subfolder is selected. Press and hold the Shift key on your keyboard and right-click anywhere in the folder background, either below the files or to the right of a list view. Select <strong>Open PowerShell window here<\/strong> or <strong>Open command window here<\/strong> (whichever option is available for you).<a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/ContextMenu.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/ContextMenu.png\" alt=\"\" width=\"280\" height=\"315\" class=\"img-space alignnone wp-image-34096 size-full\" srcset=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/ContextMenu.png 280w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/ContextMenu-267x300.png 267w\" sizes=\"auto, (max-width: 280px) 100vw, 280px\" \/><\/a><\/li>\n<li>A new window with either a blue or black background will open showing the path to your installation folder. Type <strong>.\\iapackager<\/strong> followed by a space character and the path to the report folder. If any of the folder names in the path contain spaces, you need to wrap the path into double quotes e.g.: <strong><strong>.\\iapackager &#8220;C:\\InstantAtlas Reports\\Single Map\\&#8221;<\/strong><\/strong><a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShell.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShell.png\" alt=\"\" width=\"969\" height=\"202\" class=\"img-space alignnone wp-image-34101 size-full\" srcset=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShell.png 969w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShell-300x63.png 300w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShell-768x160.png 768w\" sizes=\"auto, (max-width: 969px) 100vw, 969px\" \/><\/a><\/li>\n<li>Press enter to run the tool to create the files needed for local viewing of the dynamic report.<a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShellDone.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShellDone.png\" alt=\"\" width=\"969\" height=\"202\" class=\"img-space alignnone wp-image-34102 size-full\" srcset=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShellDone.png 969w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShellDone-300x63.png 300w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/PowerShellDone-768x160.png 768w\" sizes=\"auto, (max-width: 969px) 100vw, 969px\" \/><\/a><\/li>\n<li>In the report folder, you can sort the files by <strong>Date modified<\/strong> to see the recently created files at the top. Double-click the atlas-launch.html file to open the locally saved report.<a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/Files.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/Files.png\" alt=\"\" width=\"895\" height=\"568\" class=\"img-space alignnone wp-image-34105 size-full\" srcset=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/Files.png 895w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/Files-300x190.png 300w, https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2021\/11\/Files-768x487.png 768w\" sizes=\"auto, (max-width: 895px) 100vw, 895px\" \/><\/a><\/li>\n<\/ol>\n<h3><strong>Troubleshooting<\/strong><\/h3>\n<p>If the tool encounters an error, you will see an error message on the screen. This is usually the case if there is a typo in the command name or path to the report folder or if the double quotes are missing around a path containing spaces.<\/p>\n<p>The tool will also show an error if it cannot find one or more of the required report files. These are the following:<\/p>\n<ul>\n<li>config.xml<\/li>\n<li>data.js (including any related theme files)<\/li>\n<li>map.js<\/li>\n<li>a file containing the feature geometry information for each base geography e.g. _post_code_sectors.shp1.js<\/li>\n<li>a file containing the feature geometry information for each contextual geography e.g. contextualLayer1.jsIt is therefore advised to only run the tool on folders containing all files that make up a dynamic report rather than on a subset of the files.<\/li>\n<\/ul>\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\" \/> Please note that you cannot convert the local variant of the files into their respective counterparts for use on a webserver. This means that if you make manual changes e.g. to the map-vars.js.js file and then run the iapackager tool, those changes will be overwritten with the content of the map.js file.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The iapackager.exe is a command line tool that is included in the installation of InstantAtlas Desktop 6.12.0. It can be used to create the necessary files to open a locally saved report directly in an Internet browser. Please refer to the Starting Your Dynamic Report page for general information on how to open your dynamic &hellip; <a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/desktop-user-guide\/the-instantatlas-desktop-publisher\/the-iapackager-tool\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">The iapackager Tool<\/span><\/a><\/p>\n","protected":false},"author":22,"featured_media":0,"parent":4841,"menu_order":5,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-34098","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/34098","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=34098"}],"version-history":[{"count":0,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/34098\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/4841"}],"wp:attachment":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/media?parent=34098"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}