Page tree
Skip to end of metadata
Go to start of metadata

How To Create Netigma Mobile Application?



The App Menu

The app menu is managed witihn the Meta/MenuEditIframe.aspx?Scope=Mobile adress. The first thing to do is, filling MAINMENU and TOPMENU sections. The menu elements that is attached to MAINMENU will be displayed in the application's main menu and similarly the menu items that are attached to TOPMENU, will be placed on the top drop-down menu.

In the following figures, BELNET SSL and Netigma Mobile expressions are obtained from, Netigma's parameter server settings.

Main Menu and Top Menu

The menu items that are added under MAINMENU will be displayed in the application's main menu. Menus can be grouped(optional). In order to do this, the group name must be written in the Menu Group Text property. One of the innovations that comes within Netigma 4.1 is that menu items can be grouped. As shown below, menu items are shown in groups called Tapu, Belnet and Sample Group. Transition between groups can done by scrolling left and right. If grouping is not done, all items will be grouped under "Main Menu". How to add group information for the menus will be explained below. Simple Web Link must be selected and the appropriate Url value must be entered. Bootstrap Glypicons are available for the image features. Simply write the appropriate icon name in the link to the Image feature. The icons in the icons.html page under the Netigma app can also be used.

 

Queries

The query to be used in the mobile application should be prepared and the menu should be created as described above. For the geofenis_is object, the created query, MobilFenisSorgu query, must have URL as mgenelsorgu.aspx?Query =geofenis_is.MobilFenis. Here, the mgenelsorgu.aspx page is a simplified custom query page for Netcad Online applications.

The things should be considred for queries:

  • Not add too much criterias.
  • The preferences for the query editors should be kept simple. (Text box, drop-down lists etc.)
  • The collections of query result should not contain too many columns.

 

How to add Query Page to the Main Menu?(E.g.The Fen Is Query)

 

  • Add a new submenu to the MAINMENU. 
  • Choose its display name as Fen Is Sorgu.
  • The Menu Main Group (new feature) is set to, e.g, Belnet. This field can be left blank. If it is not left blank, the main menu items are shown in groups with the names given here.(see:What are Menu Groups? How to create group?)
  • An icon can be selected directly from the image feature or Bootstrap glypicones can be used. It is recommended to use font icons in the icons.html file in the Netigma main directory. 
    • The example usages of Netigma icons:
      • fa fa-search
      • fa fa-3x  fa-search (fa-3x makes the icon larger)
    • Usage of Bootstrap Icons
      • glyphicon glyphicon-search
    • The image selection editor can be used to add images directly. This use is not recommended for mobile applications. The use of font icons is more practical and faster.
  • For the action property "Simple Web Link" should be selected ve target should be left blank.
  • For Url, e.g: mgenelsorgu.aspx?Sorgu=geofenis_is.MobilFenis expression should be entered. The query parameter determines the query that will open up with the link.
  • The SHOWDISTANCETRACK parameter: if SHOWDISTANCETRACK=true parameter is given for the url property (mgenelsorgu.aspx?Sorgu=geofenis_is.MobilFenis&SHOWDISTANCETRACK=true) a scroller control is added to the top of the query page, from the query result, to access records within a certain distance depending on the location of the device.


Query Results

The columns added to the query result are displayed in the query result screen in the order in which they are added to the list. The first column in the row is dark. Each row is displayed with 3 column display editors in a row. It is not recommended to use editors other than Default and Unified Field Display editors.When touch to one record, all columns with the next third row of columns will be displayed as name - value. Up to 250 entries can be displayed. .

Info card,  reporting and mapping actions can be added to the query result. If you scroll from right to left in the corresponding row, the actions links menu appears.  It is advised, not to add more than 3 type of actions. Instead of giving actions to the data columns (instead of performing a simple web connection action on the object), non-SQL virtual column must be added and simple web link action type should be selected.

Pages that can be linked.

  • Information Form : mgenelbformu.aspx (The information card type of action will be described below)
  • Mobile Map : mobilemap2.aspx
  • File Lists: MobileFileList.aspx :
  • Reports : MobileReport.aspx

Sorgu Ekranı

sorgu ekranı

sorgu sonucu ve işlem linkleri

Information Card

Adding Info Card as a Query Result

