Použitie
Import tabuliek vyzerá jednoducho, kým neprídu skutočné súbory: bodkočiarky a desatinné čiarky z lokalizovaného Excelu, nadpis nad hlavičkami, hlavičky, na ktorých sa nikto nedohodol, dátum, ktorý neexistuje, riadok, ktorý už v aplikácii je, súbor v nesprávnom kódovaní, pád v polovici veľkého importu a používateľ, ktorý nahral nesprávny súbor a chce ho preč. Imports for Laravel tento proces rieši raz. Každý typ záznamu opíšete v triede importéra; balík dá vašim používateľom šablónu, priradí ich stĺpce, skontroluje každý riadok skôr, než sa čokoľvek uloží, importuje na pozadí a import vie vrátiť.
- Firemné aplikácie, do ktorých používatelia prinášajú vlastné dáta — namiesto prepisovania záznamov si stiahnu šablónu s rozbaľovacími zoznamami povolených hodnôt, vyplnia ju a nahrajú. Kým import nepotvrdia, nič sa neuloží, a neplatné riadky sa neuložia nikdy.
- Presun dát z iného systému — export si ponechá vlastné hlavičky; navrhnuté mapovanie sa skontroluje raz a uloží pre vlastníka, takže ďalší súbor s rovnakými hlavičkami sa namapuje sám, v ľubovoľnom poradí stĺpcov a bez ohľadu na jazyk používateľa.
- Pravidelné aktualizácie z tabuľky — riadky sa párujú podľa prirodzeného kľúča (identifikátor, potom záložný) a režim Update zmení len to, čo súbor vypĺňa: prázdna bunka ponechá uloženú hodnotu.
- Veľké súbory — overenie aj import bežia vo fronte s priebehom, v idempotentných častiach, takže pád ani nové nasadenie nikdy nezapíše riadok dvakrát; zaseknutý beh sa podľa plánu uprace.
- Hromadné nahrávanie súborov — viac súborov alebo jeden ZIP, z každého súboru jeden záznam, s rozpoznaním duplicitných súborov podľa obsahu a odmietnutím nebezpečných archívov.
- Aplikácie s viacerými nájomcami — každý import patrí vlastníkovi (tímu, firme alebo používateľovi) a číta aj zapisuje len jeho dáta, s kontrolou oprávnení pri každom kroku, aj s teams-for-laravel.
- Single-page a mobilné frontendy — zapnite JSON API a môžete vypisovať importéry, sťahovať šablóny, nahrávať, mapovať, zobraziť náhľad, importovať, sledovať priebeh a import vrátiť.
Balík je headless: vlastní súbory, kontroly, dáta aj hraničné prípady, obrazovky si postavíte sami. Importuje len CSV a XLSX — nie staršie .xls, OpenDocument ani binárne zošity — a nikdy nespúšťa makrá ani nevyhodnocuje 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 kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
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.