Versions Compared

Old Version 17

changes.mady.by.user Andreas Spall (evolu.software)

Saved on

compared with

New Version 18

changes.mady.by.user Julia Çam (evolu.software)

Saved on

Key

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

Field Type

Datamodel example

Text Field

Code Block
languagejson
{       "type": "text",

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) or Rating Fields inside its dataform. (The expression fot the calculation must be configured in the admin panel.)

You can find more information on 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.

Image Removed

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

Calculated Fields here.

Link Field
(since Version 2.9.0)

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

Image Added

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

Code Block
languagejson
{
      "type": "text",
      "value": ""
}

Text Area
(since Version 1.1.0)

Code Block
languagejson
{
      "type": "textarea",
      "value": ""
}

Single Select

Code Block
languagejson
{
      "type": "select-single",
      "allowedValues": [
        {
          "id": "High",
          "name": "High",
          "lozenge": {
            "appearance": "removed",
            "bold": true
          }
        },
        {
          "id": "Medium",
          "name": "Medium",
          "valuelozenge": ""
}

Text Area
(since Version 1.1.0)

Code Block
languagejson
{{
            "typeappearance": "textareamoved",
            "valuebold": ""
}

Single Select

Code Block
languagejson
{true
        "type": "select-single",  }
      "allowedValues": [  },
        {
          "id": "HighLow",
          "name": "HighLow",
          "lozenge": {
            "appearance": "removedsuccess",
            "bold": true
          }
        }
      ],
       "value": {
             "id": "Mediummedium",
             "name": "Medium",
             "lozenge": {
                "appearance": "moved",
                "bold": true
        }
      }
    }

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

Code Block
languagejson
{
          }"type": "select-single-number",
        },"allowedValues": [
        {
          "idname": "LowHigh",
               "namevalue": "Low"10,
          "lozenge": {
            "appearance": "successremoved",
            "bold": true
          }
        },
        ],{
      "value": {
        "id     "name": "mediumMedium",
          "namevalue": "Medium"5,
             "lozenge": {
                "appearance": "moved",
                "bold": true
          }
        },
        {
      }    "name": "Low",
   }     }

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

Code Block
languagejson
{       "typevalue": "select-single-number", 1,
          "allowedValueslozenge": [{
            { "appearance": "success",
            "namebold": "High",true
          }
        "value": 10,}
      ],
      "lozengevalue": {
              "appearancename": "removedMedium",
              "boldvalue": true5,
          }         },
        {
          "name"lozenge": {
          "appearance": "Mediummoved",
          "valuebold": 5,
          "lozenge": { true
        }
      }
     }

Multi Select

Code Block
languagejson
{
      "appearancetype": "movedselect-multi",
     
      "boldallowedValues": true
 [
        }
        },
        {
          "nameid": "LowRed",
               "valuename": 1"Red",
          "lozenge": {
            "appearance": "successremoved",
            "bold": true
          }
        },
        ],{
      "value": {
        "name    "id": "MediumYellow",
             "valuename": 5"Yellow",
             "lozenge": {
                "appearance": "moved",
                "bold": true
   
    }
      }
    }

Multi Select

Code Block
languagejson
{       "type": "select-multi",}
        "allowedValues": [},
        {
          "id": "RedGreen",
          "name": "RedGreen",
          "lozenge": {
            "appearance": "removedsuccess",
            "bold": true
          }
        },
        {],
          "idvalue": "Yellow",[]
    }

Markdown Field

Code Block
languagejson
{
      "nametype": "Yellowmarkdown",
          "lozengevalue": {
   "Hello, **World**!"
}

Date Field

Code Block
languagejson
{
        "appearancetype": "moveddate",
            "bold": true
          }"value": "2020-11-02"
}

Datetime Field

Code Block
languagejson
{
        },
        {
   "type": "datetime",
      "idvalue": "Green",
   2021-04-22T00:20+0200"
}

Number Field

Code Block
languagejson
{
      "nametype": "Greennumber",
      "value": 3
}

URL Field

Code Block
languagejson
{
      "lozengetype": {"url",
      "value": "http://www.evolu.software"
}

Single User

Code Block
languagejson
{
      "appearancetype": "successuser-single",
            "bold"value": true{
          }         }
      ],
      "value": []
    }
Markdown Field
"id": "ff659e015eec6c08bb0003",
        "name": "jose"
      }
}

