Werkzeuge (Tools)

Liste von Werkzeugen

Nutzen Sie die Werkzeug-ID aus der folgenden Tabelle, um die jeweilige Funktion in einer App zur Verfügung zu stellen:

Bundle Werkzeug-ID Funktion

coordinateconversion

coordinateconversionToggleTool

Koordinaten anzeigen, transformieren, kopieren und suchen

editing

editingToggleTool

Kartenobjekte erstellen oder bearbeiten

legend

legendToggleTool

Legende anzeigen

locateme

locateMeTool

Den aktuellen Standort auf der Karte anzeigen

mapnavigation

compassTool

Karte nach Norden ausrichten

mapnavigation

restoreInitialViewTool

Zur initialen Ansicht zurückkehren

mapnavigation

zoomInTool

Karte vergrößern

mapnavigation

zoomOutTool

Karte verkleinern

mapnavigation

moveToPreviousViewTool

Bewegt die Karte auf den zuvor angezeigten Ausschnitt (Maßstab und Zentrum)

mapnavigation

moveToNextViewTool

Bewegt die Karte auf den nächsten angezeigten Ausschnitt (Maßstab und Zentrum)

measurement-2d

distanceMeasurement2DToggleTool

Die Strecke zwischen zwei Punkten messen

measurement-2d

areaMeasurement2DToggleTool

Eine Fläche und ihren Umfang messen

measurement-3d

lineMeasurement3DToggleTool

Die Strecke zwischen zwei Punkten messen

measurement-3d

areaMeasurement3DToggleTool

Eine Fläche und ihren Umfang messen

portal-webscene-slides

slideSelectorToggleTool

Webszenen Folien öffnen

printing

printingToggleTool

Einen Ausdruck der Karte erstellen

result-ui

resultUiToggleTool

Result Center öffnen

selection-ui

selection-ui-tool

Objekte in der Karte auswählen

share-link

sharelinkTool

App mit parametrisiertem Link teilen

sketching

sketchToggleTool

Objekte auf die Karte zeichnen

sketching

pointSketchTool

Einen Punkt auf die Karte zeichnen

sketching

lineSketchTool

Eine Linie auf die Karte zeichnen

sketching

rectangleSketchTool

Ein Rechteck auf die Karte zeichnen

sketching

polygonSketchTool

Ein Polygon auf die Karte zeichnen

sketching

circleSketchTool

Einen Kreis auf die Karte zeichnen

sketching

deleteAllSketchTool

Alle Zeichnungen löschen

sketching

deleteSelectedSketchTool

Ausgewählte Zeichnungen löschen

toc

tocToggleTool

Karteninhaltsteuerung

viewmodeswitcher

viewmodeSwitcherTool

Zwischen 2D- und 3D-Ansicht wechseln

Werkzeugsets konfigurieren

Werkzeuge werden mit Hilfe von Werkzeugsets (toolsets) in eine App eingebunden. Das folgende Beispiel zeigt die Konfiguration der beiden Werkzeugsets, die in der Standard-App vorkonfiguriert sind:

{
    "toolset": {
        "ToolsetManager": {
            "toolsets": [
                {
                    "id": "mapview_tools",
                    "tools": [
                        "locateMeTool",
                        "zoomInTool",
                        "zoomOutTool",
                        "compassTool",
                        "restoreInitialViewTool",
                        "viewmodeSwitcherTool"
                    ],
                    "tooltipPositions": [
                       "before",
                       "above",
                       "below",
                       "after"
                    ],
                    "registerWidget": {
                        "widgetRole": "mapview_tools"
                    },
                    "container": "ignore",
                    "windowType": "container",
                    "cssClass": "muted"
                },
                {
                    "id": "drawer_left",
                    "title": "Werkzeuge",
                    "cssClass": "ct-main-app-menu",
                    "tools": [
                        "selection-ui-tool",
                        "printingToggleTool",
                        "sharelinkTool",
                        "coordinateconversionToggleTool",
                        "distanceMeasurement2DToggleTool",
                        "areaMeasurement2DToggleTool",
                        "lineMeasurement3DToggleTool",
                        "areaMeasurement3DToggleTool"
                    ],
                    "tooltipPositions": [
                       "after",
                       "above",
                       "below",
                       "before"
                    ],
                    "registerWidget": {
                        "widgetRole": "drawer_button"
                    },
                    "container": "ignore",
                    "windowType": "drawer_left"
                }
            ]
        }
    }
}

