Samenvatting
In dit artikel lees je hoe je een CSV-bestand opbouwt dat de import goed leest. Je leest ook wat een UID is, en waarom je die nodig hebt om documenten later bij te werken.
Wanneer gebruik je dit?
Gebruik dit als je veel documenten in één keer wilt toevoegen, bijvoorbeeld uit een spreadsheet.
Hoe werkt dit in Mach3Agent?
Een CSV-bestand is een tabel als tekst. Elke rij wordt een document, en elke kolom vult een veld van dat document. In de eerste rij staan de namen van de kolommen.
De velden van een document heten in de app zo:
| Veld | Wat erin staat | Bijzonderheden |
|---|---|---|
| uid | een vaste, unieke code per document | niet verplicht, wel aan te raden |
| name | de naam van het document | na 255 tekens valt de rest weg |
| description | een korte omschrijving | na 1000 tekens valt de rest weg |
| text | de tekst die de agent gebruikt | verplicht; hoogstens 65.000 tekens |
| url | het adres van de pagina bij het document | niet verplicht |
| image | het adres van een afbeelding bij het document | niet verplicht |
Met een UID herkent de import een document bij een volgende import. Staat de UID al in de catalogus, dan werkt de import dat document bij. Alleen nieuwe of gewijzigde inhoud wordt dan opnieuw verwerkt.
Heb je geen eigen code, dan gebruikt de import de url als UID. Heeft een rij allebei niet, dan wordt die rij bij elke import een nieuw document.
Stappenplan
- Kies Catalogussen in het menu van de agent, en kies de naam van de catalogus.
- Kies Document toevoegen.
- Kies CSV bestand.
- Kies Voorbeeld downloaden.
- Open het voorbeeld in je spreadsheet.
- Zet elk document in een eigen rij, met de tekst in de kolom text.
- Sla het bestand op als CSV.
Het voorbeeld heeft al de zes kolommen, met twee voorbeeldrijen. Het gebruikt het teken dat bij Scheidingsteken gekozen is, standaard een komma. Hoe je het bestand daarna importeert, lees je in CSV-bestand importeren.
Voorwaarden en rechten
- Iedere gebruiker van het account downloadt het voorbeeld, met elke rol.
Gevolgen en beperkingen
- Een bestand heeft hoogstens 50.000 rijen. Heb je meer, verdeel ze dan over meerdere bestanden.
- Een bestand is hoogstens 12 MB. Is het groter, verdeel het dan over meerdere bestanden.
- Een rij zonder tekst slaat de import over.
- Een tekst van meer dan 65.000 tekens slaat de import over.
- Staat dezelfde UID twee keer in het bestand, dan telt alleen de laatste rij.
Als het niet lukt
| Wat je ziet | Wat je doet |
|---|---|
| Een document staat na een tweede import dubbel in de catalogus | Geef elk document een vaste uid, of vul de url in. |
| De import slaat rijen over | Controleer of elke rij een tekst heeft. Lees meer in CSV-fouten oplossen. |