Fields of a column

title

A text field that will be the displayed text in the header of the table

Title is optional. If not set, the param is displayed

param

A string that is the field of the event/sample to display.

The source of the field (event/sample) depends on the source : if the source is event, then it is a field of here. If it is a sample, it its its value

You can also specify an array of strings. In that case, the fields are tried from the first to the last until a non null value is found. This is particularly useful when the title and the sumUp may contain the information.

source

Authorized values are event or sample. if event, then the param is a field of the event. If sample, then it is the name of a sample that belongs to the event

The event is an EventV3IO. All the fields are accessible, and the fwot itself is injected by WILCO. You can use for instance param: computedDate, or param: fwot.type

type

type is the type of the value held by the param. it can be tags, fwot, text, date, list

tags: all the tags of the filter are displayed. click on it to (un)select it
list: the selected tags only are displayed. The others are collapsed in a dropdown list. Usefull when there are many elements
fwot: displays the fwot with this precreated format. Click brings the user to the timeline @ correct time
date: date comes along with format field

filter

for tags type, the filter limits the list to the given array of strings.

behavior

RADIO means that only one of the tags that are in the filter can live at the same time: if you click on one tag to set it, the others are automatically removed

TOGGLE means that each tag that are displayed are independent and several of them can live together

editable

a boolean (true or false) saying that the cell can be edited or not. Some of the fields are not editable by nature: the id of a event, the fwot, etc... In that case, the field is ignored

askfor

A list of questions to ask the user. Each entry will lead to a popup that will help the user to enter a text. This list of responses are transmitted to the oneditpayload as askfor structures

  • id: an id of the question that will be passed to the onedit payload

  • question: the text question as it will appear in the popup box. This field is optional

  • default: a default text that will fill the prompt. This field is optional

    {
      "title": "Status",
      "type": "list",
      "param": "tags",
      "filter": [
        "ON",
        "OFF"
      ],
      "behavior": "RADIO",
      "source": "event",
      "editable": true,
      "askfor": [
        {
          "id": "switchId",
          "question": "give me the reason",
          "default": "As per documentation"
        }
      ],
      "onedit": "layouts/webhook/d42fff49-a9cf-4092-a619-431d0e2a056c"
    },

onedit

a string which is the webhook that will be called when the cell is edited (at the end of the process). It should be a WEB connector layout. The webhook is called (POST) with the eventId in the query parameters, and a payload (see below):

if onedit: layouts/webhook/XXX-a9cf-4092-a619-431d0e2a056c wilco calls `POST layouts/webhook/XXX-a9cf-4092-a619-431d0e2a056c?eventId=263572` where 263572 is the event id of the current line displayed

The payload is the following:

{
    column: h, //the current column definition (with all the fields described in this documentation
    action: action, //can be TAG or UNTAG
    data: tag, // the current tag being set
    askfor: [{id:'dez', response:'resp1'}, ...], // the list of answers (see askfor)
    user: user, // the current user (login, role...)
    eventBundleId: // the current event bundle id
}

format

a string that describes the format of the date The format syntax is described here

pattern

A regex that limits the possibilities for the edition of a cell. For example, force a number, uppercases, a count of letters, etc...

Last updated

Was this helpful?