Das Werkzeugset mit der ID mapview_tools wird in der Standard-App unten rechts angezeigt und enthält Werkzeuge, wie z.B. Zoomen. Das Werkzeugset mit der ID drawer_left wird in der Standard-App links neben der Suche geöffnet und vom linken Rand aufgeklappt. Der Abschnitt "tools": […​] gibt jeweils an, welche Werkzeuge im jeweiligen Werkzeugset angezeigt werden. Entfernen Sie Einträge oder fügen Sie neue hinzu (siehe Liste von Werkzeugen), um die App Ihren Wünschen anzupassen.

Sie können einer App weitere Werkzeugsets hinzufügen.

Eine Übersicht der verschiedenen Typen von Werkzeugsets und ihrer Konfiguration finden Sie in der Bundle-Dokumentation .

Werkzeuge mit Regeln automatisch steuern (Tool rules)

Werkzeug beim Start einer App aktivieren

Um ein Werkzeug beim Start einer App automatisch zu aktivieren, verwenden Sie die folgende Konfiguration:

{
    "toolrules": {
        "ToolActiveStateManager": {
            "activateOnStartToolIds": [
                "tocToggleTool"
            ]
        }
    }
}

Mit dieser Beispielkonfiguration wird beim Start der App direkt die Karteninhalt-Steuerung angezeigt.

Werkzeuge abhängig vom Kartenzustand steuern

Um ein Werkzeug abhängig vom aktuellen Kartenmaßstab aktivierbar zu machen, verwenden Sie folgende Konfiguration:

{
    "toolrules": {
        "ToolRuleManager": {
            "_rules": {
                "editingToggleTool": {
                    "maxScale": 10000,
                    "minScale": 200000
                }
            }
        }
    }
}

Um ein Werkzeug abhängig vom Status bestimmter Karten-Layer (aktiviert/nicht aktiviert) aktivierbar zu machen, verwenden Sie folgende Konfiguration:

{
    "toolrules": {
        "ToolRuleManager": {
            "_rules": {
                "editingToggleTool": {
                    "layerVisible": ["mylayer"]
                }
            }
        }
    }
}

Werkzeuge rollenbasiert bereitstellen

Die nachstehende Konfiguration kann in Kombination mit dem map.apps User Management , security.manager oder ArcGIS Online/ArcGIS Enterprise-Portal verwendet werden.

Die rollenbasierte Bereitstellung von Werkzeugen kann in der App-Konfiguration definiert werden. Hierzu muss im toolrules-Abschnitt für das entsprechende Werkzeug eine Rolle angegeben werden, für die dieses Werkzeug freigeschaltet wird.

{
    "toolrules": {
        "ToolRuleManager": {
            "_rules": {
                "editingToggleTool": {
                    "roles": ["maAdmin"]
                }
            }
        }
    }
}

Dies erfordert zudem, dass das authentication Bundle in der App geladen wird.

Werkzeuge regelbasiert einblenden oder aktivieren

Standardmäßig wird mit den zuvor beschriebenen Regeln ein Werkzeug in den Modus disabled (ausgegraut) versetzt und wird nur bei erfolgreicher Erfüllung der jeweiligen Regel anschaltbar (nicht mehr ausgegraut). Alternativ kann mit dem Parameter ruleSuccessProperty festgelegt werden, dass ein Werkzeug automatisch eingeblendet oder aktiviert wird:

Wert Verhalten bei nicht erfüllter Regel Verhalten bei erfüllter Regel

enabled (Standard)

Werkzeug sichtbar, aber disabled (ausgegraut)

Werkzeug sichtbar und anschaltbar

visibility

Werkzeug nicht sichtbar

Werkzeug sichtbar und anschaltbar

active

Werkzeug sichtbar und anschaltbar

Werkzeug sichtbar und aktiviert

Die Option active hat nur bei Werkzeugen, die dauerhauft umschaltbar (toggable) sind einen Effekt. Dies sind zum Beispiel Werkzeuge, die ein Fenster öffnen und nicht solche, die eine einmalige Aktion ausführen (z.B. Zoom in die Karte).

Mit der folgenden Konfiguration wird ein Editier-Fenster geöffnet, sobald ein bestimmter Karten-Layer aktiviert wird:

{
    "toolrules": {
        "ToolRuleManager": {
            "_rules": {
                "editingToggleTool": {
                    "layerVisible": ["mylayer"],
                    "ruleSuccessProperty": "active"
                }
            }
        }
    }
}
Weitere Informationen zu Werkzeugregeln (toolrules) finden Sie in der Bundle-Dokumentation .