GetConnector
Met GetConnectoren kun je zelf endpoints aanmaken en aanpassen. Deze endpoints roep je aan om data uit Profit op te halen. De GetConnectoren maak je aan op basis van velden uit een gegevensverzameling. Een gegevensverzameling bestaat uit één of meerdere tabellen en deze bevat alle relevante velden uit de onderliggende SQL-database.
Het endpoint wat aangemaakt is kun je aanroepen via de SOAP- en REST-methodes. Om nieuwe data te ontvangen doe je een nieuwe request (polling). Er zijn geen webhooks beschikbaar.
Inhoud |
Beschrijving
Een GetConnector bevat één gegevensverzameling waarmee je records kunt ophalen uit bepaalde Profit-tabellen. Je bepaalt in de gegevensverzameling welke velden je ophaalt.
De GetConnectoren zijn beschikbaar op omgevingsniveau. Je kunt de GetConnectoren uitwisselen tussen omgevingen met de import- en exportfunctie.
AFAS Profit maakt gebruik van een SQL-database. Vanuit de gegevensverzamelingen kun je gebruik maken van de relaties die er in de database tussen de tabellen gemaakt zijn. Dit geeft je de mogelijkheid om bijvoorbeeld specifieke informatie van de leidinggevende van een medewerker op te halen. Dit maakt het mogelijk om met minder GetConnectoren precies de data op te halen die jij nodig hebt. Let hierbij wel op dat je zo min mogelijk joins naar andere tabellen gebruikt om optimale performance te behalen.
Zie ook:
- Financiële mutaties ophalen
- BI-applicaties van data voorzien
- Dossieritems en reacties ophalen
- Organisaties synchroon houden met externe applicatie
Ondersteuning UTF-8
Bij het vastleggen van namen van personen (medewerkers), organisaties en woonplaatsen worden de volgende vreemde tekens ondersteund. De betreffende namen worden vastgelegd in de UTF-8 indeling (vroeger was dit de ANSI-indeling). Hierbij wordt Unicode ten dele ondersteund.
ĀāĂ㥹ĆćĈĉĊċČčĎď ĐđĒēĔĕĖėĘęĚěĜĝĞğ ĠġĢģĤĥĦħĨĩĪīĬĭĮį İıIJijĴĵĶķĸĹĺĻļĽľĿ
ŀŁłŃńŅņŇňʼnŊŋŌōŎŏ ŐőŔŕŖŗŘřŚśŜŝŞşŢţ ŤťŦŧŨũŪūŬŭŮůŰűŲų ŴŵŶŷŹźŻżſƀƁƂƃƄƅƆ
ƇƈƉƊƋƌƍƎƏƐƑƓƔƕƖƗ ƘƙƚƛƜƝƞƟƠơƢƣƤƥƦƧ ƨƩƪƫƬƭƮƯưƱƲƳƴƵƶƷ ƸƹƺƻƼƽƾƿǀǁǂǃDŽDždžLJ
LjljNJNjnjǍǎǏǐǑǒǓǔǕǖǗ ǘǙǚǛǜǝǞǟǠǡǢǣǤǥǦǧ ǨǩǪǫǬǭǮǯǰDZDzdzǴǵǶǷ ǸǹǺǻǼǽǾǿȀȁȂȃȄȅȆȇ
ȈȉȊȋȌȍȎȏȐȑȒȓȔȕȖȗ ȘșȚțȜȝȞȟȠȡȢȣȤȥȦȧ ȨȩȪȫȬȭȮȯȰȱȲȳȴȵȶȷ ȸȹȺȻȼȽȾȿɀɁɂɃɄɅɆɇ ɈɉɊɋɌɍɎɏ
Bij een GetConnector worden de gegevens worden in het formaat UTF-8 uitgevoerd. Houd hier rekening mee bij het inlezen van gegevens in externe applicaties (de externe applicatie moet UTF-8 ondersteunen).
Beschikbaarheid van GetConnectoren
Deze standaard kun je gebruiken of je maakt hier een kopie van. De kopie kun je zelf aanpassen naar de situatie die voor jou relevant is. Ook kun je een GetConnector toevoegen op basis van een gegevensverzameling. Bijna alle gegevensverzamelingen zijn geschik voor GetConnectoren. Mis je een gegevensverzameling? Meld dit via klant.afas.nl. Wij zullen beoordelen of en wanneer de gegevensverzameling beschikbaar gesteld kan worden.
Best business practices
- Gebruik geen format-velden in de gegevensverzamelingswizard (dit zijn velden waarmee je een ander uitvoerformaat toepast, bijvoorbeeld een datum omzetten naar een uitgeschreven datum.
- Verdicht regels wanneer je niet alle mutaties nodig hebt.
- Gebruik geen snelfilters wanneer je filters in de definitie gebruikt (maar bijvoorbeeld wel een 'is gelijk aan' filter).
Werkwijze
- GetConnector bouwen en testen
- Performance optimaliseren
- Importeren en Exporteren GetConnector
- Gewijzigde gegevens opvragen met een GetConnector
- Omgaan met verwijderde gegevens
- GetConnector voor ophalen van waarden uit vrij bestand