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 |
|---|---|---|
|
|
Koordinaten anzeigen, transformieren, kopieren und suchen |
|
|
Kartenobjekte erstellen oder bearbeiten |
|
|
Legende anzeigen |
|
|
Den aktuellen Standort auf der Karte anzeigen |
|
|
Karte nach Norden ausrichten |
|
|
Zur initialen Ansicht zurückkehren |
|
|
Karte vergrößern |
|
|
Karte verkleinern |
|
|
Bewegt die Karte auf den zuvor angezeigten Ausschnitt (Maßstab und Zentrum) |
|
|
Bewegt die Karte auf den nächsten angezeigten Ausschnitt (Maßstab und Zentrum) |
|
|
Die Strecke zwischen zwei Punkten messen |
|
|
Eine Fläche und ihren Umfang messen |
|
|
Die Strecke zwischen zwei Punkten messen |
|
|
Eine Fläche und ihren Umfang messen |
|
|
Webszenen Folien öffnen |
|
|
Einen Ausdruck der Karte erstellen |
|
|
Ergebniscenter öffnen |
|
|
Objekte in der Karte auswählen |
|
|
App mit parametrisiertem Link teilen |
|
|
Objekte auf die Karte zeichnen |
|
|
Einen Punkt auf die Karte zeichnen |
|
|
Eine Linie auf die Karte zeichnen |
|
|
Ein Rechteck auf die Karte zeichnen |
|
|
Ein Polygon auf die Karte zeichnen |
|
|
Einen Kreis auf die Karte zeichnen |
|
|
Alle Zeichnungen löschen |
|
|
Ausgewählte Zeichnungen löschen |
|
|
Karteninhaltsteuerung |
|
|
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 |
|---|---|---|
|
Werkzeug sichtbar, aber disabled (ausgegraut) |
Werkzeug sichtbar und anschaltbar |
|
Werkzeug nicht sichtbar |
Werkzeug sichtbar und anschaltbar |
|
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 . |