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_="button"
Using <widget class_="button"> creates a button that can be configured to perform many actions and initiate interactions.
type_="set"
Using type_="set" creates a button that sets the value of one or more variables defined by the containing <dynamic> tag.

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.
      - type_="config"
        Using type_="config" creates a button that sets the values of dynamic variables from the results of a query.
      - type_="dummy"
        Using type_="dummy" creates a button that doesn't do anything useful, but can send a message.
      - type_="dump"
        Using type_="dump" creates a button that saves the current dynamic state of the QuickApp into a table consisting of a single row with one column per dynamic variable name.
      - type_="export" (deprecated)
        Using type_="export" creates a button that exports the widgets of a QuickApp to a valid output type, such as an Excel workbook.
      - type_="render"
        Using type_="render" creates a button that exports the widgets of a QuickApp to a valid output type, such as an Excel workbook.
      - type_="set"
        Using type_="set" creates a button that sets the value of one or more variables defined by the containing <dynamic> tag.
      - type_="submit"
        Using type_="submit" creates a button that either triggers an update of invalidated widgets or executes a <do> clause.
    - 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.
    - 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.

`type_="set"`

Using type_="set" creates a button that sets the value of one or more variables defined by the containing <dynamic> tag.

Syntax

<dynamic variable="">
    <widget class_="button" type_="set" value_="@var" 
     newvalue_="[VALUE]" text_="[BUTTON_NAME]" 
     valueSUFFIX_="[SUFFIX]" newvalueSUFFIX_="[SUFFIX_VALUE]"/>
</dynamic>

Attributes for `type_="set"`

value_: Accepts a variable defined in the containing <dynamic> element. Variable is set upon the clicking of the button.
newvalue_: Accepts any value. Value is assigned to the variable provided to value_.
valueSUFFIX_: Accepts additional variables defined in the containing <dynamic> element. Values can be assigned to these variables with the same button press.
newvalueSUFFIX_: Accepts any value. Specifies the value to be assigned to the variable in valueSUFFIX_ with the corresponding suffix.

Example for `type_="set"`

<dynamic larry="Nyuck" moe="nyuck" curly="nyuck">
    <widget class_="button" type_="set" text_="Set values"
     value1_="@larry" newvalue1_="Why" value2_="@moe" newvalue2_="I"/>
    <widget class_="text" text_="{@larry}"/>
    <widget class_="text" text_="{@moe}"/>
    <widget class_="text" text_="{@curly}"/>
</dynamic>