In order to be able to open the information card of a record from the query result, a web link action type must be added to the query result collection. The URL property of the web link must be written in Mgenelbilgiformu.aspx. The KODU and BFORM keys must be added to the parameters of the web link. (As in the Netigma web application). A suitable form must be selected as a value for the BFORM parameter. It should be ensured that there is not much fields in the selected form.

  • It would be appropriate to add a new non-sql virtual column instead of adding the Web link to an existing data column.
  • A short text (eg: details) must be entered for text property of the display editor.(Selecting long text could distort the image)
  • An appropriate icon should be selected from the Bootstrap Glypicons to the Picture Path feature. If not selected, the application will display the default icon. In this case, the same icon is displayed in all of the actions from the query result.

Viewing The Info Card

If the query result has information card type of action, the user can see the info card link with swipe operation. When the link is clicked, the netigma form will be opened as the parameter (BFORM) for the web operation. The form is no different from Netigma web applications forms. In mobile forms, Simple form editors may be suitable to be used. (e.g. text box, drop-down lists etc.). Also it should be ensured that there is not too much fields in the form.

Adding and Viewing Files

A file attachment type of editor can be added to the information form and a file can be added to the corresponding entry. Files previously added, can be accessed by clicking on the file icon at the top of the Info form screen.

Map Action

Going to Map from Query Result

In order to go to the map from the query result, a link with the Mobile Map Link must be added to the query result. In the text property, a short phrase such as Map should be used and a suitable bootstrap icon should be selected. The layer property must also be shown in the Netcad Layer manager.

 

 

 

When the user clicks the Map link -in user action menu- opens the Map and highlightes the record in the corresponding layer.

After the map is opened, the user:

  •  can return to the query list by clicking the back link in the top menu
  • can enter the new buffer information with the distance slider at the top. (meter)
  • with this new buffer information, can make a new query by clicking "Query Layer" in the submenu.
  • can select a new layer from the layer selection list and make a new query.
  • By clicking the Show menu in the list, can view the records on the map in the list.

Query witihin the Map

Map link can be added to the main menu as well as accessing the map from the query result.The mobilemap2.aspx? QueryID = geofenis_is.MobilFenis value must be entered for the URL property of the Map Link that is added to the main menu, The query name parameter is important. It specifies which layer to query when the map is first opened, and in which netigma query (which will be opened in the query when clicking the show link in the list) the records found as a result of the query.

For example if the geofenis_is layer will be queried on the map and it is aimed to show the records with geofenis_is table for the selected range on the map:

  • In Workspaces there should be a layer called geofenis_is.
  • The geofenis_is object has to be in Netigma.
  • There must be a query realted to this object to be used in this mobile application.
  • There should be a label for the query as Mobile (this expression is displayed in the layer selection menu on the map page.)

 

Map Page Operations

  1. Menu: Two operations can be done witihin the popup menu that is opens up from bottom to the top of the screen. With Query the Layer, records in the selected layer will be queried. The drawn geometries will be displayed in the list with the Show button on the query result page.
  2. Go to Location: Moves the map location to the location of the device.
  3. Location Selection:This point at the center of the map is used to select the location to be queried. It is always in the middle of the map. By repositioning the map, the selected position can be changed.
  4. Layer Selection:The layer to be queried is changed from here. Mobile-tagged queries in Netigma's metadata will be listed here. The name of the main object of the query adn the recorded layer are assumed to exist in a workspace.
  5. Distance Selection: It is used to give buffer to the point of query. According to the position of the slider, the position selection icon that is centered circle, grows and shrinks. The records in this circle can be queried.

 

Example Map Query with Video Tutorial

When the map is first opened with the query name as a parameter, there will be a mark at the center of the screen. It is necessary to move the map by moving left and right to change the location of this mark. The position of the mark changes when the map is moved. (The yellow marker icon indicates the mark's previous position.) With the top distance selection control, the circular area to be queried can be collapsed and expanded. (Excluding the deed module. Distance selection control is disabled in the deed module).After selecting the appropriate search distance, click the menu button that is in the bottom center of the screen, then click the query button. After this process, the respective layer geometries are marked with the selected circular area. If desired, location and buffer can be changed and new query can be made or by clicking show button in list, results can be displayed as mobile query result