Multi User

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

Date Field

Code Block
languagejson
{user-multi",
      "typevalue": [{
        "id": "dateff659e015eec6c08bb0003",
           "valuename": "2020-11-02jose"
}

Datetime Field

Code Block
languagejson
{
      "type      },
      {
        "id": "datetimeff65dsljfk93b0003",
           "valuename": "2021-04-22T00:20+0200"
}
Number Field
alana"
      }]
}

Boolean

Code Block
languagejson
{
      "type": "numberboolean",
      "valueallowedValues": 3
}

URL Field

Code Block
languagejson
 [
        {
          "typeid": "urltrue",
          "valuename": "http://www.evolu.software"
}

Single User

Code Block
languagejson
{Approved"
        },
        "type": "user-single", {
          "valueid": {
        "id "false",
          "name": "ff659e015eec6c08bb0003Rejected",
        }
     "name": "jose"
       ],
      "value": true
    }
}

Multi UserRating
(since Version 1.1.0)

Code Block
languagejson
{
      "type": "user-multirating",
      "value": [{
        "id": "ff659e015eec6c08bb0003",allowedValues": [
        {
          "name": "joseReally negative",
       },   "value": 1, 
 {         "idicon": "ff65dsljfk93b0003star",
        "name": "alana"},
​​​       }] }

Boolean

Code Block
languagejson
{
      "type{
          "name": "booleanNegative",
      "allowedValues": [
        {
          "id
          "value": 2, 
          "icon": "truestar",
           "name": "Approved"  },
      },         {
   
      "id": "false",           "name": "Rejected"
        }
      ],
     Alright",
          "value": true3,
       } }

Rating
(since Version 1.1.0)

Code Block
languagejson
{       "typeicon": "rating"star"
        },
      "allowedValues": [         {
          "name": "Really negativePositive",
          "value": 14,
           "icon": "star"
        },
​​​        {
          "name": "NegativeReally positive",
          "value": 25,
           "icon": "star"
        }
      ],
      "value": 
},         {
          "name": "AlrightPositive",
          "value": 34,
          "icon": "star"
        },
        {
          "name": "Positive",
          "value": 4
}

Radio Button
(since Version 2.4.0)

Code Block
languagejson
{
     "type": "radiobutton",
          "iconvalue": "star"
        },
        {
          "name": "Really positiveapproved", 
         "value": 5},
          "iconallowedValues": "star"[
        }       ],
      "value":{ 
          "name": "in {review" 
         "name": "Positive" },
          "value": 4,{ 
          "iconname": "staron hold"
  
     } }

Radio Button
(since Version 2.4.0)

Code Block
languagejson
{      "type": "radiobutton" },
          "value": {
          "name": "approved" 
          }, 
         "allowedValues": [ {
          "name": "rejected"
          }, 
{        ]
}

Checkbox Field
(since Version 2.7.0)

Code Block
languagejson
{
     "nametype": "in reviewcheckbox",
           },"value": [
          { 
          "name": "on holdJava" 
          },
          {
          "name": "approvedPython" 
          }, 
          {],
          "nameallowedValues": "rejected"[
          }, 
{ 
      ] }

Checkbox Field
(since Version 2.7.0)

Code Block
languagejson
{      "typename": "checkboxJava", 
         "value": [ },
          { 
          "name": "JavaC++" 
          },
          {
          "name": "Python" 
          } 
        ], 
         "allowedValues": [
          { 
          "name": "JavaJS" 
          }, 
        ]
}

Calculated Field
(since Version 2.9.0)
(calcFormat since 2.9.2)

Code Block
languagejson
{
    {  "type": "calculated",
          "namevalue": "C++",
           },
     "config": {
    {           "namecalc": "Python" 
          }, 
 risk-id impact-id + effort-id /",
        {    "calcFormat": [
     "name": "JS"        {   }"start": undefined, "end": 50, "color": "#FF494D" },
    ] }

Calculated Field
(since Version 2.9.0)

Code Block
languagejson
{
     "type": "calculated",      { "start": 50, "end": 100, "valuecolor": "#6fa8dc" },
              { "configstart": {
    100, "end": undefined, "color": "#b6d7a8" }
       "calc": "risk-id impact-id + effort-id /"]
          }
}

Link Field
(since Version 2.9.0)

Code Block
{
     "type": "link",
     "config": {
       "ctype": "page"
     }
}