Skip to content

docs: sync public docs with framework 8.0→10.2 changes #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
xuyushun441-sys merged 1 commit into from
Jun 23, 2026
Merged

docs: sync public docs with framework 8.0→10.2 changes #28

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 24 additions & 9 deletions content/docs/build/views.de.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,8 @@ view: {
| `timeline` | Chronologischer Feed | `timeline: { startDateField, titleField }` |
| `gantt` | Projektzeitachse + Abhängigkeiten | `gantt: { startDateField, endDateField, titleField }` |
| `map` | Geografische Pins | `map: { locationField }` |
| `chart` | Eingebettetes Diagramm | `chart: { chartType, xAxisField, yAxisFields }` |
| `tree` | Selbstreferenzierende Hierarchie | `tree: { parentField, labelField }` |
| `chart` | Eingebettetes Diagramm | `chart: { chartType, dataset }` |

### Allgemeine List-Optionen

Expand Down Expand Up @@ -151,24 +152,38 @@ Bearbeitung.
}
```

### Tree

```ts
{
type: 'tree',
tree: {
parentField: 'parent_id', // self-lookup that builds the hierarchy
labelField: 'name', // shown indented in the first column
defaultExpandedDepth: 1 // optional — 0 = roots only, omit = expand all
}
}
```

Für ein selbstreferenzierendes Objekt (Kategorien, Stücklisten, Organisationseinheiten, verschachtelte Kommentare) verschachtelt das Tree-Grid die Zeilen anhand ihres `parentField`-Zeigers.

### Chart (inline)

Eine `chart`-Listenansicht bindet ein benanntes **Dataset** — die semantische Analyseschicht (ADR-0021) — und wählt dessen Dimensionen und Kennzahlen **per Name**. Definieren Sie eine Kennzahl einmal, und jedes Diagramm, Dashboard und jeder Report, der dasselbe Dataset bindet, bleibt konsistent:

```ts
{
type: 'chart',
chart: {
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
xAxisField: 'created_at',
yAxisFields: ['amount'],
aggregation: 'sum',
groupByField: 'status'
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
dataset: 'tickets_by_status', // a dataset declared with defineDataset(...)
dimensions: ['status'], // dataset dimension name(s) — X / group / split
values: ['ticket_count'] // dataset measure name(s) — the value axis
}
}
```

Chart-Views sind für eingebettete Dashboards auf einem einzelnen Objekt
gedacht — für umfangreichere, objektübergreifende Analysen verwenden Sie
die dedizierte Reports-Oberfläche.
Die Inline-Form `xAxisField` / `yAxisFields` / `aggregation` / `groupByField` wurde in 9.0 entfernt — jedes Diagramm, Dashboard-Widget und jeder Report bindet jetzt ein Dataset. Für umfangreichere, objektübergreifende Analysen verwenden Sie die dedizierte Reports-Oberfläche.

## Form-View-Typen

Expand Down
32 changes: 24 additions & 8 deletions content/docs/build/views.es.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,8 @@ view: {
| `timeline` | Feed cronológico | `timeline: { startDateField, titleField }` |
| `gantt` | Cronograma de proyecto + dependencias | `gantt: { startDateField, endDateField, titleField }` |
| `map` | Pines geoespaciales | `map: { locationField }` |
| `chart` | Gráfico incrustado | `chart: { chartType, xAxisField, yAxisFields }` |
| `tree` | Jerarquía autorreferenciada | `tree: { parentField, labelField }` |
| `chart` | Gráfico incrustado | `chart: { chartType, dataset }` |

### Opciones comunes de lista

Expand Down Expand Up @@ -147,23 +148,38 @@ agrupado — con las mismas reglas de permisos que una edición manual.
}
```

### Tree

```ts
{
type: 'tree',
tree: {
parentField: 'parent_id', // self-lookup that builds the hierarchy
labelField: 'name', // shown indented in the first column
defaultExpandedDepth: 1 // optional — 0 = roots only, omit = expand all
}
}
```

Para un objeto autorreferenciado (categorías, listas de materiales, unidades organizativas, comentarios anidados) el tree-grid anida las filas según su puntero `parentField`.

### Chart (en línea)

Una vista de lista `chart` vincula un **dataset** con nombre —la capa analítica semántica (ADR-0021)— y selecciona sus dimensiones y medidas **por nombre**. Define una métrica una vez y cada gráfico, panel e informe vinculado al mismo dataset se mantiene consistente:

