## Start Lists & Summary Tables Panel Help

This guide covers creating and managing start lists (draw) and summary tables (results) with filters, column options, sorting, and export functionality.

##### Introduction

This panel provides two main report types: Start Lists (Draw) showing order and basic athlete info, and Summary Tables (Results) showing scores, ranks, and aggregates. You can save your setup as configurations that automatically update across all connected displays. All outputs use UTF-8 encoding for proper international character display.

## Introduction

This panel provides two report types:

- Start List (Draw) – order and basic athlete info.
- Summary Table (Results) – scores, ranks, and aggregates.

You can save your setup as a configuration. When you edit and save a configuration, pages using it will update automatically on next load. All outputs use UTF‑8 so names like “Łukasz” display correctly.

## Where results are visible

- In this admin panel (live preview).
- Public dashboards/overlays that read saved configurations will reflect updates automatically.
- Direct API links using `config_id` for HTML/CSV/JSON.

Visibility depends on each configuration’s Status (e.g., public, private, draft).

## Quick start

1. Select an Event (and optional Heat).
2. Choose Start List or Summary Table.
3. Apply Filters (Gender, Category).
4. Toggle Column Options.
5. (Optional) Rename headers.
6. (Optional) Adjust Sorting.
7. Save as a configuration for reuse.

## Filters

- Event – required; controls all following choices.
- Heat – optional focus on a specific heat.
- Gender – All, Male, or Female.
- Category – main and ranking categories; “All” by default.

Filters are stored in configurations for 1‑click recall later.

## Column options

### Basic information

- Rank
- Bib / Start No
- Participant
- Category
- Club / Team
- Gender
- FIS Code
- Licence Code
- Country

### Scores & aggregates

- Individual Runs
- Judge Scores
- Control Points
- Figures
- Event Settings row

### Event Settings details

- Format name
- Judge info
- Scoring scale
- Drop rule
- Mode config
- Heat info

### Summary highlights

- Heat Best
- Heat Average
- Overall Best
- Highest Average

## Column renaming

- Change any header label (e.g., “Bib” → “Start No”).
- Stored per event in your browser (localStorage) and applied when you load.
- Use presets, and Copy/Paste to reuse across configs.
- Clear all renames anytime.

Advanced: API can accept `rename_*` parameters, e.g. `rename_bib=Start+No`.

## Sorting

Pick a Sort By field and Direction:

- Overall Average, Overall Best, Heat Average, Heat Best
- Also: Bib, Name, Club, Category (availability may vary)

## Configurations

- Save – stores filters, column visibility, sorting, renames.
- Load – instantly restore a saved view.
- Edit – switch to editing mode, then save to update.
- Duplicate – clone and adjust.
- Delete – remove when no longer needed.
- Status – public/private/draft controls visibility.
- Display order – controls how configs are listed.
- Preview – see final output quickly.

After you save edits, any page rendering this configuration will show the updated version automatically on next load.

## Exports & API

Share results or consume them programmatically:

- Summary Table via `config_id`:
  `/v2/api/summary_table_api.php?config_id=123&format=html`
  `/v2/api/summary_table_api.php?config_id=123&format=csv`
  `/v2/api/summary_table_api.php?config_id=123&format=json`
- On‑the‑fly build via parameters:
  `/v2/api/summary_table_api.php?event_id=1&heat_number=1&gender=all&format=html`

CSV is UTF‑8 with BOM. JSON preserves unicode characters.

## FAQ & Tips

##

Select a Heat in the Filters, or use `heat_number=H` in API links.

##

A rename preset or manual rename may be applied. Open the Rename section to review or clear.

##

Yes, outputs are UTF‑8. If you see odd characters, refresh and verify the source data.

##

When you save changes to a configuration, any page using it will render the updated version on next load automatically.

##

Yes. Use the config actions in the panel or the API formats above to copy a link.

## URL parameters (advanced)

### Filters

- `event_id`, `heat_number`
- `gender` = all|M|F
- `category` or `category_id`

### Sorting

- `sort` (e.g., `OverallAverage`)
- `sort_direction` = asc|desc

### Visibility

- `show_rank`, `show_bib`, `show_participant`, `show_category`, `show_club`, `show_gender`, `show_fis_code`, `show_licence_code`, `show_country`

### Aggregates

- `show_runs`, `show_judges`, `show_control_points`, `show_figures`
- `show_event_settings` + details: `show_format_name`, `show_judge_info`, `show_scale_info`, `show_drop_rule`, `show_mode_config`, `show_heat_info`
- `show_heat_best`, `show_heat_average`, `show_overall_best`, `show_highest_average`

### Renaming

- `rename_bib`, `rename_participant`, `rename_category`, `rename_club`, `rename_gender`, `rename_overall_average`, `rename_overall_best`, `rename_heat_best`, `rename_heat_average`, …

Exact keys depend on your build; use the panel’s Rename section to see what’s available.

Last updated: