Met een datalayer geef je aan hoe je een datastore bewerkt en hoe je hem kunt gebruiken.
In de algemene instellingen worden datalayers gecreëerd en onderhouden.
Bestaande datalayers zijn op dit tabblad zichtbaar. Van elke datalayer zie je de volgende gegevens:
- naam datalayer
- aanmaakdatum
- datum waarop de definitie of inhoud van de datalayer voor het laatst is gewijzigd.
Klik op de button ‘+ Toevoegen’ om een nieuwe datalayer toe te voegen.
De datalayer kan worden bewerkt en gedupliceerd door op het tandwielicoon te klikken.
Let op: bij het kopiëren van een datalayer worden de opties niet meegenomen, deze moeten opnieuw worden geselecteerd.
Toevoegen
Vul alle velden in om een datalayer toe te voegen.
Definitie
Geef de datalayer een unieke naam en een omschrijving.
Selecteer de gewenste datastore uit het dropdown menu.
Aanmaken
Met het definiëren van de kolommen kies je welke informatie uit de datastore in deze datalayer gebruikt wordt.
Het aanmaken van een kolom kan door de gewenste waarde uit de dropdown te selecteren.
Indien gewenst is het mogelijk om de naam van het label aan te passen.
Bewerken
De kolommen zijn te wijzigen via het edit icoon.
Opties
In deze sectie kan worden beheerd welke functionaliteiten beschikbaar zijn.
- Toevoegen en bijwerken:
Met deze optie worden records in de onderliggende datastore bijgewerkt, indien de sleutel aanwezig is. Als dit niet het geval is, wordt er een nieuw record aangemaakt. - Verwijderen:
Met deze optie worden records in de onderliggende store verwijderd, indien de sleutel aanwezig is - Samenvoegen:
Met deze optie wordt de onderliggende datastore vergeleken met de aangeleverde data. Records die niet bestaan in de datastore worden aangemaakt, records die bestaan worden bijgewerkt en records die ontbreken in de aangeleverde data worden uit de datastore verwijderd.
Flowbuilder
Met de optie Flowbuilder geef je aan of de datamart beschikbaar is in de flowbuilder.
Sleutel API
Met de optie ‘Sleutel API’ wordt een record op basis van een sleutel gegenereerd. Let op: Houd de Security Key geheim.
Het is mogelijk om de Security Key te vernieuwen. Let op: Bij het vernieuwen, werken de koppelingen op basis van de oude Security Key niet meer.
| VOORBEELD
Toegang verlenen tot online content op basis van een productcode
Op deze datamart worden 2 sleutels gedefinieerd: abonnementnummer en klantnummer. De gebruiker logt in op de website. Na een succesvolle login is het klantnummer bekend. De website roept vervolgens de Sleutel API van deze datamart aan en geeft het klantnummer door als sleutel. De API retourneert vervolgens alle records uit de datamart die bij deze sleutel (klantnummer) horen. Bijvoorbeeld PRODUCT A en PRODUCT C. De website geeft de ingelogde gebruiker op basis van deze informatie alleen toegang tot deze producten. |
Dataset API
Met de optie ‘Dataset API’ wordt een de complete dataset geretourneerd.
| VOORBEELD
Een complete datamart ontsluiten voor reporting of analyses
Maak via Power BI of een andere reportingtool een connectie met de API van deze datamart om het dashboard op te maken. |
API sleutel
Om deze API te gebruiken is authenticatie nodig via een Authorisation header met een Bearer token. Deze moet worden toegevoegd in het HTTP verzoek. Bijvoorbeeld: Authorization: Bearer b383ebef-3456-491c-ae14-9a6ec91e9d2c
Veldnamen
Als je een datalayer via een API aanroept, kan je voortaan via een parameter de casing van de veldnamen opgeven:
- pascalcase (camelCase); waarbij spaties worden vervangen door een hoofdletter
- snakecase (snake_case); waarbij spaties worden vervangen door een liggend streepje (_)
- kebabcase (kebab-case); waarbij spaties worden vervangen door een midden streepje (-)
- Default; die de veldnamen teruggeeft zoals ze zijn.
Wanneer je alles hebt gedefinieerd, sla je de datalayer op door op de ‘Opslaan’ button te klikken.
Hier vind je de documentatie over de Ternair Systeem datamart API
Verwijderen
Let op! Als je de datalayer verwijdert, zullen alle processen die gebruik maken van deze datalayer (selectie en API’s) een foutmelding geven. Deze actie kan niet ongedaan worden gemaakt.
Autorisaties
Het is mogelijk toegangsrechten aan de datalayer toe te kennen via de autorisaties in de algemene instellingen. Als toegang tot de datalayer is uitgeschakeld voor een gebruikersgroep is het voor gebruikers niet mogelijk om de selectie te openen.
