> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CSV-muoto

> Näin valmistelet CSV-tiedoston joukkoluontia varten: pakollinen otsikkorivi, rivit, URL-säännöt ja validointivirheet.

Joukkoluonti lukee yksinkertaisen CSV-tiedoston: yksi otsikkorivi ja sen jälkeen yksi rivi kutakin QR-koodia kohden, jossa on nimi ja kohde-URL. Tällä sivulla luetellaan säännöt, jotka GetQR tarkistaa, kun lataat tiedoston.

## Esimerkkitiedosto

```csv bulk-qr-template.csv theme={null}
name,url
Spring Menu,https://getqr.com/spring
Store #14,https://getqr.com/store-14
Table 7,example.com/menu?table=7
"Downtown, Main St",https://example.com/stores/downtown
```

Voit myös ladata tämän lähtökohdan sovelluksessa: napsauta **Add links** -vaiheessa **Download CSV template**.

## Säännöt

| Osa | Sääntö |
| - | - |
| Tiedosto | Täytyy olla `.csv`-tiedosto. Excel- ja muita formaatteja ei hyväksytä. |
| Otsikkorivi | Ensimmäisen rivin on oltava täsmälleen `name,url`: pienillä kirjaimilla, tässä järjestyksessä, ei muita sarakkeita. |
| Rivit | Enintään 100 ei-tyhjää riviä. Tyhjät rivit ohitetaan. |
| `name` | Pakollinen. Tästä tulee QR-koodin nimi. Enintään 40 merkkiä; pidemmät nimet katkaistaan 40 merkkiin. |
| `url` | Pakollinen. Verkko-osoite, joka alkaa `http://` tai `https://`. |

### URL-säännöt

* Jos jätät skeeman pois, GetQR lisää `https://`. `example.com/menu` muuttuu muotoon `https://example.com/menu`.
* Osoitteessa on oltava oikea verkkotunnus, jossa on piste, kuten `example.com`.
* Ei välilyöntejä, sarkaimia tai rivinvaihtoja.
* Vain verkkolinkit toimivat. `mailto:`, `ftp://`, `javascript:` ja pelkät sähköpostiosoitteet hylätään.

### Päällekkäiset nimet

Nimien ei tarvitse olla yksilöllisiä. Jos kahdella rivillä on sama nimi (isoja ja pieniä kirjaimia ei eroteta), GetQR numeroi toistot: `Menu`, `Menu 2`, `Menu 3`.

### Pilkut ja lainausmerkit

Jos nimessä on pilkku, ympäröi se lainausmerkeillä, kuten `"Downtown, Main St"`. Taulukkolaskentasovellukset tekevät tämän puolestasi, kun ne tallentavat CSV-muodossa.

## Luo tiedosto taulukkolaskentaohjelmassa

**1. Määritä kaksi saraketta**

Kirjoita ensimmäiselle riville `name` sarakkeeseen A ja `url` sarakkeeseen B.

**2. Lisää yksi rivi kutakin koodia kohden**

Täytä jokaiselle riville nimi ja linkki, enintään 100 riviä.

**3. Tallenna CSV-muodossa**

Vie tai tallenna taulukko CSV-muodossa. Valitse Excelissä **CSV UTF-8**. Valitse Google Sheetsissä **File > Download > Comma-separated values**.

> [!TIP]
>
> UTF-8-muodossa tallentaminen pitää nimiesi skandinaaviset kirjaimet (kuten ä ja ö) ja muut erikoismerkit ehjinä.

## Validointivirheet

### Tiedostovirheet

Nämä pysäyttävät koko tiedoston. Korjaa tiedosto ja lataa se uudelleen.

| Viesti | Mitä tehdä |
| - | - |
| Choose a CSV file. Other file types are not supported. | Tallenna tiedosto `.csv`-muodossa, ei `.xlsx`- tai `.numbers`-muodossa. |
| The CSV header must be exactly name,url in that order. | Tee ensimmäisestä rivistä täsmälleen `name,url`. Tarkista isot kirjaimet, ylimääräiset sarakkeet tai puuttuva otsikkorivi. |
| Add at least one non-empty data row to the CSV. | Tiedostossa on otsikkorivi mutta ei rivejä. Lisää vähintään yksi nimi ja linkki. |
| A CSV can contain at most 100 non-empty rows. | Jaa luettelo enintään 100 rivin tiedostoihin. |
| This CSV is malformed and could not be read. | Vie tiedosto uudelleen taulukkolaskentasovelluksestasi. Etsi sulkemattomia lainausmerkkejä. |

### Rivivirheet

Nämä merkitsevät yksittäisiä rivejä. Voit korjata ne ja ladata tiedoston uudelleen tai jatkaa vain kelvollisilla riveillä.

| Merkintä tai viesti | Syy |
| - | - |
| **MISSING** / Name is required | `name`-solu on tyhjä. |
| **MISSING** / URL is required | `url`-solu on tyhjä. |
| **INVALID** / Enter a valid HTTP(S) URL | Linkki rikkoo jotakin [URL-säännöistä](#url-säännöt). |

Rivinumeroinnissa otsikkorivi on rivi 1, joten ensimmäinen tietorivi on rivi 2, samoin kuin taulukossasi.

## Yleisiä ongelmia

> **Otsikkorivini näyttää oikealta, mutta saan silti otsikkorivivirheen**
>
> Otsikkorivin on oltava pienillä kirjaimilla ja siinä saa olla vain kaksi saraketta. `Name,URL` tai `name,url,notes` eivät kelpaa. Tarkista myös, onko taulukossasi tyhjiä sarakkeita `url`-sarakkeen oikealla puolella.

> **Selaimessani toimiva linkki on merkitty INVALID**
>
> Linkissä voi olla välilyönti, tai se käyttää muuta skeemaa kuin http tai https. Koodaa välilyönnit muotoon `%20` tai poista ne ja käytä täydellistä verkko-osoitetta.

> **Joitakin nimiä lyhennettiin**
>
> Yli 40 merkin nimet katkaistaan 40 merkkiin. Lyhennä ne tiedostossa, jos haluat valita sanamuodon itse.

## Mitä seuraavaksi

> **[Luo QR-koodeja CSV-tiedostosta](/fi/bulk/create-from-csv)**
>
> Lataa tiedostosi ja käynnistä erä.

> **[Joukkoluonnin yleiskatsaus](/fi/bulk/overview)**
>
> Rajoitukset ja joukkoluonnin toiminta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.