Hoe herhaal ik mijn analyse met nieuwe gegevens? (sjabloon en logboek van gegevenswijzigingen)

Kort

Hoe herhaal ik mijn analyse met een nieuw bestand? Het logboek legt elke wijziging van de gegevens vast, met een controlesom (SHA-256) van het bestand. Een sjabloon legt de stappen en analyses van een project vast, zonder gegevens. Een nieuw bestand met dezelfde kolommen doorloopt dan alles opnieuw.

Zo werkt het in Statable

Kies op de pagina “Logboek” de knop “Sjabloon opslaan”. Het bestand eindigt op “.statable-vorlage” en bevat geen gegevens.
Open het nieuwe bestand, kies “Sjabloon kiezen” op de pagina “Logboek” en selecteer het bestand.
Statable controleert eerst of het sjabloon past. Daarna lopen de stappen op volgorde, en het logboek toont wat er gebeurde.

Het logboek

Op de pagina “Logboek” toont elke stap: nummer, soort, kolommen, aantal getroffen rijen, rijen voor en na, tijd, bron (met de hand of uit een sjabloon) en een opmerking. Dit geldt voor elke wijziging in het project, niet alleen voor sjablonen.

Het logboek wordt nooit gewist en nooit bewerkt. Wordt een stap ongedaan gemaakt, dan blijft hij staan met de aantekening “ongedaan gemaakt”.
Het bevat geen waarden uit de gegevens, alleen wat je zelf als regel hebt ingevoerd.
Voor het geopende bestand wordt de controlesom (SHA-256) getoond. Ze verandert bij elke wijziging van het bestand; wie hetzelfde bestand heeft, krijgt dezelfde controlesom. Zo is later aan te tonen met welk bestand is gerekend.
“Opslaan als CSV” bewaart het logboek als tabel. In het rapport kan het als bijlage staan. Het hoort bij het projectbestand. Oudere projecten laden nog steeds; hun logboek begint met deze versie van Statable, en dat staat erin.

Een sjabloon opslaan

Kies op de pagina “Logboek” de knop “Sjabloon opslaan”. Er ontstaat een bestand dat eindigt op “.statable-vorlage”. Het bevat alle gegevenswijzigingen in volgorde en alle analysepagina’s, maar geen gegevens, geen rijen en geen waarden. Kolomnamen, labels en instellingen staan erin.

Wat kan worden herhaald en wat niet

Sommige stappen kunnen op andere gegevens niet worden herhaald. Statable noemt ze bij het opslaan, met nummer en reden. Een sjabloon met zulke stappen kan niet worden toegepast.

De stap heeft betrekking op afzonderlijke rijen (een cel wijzigen, een rij verwijderen of toevoegen).
Het steunt op waarden uit de oorspronkelijke gegevens.
Hij heeft een tweede bestand nodig (bijvoorbeeld bestanden samenvoegen).
Het bevat een opdracht die in sjablonen niet is toegestaan.
Hij eindigde met een foutmelding, bouwde de gegevens als nieuw project op of is te lang.

Een sjabloon toepassen

Open het nieuwe bestand, kies “Sjabloon kiezen” op de pagina “Logboek” en selecteer het bestand. Eerst controleert Statable of het sjabloon bij de gegevens past, voordat iets wordt veranderd:

Geblokkeerd: een kolom ontbreekt of heeft een ander soort (getal in plaats van tekst). Statable noemt haar. Ontbreekt een kolom, dan kun je een bestaande koppelen; de koppeling staat in het logboek. Er wordt nooit stilzwijgend iets overgeslagen.
Waarschuwing: een categorie is nieuw die een hercodering niet kent. Statable noemt het aantal rijen. Deze waarden blijven staan zoals de stap voorziet. Je bevestigt dit, en het staat in het logboek.
Opmerking: een nieuwe kolom in de gegevens of een categorie die ontbreekt. Dit houdt niets tegen.

Daarna lopen de stappen in volgorde op de nieuwe gegevens, met dezelfde functies als met de hand. De analyses uit het sjabloon staan open als tabbladen en rekenen zodra je ze opent, of allemaal tegelijk in het rapport. Stopt een stap, dan stopt alles wat volgt, zijn de gegevens als vóór de uitvoering, en staat de reden in het logboek.

Waarschuwingen

Het sjabloon herhaalt de stappen. Het controleert niet of ze bij de nieuwe gegevens passen.
Als de betekenis van een kolom is veranderd, merkt Statable dat niet.
Zinnen in de analyses verwijzen naar de nieuwe getallen. Je eigen notities uit de oude versie blijven ongewijzigd en moeten worden nagekeken.

Voor specialisten

Het sjabloon is een JSON-bestand met een versienummer; een nieuwere versie dan de app begrijpt, wordt geweigerd. Een sjabloon van elders geldt als onveilig: het doorloopt dezelfde controles als de invoer van de interface, de teksten komen nooit ongecontroleerd in R- of PSPP-code, en een kapot bestand geeft een zin in plaats van een crash. De controlesom is SHA-256 over de bytes van het bestand, in de browser gevormd met crypto.subtle; bij gegevens zonder bestand (voorbeeld, zelf ingevoerd, herstructureerd) staat dat er zo. De uitvoering gebruikt dezelfde code als de gegevensassistent, geen tweede weg.