```ts
{
type: 'chart',
chart: {
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
xAxisField: 'created_at',
yAxisFields: ['amount'],
aggregation: 'sum',
groupByField: 'status'
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
dataset: 'tickets_by_status', // a dataset declared with defineDataset(...)
dimensions: ['status'], // dataset dimension name(s) — X / group / split
values: ['ticket_count'] // dataset measure name(s) — the value axis
}
}
```

Las vistas de gráfico son para paneles en línea sobre un único objeto — para
analíticas más ricas y entre objetos, usa la superficie dedicada de informes.
La forma en línea `xAxisField` / `yAxisFields` / `aggregation` / `groupByField` se eliminó en 9.0 — cada gráfico, widget de panel e informe ahora vincula un dataset. Para analíticas más ricas y entre objetos, usa la superficie dedicada de informes.

## Tipos de vista de formulario

Expand Down
32 changes: 24 additions & 8 deletions content/docs/build/views.fr.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,8 @@ view: {
| `timeline` | Flux chronologique | `timeline: { startDateField, titleField }` |
| `gantt` | Échéancier de projet + dépendances | `gantt: { startDateField, endDateField, titleField }` |
| `map` | Repères géospatiaux | `map: { locationField }` |
| `chart` | Graphique intégré | `chart: { chartType, xAxisField, yAxisFields }` |
| `tree` | Hiérarchie auto-référencée | `tree: { parentField, labelField }` |
| `chart` | Graphique intégré | `chart: { chartType, dataset }` |

### Options de liste courantes

Expand Down Expand Up @@ -147,23 +148,38 @@ champ de regroupement — mêmes règles d'autorisation qu'une modification manu
}
```

### Arbre

```ts
{
type: 'tree',
tree: {
parentField: 'parent_id', // self-lookup that builds the hierarchy
labelField: 'name', // shown indented in the first column
defaultExpandedDepth: 1 // optional — 0 = roots only, omit = expand all
}
}
```

Pour un objet auto-référencé (catégories, nomenclatures, unités organisationnelles, commentaires imbriqués), la grille arborescente imbrique les lignes selon leur pointeur `parentField`.

### Graphique (intégré)

Une vue liste `chart` lie un **dataset** nommé — la couche analytique sémantique (ADR-0021) — et sélectionne ses dimensions et mesures **par leur nom**. Définissez une métrique une fois, et chaque graphique, tableau de bord et rapport lié au même dataset reste cohérent :

```ts
{
type: 'chart',
chart: {
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
xAxisField: 'created_at',
yAxisFields: ['amount'],
aggregation: 'sum',
groupByField: 'status'
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
dataset: 'tickets_by_status', // a dataset declared with defineDataset(...)
dimensions: ['status'], // dataset dimension name(s) — X / group / split
values: ['ticket_count'] // dataset measure name(s) — the value axis
}
}
```

Les vues de graphique servent aux tableaux de bord intégrés sur un seul objet —
pour des analyses plus riches et inter-objets, utilisez la surface de rapports dédiée.
La forme en ligne `xAxisField` / `yAxisFields` / `aggregation` / `groupByField` a été supprimée en 9.0 — chaque graphique, widget de tableau de bord et rapport lie désormais un dataset. Pour des analyses plus riches et inter-objets, utilisez la surface de rapports dédiée.

## Types de vues de formulaire

Expand Down
32 changes: 24 additions & 8 deletions content/docs/build/views.ja.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,8 @@ view: {
| `timeline` | 時系列フィード | `timeline: { startDateField, titleField }` |
| `gantt` | プロジェクトタイムライン + 依存関係 | `gantt: { startDateField, endDateField, titleField }` |
| `map` | 地理空間ピン | `map: { locationField }` |
| `chart` | 埋め込みチャート | `chart: { chartType, xAxisField, yAxisFields }` |
| `tree` | 自己参照型の階層 | `tree: { parentField, labelField }` |
| `chart` | 埋め込みチャート | `chart: { chartType, dataset }` |

### 共通のリストオプション

Expand Down Expand Up @@ -146,23 +147,38 @@ view: {
}
```

### ツリー

