Smartapp.com

The 'Connector' option allows Users to add GIS (Geographic Information System) or RTLS (Real Time Location Service) Connector layers to the Project Locations. In addition, you can also configure Actions in Location Manager that pulls Connector Data into custom created App Items via selected Connector Data in Maps.

Add Connectors

• In Project Location, the 'Connector' Toolbar option lets Users add a GIS or RTLS Connector layers to their Project Locations. Admin can click on the 'Connector' Toolbar option to add a Connector to the selected Location.

• Admin should click on the 'Add' button to Add a Connector to the Project Location, the Connectors window shows as shown below.

        Note: The Google Connector option is available to users as DEFAULT GIS Connector.

• Admin clicks to add a 'Connector Name' for the new Connector. The Add Connector window contains the following fields:

• With Connector Information Added, Admin can click the 'Test Connection' button to test the Connector Connection.
  
  

• If the Connection Fails, Admin will see a 'Caution Icon' with 'Connection Failed' text along with 'Test Again' text to retest the connection. 

• Click on the 'Save' Button to Save and activate the connector.

        Note: Save button is enabled only when the connection is successful. 

• The Newly Created Connector now showing in the Connectors List.

Selecting Connector Layers - Adding Connector Layers:

• When a Connector is Successfully added to the Connectors list, Admin has the option to map Specific GIS Layers to Show by clicking on the 'Select Layers' Icon to Manage the GIS Layers for the selected Connector.

• The Select Layers List is populated by GIS Data from the Connector with different layers from the Connector added which  the admin can select from.
  
  

• With Layers Selected, Admin clicks 'Save' to Save the Selected Layers.

• The Saved Selected Layers will now show next to the Select Layers icon in the Connectors Grid. In addition, The Selected Layers will show in the Left Menu in Project Locations.

Editing Connector Layers

• Admin has the option of Editing Selected layers at any point by clicking on a Layer and Unselecting layers already added.

•  Admin can click on 'Save' button to Save changes.

• With the Connector Layers Edited, and a Layer deselected, the Layer stops showing in the 'Select Layers' column in the left pane as well as in the Map Area.
  
  

Showing Layers in Left Pane

• With Connectors Successfully added to the Connectors list and Layers Selected for the Connectors, these Selected Layers will now show in the Left Pane of the Project Location window under 'Layers'. 
  
  

• One or Many Selected Layers associated will show in the Left Pane in Project Location. By Default, the 'Show All' Checkbox is selected and ALL Active Selected Layers will show in the list with an YELLOW highlight. With All Layers showing, the Map View will show All Selected Layers one on top of the other. User clicks to uncheck the 'Show All' Checkbox to hide layers in Map View.
  
  

• Tap on One or many layers on the left pane, With All Layers Turned Off, Admin can select a specific layer to View in Map View.
  
  

• With a Layer Selected, Admin can click the Edit Toolbar Button to View and Edit Layer Information.
  
  

• The Layer Info Panel contains the information as shown below. Admin has the option to Edit the 'Layer Name' Field in Layer Info and click 'Save'.
  
  

Deactivate Connectors

• Admins have the option to Deactivate Connectors. When a Connector is Deactivated, it is saved, but it becomes disabled. This gives the Admin the option to Reactivate Deactivated Connectors at a later date.
• Admin clicks on the 'Connector' Toolbar option to View Connectors. In the Connectors window, Admin clicks to select a Connector they want to Deactivate. With a Connector Selected, Admin clicks on the Deactivate/Activate button to Deactivate the Selected Connector.

• With the Connector Deactivated, the Selected Connector becomes grayed out and not editable. A message stating "Connector deactivated successfully" is shown.

        Note: Deactivating a Connector Hides the 'Deactivated' Selected Layers from the 'Layers' List in the Left Menu.

Map Mode to show Layers

• Map has THREE tabs displayed

• SmartApp
• People
• GIS 

• All the layers added from Project Locations will be displayed in Map mode Under GIS tab and all areas where the map is displayed will show the GIS layers added. By default all the layers will be shown on Map with 'Show All on Map' selected and the layers highlighted by default.

• Tap on one or many layers to hide or show layers on the Map mode, Once selected the layers will show highlighted.

• When a layer is not active, tapping on map mode will show message 'Click on a layer from the left pane to make it active'.

• To make a layer active, User needs to TAP on the layer selected already, which will highlight the active layer in ORANGE in the left pane.
  
  

Manage Actions

• With Connectors Successfully added to the Connectors list and Layers Selected for the Connectors, Admin has the option to create Map Based Custom Actions. The Two Main Action Event Types that can be configured are:

• Click on Map: With this Event Type Selected, Clicking on the Map would start an Action
• Multi Select/draw polygon on map: With this Event Type Selected, Multi- Selecting Items, or Drawing     a Polygon on a Map would start an Action. With this option,

• Admin clicks to Select a Layer to create an Action with.
• With a Layer Selected, Admin clicks on the Manage Actions button to Create a New Action using the Selected Layer.

• As the Admin clicks 'Add' Button to create a new Action. 

Click on Map - Configuration

• Admin creates an action using the 'Click on Map' Event, click on the 'Name' field to add a Name to the Action.
  
  

• In the Select Action Field, Admin clicks to select the 'Spawn Item' option from the dropdown.
  
  

• Selecting Click on Map will launch an Action with a Click on the Map. With this selection, the 'Create in Main Item' and 'Create Sub Item' options are disabled. Admin clicks and Selects an App from the 'App' dropdown list.
  
  

