Verwenden von benutzerdefinierten Web-Werkzeugen

Benutzerdefinierte Web-Werkzeuge sind Geoverarbeitungs-Workflows wie Modelle oder Skripte, die in ArcGIS Online veröffentlicht und gehostet werden. Benutzerdefinierte Web-Werkzeuge können unterstützten Apps wie Map Viewer hinzugefügt und über die Registerkarte Analyse ausgeführt werden.

Typen von benutzerdefinierten Web-Werkzeugen

Benutzerdefinierte Web-Werkzeuge in ArcGIS Online verwenden Werkzeugelemente Werkzeug, die aus ArcGIS Notebooks veröffentlicht werden.

Öffnen und Ausführen eines benutzerdefinierten Web-Werkzeugs

Führen Sie die folgenden Schritte aus, um benutzerdefinierte Web-Werkzeuge in Map Viewer aufzurufen und zu verwenden:

  1. Klicken Sie auf der (hellen) Werkzeugleiste Einstellungen auf Analyse Analyse.
    Hinweis:

    Wenn die Schaltfläche Analyse in Map Viewer nicht angezeigt wird, wenden Sie sich an Ihren ArcGIS-Administrator. Möglicherweise sind Sie nicht im Besitz der erforderlichen Berechtigungen oder Credits zum Durchführen von Analysen.

    Weitere Informationen zu Lizenzanforderungen für die räumliche Analyse

  2. Klicken Sie auf Werkzeuge Werkzeuge.
  3. Klicken Sie im Bereich unten auf Benutzerdefinierte Web-Werkzeuge durchsuchen.

    Das Fenster Benutzerdefinierte Web-Werkzeuge durchsuchen wird angezeigt. Im Fenster werden standardmäßig die benutzerdefinierten Web-Werkzeuge angezeigt, die unter Eigene Inhalte verfügbar sind.

  4. Klicken Sie optional auf Eigene Inhalte, und wählen Sie im Menü die Option Eigene Favoriten, Eigene Gruppen, Eigene Organisation, Living Atlas oder ArcGIS Online aus, um die Quelle der Elemente zu ändern.
  5. Sie können auch die Suchleiste und das Menü Sortieren nach verwenden, um die Anzahl der Elemente zu reduzieren oder die Elemente neu zu anzuordnen.
  6. Klicken Sie für das gewünschte Element auf Task auswählen, und wählen Sie einen Task aus dem Menü aus.

    Einem Element können mehrere Tasks zugewiesen werden.

    Sie können auch auf das Element klicken, um die Details des Elements im Seitenbereich anzuzeigen.

  7. Klicken Sie auf Bestätigen.

    Das benutzerdefinierte Web-Werkzeug wird im Bereich Analyse geöffnet.

    Hinweis:

    Benutzerdefinierte Web-Werkzeuge, die aus Notebooks veröffentlicht werden, sind nicht verfügbar, wenn Ihr ArcGIS-Administrator ArcGIS Notebooks zu den gesperrten Apps Ihrer Organisation hinzugefügt hat.

  8. Aktualisieren Sie die Werkzeugparameter.

    Erforderliche Parameter sind mit einem roten Punkt gekennzeichnet.

    Tipp:

    Klicken Sie auf das Hilfesymbol neben einem Parameter, um die Hilfe anzuzeigen, falls verfügbar.

  9. Klicken Sie auf Umgebungseinstellungen, um die Umgebungen, die bei der Verarbeitung verwendet werden, anzuzeigen und zu aktualisieren.
  10. Klicken Sie auf Ausführen.

Credits

Benutzerdefinierte Web-Werkzeuge, die über ArcGIS Notebooks veröffentlicht werden, verbrauchen Credits. Der Verbrauch von Credits richtet sich nach der Zeit, die für die Ausführung des benutzerdefinierten Web-Werkzeugs benötigt wird, und nach der Anzahl der Credits, die für das jeweilige Werkzeug im Notebook erforderlich sind.

Weitere Informationen finden Sie unter Informationen zu Credits für räumliche Analysen.

Ausgaben

