Data importeren

Samenvatting

Op het tabblad Imports van een collectie zet je items, velden, tags en bestanden in een keer naar binnen.

Je levert die gegevens aan als JSON, in een bestand van je computer of op een adres.

Elke import komt daarna als eigen regel in het importoverzicht te staan, met de aantallen per onderdeel.

Wanneer gebruik je dit?

Je gebruikt dit als de inhoud al ergens gestructureerd bestaat en overtypen te veel werk is.

Denk aan een verhuizing van een andere website, een export uit een ander systeem, of een lange lijst met producten.

Moet een ander systeem de baas blijven over de gegevens, dan is een import niet de juiste keuze. Lees Externe data.

Wil je juist je eigen collectie aan een ander systeem geven, lees dan Publieke data.

Hoe werkt dit in Mach3Blocks?

Het tabblad Imports is het vierde en laatste tabblad van een geopende collectie.

Zolang er niets is geïmporteerd, staat er Nog niets om te tonen, met de knop Data importeren eronder.

De pop-in Data importeren

Die knop opent de pop-in Data importeren. Bovenin staat wat een import aan de collectie toevoegt, met per onderdeel het maximum.

Daaronder staat de regel dat de data JSON moet zijn met de juiste indeling. Achter die regel staat de link Voorbeeld JSON.

De pop-in heeft twee velden. Bij Bestand kies je een bestand van je computer, en dat moet een .json zijn.

Bij URL vul je een adres in waar de gegevens staan. Je vult er een van de twee in, niet allebei.

De vereiste indeling

De link Voorbeeld JSON opent in een nieuw venster. Dat voorbeeld is toegespitst op jouw collectie, want het gebruikt de sleutels van jouw eigen velden.

Het voorbeeld heeft twee blokken: tags en items. Het eerste blok bevat de taggroepen met hun tags, het tweede blok bevat de items zelf.

Elke tag in het eerste blok heeft een nummer. Een item wijst zijn tags aan met diezelfde nummers.

De veldwaarden van een item staan bij elkaar onder de sleutel fields. Elke waarde staat daar onder de key van het veld.

Een waarde mag ook per taal worden aangeleverd. Je zet dan de taalcode voor de waarde, en dat werkt ook voor de naam van een tag.

Wat de import van een item overneemt

Naast de veldwaarden neemt de import veertien vaste eigenschappen van een item over.

Gebruikt je collectie nano-ID's, dan neemt de import ook het meegegeven nano-ID over. Lees URL en nano-ID's.

Wat nieuw komt en wat wordt hergebruikt

Dit verschil kun je het beste kennen voordat je begint.

Twee keer hetzelfde bestand importeren geeft dus dubbele items, maar geen dubbele tags.

Heeft de collectie nog geen veld met Gebruik als itemnaam, dan wordt het eerste nieuwe veld van het type Heading dat veld.

Waar de bestanden terechtkomen

De import haalt alleen afbeeldingen en documenten op die het platform kent. Een video wordt niet opgehaald, en dat levert ook geen foutregel op.

De opgehaalde bestanden komen in een eigen map in Bestandsbeheer. Die map heet Collectie import, met de datum en de tijd erachter.

Is er een veld van het type Mediacollectie, dan krijgt dat veld een submap Mediacollectie 1, Mediacollectie 2, enzovoort.

Het importoverzicht

Na afloop staat de import als regel op het tabblad Imports. De nieuwste staat bovenaan.

Dit overzicht heeft geen zoekveld en is niet te sorteren. De volgorde ligt vast op nieuwste eerst.

Open je een regel, dan verschijnt de pop-in Data import. Op het tabblad Informatie staan dezelfde negen gegevens, alleen om te lezen.

Een aantal dat nul is, blijft in die pop-in weg. Staat er een getal bij Errors, lees dan Importfouten.

Stappenplan

De data importeren

1. Open de collectie en ga naar het tabblad Imports.
2. Klik op Data importeren.
3. Open de link Voorbeeld JSON en vergelijk die indeling met je eigen gegevens.
4. Kies een bestand bij Bestand, of vul een adres in bij URL.
5. Klik op Importeren.

Na een geslaagde import verschijnt de melding "De data is geïmporteerd." met de aantallen per onderdeel.

De import controleren

1. Open de nieuwe regel in het importoverzicht en lees de negen aantallen.
2. Ga naar het tabblad Items en bekijk de nieuwe items onderaan de lijst.
3. Ga naar het tabblad Velden en controleer het type van elk nieuw veld.
4. Publiceer je website.

Die laatste stap is geen formaliteit. Zolang je niet publiceert, staat de geïmporteerde inhoud niet op je website; lees Website publiceren.

Voorwaarden en rechten

Je hebt het recht Collecties toevoegen nodig. Zonder dat recht zie je het tabblad Imports niet.

Datzelfde recht toont ook het tabblad Velden, en het laat je een collectie aanmaken.

Voor het publiceren van je website heb je daarnaast het recht Publiceren nodig.

De acht rechten die op een collectie werken, staan bij elkaar in Rechtenoverzicht.

Gevolgen en beperkingen

De nieuwe items komen onderaan de lijst, achter de items die er al stonden.

Heeft de collectie een sorteerveld, dan vallen ze meteen op hun gesorteerde plek. Lees Collectie-instellingen.

Ging er iets mis met de hele import, dan haal je hem in een keer weg. Lees Import terugdraaien.

Als het niet lukt

Zie je de melding "Je hebt geen geldige JSON opgegeven.", dan is het bestand of het adres niet als JSON te lezen.

Controleer dan of het bestand echt JSON bevat, en of het adres zonder inloggen te openen is.

Zie je de melding "Er zijn geen items, velden of tags gevonden in de data.", dan bevat je bestand geen tags en geen items.

Staat er een getal in de kolom Errors, dan is een deel van de data niet binnengekomen. Lees Importfouten.

Mist een item zijn tags, controleer dan of die tags met hetzelfde nummer in het tagblok van hetzelfde bestand staan.

Ziet je website er onveranderd uit, dan is er na de import nog niet gepubliceerd.

Is een bestand niet opgehaald en staat het adres nog in de tekst, dan kent het platform dat bestandstype niet.

Zie je het tabblad Imports niet, dan mist je gebruiker het recht Collecties toevoegen, of de collectie gebruikt externe data.