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.
Let op:
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.
|
In dit artikel is gave nieuwe functionaliteit verwerkt die beschikbaar is vanaf Profit 7. |
Bij een GetConnector-aanroep stelde de SQL-server van AFAS t/m Profit 6 de response samen. Vanaf Profit 7 is dit gewijzigd en komt de response direct uit Profit. Het gaat hierbij om zowel JSON bij REST als XML bij SOAP.
Let op:
Het formaat van de resultaten is anders. Deze aanpassingen kunnen invloed hebben op aangepaste string verwerking van ruwe JSON / XML. Als je gebruik maakt van een standaard XML/JSON parser zal dit geen probleem geven.
Dit zijn de wijzigingen:
- Decimalen zien er anders uit.
Voorbeeld: -.5 wordt nu -0.5
- In XML worden carriage returns (\r) anders weergegeven:

 wordt nu weergegeven als 
Om de performance van metainfo-aanroepen te verbeteren is de format van de response gewijzigd. De respons op een metainfo-aanroep resulteert nu in een string zonder spaties of enters, oftewel het resultaat is geen geformatteerde JSON meer.
|
Inhoud |
Beschrijving
Let op:
Vanaf Profit 7 moet de AFAS-token in de header van de connector-call 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.
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.
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.