• In the Field Mapping Section, Admin clicks to Select an App Field from the Dropdown List.

        Note: The App Field dropdown Collection will change based on the Fields Configured in the App Selected Above.

• With an App Field Selected, Admin clicks to Select a Layer from the Layer Dropdown.
  
  

• With a Layer Selected, Admin clicks to Select a 'Layer Field' from the Layer Field Dropdown. Which displays all the fields from the layer selected.
  
  

• Admin has the option to add additional Field Mappings to the selection Action. With all Type information added, Admin clicks on the 'Save' button to Save the new Action.
  
  

• With the 'Create Permit' Action Set, users click 'Save' to Save the Actions.
  
  

Click on Map - Consumption

• With a 'Click on Map' Custom Action Event Configured for a Layer, Users on Consumption will now have the opportunity to use the New Custom Action in Map Mode.
• Hover Data: Hovering on a layer Object will display an interactive hover, with Name at the top and the data we get from the layer has to be formatted as <Filed>: <Label> showing one below another in a scrollable form.
  
  

• Custom buttons can also be accessed via the wrench icon and the interactive hover. For the event/object selected in Map mode and based on the layer active in the left panel plus the custom action configuration, the corresponding custom button will be displayed.
  
  

• With a Layer Selected, user Clicks on the Map to Select a Building to Create an Action with. With a Building Selected, The Action Toolbar button in Map Mode becomes Active.

        Note: A Layer Must be selected for an Action to happen.

• With a Building selected, the user clicks on the Action button to run the 'Create Permit' Action.

Note: The 'Create Permit' option is based on the previously configured Action Name Field. This option changes from Action to Action.

• With the custom button click, Based on the action configured for the custom button, corresponding data will load. In this example we had the custom button to open an App and fill in the mapped data.
  
  

Multi select/draw polygon on map - CREATE AS MAIN - Configuration

Admin creates an action using the 'Multi select/draw polygon on map' Event. With the 'Multi select/draw polygon on map', the 'Create as Main Item' and 'Create Sub Items' options will be  enabled, 

Note: The button will become enabled Only if the selected App has Sub Items.

• In the Add Type Window, Admin can select the 'Multi select/draw polygon on map' option.
• Admin can select 'Spawn Item' as the action and select an App called 'Third party license'. With the app selected having Sub Items, the 'Create as Main Item' and 'Create Sub Items' options are now available. If the app selected had no sub items, these two options would be disabled and 'Create as Main Item' would be the Default option.
• Admin can select the 'Create as Main Item' option and Maps the Field Mappings. 'App fields’' will display Main Items for the selected App.

• With all the Action options filled out, Admin clicks 'Save' to save the 'Create as Main Item' - 'Multi select/draw polygon on map' Action.

• With the <Third Party License> Action Set, click 'Save' to Save the Actions.

Multi select/draw polygon on map - DRAW POLYGON - Consumption

• With a 'Multi select/draw polygon on map' Custom Action Event Configured for a Layer, Users on Consumption will now have the opportunity to use the New Custom Action in Map Mode. With a Layer Selected, the user Draws a Polygon on the map to select the buildings within the polygon.

• With the Buildings selected, a Toast appears showing the number of buildings selected: "<32> buildings selected' AND the polygon will disappear. Any custom button configured to Polygon and the layer selected will show up.
• User clicks on the <Third Party License> Action Button in the Map Toolbar to run the Action created for the <32> selected items.

• Since the custom button was to spawn Main Item, If one layer object was selected, then the spawn item properties page would be open in the Main Item, Since multiple items were selected, Item gets created behind the scenes and shows a toast message as shown below.

Multi select/draw polygon on map - CREATE SUB ITEMS - Configuration

• Admin creates an action using the 'Multi select/draw polygon on map' Event. With the 'Multi select/draw polygon on map', the 'Create as Main Item' and 'Create Sub Items' options now become enabled. 
• Admin selects the 'Create Sub Items' option. The 'Create as Main Item' and 'Create Sub Items' options now become enabled PLUS the button will become enabled Only if the selected App has Sub Items, Else default the action to 'Create Main Item'
• In the Add Type Window, Admin selects 'Multi select/draw polygon on map' option. Admin selects 'Spawn Item' as the action and selects an App called <Zone Permissions>. With the app selected having Sub Items, the 'Create as Main Item' and 'Create Sub Items' options are now available.
• If the app selected had no sub items, these two options would be disabled and 'Create as Main Item' would be the Default option. Admin selects the 'Create Sub Items' option and Maps the Field Mappings. Since the 'Create Sub Item' option was selected, the 'App Fields' will display both Main Item and Sub Item tokens.
  
  

• With all the Action options filled out, Admin clicks 'Save' to save the 'Create Sub Items' - 'Multi select/draw polygon on map' Action. With the <Zone Permissions> Action Set, click 'Save' to Save the Actions.
  
  

Multi select/draw polygon on map - SUB ITEM - MULTI SELECT - Consumption

• With a 'Multi select/draw polygon on map' Custom Action Event Configured for a Layer, Users on Consumption will now have the opportunity to use the New Custom Action in Map Mode. With a Layer Selected, the user Draws a Polygon on the map to select the buildings within the polygon.
  
  

• With the Buildings selected, a Toast appears showing the number of buildings selected.
  
  

• With the custom button click, Based on the action configured for the custom button, corresponding data will load. In this example we had the custom button to open Main Item and create the corresponding Sub Items.
  
  

• With the Sub Items processed, User can click Save to Save the New App Item.