{"_id":"56e1d641bc46be0e002af296","project":"55faeacad0e22017005b8265","parentDoc":null,"__v":11,"category":{"_id":"56e1cd21e416450e00b9e48e","pages":["56e1d641bc46be0e002af296","56e1d68292bf640e00b55673","56e1d70fe416450e00b9e4bc"],"__v":3,"project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-03-10T19:38:09.558Z","from_sync":false,"order":13,"slug":"arcmap-addin-application","title":"ArcMap AddIn Application"},"user":"56267741db1eda0d001c3dbb","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":35,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37","59e76ce41938310028037295","5a009de510890d001c2aabfe"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"updates":["57b033e28666b20e00aa1f9c","57b0341f95c7240e006d8250"],"next":{"pages":[],"description":""},"createdAt":"2016-03-10T20:17:05.352Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"#Installation Instructions#\n\n**Installation Requirement - Requires Arcmap 10.4 or later**\n*Note: There is a version of the AddIn that is available for Arcmap 10.2 and 10.3. However, this version only receives updates to maintain functionality.*\n\nThe following instructions will walk you through installation of the GBDX ArcMap AddIn on your computer.  \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/pJjMoGRbSmJYotrnHI3Q_new_screen_edit.png\",\n        \"new_screen_edit.png\",\n        \"1657\",\n        \"986\",\n        \"#3a4e73\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n#Step 1: Download the Gbdx.esriAddIn file from the ESRI AddIn Releases folder on the DGConnect-ESRI GitHub#\n[block:embed]\n{\n  \"html\": false,\n  \"url\": \"https://github.com/DigitalGlobe/DGConnect-ESRI\",\n  \"title\": \"DigitalGlobe/DGConnect-ESRI\",\n  \"favicon\": \"https://assets-cdn.github.com/favicon.ico\",\n  \"image\": \"https://avatars3.githubusercontent.com/u/10076238?v=3&s=400\"\n}\n[/block]\n*Note: Last stable release will be in master. Other branches are in development; download from other branches at your own risk.* \n\n#Step 2: Once the ESRI AddIn File is in the directory of your choice, double-click on Gbdx.esriAddIn and following dialog shows up:#\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/enyudI5cQoOKXrKxsNdG_gbdx_install.PNG\",\n        \"gbdx_install.PNG\",\n        \"396\",\n        \"422\",\n        \"#954e1e\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n#Step 3: In the ESRI ArcGIS Add-In Installation Utility, click Install Add-In. An installation succeeded prompt should show up as below:#\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/V32NUfIMQd6Ve4khIhW0_ArcMapAddInSetup3.PNG\",\n        \"ArcMapAddInSetup3.PNG\",\n        \"241\",\n        \"146\",\n        \"#a45a44\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n#Step 4: Open ESRI ArcMap. Click Customize -> Toolbars -> GBDX Toolbar#\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/SfvHEEuAQaqOmFnPRlF8_ArcMap_customize_toolbar.PNG\",\n        \"ArcMap_customize_toolbar.PNG\",\n        \"783\",\n        \"400\",\n        \"#44a4fa\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n#Step 5: New toolbar is added and can be free or docked.#\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/fBdJxIZGTyWpMsm03xx1_new_toolbar.PNG\",\n        \"new_toolbar.PNG\",\n        \"146\",\n        \"44\",\n        \"#72a032\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n#Step 6: Click on the gear icon to bring up the settings.  Enter username, password, API Key, and adjust the File Location to choice of directory for application data cache:#\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e3Tgn8jUSo6fLlBAqo5T_new_setting.PNG\",\n        \"new_setting.PNG\",\n        \"470\",\n        \"336\",\n        \"#50b3da\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nDon't know your API Key? See [Lesson: How to Find Your API Key](doc:lesson-how-to-find-your-api-key-1).\n\n#Step 7: Click Test Connection to confirm username and password have been entered correctly.#\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/KR08L7AaTbCpNc60Q4YZ_new_test_connection.PNG\",\n        \"new_test_connection.PNG\",\n        \"226\",\n        \"182\",\n        \"#2a606d\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n#Step 8: Save Settings. GBDX ESRI Add-In is now ready for use.#\n\nRefer to [ArcMap AddIn - Functionality](doc:arcmap-addin-functionality) pages for how to use the tools.\n\nNote: If you had an earlier version installed and the current version is not working correctly now, \nfollow these steps to fix the issue:\n\n1. Completely uninstall the add-in. To uninstall, in Arcmap go to Customize > Add-In Manager > select the GBDX add-in and click 'Delete this Add-In.' Close Arcmap, re-install the add-in, and open Arcmap once more. Use a tool from the add-in to verify that you are able to connect again.\n\n2. If that didn't alleviate the issue, completely uninstall the add-in again, close Arcmap, open your explorer and go to C:\\Users\\<username>\\AppData\\Roaming\\ESRI\\Desktop10.4\\ArcMap\\Templates. Remove Normal.mxt from this directory. Now go to C:\\Users\\<username>\\AppData\\Local\\ESRI. Remove the DefaultDomain....etc directory from this directory. Re-install the add-in, and open Arcmap once more. You will need to re-enter your credentials for the add-in prior to using a tool to verify that you are able to connect again.","excerpt":"","slug":"arcmap-addin-setup","type":"basic","title":"ArcMap AddIn - Setup"}

