Inrichting Afas voor koppeling met Assist Planner
1 Doel van het document
Dit document geeft een beschrijving van de inrichting en werking en inrichting van de Afas get en update connectoren en de app connector die noodzakelijk zijn voor de verbinding met Assist Planner.
Om verbinding te leggen met Afas is een zogenoemde App connector nodig. Deze connector zorgt voor de authenticatie van de applicatie en bepaald welke data toegankelijk is (welke app connectoren) en welke data kan worden bijgewerkt (update connectoren).
Indien er sprake is van een compleet nieuwe inrichting dan dient te worden gestart met hoofdstuk 2.
Op het moment dat de inrichting is gebaseerd op een inrichting conform de Assist Zorg Blauwdruk dan bestaat de zogenoemde app connector voor het maken van een verbinding en kunnen de stappen uit hoofdstuk 3 gevolgd worden. Tijdens het werken met Assist Planner kan het voorkomen dat er wijzigingen nodig zijn aan de App Connector. De wijzigingen aan de App connector en Assist Planner kant worden uitgevoerd door Qics en worden als download beschikbaar gesteld om in te lezen in de omgeving. Hoe het wijzigen van connectoren precies in zijn werk gaat lees je terug in een ander support artikel. De beschrijvingen in dit document zijn gemaakt met Profit versie 3. Lees voor je een actie gaat uitvoeren eerst het gehele hoofdstuk door voordat je aan de slag gaat zodat je extra opmerkingen over het item alvast hebt gelezen.
2 Inrichting volledig nieuw lege omgeving:
Extra velden toevoegen:
Het is van belang dat alle velden die worden opgehaald, ook beschikbaar zijn in AFAS. Voor Assist Planner kennen we twee extra (vrije) velden die moeten bestaan in AFAS. Download hiervoor de twee bestanden die (onderaan) bij dit artikel staan en open vervolgens AFAS.
Klik vervolgens in AFAS op:
- Algemeen -> Beheer -> Management tool en open de functiegroep medewerker:
- Klik onder in beeld op medewerker en vervolgens op importeren (rechts in beeld)
- Selecteer vervolgens het bestand: Medewerker_Uitzendbureau.fie en klik op voltooien.
- Herhaal deze stap door de management tool opnieuw te openen en naar de functiegroep organisatie/persoon te gaan.
- Klik vervolgens links op verkooprelatie en rechts weer op importeren:
- Selecteer het bestand Verkooprelatie_BTW voor relatie.fie en klik op voltooien.
N.B. AFAS controleert of de velden op de juiste locatie worden geplaatst.
Daarnaast gaan we bij het aanmaken van een relatie uit Assist Planner richting AFAS er vanuit dat de volgende verzamelrekeningen bestaan:
- 140000 (debiteuren)
- 200004 (Crediteuren zzp'ers).
Let op, we gaan er bij Assist Planner vanuit dat de nummering van personen, medewerkers inkoop relaties en verkoop relaties overeenkomt (zie hiervoor ook de algemene instellingen van AFAS). Als hier afwijkingen in zitten kunnen er onverwachte problemen en fouten optreden!
[Algemeen -> Omgeving -> Beheer -> Eigenschappen -> Nummering]
3 Handmatige inrichten nieuwe connector (bijvoorbeeld voor implementatie ZONDER Blauwdruk)
Wil je de bovenstaande stappen handmatig uitvoeren in AFAS zodat je precies weet waar alles staat, of heb je een omgeving waarvan een deel van de onderdelen als is ingericht en wil je alles controleren, volg dan de onderstaande stappen in de hoofdstuk.
Omdat er straks een gebruiker moet worden opgegeven die verbinding maakt en we deze gebruiker van de juiste rechten willen voorzien maken we een systeemgebruiker aan. Deze systemgebruiker willen we goed kunnen onderscheiden van de overige gebruikers.
2.1 Nieuwe gebruikersgroep
Om de rechten tot de applicatie t.b.v. de connector goed te kunnen regelen is een gebruikersgroep noodzakelijk.
Ga hiervoor naar de autorisatietool om dit te doen ga je in AFAS Profit naar Algemeen -> beheer -> Autorisatie tool en klik op onderhoud groepen en vervolgens op nieuw.
Kies vervolgens voor het maken van een geheel nieuwe gebruikersgroep en klik op volgende.
Geef de groep de naam: Assist_Planner_GG vul desgewenst een omschrijving in en kies bij gebruikersgroep vullen voor de optie handmatig. En klik op voltooien.
vervolgens ben je klaar met het aanmaken van de gebruikersgroep als je deze ziet staan in het overzicht.
2.2 Systeemgebruiker aanmaken
Ga opnieuw naar de autorisatietool (als je daar niet meer bent ga je naar Algemeen -> beheer -> Autorisatie tool)
Klik op onderhouden gebruikers en vervolgens op meer acties en vervolgens op nieuwe systeemgebruiker.
Geef vervolgens als gebruikersnaam het volgende op: <licentienummer>.AP_CONNECTOR dus bijvoorbeeld 91145.AP_CONNECTOR en voeg een omschrijving toe zodat je de gebruiker gemakkelijk kan herkennen (tip: het meest makkelijk is om dezelfde naam aan te houden) en klik op volgende.
LET OP: In dit scherm het vinkje Geblokkeerd niet aanvinken
In het volgende scherm Applicatie, kunnen alle vinkje uit en klik je vervolgens op volgende
N.B. Het vinkje van Profit hoeft dus niet aan te staan!
Het e-mail adres en de UPN blijven leeg. En vervolgens klik je op volgende.
en klik vervolgens op voltooien.
Voeg vervolgens de gebruikers toe aan de gebruikersgroep de app connector gebruiker toe aan de groep door bij het tabblad onderhoud gebruikers de gebruikerscode <licentiecode>.AP_CONNECTOR aan te klikken en vervolgens bij het tabblad lid van groep te klikken op de optie nieuw.
Selecteer vervolgens de zojuist aangemaakt groep en klik op selecteren en sluit de autorisatie tool.
Let op, de gebruikersgroep dient te beschikken over voldoende rechten. Welke rechten dit zijn en hoe je dit inricht zie je terug in het artikel: Welke rechten en gebruiker is er nodig voor de APP connector met AFAS Vergeet niet na het instellen dit artikel af te maken!
2.3 GetConnectoren toevoegen
Om de laatste versie van de get connector te downloaden browse je naar de volgende URL waar je <XXX> vervangt door het versienummer van de Assist Planner omgeving waarmee je bent gekoppeld.
https://qpzstorage.blob.core.windows.net/public/4.<versie AP>/Afas.GetConnectoren.zip
Pak dit bestand vervolgens op je computer uit en onthoud de locatie waar je deze hebt opgeslagen.
Klik vervolgens in Afas Profit op Algemeen -> Uitvoer -> Beheer -> GetConnector en vervolgens in de balk op meer acties en dan importeren.
kies vervolgens voor map en zoek de map op waar je bestanden in hebt uitgepakt en klik vervolgens op select folder.
Klik vervolgens op voltooien.
Het scherm ziet er na het voltooien ongeveer als volgt uit:
2.4 Maak een appconnector
In Profit onder Algemeen -> Beheer -> App connector kan door middel van de knop nieuw een nieuwe app connector worden aangemaakt.
Klik in dit scherm dus op Nieuw.
Geef de app connector vervolgens de volgende naam: ASSIST_PLANNER_APP_CONNECTOR
Kies bij gebruikersgroep voor de zojuist aangemaakt gebruikersgroep Assist_Planner_GG en klik op volgende.
Klik vervolgens op de knop nieuw om de getConnectoren op te kunnen geven die moeten worden gebruikt. Selecteer vervolgens alle getConneconnectoren die beginnen met de omschrijving Assist_planner en klik op voltooien.
Klik vervolgens op volgende.
Voeg vervolgens de update connectoren toe door op de knop nieuw te klikken en de volgende items te selecteren (let op, als je de filter gebruikt vervallen je selecties!).
Betermelding InSite (HrWellnessInSite)
Financiële mutatie (FiEntries)
Inkooprelatie organisatie (KnPurchaseRelationOrg)
Inkooprelatie persoon (KnPurchaseRelationPer)
Loonmutatie (HrCompMut)
Medewerker (KnEmployee)
Persoon (KnPerson)
Verkooprelatie organisatie (KnSalesRelationOrg)
Verkooprelatie persoon (KnSalesRelationPer)
Ziekmelding InSite (HrIllnessInSite)
Klik vervolgens op voltooien en vervolgens nogmaals op voltooien.
Controleer in het scherm vervolgens dat de APP connector niet is geblokkeerd.
Ga vervolgens in het menu naar gebruikerstokens en verwijder de gebruiker door bij acties op verwijderen te klikken (en dit te bevestigen).
Klik vervolgens op nieuw en selecteer vervolgens de gebruiker door op de knop te drukken,
Dubbelklik op de gebruikersgroep en vul vervolgens een omschrijving in bij de gebruiker
Kopieer vervolgens de token en plak deze in het instellingenscherm van AP bij het onderdeel AFAS bij Gebruikerstoken.
Controleer na het importeren of alle bestanden aanwezig zijn en bij de app connector in het onderdeel GetConnectoren of alle GetConnectoren ook beschikbaar zijn voor de AppConnector (zie ook hoofdstuk 5.2.2) Controleer daarnaast of er in de ChangeLog vermeld staat of er updateConnectoren moeten worden toegevoegd (en voeg deze indien nodig toe).
Klik vervolgens op opslaan en sluiten.
Je kunt nu de verbinding testen vanuit Assist Planner.
Opmerkingen
0 opmerkingen
Artikel is gesloten voor opmerkingen.