> For the complete documentation index, see [llms.txt](https://docs.flightwatching.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flightwatching.com/user-manual/designer-user-manual/general-conf/configuration/event-tables/tables/json-structure/cols/fields-of-a-column.md).

# Fields of a column

## title

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

{% hint style="info" %}
Title is optional. If not set, the param is displayed
{% endhint %}

## 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](https://app.swaggerhub.com/apis/flightwatching/wilco-api/3.0.0#/EventV3IO). If it is a `sample`, it its its value

{% hint style="info" %}
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.
{% endhint %}

## 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`](https://app.swaggerhub.com/apis/flightwatching/wilco-api/3.0.0#/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](https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LucrvGdSn3RONbIcfqh%2F-MVGzQ0PPJ5lV5bHopVG%2F-MVGzn9JQizjxnwcZkGt%2Fimage.png?alt=media\&token=ebf9eeb3-d3d5-49f1-a8a7-b16383b54f8d)

![list: the selected tags only are displayed. The others are collapsed in a dropdown list. Usefull when there are many elements](https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LucrvGdSn3RONbIcfqh%2F-MVGzQ0PPJ5lV5bHopVG%2F-MVH-GQWj5ad3xmaodY-%2Fimage.png?alt=media\&token=b8c468e7-9f95-4762-92d3-e12d7d12aa9c)

![fwot: displays the fwot with this precreated format. Click brings the user to the timeline @ correct time](https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LucrvGdSn3RONbIcfqh%2F-MVGzQ0PPJ5lV5bHopVG%2F-MVH-bxoANoZi7qShSAT%2Fimage.png?alt=media\&token=0d31807b-9082-4c32-aa8d-f8c86174fcca)

![date: date comes along with format field](https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LucrvGdSn3RONbIcfqh%2F-MVGzQ0PPJ5lV5bHopVG%2F-MVH-r1NQJeDe5BImvuf%2Fimage.png?alt=media\&token=5d32ccc9-06f5-42eb-9c8f-82df91815ba7)

## 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 `onedit`payload 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

```json
    {
      "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"
    },
```

![](https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2FDamSuqcpZhgDKqKWkgwU%2Fimage.png?alt=media\&token=14e185e1-1743-4432-bca2-3b1fd6f0f677)

## 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:

```json
{
    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](https://momentjs.com/docs/#/displaying/)

## pattern

A [regex](https://www.w3schools.com/js/js_regexp.asp) that limits the possibilities for the edition of a cell. For example, force a number, uppercases, a count of letters, etc...