AFAS connectoren: overstappen op de App connector met SSIS

Per 1 januari 2017 werkt NTLM-authenticatie niet meer op AFAS Online en roep je een connector alleen nog aan via tokens, met de App Connector. Meer informatie en achtergrond hierover is te vinden op de website van AFAS via de volgende link: https://klant.afas.nl/appconnector . In een eerdere blog op deze website is in een stappenplan aangegeven hoe AFAS connectoren konden worden gebruikt met behulp van SQL Server Integration Services (SSIS). In deze blog werd uitgegaan van authenticatie met behulp van gebruikersnaam en wachtwoord. In dit artikel wordt uitgelegd hoe je gebruik kunt maken van de App connector en de autorisatie met behulp van tokens.

Stap 1: App connector autoriseren

Allereerst moet de app connector in AFAS zelf geautoriseerd worden.
In deze blog wordt hier niet verder op ingegaan. Verwezen wordt naar de uitgebreide documentatie van AFAS zelf, te vinden via de volgende link: https://static-kb.afas.nl/datafiles/help/2_9_7/SE/NL/index.htm#App_Apps_Custom_Auth.htm.

Stap 2: HTTP connectie

In SSIS moet een nieuwe connectie manager worden aangemaakt.

Maak een nieuwe HTTP Connection Manager aan.

Vul bij de Server URL de juiste url naar de wsdl in.
De opbouw van de URL is als volgt:

https://deelnemernummer.afasonlineconnector.nl/profitservices/appconnectorget.asmx?wsdl

Stap 3: Aanmaken WSDL bestand

Surf in een browser naar bovenstaande server url.

Kopieer alle tekst op deze website en plak deze in een nieuw bestand in een teksteditor zoals Notepad.

Sla het bestand op met een extensie .wsdl.

Stap 4: Aanmaken Web Service Task

Sleep in SSIS een nieuw Web Service Task naar de Control Flow.

Selecteer op het tabblad General het in stap 3 aangemaakt wsdl bestand:

Ga naar het tabblad Input en vul de volgende gegevens in:

1. Kies bij Service voor ‘ConnectorAppGet’
2. Kies bij Method ‘GetDataWithOptions’, vervolgens verschijnt er een tabel.
3. Vul bij token de volledige token in.
   Let op dat dit inclusief alle tags moet worden ingevoerd. Dus in de volgende vorm:
   <token><version>1</version><data>7748B1A4B5AF4A899588017DD71E55CBB60F8C504E2C16A17D1F9D9F42914C7C</data></token>
4. Vul bij connectorId de juiste connectornaam in, bv. ‘FbInstalment’ en klik op OK
5. Vul bij Take het aantal regels in dat moet worden opgehaald (bijvoorbeeld 1.000.000).
6. Verbind op het tabblad ‘output’ nog een connectie toe naar een bestand waar de gegevens in moeten weggeschreven.

Het SSIS package kan nu worden gestart en de webservices zullen worden aangeroepen en opgehaald.

Conclusie

Het gebruiken van de app connector verschilt niet veel ten opzichte van het gebruik van de authenticatie via gebruikersnaam en wachtwoord. Met een kleine aanpassing kan de authenticatie omgezet worden.