Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

When creating a widget, define its form, fields, and their behaviour by its behavior by using the template elements to specify the widget view and the way it displays with HTML and Widget Attributes.

Common SimpleTags

Learn how to apply HTML tags that The widget template also allows end-users to input data and interact with it. Apply HTML tags and React components to add and control elements such as buttons and various types of fields. 

<attachment>

description goes here

Code Block
languagexml
titleExample
<attachment model="data.attachments"></attachment>

<button>

Use this attribute to add a button to your widget form. The element is similar to the react component:

Code Block
languagexml
titleExample
linenumberstrue
<button event-click="window.s_widget_custom.showDropdown()">
	Toggle dropdown
</button> 

<checkbox>

This element allows adding and configuring the checkbox field.

Code Block
languagexml
titleExample
linenumberstrue
<checkbox model='data.check'></checkbox>

<codemirror>

The element adds a text field with the code formatting.

Code Block
languagexml
titleExample
linenumberstrue
<codemirror model="data.mirror"></codemirror>

<conditions>

A condition field... :

  1. data-table - provides a connection with a table by its name.
  2. data-table_id - provides a connection with a table by the ID.
Code Block
languagexml
titleExample
linenumberstrue
<conditions model="data.conditions" 
data-table="itsm_incident" 
data-table_id="155964310500000569">
</conditions>

<datetimeinput>

The element provides a data input of the datetime format. 

Code Block
languagexml
titleExample
linenumberstrue
<datetimeinput model="data.datetime">

<daysofweek>

The element adds a field that allows selecting days of week.

Code Block
languagexml
titleExample
linenumberstrue
<daysofweek model="data.daysofweek"></daysofweek>

<duration>

The tag adds a field counting the time duration.

Code Block
languagexml
titleExample
linenumberstrue
<duration model="data.duration"></duration>

<form>

The dynamic form creating component. It requires the following arguments recieved from the server script:

  • table - specifies a name of the table, e.g. "sys_cmdb_ci".
  • view - defines a name of the table template view, e.g. "record", "list", etc.
  • (optional) sys_id - an ID of the form.
  • (optional) buttons - form UI actions including buttons and other graphical elements.

    Info

    Specify the way UI actions displayed on the form with the options below:

    • header - on the top of the form;
    • bottom - on the bottom of the form;
    • link - as a link.

    Specify these options separating them with the coma.

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <form table="name_table" view="name_view" 
    sys_id="sys_number" buttons="header, bottom, link">
    </form>

    <getlist>

    Виджет для получения списка из АПИ и прокидывания результатов в дочерний виджет.
    Code Block
    languagexml
    titleExample
    linenumberstrue
    there was text here. it's gone now. 

    <htmlinput>

    Text input field in html format along with text formatting options.

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <htmlinput model="data.htmlinput"></htmlinput>

    <list>

    A field 

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <list model="data.list" data-table="itsm_incident" 
    data-table_id="155964310500000569">
    </list>

    <modal>

    модальное окно

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <modal model="data.modal" title="Modal Label" isShow="true">

    <reference>

    This element adds a reference field to a widget for establishing connections with data tables by a custom reference.

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <reference model="data.element" data-table="cmdb" condition="(sys_id=123456789012345678)" isFixed="true"></reference>

    <report>

    Add this SimpleTag to display a particular report.

    Specify the reportID attribute of this element to display the report with the appropriate ID.

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <Report reportid="123456789012345678"/>

    <select>

    Adds a field for items selecting.

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <select model="data.select" 
    options='[{ "database_value": "1", "display_value": "Test" },
     { "database_value": "2", "display_value": "Test 2" }]'>
    </select>

    <stringinput>

    In a widget, use this attribute to designate an input field for text information. The element is similar to the react component:

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <stringinput model="data.input"></stringinput>

    <textarea>

    A multi-line text field. The element is similar to the react component:

    Code Block
    languagexml
    titleExample
    linenumberstrue
    <textarea model="data.textarea"></textarea>
    Table of ContentsclassfixedPosition

    Portal SimpleTags 

    Learn SimpleTags that implement portal widgets.

    Note

    When a widget is implemented, all tag attribute values are transmitted as a string regardless of the attribute type; and during the processing phase, the attribute value is applied in line with the type specified.