```ts
{
type: 'tree',
tree: {
parentField: 'parent_id', // self-lookup that builds the hierarchy
labelField: 'name', // shown indented in the first column
defaultExpandedDepth: 1 // optional — 0 = roots only, omit = expand all
}
}
```

自己参照型のオブジェクト（カテゴリ、部品表、組織単位、入れ子のコメント）では、ツリーグリッドが `parentField` ポインタに従って行を入れ子にします。

### チャート（インライン）

`chart` リストビューは、名前付きの **dataset**（セマンティック分析レイヤー、ADR-0021）をバインドし、そのディメンションとメジャーを**名前で**選択します。メトリックを一度定義すれば、同じ dataset をバインドするすべてのチャート、ダッシュボード、レポートが一貫します。

```ts
{
type: 'chart',
chart: {
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
xAxisField: 'created_at',
yAxisFields: ['amount'],
aggregation: 'sum',
groupByField: 'status'
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
dataset: 'tickets_by_status', // a dataset declared with defineDataset(...)
dimensions: ['status'], // dataset dimension name(s) — X / group / split
values: ['ticket_count'] // dataset measure name(s) — the value axis
}
}
```

チャートビューは、単一オブジェクト上のインラインダッシュボード向けです。より高度な
オブジェクト横断分析には、専用のレポート画面を使用してください。
インラインの `xAxisField` / `yAxisFields` / `aggregation` / `groupByField` の形式は 9.0 で削除されました。すべてのチャート、ダッシュボードウィジェット、レポートは現在 dataset をバインドします。より高度なオブジェクト横断分析には、専用のレポート画面を使用してください。

## フォームビューの種類

