Inleiding

Swing Studio (hierna 'Studio') is de basismodule voor het beheren, bewerken en combineren van statistische en geografische data. Met Studio brengt u eenvoudig gegevens van verschillende (geografische) niveaus samen in één database. Het resultaat bekijkt en deelt u met Swing Viewer (hierna 'Viewer') en/of Swing Mosaic (hierna 'Mosaic'). In deze instructie leest u hoe u als beheerder snel en eenvoudig data kunt importeren en publiceren.

Praktische vragen zoals hieronder beschreven komen aan bod.

  • Hoe moet mijn importbestand opgebouwd zijn?
  • Hoe importeer ik data?
  • Waar voeg je de metadata toe?
  • Hoe bekijk ik het eindresultaat?

Conceptuele aspecten van Swing worden alleen waar nodig toegelicht.

Eerst wordt uitgelegd hoe u toegang krijgt tot de applicatie. Vervolgens krijgt u inzicht in de mogelijkheden en eisen van data- en metadatabestanden.

Algemeen

ABF geeft u een webadres en accountgegevens die u toegang verlenen tot Studio. In de afbeelding hieronder ziet u het inlogscherm.

1

Direct na het inloggen in Studio verschijnt de startpagina. Deze bestaat uit verschillende ‘tegels’ met interessante informatie en doorverwijzingen naar de meest gebruikte onderdelen:

  1. Het importmenu; importeer hier de (meta)data
  2. De onderwerpentabel; voeg onderwerpen toe
  3. De themaboom; bewerk de themaboom
  4. Rapporten; opent de rapportenmodule
  5. Opent de testversie (../admin/jive)
  6. De meest recente activiteiten in Studio
  7. De actieve beheerders en het onderdeel waarin ze actief zijn
  8. Consistentierapporten uitdraaien
  9. Links naar de online support van Swing
  10. Het aantal onderwerpen in gebruik, inclusief het maximum toelaatbare
  11. Het aantal onderwerpen met een formule, inclusief het maximum toelaatbare
  12. Het aantal datarecords in gebruik, inclusief het maximum toelaatbare
1

Data importeren

Praktische zaken vooraf

Bij het importen van data in Studio dient u eerst een bestand te uploaden naar de ABF-server. U kunt maximaal 1 bestand per keer uploaden. Een bestand mag uit meerdere tabbladen bestaan (met uitzondering van csv-bestanden). Wanneer u meerdere bestanden in een keer wilt uploaden, dan is dat mogelijk door de bestanden in een gecomprimeerde map (.zip) te plaatsen. U plaatst bestanden in een gecomprimeerde map door deze te selecteren en vervolgens via de rechtermuisknop te kiezen voor de optie 'Kopiëren naar' Gecomprimeerde (gezipte) map.

1

Studio ondersteunt het importeren van gegevens voor de volgende bestandstypen:

  • Access (.mdb / .accdb)
  • Excel (.xls / .xlsx / .xml )
  • CSV

Het is ook mogelijk om geautomatiseerd data in Studio te importeren. Dit kan vanaf een bestaande Studio-database of een andere gegevensbron. Tevens is het mogelijk om grote hoeveelheden data te downloaden als CSV of JSON. Benieuwd naar de mogelijkheden? Voor meer informatie kunt u contact opnemen met de Swing Helpdesk via telefoonnummer 015 – 27 99 399 of per mail: helpdesk@swing.eu.

In Studio worden voor het importeren van gegevens twee soorten data onderscheiden, namelijk data (standaard data of kubusdata) en metadata. In de volgende paragrafen worden de voorwaarden voor het importbestand uiteengezet.

Voorbeelden van importbestanden van standaard en kubusdata kunt u hier downloaden.

Metadata

Metadata zijn beschrijvende gegevens over de data (data over data), bijvoorbeeld de naam, eenheid, datatype of bron van een onderwerp. Voor veel onderdelen (Indicators, Units, Geolevels, etc. ) in Studio kunt u een metadatabestanden inlezen.

