SupportAndConfiguration

Support and configuration

Support

Log

• Log are generated during utilization of Isogeo ArcGis Pro Add-In to help support, debug, and so one.
• You can find the generated log file inside C:\Users\[Username]\AppData\Local\ESRI\ArcGISPro\AssemblyCache\{d3cd9cd7-2008-4a27-be55-da1aeb26239f}\
  • The log file is Isogeo.log
• This log file is regenerated at each restart of ArcGis Pro software
  • ArcGisPro\AssemblyCache is a temporary folder
    • At software startup, ArcGis Pro will retrieve each Add-In saved inside its install folder, and place it inside AssemblyCache folder.
      • Because log file is generated inside this AssemblyCache folder, it will be removed next startup of ArcGis Pro.
• Making this file a temporary file is intended
  • If you want to change this comportment, you can modify log4net.config inside Isogeo.AddIn project, or, modify code of DockpaneViewModel.cs inside Isogeo.AddIn project, InitLog() method.

Configuration

Inital values of Isogeo ArcGis Pro AddIn can be changed :

• App.config inside Isogeo.AddIn contains default values

• If Isogeo ArcGis Pro AddIn doesn't find AddInConfiguration.json inside C:\Users\[username]\Documents\Isogeo\ArcGisPro (for example first utilization of Isogeo AddIn or deletion of this file by user before executing ArcGis Pro software), it will generate this AddInConfiguration.json inside C:\Users\[username]\Documents\Isogeo\ArcGisPro from App.config.

  • (If creation of AddInConfiguration.json failed, ArcGis Pro AddIn will continue to work, but with temporary configuration inside C:\Users\[Username]\AppData\Local\ESRI\ArcGISPro\AssemblyCache\{d3cd9cd7-2008-4a27-be55-da1aeb26239f}\)
    • (It will edit the App.Config, and use it as it was AddInConfiguration.json, and because AssemblyCache folder is erased each startup of software, data like authentication settings or quick search will not be saved)

• default configuration (from Isogeo ArcMap plugin) :

<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <geographicalOperator></geographicalOperator>
  <sortMethode>_created</sortMethode>
  <sortDirection>desc</sortDirection>
  <defaultSearch></defaultSearch>
  <userAuthentication>
    <id></id>
    <secret></secret>
  </userAuthentication>
  <searchs>
    <searchs>
      <Search>
        <name></name>
        <query></query>
      </Search>
    </searchs>
  </searchs>
  <proxy>
    <proxyUrl></proxyUrl>
    <proxyUser></proxyUser>
    <proxyPassword></proxyPassword>
  </proxy>
  <apiIdUrl>https://id.api.isogeo.com/</apiIdUrl>
  <apiUrl>https://v1.api.isogeo.com/</apiUrl>
  <emailSupport>vianney.doleans@gmail.com;support+arcgispro@isogeo.fr</emailSupport>
  <emailSubject>Plugin ArcGis Pro - Demande d'aide</emailSubject>
  <emailBody>Bonjour,/nJ'ai une question concernant l'utilisation du plugin Isogeo pour ArcGis Pro.../n/nPour reproduire :/n/n1. Ouvrir ArcGis Pro/n2. Ouvrir le plugin/n3./n/n=&gt; description comportement/n/nVoici le comportement souhaité :/n/n/n=&gt; description comportement/n/nLes informations de mon environnement de travail :/n/n- Mon groupe client utilisé / client id : /n- Windows : /n- Version ArcGis Pro : /n- Version du plugin Isogeo ArcGis Pro : /n- Architecture du processeur : /n- Proxy :    pare-feu :/n- utilisateur administrateur ?/n-Autres informations potentiellement utiles/n/nLes captures d'écrans sont en pièces-jointes</emailBody>
  <urlHelp>https://isogeo.gitbooks.io/app-plugin-arcmap/content/</urlHelp>
  <startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2"/></startup>
</configuration>

Added parameters

• box
• apiIdUrl
• apiUrl

box :

box parameter have been added late in the development of the V1

• Following Isogeo's request, I did a modification inside original configuration, adding <box></box> inside <Search><Search> (Quick search saved)

  • This parameter can be empty (no geographical Operator, so no box (extent)), or have an envelope as value (string composed of 4 number (double), separating by ',' , using for setting current map extent)

    • Format of this extent inside configuration file is WGS84 (it will be convert to current format used by ArcGis Pro Map during loading process, so don't worry, just have to be sure that if you fill it by yourself inside JSON configuration file or app.config, it's based on WGS84 format).

    public class Search { public string name = ""; public string query = ""; public string box = ""; }

apiIdUrl & apiUrl :

• Theses parameters determine where authentication request and API request will be execute (URL)
  • In Isogeo ArcGis Pro Add-In, they were inside code
    • It's a lot more useful to do it inside configuration, and so, for example : https://id.api.qa.isogeo.com/ And https://api.qa.isogeo.com/ can be written
      • If main Isogeo API URL changed, not necessary to recompile and redistribute Isogeo ArcGis pro Add-In (at least in first instance), users can follow instructions to do it
      • Developer can make some tests with experimental API just by changing configuration inside the configuration JSON file.