Die Ausgaben der benutzerdefinierten Web-Werkzeuge variieren je nach Werkzeug. Informationen zu den Ausgaben für ein bestimmtes benutzerdefiniertes Web-Werkzeug finden Sie in der Beschreibung des Werkzeugs oder erhalten Sie vom Besitzer des Werkzeugs.

Einige benutzerdefinierte Web-Werkzeuge erstellen als Teil ihres Workflows temporäre Ausgabe-Layer, z. B. Feature-Sammlungen. Temporäre Layer sind nur innerhalb der Webkarte verfügbar, in der die Layer erstellt wurden, bis die Karte geschlossen wird, es sei denn, die Layer werden gespeichert, um einen gehosteten Layer zu erstellen. Die temporären Layer werden endgültig gelöscht, wenn die Karte geschlossen wird, ohne die Layer zu speichern. Beim Speichern der Webkarte werden temporäre Layer nicht gespeichert.

Hinweis:

Die Bearbeitung von Layern ist für Webkarten, die eine oder mehrere temporäre Layer enthalten, nicht möglich. Sie können temporäre Layer speichern, um einen gehosteten Feature-Layer zu erstellen, um die Bearbeitung in der Webkarte zu aktivieren.

Temporäre Layer können nicht als Teil eines Gruppen-Layer-Elements gespeichert werden. Wenn ein benutzerdefiniertes Web-Werkzeug einen temporären Layer als Teil eines Gruppen-Layers erstellt, haben Sie folgende Möglichkeiten:

  • Speichern Sie den temporären Layer einzeln, bevor Sie den Gruppen-Layer speichern. Der temporäre Layer wird beim Speichern durch einen gehosteten Feature-Layer ersetzt.
  • Heben Sie die Gruppierung des Gruppen-Layers auf, oder verschieben Sie den temporären Layer aus der Gruppe, und speichern Sie den temporären Layer einzeln. Der temporäre Layer wird in der Webkarte beibehalten, sobald er gespeichert und durch einen gehosteten Feature-Layer ersetzt wurde.

Temporäre Layer werden im Bereich Layer durch das folgende Symbol angezeigt: Temporärer Layer

Speichern eines temporären Layers

Führen Sie die folgenden Schritte aus, um einen temporären Layer zu speichern:

  1. Klicken Sie auf der (dunklen) Werkzeugleiste Inhalt auf Layer Layer, falls der Bereich Layer noch nicht geöffnet ist.
  2. Klicken Sie im Bereich Layer neben dem Layer, den Sie speichern möchten, auf Optionen Optionen und dann auf Speichern unter Speichern unter.
    Tipp:
    Sie können den Layer auch speichern, indem Sie auf Eigenschaften Eigenschaften klicken, den Bereich Informationen einblenden und auf Speichern unter Speichern unter klicken.
  3. Geben Sie die folgenden Informationen für das neue Element an:
    • Geben Sie einen Titel ein.
    • Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie den Layer speichern möchten.
    • Wenn in Ihrer Organisation Inhaltskategorien eingerichtet wurden, wählen Sie Kategorien aus, damit andere Benutzer den Layer finden können.
    • Geben Sie zur Beschreibung des Layers Tags und eine Zusammenfassung ein.
  4. Klicken Sie auf Speichern.

    Die aktuellen Layer-Eigenschaften werden in einem neuen Element in Eigene Inhalte gespeichert. Das neue Element wird zur Quelle für den Layer in der Karte.

Lizenzanforderungen

Für die Ausführung von benutzerdefinierten Web-Werkzeugen in Map Viewer sind die folgenden Lizenzen und Konfigurationen erforderlich:

  • Benutzertyp Creator, Professional oder Professional Plus
  • Publisher-, Vermittler- oder Administratorrolle oder eine entsprechende benutzerdefinierte Rolle

Für die Ausführung von benutzerdefinierten Web-Werkzeugen, die aus Notebooks veröffentlicht wurden, ist die Berechtigung Webwerkzeuge ausführen erforderlich.

