Verwenden von benutzerdefinierten Web-Werkzeugen

Bei benutzerdefinierten Web-Werkzeugen handelt es sich um Geoverarbeitungs-Workflows, die in Ihrer ArcGIS-Organisation veröffentlicht und gehostet werden. Benutzerdefinierte Web-Werkzeuge können unterstützten Apps wie Map Viewer und Scene Viewer hinzugefügt und über die Registerkarte Analyse ausgeführt werden.

Typen von benutzerdefinierten Web-Werkzeugen

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

Öffnen und Ausführen benutzerdefinierter Web-Werkzeuge

Benutzerdefinierte Web-Werkzeuge können in Map Viewer oder Scene Viewer geöffnet und ausgeführt werden.

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

  1. Führen Sie einen der folgenden Schritte aus, um die Analyse zu öffnen:
    • Klicken Sie in Map Viewer auf der (hellen) Werkzeugleiste Einstellungen auf Analyse Analyse.
    • Klicken Sie in Scene Viewer auf der (dunklen) Werkzeugleiste Designer auf Analyse Analyse.
    Hinweis:

    Wenn die Schaltfläche Analyse nicht angezeigt wird, wenden Sie sich an Ihren Organisationsadministrator. Möglicherweise sind Sie nicht im Besitz der erforderlichen Berechtigungen oder Credits zum Durchführen von Analysen, oder in Ihrer ArcGIS-Organisation sind keine gehosteten Feature-Layer (für Analysen erforderlich) vorhanden.

    Weitere Informationen finden Sie im Blogbeitrag FAQ: Why don't I see the Analysis button in Map Viewer in der Esri Community.

  2. Klicken Sie auf Werkzeuge Werkzeuge.
  3. Klicken Sie auf benutzerdefiniertes Web-Werkzeug öffnen.

    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 Organisationsadministrator 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.
    Hinweis:

    Umgebungseinstellungen sind derzeit für benutzerdefinierte Web-Werkzeuge, die aus ModelBuilder veröffentlicht werden, nicht verfügbar.

  10. Klicken Sie auf Ausführen.

Einschränkungen

In ArcGIS Online gehostete benutzerdefinierte Web-Werkzeuge können nicht mit der Option Alle (öffentlich) freigegeben werden. Diese Einschränkung gilt nicht für in ArcGIS Enterprise gehostete benutzerdefinierte Web-Werkzeuge.

Ergebnis-Layer für Web-Werkzeuge, die aus Analysemodellen veröffentlicht wurden, können möglicherweise nicht zur Karte hinzugefügt werden, wenn bei der Ausführung des Web-Werkzeugs Werkzeugfehler aufgetreten sind. Einige gehostete Ausgaben können weiterhin erstellt und unter Eigene Inhalte gespeichert werden.

Credits

Benutzerdefinierte Web-Werkzeuge, die ausArcGIS Notebooks und ModelBuilder 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 oder Analysemodell erforderlich sind. Bei Analysemodellen verbrauchen nur Premium-Werkzeuge Credits.

Bei Web-Werkzeugen, die aus ModelBuilder veröffentlicht wurden, wird die Anzahl der verbrauchten Credits im Analyseverlauf angezeigt. Der Credit-Verbrauch basiert wie folgt auf zwei separaten Messgrößen:

  • Dauer der Ausführung: Die Anzahl der verbrauchten Credits basierend auf der Laufzeit des Werkzeugs. Es werden 70 Credits pro Stunde verbraucht, berechnet pro Minute ohne Mindestlaufzeit.
  • Utility-Services: Die Anzahl der Credits, die von ArcGIS Online-Utility-Services, wie z. B. ArcGIS GeoEnrichment Service und ArcGIS Online routing services verbraucht werden. Utility-Services werden von Premium-Werkzeugen verbraucht.

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:

Temporäre Layer werden derzeit nicht als Ausgabe in Scene Viewer unterstützt.

Die Bearbeitung temporärer Layer ist nicht möglich. Sie können temporäre Layer speichern, um einen gehosteten Feature-Layer zu erstellen und so die Layer-Bearbeitung 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:
    • Einen Titel.
    • 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.
    • Tags und eine Zusammenfassung, die den Layer beschreiben.
  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 benutzerdefinierte Web-Werkzeuge 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 und ModelBuilder veröffentlicht wurden, ist die Berechtigung Web-Werkzeuge ausführen erforderlich.

Je nachdem, welche Analysewerkzeuge im Notebook oder Modell enthalten sind, können für die Ausführung von benutzerdefinierten Web-Werkzeugen, die aus Notebooks und ModelBuilder 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.

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-Element 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 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:

  • GPMultivalue: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 Elementseite 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: