Swing Stories Studio

Een paragraaf toevoegen kan door in een hoofdstuk een 'Paragraph' tegel toe te voegen:

Bij het toevoegen van een paragraaf wordt automatisch de nummering aangepast (1.1, 1,2 etc..). Vervolgens kan een titel via de tegelsettings worden toegevoegd om de paragraaf van een titel te voorzien. De hoofdstukken en paragrafen verschijnen aan de linkerkant in een dynamische inhoudsopgave. 

Secties

Elk hoofdstuk en paragraaf kan onderverdeeld worden in secties, waarmee tegels worden gegroepeerd. Een 'single', 'double' of 'free section' kan worden toegevoegd middels:

Bij single sections bevindt de tegel zich over de gehele breedte van de pagina, bij double sections wordt de helft van de pagina gebruikt. Free sections worden voornamelijk gebruikt voor teksten (text tegels en paragraph tegel), maar ook voor een custom table. Dit zijn sections zonder grid en de tegelhoogte wordt automatisch aangepast aan de hoogte van de inhoud. Dit is voornamelijk handig bij get-statements en de custom table. Hierbij kan de inhoud, en dus de hoogte van de tegel afhankelijk zijn van de selectie van de gebruiker. Ook wordt dit type sectie herkend door voorleessoftware, zodat het digitaal toegankelijk is en zijn de marges rondom tegels in een free section zo ingesteld dat ze netjes passen binnen een Stories. 

Tegels

Binnen secties worden tegels toegevoegd. Dit kunnen grafieken, teksten of plaatjes zijn. Grafieken moeten in een single of double section worden gemaakt. In een free section kan alleen een text tegel, paragraph tegel of custom table worden gemaakt. Het aanmaken van een tegel kan op twee manieren. Per sectie kan dit via 'Add tile':

Of per tegel via het + teken. Deze verschijnt door de muis naar de onderkant van een tegel te plaatsen. De nieuwe tegel zal onder de betreffende tegel verschijnen.

Er wordt een venster geopend waar stapsgewijs de tegel wordt gemaakt. Hier kan een selectie worden gemaakt van alle indicatoren uit de Studio-database. De benodigde onderwerpen kunnen eenvoudig geselecteerd worden door te zoeken op onderwerpnaam of -code (1) en te filteren op 'Cube' (2) en 'Data type' (3). Met de Ctrl knop kunnen meerdere onderwerpen van hetzelfde datatype geselecteerd worden. Bij een kubus indicator moet een keuze gemaakt worden tussen 'Single' (4) of 'Multiple' (5).

De lijst toont de 1.500 meest recent toegevoegde indicatoren in Studio. 

Het aanmaken van een nieuwe indicator tegel verloopt in een paar eenvoudige stappen:

1. Selecteer een of meerdere indicatoren
2. Ga naar de volgende stap via de groene button 'Next' of 'Single' of 'Multiple bij kubus indicatoren rechtsonder in het scherm.
    
3. Kies vervolgens een presentatievorm onder 'Basic', 'Chart or map' of 'Infographic'. Met de groene knop 'Create' rechtsonder in het scherm wordt de tegel gemaakt.
    
4. Bij kubus indicatoren volgt een extra venster voor de selectie van de gewenste dimensies, dimensieniveaus en dimensie-items. Afhankelijk van de gekozen presentatievorm zijn er verschillende selectiemogelijkheden.

Het is ook mogelijk om te kiezen voor een 'Presentation' of een 'custom' tegel. Bij ieder custom tegeltype staat een toelichting onder het vraagtekenicoon. De Presentation, of Viewer presentaties en een aantal custom tegel types worden nader toegelicht in onderstaande hoofdstukken.

Maak na de keuze de tegel aan door de groene button 'Create' rechtsonder in het scherm te selecteren.

Invoegen speciale elementen

Naast tegels voor teksten en grafieken zijn er ook een aantal speciale tegels. Speciale tegels omvatten: Afbeeldingen, Viewer presentaties, Iframes en Tabellen. Hieronder worden ze apart besproken.

Viewer presentaties

In Swing Stories zijn diverse soorten visualisaties beschikbaar op basis van de indicatoren in Swing. Soms kan de gewenste visualisatie niet worden gerealiseerd met de standaard Stories presentatievormen, maar wel in de Swing Viewer omgeving. 

Selecteer in de testomgeving van Swing Viewer de variabelen, visualisatie vorm, geografische instellingen en periodes, klik vervolgens op het hamburger menu links bovenin de pagina en kies "toevoegen als presentatie". 

Vervolgens kan in de Stories omgeving in een single of dual column section een tegel worden gemaakt. In het midden van het venster staat de lijst met beschikbare presentaties, met de meeste recente bovenaan. Selecteer de opgeslagen presentatie om de Viewer presentatie als tegel toe te voegen aan de Stories. 

Speciale instellingen voor de presentatie, waaronder het gebruik van het 'reference geolevel', worden geconfigureerd in de tegelinstellingen. Deze specifieke instellingen kunnen worden meegegeven bij de 'parameters' (voor meer informatie hierover, klik op het vraagteken naast parameters). 

Bij Viewer presentaties wordt standaard de gebiedsselectie van de gebruiker toegepast. Als in Viewer bijvoorbeeld een staafdiagram is aangemaakt waar alle provincies (geolevelcode = provincie) getoond worden, dan zal in Stories deze Viewer presentatie er anders uitzien omdat de gebiedsselectie van de gebruiker wordt overgenomen. Het gekozen gebied zal getoond worden in plaats van alle provincies. Om deze gebiedsselectie te negeren, kan via de tegelinstellingen de volgende parameter worden toegevoegd: &geolevel=provincie. Hiermee wordt de presentatie altijd op provincieniveau getoond.

Afbeeldingen

Een tegel met een afbeelding kan worden toegevoegd in een single of dual column section. Bij het maken van een nieuwe tegel staan aan de rechterkant de verschillende custom tegeltypes, waaronder vier opties voor een image tegel. De blauwe vraagtekens achter de tegeltypes leggen de verschillen uit.

De afbeeldingen die worden toegevoegd aan een tegel behouden altijd hun oorspronkelijke verhoudingen (breedte x hoogte) om te zorgen dat ze niet vervormen en in de tegel passen. Als de verhoudingen van de afbeelding afwijken van de tegel, dan kunnen witranden binnen de tegel ontstaan. Het formaat (en dus de verhoudingen) van een tegel zijn door de beheerder zelf aan te passen. Om te zorgen dat een afbeelding volledig in de tegel past, zal deze dus dezelfde verhouding van de tegel moeten hebben. Het formaat van een tegel is de achterhalen via de devtools van een browser: veelal middels F12 en dan via 'elementen expecteren' de tegel expecteren om het formaat te tonen. 

IFrame

Met een IFrame kan een (deel van een) externe webpagina in Stories worden opgenomen. Een voorbeeld is het integreren van GIS kaarten uit andere applicaties of het opnemen van uitleg video’s vanuit YouTube. Dit kan door gebruik te maken van iFrame-tegels in de Stories. De link van de webpagina moet worden opgegeven in de iFrame-tegel. IFrame-tegels zijn beschikbaar bij single en dual column sections onder:

add tile -> custom. 

Niet elke webpagina kan via een iFrame worden geladen (de webpagina moet in de instellingen toestemming geven voor het laden via een iFrame). Dit is eenvoudig te testen door te proberen een webpagina als iFrame op te halen. In sommige gevallen, zoals bij YouTube is er een speciale link nodig om de webpagina in te sluiten in een iFrame (een embedlink). Ook kan het voorkomen dat door ABF een domein toegang moet worden gegeven om als IFrame in een Stories te worden geladen.  

Een iFrame wordt ook opgenomen in de PDF-download van een Stories. Afhankelijk van de ingesloten webpagina kan dit mogelijk ongewenste resultaten opleveren. Als het laden van de IFrame lang duurt, kan dit een wit vlak opleveren. Dit wordt veroorzaakt omdat de PDF al gegenereerd wordt voordat de IFrame geladen is. ABF kan in dat geval de time-out voor het laden van de PDF verhogen zodat de IFrame alsnog correct in het PDF document getoond wordt. 

Tabel

In een situatie waarbij data te uitgebreid is of te ver uit elkaar ligt, kan een custom tabel een goede oplossing bieden. Hiervoor is een aparte handleiding met een voorbeeld van hoe een custom tabel wordt opgebouwd.

Meer info

Tegels kunnen van meer informatie worden voorzien om extra duiding te geven. Via een uitklapbaar menu verschijnt deze extra intormatie onderaan de tegel. 

Het toevoegen van extra informatie kan op Stories niveau via Stories settings > Tile > More information. 

Dit wordt vervolgens toegepast op elke tegel binnen de Stories. Er kan ook op hoofdstuk- en tegelniveau meer informatie worden opgegeven:

Chapter settings -> Tile -> More information 

Settings -> Interface -> More information

Dit is een aanvulling op de extra informatie die is opgegeven op een hoger niveau. Op hoofdstuk- en tegelniveau kan worden aangegeven of de extra informatie van het hogere niveau moet worden overgenomen: 'Include the more information of the chapter/Stories'

De extra informatie kan ook voorzien worden van get-statements, zodat bijvoorbeeld automatisch de beschrijving van het onderwerp dat gebruikt wordt in de tegel wordt getoond. In onderstaand voorbeeld is dit toegepast op Stories niveau. Hierbij wordt automatisch de omschrijving, bron en peildatum van de gebruikte onderwerpen in de tegel opgeroepen. Aangezien een tegel ook uit meerdere onderwerpen kan bestaan, kan deze met opsommingtekens gescheiden worden. Dit kan door het toevoegen van: html: li;single-html:. 

Naast het opgeven van extra informatie via het 'More information' veld in de Stories-, hoofdstuk- of tegelinstellingen, kan dit ook in Studio in de 'Metadata settings' tabel worden opgegeven via: Data -> Metadata settings. Door deze optie in te schakelen en per onderdeel op te geven wat getoond moet worden, zoals het datatype en de eenheid van een onderwerp, wordt dit toegevoegd aan de extra informatie van een tegel.

Kleurinstellingen

Om aangepaste kleuren te gebruiken binnen een Stories, moeten deze kleuren zijn toegevoegd in: 

Stories settings -> Colors -> Color Palette.

Vervolgens kunnen kleuren voor specifieke tegels worden ingesteld in de instellingen van Stories, hoofdstukken of individuele tegels. 

Kleurenschema's moeten eerst worden toegevoegd aan Swing Studio voordat ze in Swing Stories gebruikt kunnen worden. Kleurenschema’s zijn van toepassing op alle Swing modules en worden toegevoegd via: General -> System -> Color schemes.

Vormgeving

Niet alles wat betreft vormgeving en kleuren die in Stories zichtbaar zijn, kan een beheerder aanpassen. De webpagina waarbinnen Stories geladen wordt, bestaat uit een banner en een footer. Deze kunnen naar wens door de afdeling vormgeving van ABF worden aangepast. Dit kan een stuk tekst zijn, maar ook een logo of een afbeelding. Eventueel kan voor ieder hoofdstuk een andere afbeelding als banner getoond worden. Ook zal de achtergrond van een Stories van de juiste kleur moeten worden voorzien. Voordat een Stories ingericht kan worden, moeten deze onderdelen in samenspraak met de accountmanager binnen ABF afgestemd worden.

De inhoudsopgave en de selectiontool waar de gebruiker een gebied kan kiezen, wordt ook door een vormgever van ABF opgezet. Dit is in lijn met de bestaande vormgeving van Stories, zodat het een geheel vormt en tevens digitaal toegankelijk is. 

Verder kunnen de onderstaande onderdelen door ABF worden opgemaakt en aangepast:

• Een schaduw toevoegen aan tegels.
• Randen toevoegen voor tegels.
• Een default fontsize voor free text tiles opgeven.

Instellingen inhoudsopgave

Swing stories heeft een automatisch gegenereerde inhoudsopgave aan de linkerkant van de digitale rapportage. Hier zijn standaard een aantal opties ingeschakeld die door de beheerder van de Stories kunnen worden uitgeschakeld.

Boven de inhoudsopgave bevindt zich de 'selectiontool', waarmee gebruikers de optie hebben om een gebied en eventueel een referentiegebied te selecteren. Als de rapportage voor één gemeente is gemaakt, wordt de selectie mogelijkheid overbodig. In dat geval kan de selectiontool worden uitgeschakeld onder:

Stories settings -> Selection tool -> Show selection tool

Het is ook mogelijk om hoofdstukken en paragrafen automatisch te nummeren via:

Stories settings -> Interface -> Automatically number the table of contents.

PDF generatie instellingen

In Swing Stories is het mogelijk om een digitale rapportage als PDF op te slaan. Dit kan eenvoudig met de download knop rechtsboven in de Stories. De optie kan worden in- of uitgeschakeld via:

Stories settings -> Interface -> Enable PDF download all dashboards.

Voorblad en achterblad

De gegenereerde PDF kan voorzien worden van een voor- en achterblad. Deze moeten eerst in PDF formaat worden geüpload onder Stories -> Files.

Vervolgens kunnen het voor- en achterblad worden toegevoegd via:

Stories settings -> interface -> PDF front page en PDF back page 

Op basis van de aanwezige hoofdstuk indelingen in de Stories kan ook een inhoudsopgave worden gegenereerd voor de PDF:

Stories settings -> Interface -> Add Table of Contents to Pdf.

Pagebreaks 

Om de leesbaarheid in de gegenereerde PDF's te verbeteren, kunnen 'page breaks' worden ingesteld. Instellingen van page breaks staan op tegelniveau onder:

Settings -> Interface -> Start new page after this tile (PDF). 

Als tegels in een dual column section staan, moet de page break worden toegevoegd aan de rechter tegel.

Teksten toevoegen

In Stories kunnen eenvoudig dynamische rapportages worden gegenereerd. Voor het toevoegen van teksten binnen deze rapportages worden free sections gebruikt. Dit is een van de drie type secties die gekozen kunnen worden bij een Stories. 

Een voordeel van het plaatsen van teksten in free sections is dat de hoogte van de tegel automatisch wordt aangepast op basis van de inhoud. Daarnaast zijn de marges rondom tegels in een free section zo ingesteld dat ze netjes passen binnen een rapportage. Ook wordt een free section herkend door voorleessoftware zodat teksten hierin digitaal toegankelijk zijn. 

Binnen free sections kan er gebruik gemaakt worden van verschillende tegels. De paragraph tegel is bedoeld voor titels. De titel die in deze tegel wordt opgegeven, is ook de subtitel binnen de dynamisch gegenereerde inhoudsopgave. Normale teksten worden in 'text' tegels geplaatst.

Dynamische teksten

In Swing Stories is het mogelijk om teksten dynamisch aan te passen op basis van de achterliggende data en metadata in Swing Studio. Dit wordt opgehaald met een gestructureerde code waar parameters en eventueel formules in worden opgegeven; deze worden 'get-statements' genoemd. Via Help -> Content wordt de algemene help pagina van Studio geopend. Onder het kopje Mosaic & Stories staat het hoofdstuk Get statements.

In dit onderdeel staat voor ieder type get-statement een voorbeeld van hoe het moet worden opgebouwd. Er is ook een aparte handleiding met voorbeelden van verschillende type get-statements.

Conditionals

In Stories is er de mogelijkheid om hoofdstukken, secties en tegels te tonen aan de hand van door de beheerder opgegeven condities. Op basis van de gebruikersselectie (zoals een bepaald gebied) kan een hoofdstuk, sectie of tegel verborgen worden. Voor een uitgebreide uitleg zie het onderdeel 'Conditionals' binnen de helpfunctie van Studio. Het is bijvoorbeeld mogelijk om een hoofdstuk alleen te tonen indien de gebruiker de provincie Zuid-Holland gekozen heeft. Als onderdelen verborgen worden op basis van een conditie, zijn deze ook niet zichtbaar in de automatisch gegenereerde inhoudsopgave. Hierbij wordt rekening gehouden met de nummering van hoofdstukken en paragrafen.

Binnen de instellingen van een hoofdstuk, sectie of tegel kan in het tabblad 'Conditions' de voorwaarden worden opgegeven. Onderstaand hoofdstuk wordt alleen getoond indien het gekozen gebiedsniveau 'provincie' is, of wanneer de data van onderwerpcode 'bevtot' minder dan 1.000 is voor het gekozen basisgebied:

Authorisatie

De autorisatie instellingen in Studio worden aan Stories doorgegeven en toegepast. Zo kan een Stories (optioneel) achter een loginscherm worden geplaatst en kunnen onderwerpen, gebiedsniveaus en tegels enkel getoond worden voor specifieke gebruikers.

Binnen het menu Authorization (Stories settings) kan het autorisatie type worden opgegeven, er zijn drie opties: geen login, optionele login en een verplichte login. Indien een gebruiker inlogt dan gelden de rechten die middels de 'usergroup' aan deze gebruiker zijn gekoppeld. Specifieke onderwerpen of gebieden die deze gebruiker niet mag zien, worden dus niet getoond in de Stories. Daarnaast is het mogelijk om een Default user group op te geven. Dit is de usergroup die wordt toegepast indien er niet ingelogd hoeft te worden en dus voornamelijk relevant voor (gedeeltelijk) openbare Stories. Indien de Stories niet achter een login is geplaatst dan gelden de rechten die gekoppeld zijn aan deze Default user group.

Het is ook mogelijk om de toegang van thema's binnen de Stories settings in te stellen. Hiervoor dient eerst deze setting te worden geactiveerd: Stories settings > Authorization > Use chapter authorization.

Vervolgens kan per hoofdstuk bepaald worden welke gebruikersgroepen toegang mogen hebben tot een hoofdstuk. Activeer hiervoor per hoofdstuk de setting 'Restrict chapter access':

Chapter settings > Authorization. 

Publiceren

Het publiceren van Stories gaat via Publish -> Publish Studio.

Dit opent een scherm met vier kolommen. De eerste geeft het product aan, de tweede de Admin (ontwerp/test ) versie, de derde de Accept versie (acceptatie) en de vierde de Live versie

Dit opent een scherm met vier kolommen. De eerste geeft het product aan, de tweede de Admin (ontwerp/test ) versie, de derde de Accept versie (acceptatie) en de vierde de Live versie

Het publiceren van Stories gaat via Publish -> Publish Studio.

Met de knop Select All worden alle vinkjes aangezet of per rubriek (Select all stories) of per onderdeel. 

Met de knopwordt het betreffende onderdeel geopend.

Door middel van de knopworden de geselecteerde onderdelen gepubliceerd naar de volgende versie. De Accept versie kan intern gecontroleerd worden voordat het naar de Live omgeving wordt gepubliceerd.

Met het vinkje 'Publish to all versions' wordt direct naar de Live omgeving gepubliceerd.
Tijdens het publiceren zijn de versies die gepubliceerd en waarnaar gepubliceerd wordt, bijvoorbeeld test en accept, niet beschikbaar.

De test, accept en live versies kunnen worden geopend via Stories -> Version -> Open test version:

Controle rapporten

Er zijn diverse controle rapporten beschikbaar waarmee handige overzichten uitgedraaid kunnen worden, zoals een overzicht van het gebruik van indicatoren en conditionals in een Stories. Ook kan een consistentie check worden uitgedraaid waarin onbekende onderwerpen en dimensieniveaus in kaart kunnen worden gebracht. Deze zijn te vinden in het menu General > Consistency check. Het is raadzaam dit regelmatig te controleren om fouten te voorkomen.