ArcMap AddIn - Setup


#Installation Instructions# **Installation Requirement - Requires Arcmap 10.4 or later** *Note: There is a version of the AddIn that is available for Arcmap 10.2 and 10.3. However, this version only receives updates to maintain functionality.* The following instructions will walk you through installation of the GBDX ArcMap AddIn on your computer. [block:image] { "images": [ { "image": [ "https://files.readme.io/pJjMoGRbSmJYotrnHI3Q_new_screen_edit.png", "new_screen_edit.png", "1657", "986", "#3a4e73", "" ] } ] } [/block] #Step 1: Download the Gbdx.esriAddIn file from the ESRI AddIn Releases folder on the DGConnect-ESRI GitHub# [block:embed] { "html": false, "url": "https://github.com/DigitalGlobe/DGConnect-ESRI", "title": "DigitalGlobe/DGConnect-ESRI", "favicon": "https://assets-cdn.github.com/favicon.ico", "image": "https://avatars3.githubusercontent.com/u/10076238?v=3&s=400" } [/block] *Note: Last stable release will be in master. Other branches are in development; download from other branches at your own risk.* #Step 2: Once the ESRI AddIn File is in the directory of your choice, double-click on Gbdx.esriAddIn and following dialog shows up:# [block:image] { "images": [ { "image": [ "https://files.readme.io/enyudI5cQoOKXrKxsNdG_gbdx_install.PNG", "gbdx_install.PNG", "396", "422", "#954e1e", "" ] } ] } [/block] #Step 3: In the ESRI ArcGIS Add-In Installation Utility, click Install Add-In. An installation succeeded prompt should show up as below:# [block:image] { "images": [ { "image": [ "https://files.readme.io/V32NUfIMQd6Ve4khIhW0_ArcMapAddInSetup3.PNG", "ArcMapAddInSetup3.PNG", "241", "146", "#a45a44", "" ] } ] } [/block] #Step 4: Open ESRI ArcMap. Click Customize -> Toolbars -> GBDX Toolbar# [block:image] { "images": [ { "image": [ "https://files.readme.io/SfvHEEuAQaqOmFnPRlF8_ArcMap_customize_toolbar.PNG", "ArcMap_customize_toolbar.PNG", "783", "400", "#44a4fa", "" ] } ] } [/block] #Step 5: New toolbar is added and can be free or docked.# [block:image] { "images": [ { "image": [ "https://files.readme.io/fBdJxIZGTyWpMsm03xx1_new_toolbar.PNG", "new_toolbar.PNG", "146", "44", "#72a032", "" ] } ] } [/block] #Step 6: Click on the gear icon to bring up the settings. Enter username, password, API Key, and adjust the File Location to choice of directory for application data cache:# [block:image] { "images": [ { "image": [ "https://files.readme.io/e3Tgn8jUSo6fLlBAqo5T_new_setting.PNG", "new_setting.PNG", "470", "336", "#50b3da", "" ] } ] } [/block] Don't know your API Key? See [Lesson: How to Find Your API Key](doc:lesson-how-to-find-your-api-key-1). #Step 7: Click Test Connection to confirm username and password have been entered correctly.# [block:image] { "images": [ { "image": [ "https://files.readme.io/KR08L7AaTbCpNc60Q4YZ_new_test_connection.PNG", "new_test_connection.PNG", "226", "182", "#2a606d", "" ] } ] } [/block] #Step 8: Save Settings. GBDX ESRI Add-In is now ready for use.# Refer to [ArcMap AddIn - Functionality](doc:arcmap-addin-functionality) pages for how to use the tools. Note: If you had an earlier version installed and the current version is not working correctly now, follow these steps to fix the issue: 1. Completely uninstall the add-in. To uninstall, in Arcmap go to Customize > Add-In Manager > select the GBDX add-in and click 'Delete this Add-In.' Close Arcmap, re-install the add-in, and open Arcmap once more. Use a tool from the add-in to verify that you are able to connect again. 2. If that didn't alleviate the issue, completely uninstall the add-in again, close Arcmap, open your explorer and go to C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.4\ArcMap\Templates. Remove Normal.mxt from this directory. Now go to C:\Users\<username>\AppData\Local\ESRI. Remove the DefaultDomain....etc directory from this directory. Re-install the add-in, and open Arcmap once more. You will need to re-enter your credentials for the add-in prior to using a tool to verify that you are able to connect again.