Home
Macro Language Elements
The section contains detailed specifications for all 1010data Macro Language elements.
Application Development
<widget>
<widget> is used to define all visual components of a QuickApp, including drop-downs, text boxes, tables, and calendars. The form a widget takes is controlled by the class_ attribute.
class_="gmap"
Using <widget class_="gmap"> creates a graphical map that can be used to display geographical information. This widget is powered by the Google Maps service.
<layer name="marker">
<layer name="marker"> is used for placing "pins" on the map within the map widget.

Macro Language Elements
The section contains detailed specifications for all 1010data Macro Language elements.
- Data Transformation
  Data transformation operations use functions and expressions to functionally alter tabular data. These operations take 0, 1, or 2 tables as input and produce a single table as a result.
- Blocks
  Blocks allow users to reuse sections of Macro Language code and to parameterize values in that code for greater flexibility and power.
- Application Development
  - <dynamic>
    The <dynamic> element creates an environment in 1010data that maintains the state of system interactions and controls the running of queries.
  - <render>
    The <render> element provides the ability to configure certain QuickApp widgets when rendered to available output targets. A single <render> element contains one or more elements that specify output targets and settings for the final output.
  - <layout>
    The <layout> element is a nestable pseudo-operation that can be used to organize <widget> elements and other <layout> elements.
  - <widget>
    <widget> is used to define all visual components of a QuickApp, including drop-downs, text boxes, tables, and calendars. The form a widget takes is controlled by the class_ attribute.
    - class_="alert"
      The alert widget displays a message to the user when an event triggers an alert. (Available as of prod-9)
    - class_="bokehchart"
      <widget class_="bokehchart"> allows you to create data visualizations. (Available as of version 13.30)
    - class_="browser"
      Using <widget class_="browser"> creates a file-browser that enables the end-user of the QuickApp to select 1010data objects such as tables, folders, and queries.
    - class_="buildgrid"
      Using <widget class_="buildgrid"> provides an editable, expandable grid for entering data into a temp table.
    - class_="button"
      Using <widget class_="button"> creates a button that can be configured to perform many actions and initiate interactions.
    - class_="chart"
      Using <widget class_="chart"> allows you to create client-side data visualizations rendered by the Kendo UI ®charting engine. (Available as of version 10.16)
    - class_="checkbox"
      Using <widget class_="checkbox"> creates a simple checkbox with a label.
    - class_="checklist"
      Using <widget class_="checklist"> creates a set of checkboxes with horizontal or vertical orientation.
    - class_="color"
      Using <widget class_="color"> creates a widget that allows the end-user to select a color value.
    - class_="date"
      Using <widget class_="date"> creates an input field with an accompanying calendar widget for easier date selection.
    - class_="draggable"
      Using <widget class_="draggable"> creates drag-and-drop biscuits to add columns to different drop zones.(Available as of version 13.04)
    - class_="dropdown"
      Using <widget class_="dropdown"> creates a drop-down menu.
    - class_="dropdownlist"
      Using <widget class_="dropdownlist"> creates a drop-down menu with multi-select capabilities that preserve the order of items clicked. (Available as of prod-9)
    - class_="editgrid" (deprecated)
      Using <widget class_="editgrid"> creates a table whose cells can be edited in the browser.
    - class_="expression"
      The expression widget provides assistance in composing 1010data expressions. (Available as of version 11.18)
    - class_="field"
      Using <widget class_="field"> creates a text input field.
    - class_="font"
      Using <widget class_="font"> creates a widget that allows the end user to select a font and related properties such as size and style.
    - class_="gauge"
      Using <widget class_="gauge"> creates a linear or radial gauge that displays scalar data on a specified range of values. (Available as of prod-9)
    - class_="gmap"
      Using <widget class_="gmap"> creates a graphical map that can be used to display geographical information. This widget is powered by the Google Maps service.
      - <layer name="marker">
        <layer name="marker"> is used for placing "pins" on the map within the map widget.
      - <layer name="bubble">
        <layer name="bubble"> is used to create color "bubbles" to highlight a geographic region in Google maps.
      - <layer name="heatmap">
        <layer name="heatmap"> is used for overlaying a heat map on top of geographical data.
      - <layer name="polygon">
        <layer name="polygon"> is used for overlaying polygons (state/counties) on top of Google Map data.
    - class_="graphics"
      Using <widget class_="graphics"> creates a graph generated by 1010data's visualization engine.
    - class_="grid"
      Using <widget class_="grid">, the results from a 1010data query can be displayed in a tabular format.
    - class_="image"
      Using <widget class_="image"> inserts an image into the layout of a QuickApp.
    - class_="lineup"
      The <widget class_="lineup"> is a specialized alternative to <widget class_="sorter">, which allows for selection, ordering, and sorting from a collection of columns or similar objects. (Available as of version 12.06)
    - class_="link"
      Using <widget class_="link"> creates an HTML hyperlink.
    - class_="list"
      Using <widget class_="list"> creates a scrollable box with a list of values that can be selected by clicking or lassoing.
    - class_="logout"
      Sends a logout command to the server.
    - class_="menu"
      Using <widget class_="menu"> creates a hierarchical menu bar with cascading submenus that can submit action or alter variables on selection. (Available as of prod-9)
    - class_="nest"
      Using <widget class_="nest">, widgets can be dynamically generated based on parameterized values.
    - class_="progressbar"
      Using <widget class_="progressbar"> creates a progress bar with several display modes. (Available as of prod-9)
    - class_="querytree"
      Using <widget class_="querytree"> provides a display of hierarchical data with nested parent/child nodes. (Available as of prod-9)
    - class_="radio"
      Using <widget class_="radio"> creates a set of radio buttons with horizontal or vertical orientation.
    - class_="radiobutton"
      Using <widget class_="radiobutton"> creates a button that assigns the value of a specified expression to a dynamic variable when the button is clicked. The button can assume different guises.
    - class_="receiver"
      Using <widget class_="receiver"> updates dynamic variables when it receives JavaScript messages sent from external web applications.
    - class_="slider"
      Using <widget class_="slider"> creates a sliding value widget.
    - class_="sorter"
      Using <widget class_="sorter"> creates a scrollable box with a list of values that can be sorted, or two lists in which values that can be moved from one to the other and sorted within each individual list.
    - class_="spy"
      Detects the size of the display area used to show a QuickApp and changes values in a package variable when the dimensions of the display area change. These values can then be used to change dimensional aspects of the QuickApp.
    - class_="table"
      Using <widget class_="table"> creates a fixed table ideal for displaying a relatively small dataset. The current maximum size for a table widget is 1000 rows and 500 columns. Any results from a 1010data query can be displayed in this table/grid element.
    - class_="taglist"
      Provides an input box for multiple strings which are then parsed into tags. (Available as of version 15.04)
    - class_="terminal"
      Provides an xterm-compatible terminal emulator as a widget.
    - class_="text"
      Using <widget class_="text"> displays text in the QuickApp.
    - class_="textbox"
      Using <widget class_="textbox"> creates a large text field for entering and editing arbitrary text, including 1010data Macro Language code.
    - class_="transmitter"
      Using <widget class_="transmitter"> sends a JavaScript message to the web application in which the QuickApp is contained, notifying it when the values of specified dynamic variables have changed.
    - class_="value"
      A value widget displays the value of its bound variable, formatted appropriately for its type. (Available as of version 11.19)
  - <do>
    A <do> clause within a <dynamic> provides the ability for <dynamic> variables to be updated when some variable within the scope of the <dynamic> is changed.
  - <do action_="sql">
    <do action_="sql"> provides a programmatic API to the SQL metadata store. (Available as of version 17.29)
  - <loop>
    <loop> is a special operation that allows one query to iteratively reference the data from each row in the results of another query.

