Strategy ONE

Utilisation d'un proxy pour le serveur ESRI avec un environnement basé sur un cloud ou sur site

Il peut y avoir des circonstances où vous souhaitez ou devez utiliser un proxy pour le serveur ESRI. Par exemple, vous disposez peut-être de jetons de sécurité que vous ne souhaitez pas voir sur votre serveur ESRI local. Ou, vos requêtes peuvent dépasser la limite de longueur des URL (Uniform Resource Locators) imposée par le navigateur. L'utilisation d'un proxy pour le serveur ESRI contourne la limite de longueur en effectuant une requête POST au lieu d'une requête GET. Les requêtes POST ne sont pas limitées par le maximum de 2048 caractères, car les informations sont transférées dans l'en-tête à la place de l'URL.

Le proxy est constitué d'un code côté serveur qui s'exécute sur votre serveur Web. Votre application Web basée sur un navigateur envoie la requête au proxy (sur votre serveur Web). Le proxy transmet ensuite la requête au serveur ESRI et relaie la réponse renvoyée par le serveur ESRI à votre application.

Pour utiliser un proxy pour le serveur ESRI, suivez les étapes de l'une des méthodes ci-dessous. Vous pouvez utiliser la première méthode pour configurer un proxy avec une intégration basée sur un cloud ou sur site ; la deuxième méthode ne fonctionne que pour l'intégration sur site.

Pour résoudre un problème, reportez-vous à KB484310 : Prise en charge de l'authentification de base pour le proxy ESRI.

Utilisation d'un proxy pour le serveur ESRI avec une intégration basée sur le cloud ou sur site

Environnement J2EE

  1. Copier esriproxy.jsp, situé sous jsp dans le répertoire d'installation MicroStrategy Web et collez-le dans un emplacement accessible. Les instructions ci-dessous supposent que vous l'avez enregistré sous jsp Dossier dans votre plug-in.

  2. Dans le répertoire d'installation MicroStrategy Web, ouvrez WEB-INF/xml/proxy.xml. Dans la <serverUrls> nœud, ajout <serverUrl> nœuds, en répertoriant toutes les URL des cartes pour lesquelles vous souhaitez utiliser un proxy et enregistrer vos modifications.

    Copier 
      <serverUrls>
        <serverUrl url="services.arcgisonline.com" matchAll="true" />
        <serverUrl url="sampleserver1.arcgisonline.com" matchAll="true" />
        <serverUrl url="www.arcgis.com" matchAll="true" />
        ...
        <serverUrl url="myserver.mycompany.com" matchAll="true" > 
      </serverUrls>

  3. Ouvrir mapConfig.xml dans votre plug-in.

  4. Dans la <ec> nœud, ajout <proxyURLs> et <urlPrefixes> nœuds. Cela indique à l'application d'utiliser un proxy pour les URL de carte que vous avez ajoutées dans <urlPrefixes>.

    Si le alwaysUse l'attribut est défini sur "true", un proxy est toujours utilisé. Si le alwaysUse l'attribut est défini sur "false" ou est manquant, ESRI décide s'il faut ou non utiliser un proxy.

    Si vous ajoutez un <urlPrefix> nœud , vous devez ajouter un attribut ID. Cet attribut ID doit être unique et ne peut pas utiliser des entiers compris entre 1 et 13.

    Copier 
    <mc>
      <ec>
        <proxyURLs>
          <proxyURL alwaysUse="true">../plugins/ConnectorForESRI/jsp/esriproxy.jsp</proxyURL>
        </proxyURLs>
        <urlPrefixes>
          <urlPrefix id="21">myserver.mycompany.com</urlPrefix>
          <urlPrefix id="22">services.arcgis.com</urlPrefix>
          <urlPrefix id="23">sampleserver1.arcgisonline.com</urlPrefix>
        </urlPrefixes>
        ...
      </ec>
    </mc>

  5. Sauvegardez vos modifications et redémarrez le serveur MicroStrategy Web.

Environnement .NET

  1. Dans le répertoire d'installation MicroStrategy Web, sous le asp dossier, copie esriproxy.ashx, proxy.config, et proxy.xsd. Collez-les dans un emplacement accessible sous le même dossier. Les instructions ci-dessous supposent que vous l'avez enregistré sous asp Dossier dans votre plug-in.

  2. Dans votre plug-in, ouvrez proxy.config. Ajoutez des URL aux cartes pour lesquelles vous souhaitez utiliser un proxy et enregistrez vos modifications. Dans la <serverUrls> nœud, ajout <serverUrl> nœuds, répertoriez toutes les URL des cartes pour lesquelles vous souhaitez utiliser un proxy et enregistrez vos modifications.

    Copier 
      <serverUrls>
        <serverUrl url="services.arcgisonline.com" matchAll="true" />
        <serverUrl url="sampleserver1.arcgisonline.com" matchAll="true" />
        <serverUrl url="www.arcgis.com" matchAll="true" />
        ...
        <serverUrl url="myserver.mycompany.com" matchAll="true" > 
      </serverUrls>

  3. Dans votre plug-in, ouvrez mapConfig.xml.

  4. Dans la <ec> nœud, ajout <proxyURLs> et <urlPrefixes> nœuds. Cela indique à l'application d'utiliser un proxy pour les URL de carte que vous avez ajoutées dans <urlPrefixes>.

    Si le alwaysUse l'attribut est défini sur "true", un proxy est toujours utilisé. Si le alwaysUse l'attribut est défini sur "false" ou est manquant, ESRI décide s'il faut ou non utiliser un proxy.

    Si vous ajoutez un <urlPrefix> nœud , vous devez ajouter un attribut ID. Cet attribut ID doit être unique et ne peut pas utiliser des entiers compris entre 1 et 13.

    Copier 
    <mc>
      <ec>
        <proxyURLs>
          <proxyURL alwaysUse="true">../plugins/ConnectorForESRI/asp/esriproxy.ashx</proxyURL>
        </proxyURLs>
        <urlPrefixes>
          <urlPrefix id="21">myserver.mycompany.com</urlPrefix>
          <urlPrefix id="22">services.arcgis.com</urlPrefix>
          <urlPrefix id="23">sampleserver1.arcgisonline.com</urlPrefix>
        </urlPrefixes>
        ...
      </ec>
    </mc>

  5. Sauvegardez vos modifications et redémarrez le serveur MicroStrategy Web.

  6. Redémarrez le serveur MicroStrategy Web.