De kolomnamen in een metadatabestand dienen overeen komen met de kolomnamen van de desbetreffende tabel in Studio. U kunt eenvoudig een voorbeeld kolomnamen verkrijgen door in Studio een aantal rijen te selecteren van de tabel en deze vervolgens te exporteren met de knop 'Export metadata'.

1

Selecteer vervolgens het gewenste bestandsformaat:

1

Databestanden

Databestanden bevatten de waarden (getallen of teksten) van een (of meer) onderwerp(en) die u wilt toevoegen in Studio. U kunt daarvoor twee indelingen hanteren. Deze worden in hieronder beschreven.

Coderingen binnen Swing kunnen bestaan uit letters, getallen of een combinatie van die twee. Speciale karakters zijn - op een underscore na - niet toegestaan. Speciale karakters en spaties in coderingen worden automatisch omgezet naar een underscore.

Indeling 1: onderwerp per kolom

In het databestand kunt u gebruik maken van de vaste kolomnamen PERIOD, GEOLEVEL en GEOITEM voor respectievelijk de kolommen met de perioden, de gebiedsniveaus en de gebieden, zie voorbeeld 1. Bij afwijkende kolomnamen kunt u de kolomindeling na het uploaden van het bestand en voor het daadwerkelijk importeren nog aanpassen. Een andere mogelijkheid is het opnemen van een definitiebestand om de kolommen te definiëren, zie voorbeeld 2. Dit betreft een extra tabblad met dezelfde naamgeving als het tabblad waar de data betrekking op heeft, maar dan inclusief de prefix '_def', in dit voorbeeld is dat dus 'data_def1'.

Voorbeeld 1: (standaard)databestand met 13 onderwerpen

1

Voorbeeld 2: (kubus)databestand met definitietabel

1

1

Indeling 2: Waarde per record

Een andere indeling voor het inlezen van data is door voor iedere waarde een apart record op te nemen, zie voorbeeld 4. In het importbestand kunt u wederom gebruik maken de vaste kolomnamen PERIOD, GEOLEVEL, GEOITEM, CUBEMEMBERS, VARIABLE en VALUE voor respectievelijk de kolommen met de perioden, de gebieden, de onderwerpen, de dimensie-items en de data, zie voorbeeld 4. Bij afwijkende kolomnamen kunt u de kolomindeling na het uploaden van het bestand en voor het daadwerkelijk importeren nog aanpassen. Een andere mogelijkheid is het opnemen van een definitiebestand om de kolommen te definiëren.

Voorbeeld 4: (kubus)databestand en definitietabel bij importeren waarde per record

1

1

Onderstaand een overzicht van alle mogelijke types in de definitietabel:

type omschrijving
period Deze kolom bevat de periodecode van de data
geolevel Deze kolom bevat de gebiedsniveaucode van de data
geoitem Deze kolom bevat de gebiedscode van de data
dim Deze kolom bevat de dimensiecode van de data, voorbeeld geslacht MAN/VROUW
var Deze kolom bevat de onderwerpcode bij type 'Waarde per record' of de data bij type 'Onderwerp per kolom'
data Deze kolom bevat de data, alleen gebruikt bij type 'Waarde per record'

Importeren

U kunt een metadata- en/of databestand importeren via het menu Data > Import.

1

Hier kunt een bestand kiezen om te uploaden naar de server van ABF. Studio upload het geselecteerde bestand en analyseert het.

1 1

Vervolgens verschijnt het importscherm. Afhankelijk van het formaat wat u inleest herkent Studio het bestand en de indeling van de kolommen. U ziet dat zowel het data- als het metadatabestand herkend zijn door de applicatie (2). Indien het (excel)bestand lege cellen bevat, zal hiervoor een waarschuwing verschijnen boven in beeld (1). Dit is vaak op te lossen door de gegevens te 'kopiëren' en vervolgens te 'plakken als waarden' in een ander tabblad. Lege cellen in de kolom(men) met data kunt u opvullen met de codes '-99996' ('empty') of '-99998' (n.v.t.).

