Werkzeuge (Tools)

Konfiguration von Werkzeugsets

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"
                    ],
                    "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"
                    ],
                    "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 .

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.

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

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

resultcenter

resultcenterToggleTool

Ergebniscenter ö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

Nutzerspezifische Bereitstellung von Werkzeugen

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

Die nutzerspezifische 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": {
                "agsprinttool": {
                    "roles": [
                        "maAdmin"
                    ],
                    "ruleSuccessProperty": "visibility"
                }
            }
        }
    }
}