# sipiq_download_v1.0

**Verze:** 1.0 · **Datum:** 2026-06-19

## Co dělá
Automaticky stáhne SIPIQ survey report z Qualtrics přes oficiální **Export
Responses API** (start → poll → download ZIP → rozbalit CSV) a uloží CSV
s timestampovaným názvem do importní složky
`Feasibility\77242113UCO2001\ImportSIPIQcompled`, odkud ho beze změny sebere
`sipiq_import_v1.2.py`.

Nahrazuje ruční proklikávání *Results → Data & Analysis → Export & Import →
Export Data → CSV → Download*.

## Konfigurace (root `.env`, neverzovat)
```
QUALTRICS_API_TOKEN=<token>          # Account Settings → Qualtrics IDs → API → Generate Token
QUALTRICS_DATACENTER=janssenfeasibility.co1
QUALTRICS_SURVEY_ID=SV_9AdeNaNyohp5fNQ
```
Token je citlivý údaj — vlož ho ručně, nikdy ne do kódu/gitu.

## Použití
```
python sipiq_download_v1.0.py            # CSV s labely (jako UI "Export labels")
python sipiq_download_v1.0.py --values   # CSV s hodnotami (useLabels=False)
python sipiq_download_v1.0.py --format tsv
python sipiq_download_v1.0.py --out "<jiná složka>"
```

## Celá pipeline (download → import)
```
python sipiq_download_v1.0.py
python sipiq_import_v1.2.py --apply
```

## Mapování UI → API
| UI dialog | API |
|---|---|
| CSV | `format=csv` |
| Export labels | `useLabels=True` (default) |
| Export values | `useLabels=False` (`--values`) |
| Download all fields | default API chování |
| komprese ZIP | API automaticky |

## Výstupní název
`YYYY-MM-DD_HHMMSS sipiq-<původní_název>.csv` — timestamp = čas stažení;
`sipiq_import` čte `source_exported_at` z mtime souboru. Re-download celé
survey je bezpečný (import je delta podle ResponseId).

## Poznámky
- Před nasazením na scheduler spusť jednou ručně a porovnej CSV s tím, co
  stahuješ přes UI.
- Alternativa bez vlastního kódu: nativní **Response Export Automation**
  v Qualtrics (Export & Import) — plánovaný export na SFTP/cloud.