Pierre Dittgen (6313ec37) at 05 May 06:54
0.4.3
Relative to #4
First try to integrate arrayItem
information into generated markdown:
classification
Classification A
, Classification B
, Classification C
Classification A
For table layout
template, I still scratch my head to see how this additional info will be added into table. Current markdown output for this field is:
Ce modèle de données repose sur les 4 champs suivants correspondant aux colonnes du fichier tabulaire.
nom | type | titre | exemple | Contraintes |
---|---|---|---|---|
id |
nombre entier | 42 |
valeur obligatoire |
|
date_creation |
date | 2020-02-27 |
valeur obligatoire |
|
nom |
chaîne de caractères | Brouette |
valeur obligatoire |
|
classification |
liste | Classification A |
valeur optionnelle |
Si ce table layout n'est à l'heure actuelle pas utilisé, je partirais sans plus attendre sur ta solution si elle te paraît la solution la plus directe ou la conversion la plus littérale du JSON.
L'idée est d'améliorer dès maintenant la doc SCDL du schéma menu-collectif dont 4 champs utilisent arrayItem, et ne pas investir plus de temps dans cette librairie vu qu'à l'avenir la fonctionnalité "table schema -> markdown" pourrait être intégrée dans frictionless-py.
Oui, on peut tout mettre dans la colonne contraintes
mais dans ce cas, on ne peut plus distinguer les contraintes définies au niveau du champ des contraintes définies au niveau de l'élément de liste et on risque d'avoir des informations en double.
La spécification actuelle de tableschema ne définit pas précisément ce que l'on peut trouver comme propriétés dans associées à arrayItem
à part type
et constraints -> enum
car c'est pour ce cas d'utilisation que l'on a créé la propriété.
Qui utilise la présentation tabulaire des champs ? Je ne sais pas.
Peut-être quelque chose comme ça ?
nom | type | titre | exemple | contraintes |
---|---|---|---|---|
id |
nombre entier | 42 |
valeur obligatoire valeur minimale : 1 |
|
date_creation |
date | 2020-02-27 |
valeur obligatoire |
|
nom |
chaîne de caractères | Brouette |
valeur obligatoire |
|
classification |
liste (chaînes de caractères) | Classification A |
valeurs autorisées : |
Petite question subsidiaire : quelle interface implémente actuellement ce "table layout" ?
Better table layout handling
Table layout generation has been improved:
Ce modèle de données repose sur les 4 champs suivants correspondant aux colonnes du fichier tabulaire.
nom | type | titre | exemple | contraintes | élément de liste |
---|---|---|---|---|---|
id |
nombre entier | 42 |
valeur obligatoire valeur minimale : 1 |
s/o |
|
date_creation |
date | 2020-02-27 |
valeur obligatoire |
s/o |
|
nom |
chaîne de caractères | Brouette |
valeur obligatoire |
s/o |
|
classification |
liste | Classification A |
type : chaîne de caractères valeurs autorisées : |
Pierre Dittgen (a81ea865) at 03 May 09:05
fixup
Pierre Dittgen (873ee6fb) at 03 May 09:00
table layout: more constraints, new arrayItem column
See !2 (merged)
Relative to #4
First try to integrate arrayItem
information into generated markdown:
classification
Classification A
, Classification B
, Classification C
Classification A
For table layout
template, I still scratch my head to see how this additional info will be added into table. Current markdown output for this field is:
Ce modèle de données repose sur les 4 champs suivants correspondant aux colonnes du fichier tabulaire.
nom | type | titre | exemple | Contraintes |
---|---|---|---|---|
id |
nombre entier | 42 |
valeur obligatoire |
|
date_creation |
date | 2020-02-27 |
valeur obligatoire |
|
nom |
chaîne de caractères | Brouette |
valeur obligatoire |
|
classification |
liste | Classification A |
valeur optionnelle |
Pierre Dittgen (6b7d0c87) at 27 Apr 13:39
Remove blank line
Pierre Dittgen (811c821a) at 27 Apr 13:26
Improve enum values display
Pierre Dittgen (daa6e955) at 27 Apr 09:00
Fix field name format
Pierre Dittgen (bb7c84ea) at 27 Apr 07:53
Add arrayItem support for fields-as-headings template
... and 1 more commit
The table-schema-to-markdown
library should be able to describe in a human-readable way the new possibilities with table schemas and multiple array values (see here).
See schema example:
"name":"classification",
"description":"Classification de l'objet.",
"example":"Classification A",
"type":"array",
"arrayItem":{
"type": "string",
"constraints": {
"enum": ["Classification A", "Classification B", "Classification C"]
}
}
Documentation should be similar to classic enum constraint (see schema example here and Markdown documentation here).