Tools
Configuration of toolsets
Tools are integrated into an app with the help of toolsets. The following example shows the configuration of the two toolsets that are preconfigured in the default app:
{
"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"
}
]
}
}
}The toolset with the ID mapview_tools is displayed in the bottom right corner of the default app and contains tools such as zooming.
The toolset with the ID drawer_left is opened in the default app to the left of the search and expanded from the left side.
The section "tools": […] indicates which tools are displayed in the respective toolset.
To customize the app to your needs, remove entries or add new ones (see list of tools).
You can add more toolsets to an app.
| An overview of the different types of toolsets and their configuration can be found in the bundle documentation . |
Activate tool at start of an app
To activate a tool automatically when an app starts, use the following configuration:
{
"toolrules": {
"ToolActiveStateManager": {
"activateOnStartToolIds": [
"tocToggleTool"
]
}
}
}With this example configuration, the map content control is displayed directly when the app is started.
List of tools
Use the ID from the following table to make the respective function available in an app:
| Bundle | Tool ID | Function |
|---|---|---|
|
|
Display, Transform, Copy and Search Coordinates |
|
|
Create or edit map objects |
|
|
Show legend |
|
|
Show the current location on the map |
|
|
Align map to north |
|
|
Return to initial view |
|
|
Zoom in map |
|
|
Zoom out map |
|
|
Measure the distance between two points |
|
|
Measure an area and its perimeter |
|
|
Measure the distance between two points |
|
|
Measure an area and its perimeter |
|
|
Open Web Scenes slides |
|
|
Create a printout of the map |
|
|
Open result center |
|
|
Select objects on the map |
|
|
Share app with parameterized link |
|
|
Draw objects on the map |
|
|
Draw a point on the map |
|
|
Draw a line on the map |
|
|
Draw a rectangle on the map |
|
|
Draw a polygon on the map |
|
|
Draw a circle on the map |
|
|
Delete all drawings |
|
|
Delete selected drawings |
|
|
Map content control |
|
|
Switch between 2D and 3D view |
Providing User Specific Tools
The following configuration can be used in combination with map.apps User Management , security.manager or ArcGIS Online/Portal for ArcGIS.
To provide user specific tools, you can configure the toolrules bundle.
Assign the role to the tool to make it accessible by users with this role.
{
"toolrules": {
"ToolRuleManager": {
"_rules": {
"agsprinttool": {
"roles": [
"maAdmin"
],
"ruleSuccessProperty": "visibility"
}
}
}
}
}