Utilisation d'un proxy pour le serveur ESRI avec intégration sur site

Vous pouvez utiliser la méthode ci-dessus ou celle ci-dessous pour l'intégration sur site.

Environnement J2EE

  1. Dans le répertoire d'installation MicroStrategy Web, sous le jsp dossier, copie esriproxy.jsp et collez-la dans un emplacement accessible. Les instructions ci-dessous supposent que vous avez enregistré le fichier sous jsp Dossier dans votre plug-in.

  2. Dans le répertoire d'installation MicroStrategy Web, ouvrez WEB-INF/xml/proxy.xml. Dans la <serverUrls> nœud, ajout <serverUrl> nœuds, en répertoriant toutes les URL des cartes pour lesquelles vous souhaitez utiliser un proxy, et enregistrez vos modifications.

    Copier 
      <serverUrls>
        <serverUrl url="services.arcgisonline.com" matchAll="true" />
        <serverUrl url="sampleserver1.arcgisonline.com" matchAll="true" />
        <serverUrl url="www.arcgis.com" matchAll="true" />
        ...
        <serverUrl url="myserver.mycompany.com" matchAll="true" > 
      </serverUrls>

  3. Ouvrir mapConfig.xml dans votre plug-in.

  4. Dans le fichier de configuration ESRI, dans la <bm> nœud, ajoutez un proxyURL attribut. Cela indique à l'application d'utiliser un proxy pour cette carte de base. Dans la <ec> nœud, ajoutez un <urlPrefixes> nœud pour lister toutes les URL des cartes pour lesquelles vous souhaitez utiliser un proxy.

    Copier 
    <mc>
      <ec>
        <bm key="default" proxyURL="../plugins/ConnectorForESRI/jsp/esriproxy.jsp">
          http://myserver.mycompany.com/ArcGIS/rest/services
        </bm>
        <urlPrefixes>
          <urlPrefix id="21">myserver.mycompany.com</urlPrefix>
          <urlPrefix id="22">the URLs to the maps you want to use a proxy for</urlPrefix>
          <urlPrefix id="23">services.arcgis.com</urlPrefix>
        </urlPrefixes>
        ...
      </ec>
    </mc>

  5. Sauvegardez vos modifications et redémarrez le serveur MicroStrategy Web.

Environnement .NET

  1. Dans le répertoire d'installation MicroStrategy Web, sous le asp dossier, copie esriproxy.ashx, proxy.config, et proxy.xsd. Collez-les dans un emplacement accessible sous le même dossier. Les instructions ci-dessous supposent que vous l'avez enregistré sous asp Dossier dans votre plug-in.

  2. Dans votre plug-in, ouvrez proxy.config. Ajoutez des URL aux cartes pour lesquelles vous souhaitez utiliser un proxy et enregistrez vos modifications. Dans la <serverUrls> nœud, ajout <serverUrl> nœuds, répertoriez toutes les URL des cartes pour lesquelles vous souhaitez utiliser un proxy et enregistrez vos modifications.

    Copier 
      <serverUrls>
        <serverUrl url="services.arcgisonline.com" matchAll="true" />
        <serverUrl url="sampleserver1.arcgisonline.com" matchAll="true" />
        <serverUrl url="www.arcgis.com" matchAll="true" />
        ...
        <serverUrl url="myserver.mycompany.com" matchAll="true" > 
      </serverUrls>

  3. Dans votre plug-in, ouvrez mapConfig.xml.

  4. Dans le fichier de configuration ESRI, dans la <bm> nœud, ajoutez un proxyURL attribut. Cela indique à l'application d'utiliser un proxy pour cette carte de base. Dans la <ec> nœud, ajoutez un <urlPrefixes> nœud pour lister toutes les URL des cartes pour lesquelles vous souhaitez utiliser un proxy.

    Copier 
    <mc>
      <ec>
        <bm key="default" proxyURL="../plugins/ConnectorForESRI/asp/esriproxy.ashx">
          http://myserver.mycompany.com/ArcGIS/rest/services
        </bm>
        <urlPrefixes>
          <urlPrefix id="21">myserver.mycompany.com</urlPrefix>
          <urlPrefix id="22">the URLs to the maps you want to use a proxy for</urlPrefix>
          <urlPrefix id="23">services.arcgis.com</urlPrefix>
        </urlPrefixes>
        ...
      </ec>
    </mc>

  5. Sauvegardez vos modifications et redémarrez le serveur MicroStrategy Web.