Utiliser des outils Web personnalisés

Les outils Web personnalisés sont des processus de géotraitement publiés et hébergés dans ArcGIS Online. Les outils Web personnalisés peuvent être ajoutés aux applications prises en charge, telles que Map Viewer, et sont exécutés à partir de la fenêtre Analysis (Analyse).

Types d’outils Web personnalisés

Les outils Web personnalisés dans ArcGIS Online utilisent les éléments d’outil publiés à partir de Outil ArcGIS Notebooks.

Ouvrir et exécuter un outil Web personnalisé

Pour accéder à des outils Web personnalisés et les utiliser dans Map Viewer, procédez comme suit :

  1. Dans la barre d’outils (claire) Settings (Paramètres), cliquez sur Analysis (Analyse) Analyse.
    Remarque :

    Si vous ne voyez pas le bouton Analysis (Analyse) dans Map Viewer, contactez votre administrateur ArcGIS. Vous risquez de ne pas disposer des privilèges ou crédits requis pour effectuer l’analyse.

    En savoir plus sur les licences requises pour l’analyse spatiale

  2. Cliquez sur Tools (Outils) Outils.
  3. Cliquez sur Browse custom web tools (Explorer les outils Web personnalisés) dans la partie inférieure de la fenêtre.

    La fenêtre Browse custom web tools (Explorer les outils Web personnalisés) apparaît. Par défaut, la fenêtre indique les outils Web personnalisés disponibles dans My content (Mon contenu).

  4. Cliquez éventuellement sur My content (Mon contenu) et sélectionnez My favorites (Mes favoris), My groups (Mes groupes), My organization (Mon organisation), Living Atlas (Living Atlas) ou ArcGIS Online (ArcGIS Online) dans le menu pour modifier la source des éléments.
  5. Utilisez éventuellement la barre Search (Rechercher) et le menu Sort by (Trier par) pour réduire le nombre d’éléments ou les réorganiser.
  6. Sur l’élément de votre choix, cliquez sur Select task (Sélectionner une tâche) et sélectionnez une tâche dans le menu.

    Plusieurs tâches peuvent être associées à un même élément.

    Vous pouvez également cliquer sur l’élement pour en afficher les détails dans une fenêtre latérale.

  7. Cliquez sur Confirm (Confirmer).

    L’outil Web personnalisé s’ouvre dans la fenêtre Analysis (Analyse).

    Remarque :

    Les outils Web personnalisés publiés à partir de Notebooks ne seront pas disponibles si l’administrateur ArcGIS a ajouté ArcGIS Notebooks aux applications bloquées de l’organisation.

  8. Mettez à jour les paramètres de l’outil.

    Les paramètres obligatoires sont signalés par un point rouge.

    Conseil :

    Cliquez sur l’icône d’aide en regard d’un paramètre pour consulter l’aide, si elle est disponible.

  9. Cliquez sur Environment settings (Paramètres d’environnement) pour afficher et mettre à jour les environnements utilisés lors du traitement.
  10. Cliquez sur Run (Exécuter).

Crédits

Les outils Web personnalisés publiés à partir de ArcGIS Notebooks utilisent des crédits. Les crédits sont utilisés en fonction de la durée d’exécution de l’outil Web personnalisé et du nombre de crédits requis pour chaque outil d’analyse dans le notebook.

Pour plus d’informations, reportez-vous à la rubrique Comprendre les crédits pour l’analyse spatiale.

Sorties

Les sorties des outils Web personnalisés varient selon l’outil. Pour plus d’informations sur les sorties d’un outil Web personnalisé spécifique, reportez-vous à la description de l’outil ou contactez son propriétaire.

Certains outils Web personnalisés créent des couches en sortie temporaires, telles que des collections d’entités, dans le cadre de leur processus. Les couches temporaires sont uniquement disponibles dans la carte Web où elles ont été créées jusqu’à ce que la carte soit fermée, à moins qu’elles ne soient enregistrées pour créer une couche hébergée. Les couches temporaires sont définitivement supprimées si la carte Web est fermée sans que les couches n’aient été enregistrées. L’enregistrement de la carte Web n’enregistre pas les couches temporaires.

Remarque :

La mise à jour des couches n’est pas disponible pour les couches temporaires. Vous pouvez enregistrer la couche temporaire pour créer une couche d’entités hébergée afin d’activer la mise à jour sur la couche.

Les couches temporaires ne peuvent pas être enregistrées comme faisant partie d’un élément de groupe de couches. Si un outil Web personnalisé crée une couche temporaire dans le cadre d’un groupe de couches, vous pouvez effectuer l’une des opérations suivantes :

  • Enregistrer la couche temporaire de manière individuelle avant d’enregistrer le groupe de couches. La couche temporaire est remplacée par une couche d’entités hébergée lorsqu’elle est enregistrée.
  • Dégrouper le groupe de couches ou déplacer la couche temporaire hors du groupe et enregistrer la couche temporaire de manière individuelle. La couche temporaire est conservée dans la carte Web une fois qu’elle a été enregistrée et remplacée par une couche d’entités hébergée.

Les couches temporaires sont indiquées dans la fenêtre Layers (Couches) à l’aide de l’icône suivante : Couche temporaire

Enregistrer une couche temporaire

