56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# 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.
|