`<layer name="marker">`

<layer name="marker"> is used for placing "pins" on the map within the map widget.

Description

The <layer> element must specify a base table containing geographic data. The table must provide columns containing valid values for latitude, longitude, location description, and a unique identifier for the pin that corresponds to a given location. 1010data has provided a sample table that contains the necessary data for <layer name="marker"> in pub.demo.geo.counties.

Syntax

<dynamic>
  <widget class_="gmap">
    <layer name="marker">
      [1010data Query]
    </layer>
  </widget>
</dynamic>

Attributes

alwayslabel_: Accepts boolean values. alwayslabel_="1" results in labels that are always visible.
lat_: Accepts a column name containing valid latitudinal values.
lng_: Accepts a column name containing valid longitudinal values.
desc_: Accepts a column name containing text values that serve as the description of the pin.
key_: Accepts a column name containing unique values, each of which serves as a unique identifier for each pin.
opacity_: Accepts a decimal value between 0.0 and 1.0 (inclusive). The higher the value specified, the more opaque the markers in the map.
showhints_: Accepts boolean values. showhints_="1" shows the hints on mouseover. This is the default value.

`marker layer` Example

The following example displays markers in the Google map. The opacity of the marker is .6 (opacity_=0.6), so they are somewhat transparent. alwayslabel_=1, so the markers have actual labels (Pennsylvania, New Jersey, and Connecticut) not just mouseover hints.

<dynamic pzpack="{pkg('lat' 'lng' 'zoom' 'nelat' 'nelng' 'swlat' 'swlng'; 40.753622 -73.972841 8 '' '' '' '')}">
  <widget class_="gmap" pzvalue_="@pzpack" width_="1383" height_="495">
    <layer name="marker" lat_="lat" lng_="long" desc_="state" key_="id" 
       opacity_=0.6 alwayslabel_=1>
      <base table="pub.demo.geo.counties"/>
      <tabu breaks="state_id">
        <tcol fun="first" source="latitude" name="lat"/>
        <tcol fun="first" source="longitude" name="long"/>
        <tcol fun="first" source="state" name="state"/>
      </tabu>
      <willbe name="id" value="i_()"/>
    </layer>
  </widget>
</dynamic>