Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

Field Type

Description

Text Field

Input field to set a string as value.

Text Area
(since Version 1.1.0)

Input field to set a string as value.

Single Select

Select field to pick one of the predefined options.

Single Select (with number value)
(since Version 2.8.0)

Select field to pick one of the predefined options. Each options has a number as value that can be used in calculated fields.

Multi Select

Select field to pick one or more of the predefined options.

Markdown Field

Text Editor to enter text and basic styles.

Date Field

Date picker to set a date as value.

Datetime Field

Datetime picker to set a date and time as value.

Number Field

Input field to set a number as value.

URL Field

Input field to set a URL string as value.

Single User

User picker to pick one user as value.

Multi User

User picker to set one or more users as value.

Boolean

Select field to set true or false.

Rating
(since Version 1.1.0)

Rating Field with 5 possible stars as default. (Number of options, icons and labels can be customised.)

Radio Button
(since Version 2.4.0)

Radio Button Group Field. (Number of options and labels can be customised.)

Checkbox Field
(since Version 2.7.0)

Checkbox Group Field. (Number of options and labels can be customised.)

Calculated Field
(since Version 2.9.0)

Shows a number calculated with the values of Number Fields and/or Select Single Fields (with number value) inside its dataform. (The expression fot the calculation must be configured in the admin panel.)

How to configure the calculated field in the admin panel
The Calculated Field takes a string as the expression. The expression must be written in postfix notation (reverse polish notation).
For more information on the postfix notation check out this link:
https://www.cs.man.ac.uk/~pjj/cs212/fix.html

The ids of the Number Fields and Select Single Fields (with number value) are used as placeholders for their values. And there needs to be a space between all ids and operators.

Example:
The Calculated Field should show: risk plus impact devided by effort.
The expression with the infix notation would look like this:
(risk-id + impact-id) / effort-id
The postfix notation (reverse polish notation) would look like this:
risk-id impact-id + effort-id /

You can convert infix expressions to postfix expressions here:
https://raj457036.github.io/Simple-Tools/prefixAndPostfixConvertor.html

https://www.calcont.in/Conversion/infix_to_postfix

Link Field
(since Version 2.9.0)

By using this field you can link the data form with other data forms.

Depending on the environment, you must specify to which type of container the data forms were attached:

  • Page

  • Space

  • Issue

  • Project

Technical Details - This is how the field types are stored

Field Type

Datamodel example

Text Field

{
      "type": "text",
      "value": ""
}

Text Area
(since Version 1.1.0)

{
      "type": "textarea",
      "value": ""
}

Single Select

{
      "type": "select-single",
      "allowedValues": [
        {
          "id": "High",
          "name": "High",
          "lozenge": {
            "appearance": "removed",
            "bold": true
          }
        },
        {
          "id": "Medium",
          "name": "Medium",
          "lozenge": {
            "appearance": "moved",
            "bold": true
          }
        },
        {
          "id": "Low",
          "name": "Low",
          "lozenge": {
            "appearance": "success",
            "bold": true
          }
        }
      ],
      "value": {
        "id": "medium",
        "name": "Medium",
        "lozenge": {
          "appearance": "moved",
          "bold": true
        }
      }
    }

Single Select
(with number value)
(since Version 2.8.0)

{
      "type": "select-single-number",
      "allowedValues": [
        {
          "name": "High",
          "value": 10,
          "lozenge": {
            "appearance": "removed",
            "bold": true
          }
        },
        {
          "name": "Medium",
          "value": 5,
          "lozenge": {
            "appearance": "moved",
            "bold": true
          }
        },
        {
          "name": "Low",
          "value": 1,
          "lozenge": {
            "appearance": "success",
            "bold": true
          }
        }
      ],
      "value": {
        "name": "Medium",
        "value": 5,
        "lozenge": {
          "appearance": "moved",
          "bold": true
        }
      }
    }

Multi Select

{
      "type": "select-multi",
      "allowedValues": [
        {
          "id": "Red",
          "name": "Red",
          "lozenge": {
            "appearance": "removed",
            "bold": true
          }
        },
        {
          "id": "Yellow",
          "name": "Yellow",
          "lozenge": {
            "appearance": "moved",
            "bold": true
          }
        },
        {
          "id": "Green",
          "name": "Green",
          "lozenge": {
            "appearance": "success",
            "bold": true
          }
        }
      ],
      "value": []
    }

Markdown Field

{
      "type": "markdown",
      "value": "Hello, **World**!"
}

Date Field

{
      "type": "date",
      "value": "2020-11-02"
}

Datetime Field

{
      "type": "datetime",
      "value": "2021-04-22T00:20+0200"
}

Number Field

{
      "type": "number",
      "value": 3
}

URL Field

{
      "type": "url",
      "value": "http://www.evolu.software"
}

Single User

{
      "type": "user-single",
      "value": {
        "id": "ff659e015eec6c08bb0003",
        "name": "jose"
      }
}

Multi User

{
      "type": "user-multi",
      "value": [{
        "id": "ff659e015eec6c08bb0003",
        "name": "jose"
      },
      {
        "id": "ff65dsljfk93b0003",
        "name": "alana"
      }]
}

Boolean

{
      "type": "boolean",
      "allowedValues": [
        {
          "id": "true",
          "name": "Approved"
        },
        {
          "id": "false",
          "name": "Rejected"
        }
      ],
      "value": true
    }
}

Rating
(since Version 1.1.0)

{
      "type": "rating",
      "allowedValues": [
        {
          "name": "Really negative",
          "value": 1, 
          "icon": "star"
        },
​​​        {
          "name": "Negative",
          "value": 2, 
          "icon": "star"
        },
        {
          "name": "Alright",
          "value": 3,
          "icon": "star"
        },
        {
          "name": "Positive",
          "value": 4,
          "icon": "star"
        },
        {
          "name": "Really positive",
          "value": 5,
          "icon": "star"
        }
      ],
      "value": 
        {
          "name": "Positive",
          "value": 4,
          "icon": "star"
        }
}

Radio Button
(since Version 2.4.0)

{
     "type": "radiobutton",
          "value": {
          "name": "approved" 
          },
          "allowedValues": [
          { 
          "name": "in review" 
          },
          { 
          "name": "on hold" 
          },
          {
          "name": "approved" 
          }, 
          {
          "name": "rejected"
          }, 
        ]
}

Checkbox Field
(since Version 2.7.0)

{
     "type": "checkbox",
          "value": [
          { 
          "name": "Java" 
          },
          {
          "name": "Python" 
          } 
        ],
          "allowedValues": [
          { 
          "name": "Java" 
          },
          { 
          "name": "C++" 
          },
          {
          "name": "Python" 
          }, 
          {
          "name": "JS"
          }, 
        ]
}

Calculated Field
(since Version 2.9.0)

{
     "type": "calculated",
          "value": "",
          "config": {
            "calc": "risk-id impact-id + effort-id /"
          }
}

Link Field
(since Version 2.9.0)

{
     "type": "link",
     "config": {
       "ctype": "page"
     }
}
  • No labels