Tabbladen die niet bedoeld zijn om te importeren kunt u uitschakelen (zoals het tabblad 'Origineel'). Verder is het mogelijk om de relevante tabbladen te selecteren (2), diverse opties aan te vinken (3) en/of een gedeelte van (of alle) data van de onderwerpen in het importbestand te verwijderen (4) voordat de data geïmporteerd (5) worden.

1

Voordat u de data gaat importeren heeft u de mogelijkheid om de door Studio automatisch geslecteerde instellingen bij het datatype en de kolommen aan te passen. Klik op 'Show column format' om de instellingen bij de kolommen te tonen. Wij adviseren u om vaste kolomnamen te hanteren (PERIOD, GEOLEVEL, GEOITEM en de prefix '_DNC' bij kubusdimensies). Deze worden automatisch herkend.

1

Na het importeren verschijnt een scherm met het importresultaat. Hierop worden tevens eventuele fouten weergegeven die bij het importeren zijn opgetreden.

1

Het importeren van (meta)data is ook mogelijk op de pagina van het betreffende ondereel (Indicators, Units, Geolevels, etc. ). Zo gebruikt u bij het ondereel 'Indicators' de button 'Import data' (1) voor het importeren van data de button 'Import metadata' (2) voor het importeren van metadata (van onderwerpen).

1

Toevoegen aan themaboom

Als er nieuwe onderwerpen aan het systeem zijn toegevoegd kunt u na het importeren van de (meta)data direct naar de themaboom (Viewer > Category tree) om de nieuwe onderwerpen aan een bestaand of nieuw thema toe te voegen. U doet dit eenvoudig door het gewenste (nieuw aangemaakte) thema en de onderwerpen te selecteren, waarna met het 'pijltje naar links' de onderwerpen aan het geselcteerde thema worden toegevoegd. Wanneer het een update van de data betreft kunt u het resultaat direct controleren in de testversie (en/of publiceren).

1

Data publiceren

Binnen Studio kunt u zowel Mosaic als Viewer publiceren, ook kunt u de live en testversie (admin) van beide applicaties inzien.

Via Publish > Publish Studio komt u in het publicatiemenu terecht. Dit bestaat uit grofweg drie onderdelen:

  1. De onderdelen die gepubliceerd kunnen worden.
  2. De databaseversies in de beheeromgeving (admin); hier selecteert u het onderdeel dat u wilt publiceren. Van elk onderdeel is de laatste wijzigingsdatum vermeld en elk onderdeel kunt u apart bekijken door op ‘View’ te klikken.
  3. De databaseversies die live staan. Door op ‘View’ te klikken kunt u van elk onderdeel de live versie openen. Tevens is de publicatiedatum van publicatie vermeld.
1

De volgende onderdelen kunt u apart publiceren:

  1. Data/Viewer/Layout(Viewer); de Viewer database. Dus alle data, rapporten, opmaakinstellingen etc.
  2. Accounts; de gebruikersdatabase. Betreft de tabel ‘Users’ in Studio. Via Accounts > Users is deze binnen Studio in te zien.
  3. Mosaic; het Mosaic. In geval van meerdere Mosaics kunt u elk Mosaic apart publiceren. Daarnaast heeft u de keuze om enkel de Mosaic-instellingen te publiceren of in combinatie met de thema’s.

Als u alle gewenste onderdelen heeft geselecteerd, dan kunt u deze publiceren door op de live button te klikken.

1

In geval u alleen het resultaat van de zojuist toegevoegde data aan Studio wilt inzien dan klikt u bij het onderdeel Data/Viewer/Layout(Viewer) in de kolom 'Admin' op 'View' (1). Zijn de data goed en wilt u deze publiceren naar de live omgeving dan vinkt u in hetzelfde onderdeel de admindatabase aan (2) en vervolgens klikt u op de button 'Publish' (3) om het publicatieproces te starten. Tijdens het publicatieproces zal de live versie tijdelijk offline zijn, gebruikers krijgen hiervoor een waarschuwing.

1