---
title: "Šablóny a reporty chýb — Imports for Laravel | Roundly"
description: "Šablóny CSV a XLSX v angličtine alebo slovenčine s rozbaľovacími zoznamami a tipmi, sťahovanie, príkaz pre šablóny, reporty chýb a CSV bez rizika vzorcov."
url: https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/sablony
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Imports for Laravel](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel.md)

# Šablóny a reporty chýb

Každý importér má šablónu pripravenú na vyplnenie, ako zošit XLSX alebo súbor CSV, s hlavičkami v požadovanom jazyku:

```php
use RoundlyConsulting\Imports\Enums\TemplateFormat;
use RoundlyConsulting\Imports\Facades\Imports;

return Imports::template('assets', TemplateFormat::Xlsx, locale: 'sk')->download();
Imports::importer('assets')->template(TemplateFormat::Csv)->store('s3', 'templates/assets.csv');
$path = Imports::template('people')->toTemporaryFile();       // you own (and delete) the file
```

- Stĺpce sú polia importéra v poradí, bez tých s excludeFromTemplate(). Hlavičky sú popisy v požadovanom jazyku (záloha: záložný jazyk aplikácie, potom názov poľa); povinné polia končia znakom „ \*“.
- Vzorový riadok (templates.example\_row, predvolene zapnutý): example() každého poľa alebo ukážka pre jeho typ.
- CSV: UTF-8 s BOM (templates.csv\_bom), oddeľovač podľa jazyka (templates.csv\_delimiter: čiarka, v slovenčine bodkočiarka) a riadok s nápovedou (templates.hint\_row.csv): povinné alebo voliteľné, povolené hodnoty, príklad dátumu, Áno/Nie, stĺpce s odkazmi.
- XLSX: tučná ukotvená hlavička; šírky stĺpcov; textové stĺpce vo formáte @, aby sa zachovali úvodné nuly, dátumy yyyy-mm-dd, desatinné čísla 0.00…; rozbaľovacie zoznamy (templates.data\_validation) pre stĺpce s výberom a áno/nie — priamo, ak sa zoznam zmestí do 255 znakov, inak skrytý hárok Lists a definovaný názov; vstupná správa pri každom stĺpci (popis a nápoveda). Predvolene bez riadka s nápovedou (templates.hint\_row.xlsx).
- Nezmenený vzorový riadok alebo riadok s nápovedou, ktorý v nahratej šablóne zostal, sa rozpozná a preskočí (ráta sa ako templateRows) v ktoromkoľvek dodanom jazyku — ale len v prvých dvoch neprázdnych dátových riadkoch, kam ich šablóna dáva. Skutočný riadok nižšie, ktorého hodnoty sa zhodujú so vzorom, sa normálne importuje.

## Objekt Template

```php
$template = Imports::template('assets');

$template->format;                    // TemplateFormat
$template->filename;                  // assets.xlsx — the label as a slug in the template's locale
$template->download('assets-template.xlsx');   // StreamedResponse
$template->store('s3', 'templates/assets.xlsx');
$template->toTemporaryFile();
$template->contents();
```

download() pošle prílohu s ASCII bezpečným filename a filename\* v UTF-8, s hlavičkou X-Content-Type-Options: nosniff, a po odoslaní dočasný súbor odstráni. Dočasný súbor sa odstráni aj pri zániku objektu — okrem toho, ktorý ste získali cez toTemporaryFile(); ten patrí vám.

## Z príkazového riadka

```bash
php artisan imports:template assets --format=csv --locale=sk --output=assets.csv
```

## Reporty chýb

```php
return $session->errorReport(TemplateFormat::Xlsx)->download();   // assets-errors.xlsx
$session->errorReport(TemplateFormat::Csv, 'sk');                    // the report's own labels in Slovak
```

Report obsahuje pôvodný riadok hlavičky a stĺpec Errors, len s chybnými riadkami — neplatnými v náhľade a zlyhanými pri importe — tak, ako boli nahraté, pripravené na opravu a nové nahratie. Pomenuje sa podľa nahratého súboru (assets-errors.xlsx), predvolene je to XLSX a overuje authorize(View). Argument jazyka vykreslí vlastné popisy reportu (stĺpec Errors, názov hárka, nepomenované stĺpce) v danom jazyku; správy zostanú v jazyku relácie a nahraté hlavičky tak, ako boli. Report dávky súborov má dva stĺpce, File a Errors, s jedným riadkom na každý odmietnutý súbor.

## Vkladanie vzorcov

Každé CSV, ktoré balík zapíše — šablóny aj reporty chýb, ktoré opakujú hodnoty nahraté inými ľuďmi — pridá ' pred bunku, ktorá začína = + - @, tabulátorom alebo CR; obyčajné číslo (-5, 1,25) zostane bez zmeny. Pri čítaní CSV sa tento ' znova odstráni. Výstup XLSX je bezpečný zo svojej podstaty: inline reťazce, nikdy vzorce.

## Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

[Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

[Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel.md)