Je nachdem, welche Analysewerkzeuge im Notebook enthalten sind, können für die Ausführung von benutzerdefinierten Web-Werkzeuge, die aus Notebooks veröffentlicht werden, zusätzliche Berechtigungen erforderlich sein. Informationen zu den Berechtigungen, die für die Ausführung eines Werkzeugs erforderlich sind, finden Sie in der Hilfe zu dem jeweiligen Werkzeug.

Hinweis:

In Notebooks erstellte benutzerdefinierte Web-Werkzeuge werden als Werkzeugelemente gespeichert.

Problembehandlung

In den folgenden Abschnitten wird erläutert, wie Sie mögliche Probleme beim Hinzufügen oder Ausführen von benutzerdefinierten Web-Werkzeugen beheben können.

Benutzerdefiniertes Web-Werkzeug lässt sich nicht öffnen

In den folgenden Fällen lassen sich benutzerdefinierte Werkzeuge möglicherweise nicht öffnen:

  • Wenn sich ein benutzerdefiniertes Web-Werkzeug nicht über das Fenster Benutzerdefinierte Web-Werkzeuge durchsuchen öffnen lässt, ist das Werkzeug möglicherweise vorübergehend nicht verfügbar.
  • Wenn sich ein benutzerdefiniertes Web-Werkzeug nicht über den Werkzeugverlauf öffnen lässt, wurde das Werkzeug möglicherweise gelöscht, oder Sie haben keine Berechtigung mehr, das Werkzeug zu verwenden (z. B. weil das Element nicht mehr freigegeben ist). Wenden Sie sich an den Besitzer des Werkzeugs, um Informationen zum Status des Werkzeugs zu erhalten.

Nicht unterstützter Parametertyp

Bestimmte Parametertypen werden für benutzerdefinierte Web-Werkzeuge in Map Viewer aktuell nicht unterstützt. Wenn ein nicht unterstützter Parameter als erforderlich gekennzeichnet ist und kein Standardwert festgelegt ist, kann das Werkzeug nicht ausgeführt werden. Die folgenden Parametertypen werden derzeit nicht unterstützt:

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

Nicht unterstützte Parameterkonfiguration

Parameter, die den Parametertyp "GPValueTable" verwenden, unterstützen keine leeren oder doppelten Parameternamen. Wenn ein leerer oder doppelter Name verwendet wird, sind die Parameter im Web-Werkzeug nicht verfügbar. Wenden Sie sich an den Besitzer des Werkzeugs, um die leeren oder doppelten Parameternamen zu aktualisieren.

Nicht unterstützte Ausgabeparameterkonfiguration

In GPValueTable-Ergebnissen geschachtelte Layer werden nicht unterstützt und können weder aufgerufen noch der Karte hinzugefügt werden.

Benutzerdefinierte Web-Werkzeuge ohne Eingabeparameter

Bestimmte benutzerdefinierte Web-Werkzeuge weisen möglicherweise keine Eingabeparameter auf. Benutzerdefinierte Web-Werkzeuge ohne Eingabeparameter wurden so konfiguriert, dass sie ein standardmäßiges Eingabe-Dataset und Parameter verwenden, die nicht konfiguriert werden können. Umgebungseinstellungen, wie z. B. die Verarbeitungsausdehnung, können verwendet werden, um die Ausgabe des Werkzeugs anzupassen. Informationen zu den Eingaben und Parametern des Werkzeugs finden Sie in der Beschreibung auf der Seite mit den Elementdetails oder erhalten Sie vom Besitzer des Elements.

Parameter werden nicht wiederhergestellt, wenn sie über den Verlauf geöffnet werden

Werkzeugausführungen können über den Analyseverlauf erneut geöffnet werden. Wenn ein benutzerdefiniertes Web-Werkzeug nach dessen Ausführung aktualisiert wurde, sind einige Parameter möglicherweise nicht mehr mit den beim Ausführen des Werkzeugs verwendeten Einstellungen gefüllt. In den folgenden Fällen werden die aktualisierten Parameter nicht gefüllt:

  • Ein Parameter wird hinzugefügt
  • Ein Parameter wird gelöscht
  • Ein Parametername wird geändert
  • Ein Parametertyp wird geändert

Ressourcen

Weitere Informationen finden Sie in den folgenden Quellen: