GetConnector Bouwen en testen
Met Profit worden veel GetConnectoren meegeleverd. Je kunt echter ook een GetConnector toevoegen en deze zelf indelen.
AFAS Support kan je niet helpen bij het bouwen van GetConnectoren. Je kunt hiervoor echter wel een aanvraag bij AFAS Servicemanagement insturen.
In de eigenschappen van een app connector zie je per GetConnector welke filterautorisatie je kunt toepassen.
|
Inhoud |
Beschrijving
Let op:
De AFAS-token in de header van de connector-call moet altijd Base64-encoded verstuurd worden. Dit geldt voor zowel REST/JSON als SOAP/XML. Als de token niet Base64-encoded is in de header, zal er een foutmelding worden gegeven.
Hierop geldt één uitzondering: bij SOAP is het ook mogelijk om de token in de SOAP-body mee te geven. In dat geval blijft alles gewoon werken zonder dat Base64-encoding vereist is.
In dit artikel lees je hoe je het XML-token omzet naar een Base64-token.
Hieronder wordt het bouwen van een GetConnector kort toegelicht. Het doel is uiteraard dat de GetConnector precies de juiste output geeft. Alle middelen om dit te bereiken worden hier genoemd.
Naleving AVG
Houdt rekening met het naleven van de AVG, deze stelt strenge regels ten aanzien van het opslaan en gebruik van data. Dit betekent ook dat data niet 'klakkeloos' uit Profit mag worden gehaald. Dit is altijd een aandachtspunt bij het exporteren van gegevens. Loop ook je GetConnectoren na en kijk kritisch naar het doel van de uit Profit geëxporteerde data.
Gegevensverzameling
Bij het toevoegen van een GetConnector kies je een gegevensverzameling, deze kun je achteraf niet wijzigen. Een GetConnector heeft altijd één gegevensverzameling. Heb je nog een andere gegevensverzameling nodig, gebruik dan een extra GetConnector.
De gegevensverzameling is een koppeling met tabellen uit de Profit SQL-database en deze bepaalt welke gegevens je uit Profit kunt halen. Voorbeelden van gegevensverzamelingen zijn Financiële mutaties, Nacalculatie, Verlofregels, etc. Je bepaalt welke velden van de gegevensverzameling je wilt gebruiken en je kunt de output direct testen.
Hieronder zie je een voorbeeld van de output van een GetConnector met verlofregels:
Filter ingebouwd in de gegevensverzameling
Je kunt direct een filter in een gegevensverzameling inbouwen, dit zal altijd worden toegepast. Het filter kan niet via een externe aanroep worden omzeild. Je filtert bijvoorbeeld op werksoort, verzuimtype,artikelcode, grootboekrekening, etc. Bij datumfilters (en enkele andere typen) kun je de ingebouwde tags gebruiken. Hierdoor blijft je filter altijd geldig en hoef je dit bijvoorbeeld volgende maand of volgend jaar niet aan te passen. Zie verder Gegevens filteren.
Hieronder zie je een voorbeeld van de output van dezelfde GetConnector met een ingebouwd filter op jaar. Door de tag [Jaar] filter je altijd op het huidige jaar.
Ook in de aanroep van de GetConnector kun je een filter gebruiken, dit kan bij elke aanroep anders zijn.
Gegevensautorisatie op GetConnectoren
Op de gegevens in een GetConnector kan autorisatie op gegevens van toepassing zijn, dit wordt filterautorisatie genoemd. De filterautorisatie is gekoppeld aan de connector-gebruiker waarmee de externe applicatie gegevens ophaalt uit Profit. Leg de filterautorisatie vast ind de Profit-gebruikersgroep waartoe de connector-gebruiker behoort, niet bij de gebruiker zelf.
Voorbeeld
Je omgeving heeft drie werkgevers en elke werkgever heeft medewerkers.
Via een autorisatiefilter kun je bereiken dat een externe toepassing alleen medewerkergegevens kan ophalen van werkgever 1, niet van 2 en 3.
In de eigenschappen van een app connector zie je per GetConnector welke filterautorisatie je kunt toepassen.
