Tabelsets in de console¶

Het concept achter kennis staat in Kennis.

Een tabelset bevat de tabellen in je documenten -- werkbladen, CSV- en JSON-bestanden, tabellen in een Word-bestand en, als je installatie PDF's parseert, de tabellen van een PDF -- elk met zijn kolommen en rijen, zodat je kunt vragen welke rijen aan een voorwaarde voldoen en wat hun totaal is. Het segment Tabelsets van het onderdeel Kennis is waar je een tabelset maakt, hem laat vullen uit je collecties, zijn tabellen doorloopt en een tabel een vraag stelt.

Links staat de lijst met tabelsets, rechts de tabelset die je koos. Zoek erboven om de lijst te versmallen, en kies de plus om er een te maken.

Je hebt een beheerdersaccount van de organisatie nodig, en de capability knowledge moet in het plafond van de organisatie aanstaan. Hetzelfde doe je met een sleutel in Tabelsets via de API.

Een tabelset toevoegen¶

Kies de plus boven de lijst. De lade Tabelset toevoegen vraagt:

Kies Toevoegen en de tabelset gaat open. Stonden er al bronnen in zijn collecties, dan vraagt het scherm je ze in te lezen (Gelezen bronnen).

Het scherm van een tabelset¶

Bovenaan staan de naam, de omschrijving en Opnieuw inlezen. De omschrijving bewerk je ter plekke. Daaronder, van boven naar beneden:

De omschrijving, de labels, de metadata, de collecties en de pipeline worden samen opgeslagen: zodra er iets is gewijzigd, verschijnt een balk met Opslaan.

De tabelset vullen uit collecties¶

Collecties¶

Vink onder Collecties de collecties aan waar de tabelset uit leest. Onder een aangevinkte collectie staat Filter: sleutels en waarden die de metadata van een bron moet hebben. Laat je het filter leeg, dan wordt de hele collectie gelezen.

Ingest-pipeline¶

Kies een ingebouwd tabellensjabloon, of een eigen ingest-pipeline die eindigt op de stap Table Store. Geen van de sjablonen roept een model aan:

Eronder staat de tekening van de stappen. Eindigt de pipeline niet op Table Store, dan staat er de waarschuwing Geen Table Store: er komt dan niets in de tabelset, en Core weigert zo'n pipeline. Hoe Core een werkblad in kolommen en types leest, staat in Hoe een tabel wordt gelezen.

Gelezen bronnen en opnieuw inlezen¶

Gelezen bronnen toont per bron de collectie, de status (In wachtrij, Bezig, Gereed of Mislukt), het aantal Tabellen en Rijen, een foutcode en het moment van de laatste wijziging. Zoek op titel of filter op status. De titel is een link naar de bron in haar collectie. Een bron die Gereed is met nul tabellen, bevat geen tabel, zoals een PDF met alleen lopende tekst. De foutcodes staan in Wanneer een bron wordt gelezen.

Een nieuwe bron in een aangevinkte collectie wordt vanzelf gelezen. In deze gevallen lees je zelf opnieuw in:

Opnieuw inlezen leest elke bron binnen bereik opnieuw en haalt de tabellen weg van bronnen die de tabelset niet meer leest. Terwijl een run loopt, staat er een balk Bronnen inlezen die vanzelf doortelt. Runhistorie toont de runs met hun voortgang en aanleiding.

Een tabel vinden¶

Tabellen toont de tabellen in de tabelset, met de Bron waar elke tabel uit komt, de Herkomst (Werkblad, CSV, Records of In het document), de Kolommen, het aantal Rijen en het moment van de laatste wijziging. Zoek op de naam van de tabel of de titel van de bron. Open een tabel om hem op een eigen pagina te zien.

De lade van een bron in haar collectie toont haar tabellen ook, gegroepeerd per tabelset die ze bevat, elk als link naar de pagina van de tabel.

De pagina van een tabel¶

Bovenaan staan de naam van de tabel, de herkomst, de bron waar hij uit komt en het aantal rijen. Terug naar de tabelset brengt je terug naar de lijst. Daaronder:

• Vraag de tabel: het vraagformulier (hieronder).
• Rijen: de rijen in de volgorde van het document, pagina voor pagina.
• Kolommen: de naam en het type van elke kolom: tekst, geheel getal, getal, ja/nee of datum.

De tabel een vraag stellen¶

Een vraag is een formulier, geen tekst: je filtert de rijen, sorteert ze, of rekent ermee, eventueel per groep. Core controleert elke kolom en vergelijking tegen de tabel.

1. Kies onder Filters voor Filter toevoegen en kies een Kolom, een Vergelijking en een Waarde. Voeg tot 20 filters toe; een rij moet aan allemaal voldoen. Bij is een van vul je de waarden in, gescheiden door een komma.
2. Laat onder Berekening geen, toon de rijen staan, of kies Aantal, Som, Gemiddelde, Kleinste of Grootste en de kolom onder Van kolom. Aantal kan alle rijen tellen.
3. Kies bij een berekening een kolom onder Per groep van kolom om per waarde van die kolom te rekenen, zoals de som per leverancier.
4. Laat onder Sorteren op volgorde van het document staan of kies een kolom; met groepen kun je sorteren op de uitkomst. Kies de Richting.
5. Stel Meeste rijen in en kies Opvragen.

Het antwoord toont de rijen die voldoen, of één rij per groep met de uitkomst. Staat er dat het antwoord onvolledig is, dan waren er meer groepen dan Meeste rijen: maak de vraag smaller. Een vraag die te lang duurt, wordt geweigerd met het verzoek een filter toe te voegen. Een vraag hier roept geen model aan en wordt niet als gebruik gemeten.

Een model stelt een tabel hier geen vraag, maar via een zoektool waarvan de pipeline de tabelset als bron heeft. De pipeline-editor van de console biedt een tabelset niet als bronblok aan; maak die zoektool via de API, vanuit het sjabloon retrieval/table-set (Een model laten zoeken).

Een tabelset verwijderen¶

Kies Verwijderen onder Tabelset verwijderen. Dit verwijdert de tabelset met al zijn tabellen en rijen, en kan niet ongedaan worden gemaakt. De collecties en hun bronnen blijven bestaan. Een zoektool die de tabelset leest, vindt hem daarna niet meer; werk zulke zoektools bij voordat je hem verwijdert.

Labels¶

Gebruik Labels om tabelsets in te delen. Regels over Tabelsets in de policy van een sleutel bepalen op naam of op label welke tabelsets die sleutel, en een persoon, bereikt (Regels over een persoon). De standaardregels van een sleutel die zonder policy is geregistreerd, staan elke tabelset toe.

Een policy van een sleutel of organisatie die is opgeslagen voordat er tabelsets bestonden, ook de standaardregels die bij het registreren van een sleutel zijn uitgeschreven, heeft geen regel over Tabelsets en bereikt er geen: opvragen en lezen geven 404 en maken geeft 403, tot je een regel toevoegt die Tabelsets toestaat (Een regel toevoegen of wijzigen).

Binnen een tabelset ziet een persoon een tabel alleen als ze de bron mag zien waar hij uit komt. Zie ook Bouwen voor personen.

Lege lijsten en toegangsbeperkingen¶

Staat er links niets, dan heeft deze organisatie geen tabelsets.

Is kennis uitgeschakeld, dan staat Kennisbronnen indexeren en doorzoeken uit in het plafond van de organisatie. De beheerder van de organisatie erboven zet het aan bij Toegestane capabilities op Instellingen; voor een organisatie zonder bovenliggende organisatie doet je operator dat.