Expand Down
32 changes: 24 additions & 8 deletions content/docs/build/views.ko.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,8 @@ view: {
| `timeline` | 시간순 피드 | `timeline: { startDateField, titleField }` |
| `gantt` | 프로젝트 타임라인 + 의존성 | `gantt: { startDateField, endDateField, titleField }` |
| `map` | 지리공간 핀 | `map: { locationField }` |
| `chart` | 임베드 차트 | `chart: { chartType, xAxisField, yAxisFields }` |
| `tree` | 자기 참조 계층 | `tree: { parentField, labelField }` |
| `chart` | 임베드 차트 | `chart: { chartType, dataset }` |

### 공통 list 옵션

Expand Down Expand Up @@ -146,23 +147,38 @@ view: {
}
```

### Tree

```ts
{
type: 'tree',
tree: {
parentField: 'parent_id', // self-lookup that builds the hierarchy
labelField: 'name', // shown indented in the first column
defaultExpandedDepth: 1 // optional — 0 = roots only, omit = expand all
}
}
```

자기 참조 오브젝트(카테고리, BOM, 조직 단위, 중첩 댓글)의 경우 tree-grid는 `parentField` 포인터에 따라 행을 중첩합니다.

### Chart (인라인)

`chart` 리스트 뷰는 이름이 지정된 **dataset**(시맨틱 분석 레이어, ADR-0021)을 바인딩하고 그 디멘션과 측정값을 **이름으로** 선택합니다. 메트릭을 한 번 정의하면 동일한 dataset을 바인딩하는 모든 차트, 대시보드, 리포트가 일관되게 유지됩니다:

```ts
{
type: 'chart',
chart: {
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
xAxisField: 'created_at',
yAxisFields: ['amount'],
aggregation: 'sum',
groupByField: 'status'
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
dataset: 'tickets_by_status', // a dataset declared with defineDataset(...)
dimensions: ['status'], // dataset dimension name(s) — X / group / split
values: ['ticket_count'] // dataset measure name(s) — the value axis
}
}
```

Chart 뷰는 단일 오브젝트의 인라인 대시보드를 위한 것입니다 — 더 풍부한
오브젝트 간 분석을 위해서는 전용 reports 표면을 사용하세요.
인라인 `xAxisField` / `yAxisFields` / `aggregation` / `groupByField` 형식은 9.0에서 제거되었습니다 — 모든 차트, 대시보드 위젯, 리포트는 이제 dataset을 바인딩합니다. 더 풍부한 오브젝트 간 분석을 위해서는 전용 reports 표면을 사용하세요.

## Form 뷰 타입

Expand Down
38 changes: 30 additions & 8 deletions content/docs/build/views.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,8 @@ view: {
| `timeline` | Chronological feed | `timeline: { startDateField, titleField }` |
| `gantt` | Project timeline + dependencies | `gantt: { startDateField, endDateField, titleField }` |
| `map` | Geospatial pins | `map: { locationField }` |
| `chart` | Embedded chart | `chart: { chartType, xAxisField, yAxisFields }` |
| `tree` | Self-referencing hierarchy | `tree: { parentField, labelField }` |
| `chart` | Embedded chart | `chart: { chartType, dataset }` |

### Common list options

Expand Down Expand Up @@ -146,23 +147,44 @@ field — same permission rules as a manual edit.
}
```

### Tree

```ts
{
type: 'tree',
tree: {
parentField: 'parent_id', // self-lookup that builds the hierarchy
labelField: 'name', // shown indented in the first column
defaultExpandedDepth: 1 // optional — 0 = roots only, omit = expand all
}
}
```

For a self-referencing object (categories, BOMs, org units, nested
comments) the tree-grid nests rows by their `parentField` pointer.

### Chart (inline)

A `chart` list view binds a named **dataset** — the semantic analytics layer
(ADR-0021) — and selects its dimensions and measures **by name**. Define a
metric once and every chart, dashboard, and report bound to the same dataset
stays consistent:

```ts
{
type: 'chart',
chart: {
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
xAxisField: 'created_at',
yAxisFields: ['amount'],
aggregation: 'sum',
groupByField: 'status'
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
dataset: 'tickets_by_status', // a dataset declared with defineDataset(...)
dimensions: ['status'], // dataset dimension name(s) — X / group / split
values: ['ticket_count'] // dataset measure name(s) — the value axis
}
}
```

Chart views are for inline dashboards on a single object — for richer,
cross-object analytics use the dedicated reports surface.
The inline `xAxisField` / `yAxisFields` / `aggregation` / `groupByField` shape
was removed in 9.0 — every chart, dashboard widget, and report now binds a
dataset. For richer, cross-object analytics use the dedicated reports surface.

## Form view types

Expand Down
31 changes: 24 additions & 7 deletions content/docs/build/views.zh-Hans.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,8 @@ view: {
| `timeline` | 按时间顺序的 feed | `timeline: { dateField, titleField }` |
| `gantt` | 项目时间线 + 依赖 | `gantt: { startDateField, endDateField, titleField }` |
| `map` | 地理 pin | `map: { locationField }` |
| `chart` | 嵌入式图表 | `chart: { chartType, xAxisField, yAxisFields }` |
| `tree` | 自引用层级 | `tree: { parentField, labelField }` |
| `chart` | 嵌入式图表 | `chart: { chartType, dataset }` |

### 通用 list 选项

Expand Down Expand Up @@ -141,22 +142,38 @@ view: {
}
```

### Tree

```ts
{
type: 'tree',
tree: {
parentField: 'parent_id', // self-lookup that builds the hierarchy
labelField: 'name', // shown indented in the first column
defaultExpandedDepth: 1 // optional — 0 = roots only, omit = expand all
}
}
```

对于自引用对象(分类、BOM、组织单元、嵌套评论),树形表格会按 `parentField` 指针把行嵌套展示。

### Chart(内联)

`chart` 列表视图绑定一个具名 **dataset**(语义分析层,ADR-0021),并**按名称**选择它的维度和度量。度量只定义一次,绑定同一个 dataset 的每个图表、仪表板和报表都保持一致:

```ts
{
type: 'chart',
chart: {
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
xAxisField: 'created_at',
yAxisFields: ['amount'],
aggregation: 'sum',
groupByField: 'status'
chartType: 'bar', // 'bar' | 'line' | 'pie' | 'area' | 'scatter'
dataset: 'tickets_by_status', // a dataset declared with defineDataset(...)
dimensions: ['status'], // dataset dimension name(s) — X / group / split
values: ['ticket_count'] // dataset measure name(s) — the value axis
}
}
```

完整的报表请用 [Reports](/docs/build/reports) 表面 —— chart 视图用于对象的内联仪表板。
内联的 `xAxisField` / `yAxisFields` / `aggregation` / `groupByField` 形式已在 9.0 中移除 —— 现在每个图表、仪表板小组件和报表都绑定 dataset。完整的跨对象分析请使用专用的 reports 表面。

## Form 视图类型

Expand Down
Loading
Loading