Pour enregistrer une couche temporaire, procédez comme suit :

  1. Dans la barre d’outils (foncée) Contents (Contenu), cliquez sur Layers (Couches) Couches si la fenêtre Layers (Couches) n’est pas ouverte.
  2. Dans la fenêtre Layers (Couches), cliquez sur Options Options en regard de la couche à enregistrer, puis sur Save as (Enregistrer sous) Enregistrer sous.
    Conseil :
    Vous pouvez également enregistrer la couche en cliquant sur Properties (Propriétés) Propriétés, en développent la section Information (Informations), puis en cliquant sur Save as (Enregistrer sous) Enregistrer sous.
  3. Indiquez les informations suivantes pour le nouvel élément :
    • Spécifiez un titre.
    • Dans My content (Mon contenu), choisissez un dossier dans lequel enregistrer la couche.
    • Si l’organisation a configuré des catégories de contenu, sélectionnez des catégories qui aideront les utilisateurs à trouver la couche.
    • Entrez des balises et un résumé décrivant la couche.
  4. Cliquez sur Save (Enregistrer).

    Les propriétés de la couche actuelle sont enregistrées dans un nouvel élément, dans My Content (Mon contenu). Ce nouvel élément devient la source de la couche dans la carte.

Licences requises

Les outils Web personnalisés requièrent les licences et configurations suivantes pour être exécutés dans Map Viewer :

  • Type d’utilisateur Creator, Professional ou Professional Plus
  • Rôle d’éditeur, de facilitateur ou d’administrateur, ou rôle personnalisé équivalent

Le privilège Run web tools (Exécuter des outils Web) est requis pour exécuter des outils Web personnalisés publiés à partir de Notebooks.

Des privilèges supplémentaires peuvent être requis pour exécuter les outils Web personnalisés publiés à partir de Notebooks, en fonction des outils d’analyse inclus dans le notebook. Pour plus d’informations sur les privilèges requis pour exécuter un outil d’analyse, reportez-vous à l’aide de cet outil.

Remarque :

Les outils Web personnalisés créés dans Notebooks sont hébergés comme éléments d’outil :

Dépannage

Utilisez les sections ci-après pour résoudre les problèmes potentiels lors de l’ajout ou de l’exécution d’outils Web personnalisés.

Échec de l’ouverture de l’outil Web personnalisé

Il est possible que l’ouverture des outils Web personnalisés échoue dans les cas suivants :

  • Si l’ouverture d’un outil Web personnalisé à partir de la fenêtre Browse custom web tools (Explorer les outils Web personnalisés) échoue, il se peut que cet outil soit temporairement indisponible.
  • Si l’ouverture d’un outil Web personnalisé à partir de l’historique des outils échoue, il se peut que l’élément d’outil ait été supprimé ou que vous ne disposiez plus des autorisations d’utilisation de l’outil (par exemple, l’élément n’est plus partagé). Pour plus d’informations sur le statut de l’outil, contactez son propriétaire.

Type de paramètre non pris en charge

Certains types de paramètres ne sont actuellement pas pris en charge pour les outils Web personnalisés dans Map Viewer. Si un paramètre non pris en charge est marqué comme requis, mais qu’aucune valeur par défaut n’est définie, l’outil ne peut pas être exécuté. Les types de paramètres suivants ne sont actuellement pas pris en charge :

  • GPMultivalue:GPComposite
  • GPMultivalue:GPBoolean
  • GPMultivalue:GPDataFile
  • GPMultivalue:GPRasterDataLayer

Configuration de paramètre non prise en charge

Les paramètres qui utilisent le type de paramètre GPValueTable ne prennent pas en charge les noms de paramètre vides ou en double. Si un nom vide ou en double est utilisé, les paramètres ne sont pas disponibles dans l’outil Web. Contactez le propriétaire de l’outil pour mettre à jour les noms de paramètre vides ou en double.

Configuration de paramètre en sortie non prise en charge

Les couches imbriquées dans les résultats GPValueTable ne sont pas prises en charge et ne sont pas accessibles ou ajoutées à la carte.

Outils Web personnalisés sans paramètre en entrée

Il se peut que certains outils Web personnalisés ne disposent pas de paramètre en entrée. Des outils Web personnalisés sans paramètre en entrée ont été configurés pour utiliser un jeu de données en entrée par défaut et des paramètres qui ne peuvent pas être configurés. Des paramètres d’environnement, tels que le paramètre Processing extent (Étendue de traitement), peuvent être utilisés pour personnaliser la sortie de l’outil. Pour plus d’informations sur les entrées et paramètres de l’outil, consultez-en la description dans la page de l’élément ou contactez le propriétaire de l’élément.

Paramètres non réalimentés si ouverts à partir de l’historique

Les exécutions d’outil peuvent être ouvertes à nouveau à partir de l’historique d’analyse. Si un outil Web personnalisé a été mis à jour depuis que l’outil a été exécuté, certains paramètres risquent de ne pas être réalimentés en fonction des paramètres utilisés lors de l’exécution de l’outil. Les paramètres mis à jour ne sont pas alimentés dans les cas suivants :

  • Un paramètre est ajouté.
  • Un paramètre est supprimé.
  • Un nom de paramètre est modifié.
  • Un type de paramètre est modifié.

Ressources

Référez-vous aux ressources suivantes pour en savoir plus :