Frequentie gebruik:
Moeilijkheidsgraad:
De GetConnector start is de meest gebruikte startacties binnen Flow. Met GetConnector start wordt een GetConnector volledig uitgelezen welke je daarna kunt verwerken
Er zijn drie vormen van deze GetConnector actie.
- GetConnector Start
- GetConnector Start (Geavanceerd)
- GetConnector (Geavanceerd)
- GetConnector Conditie
De normale GetConnector is in 90% van de gevallen voldoende. In de volgende gevallen wijk je uit naar geavanceerd:
- Je wilt halverwege een Flow nog een keer een GetConnector uitvoeren;
- Je hebt een hele zware GetConnector en wilt zaken parallel uitvoeren;
- Je hebt een GetConnector waar je zelf de snelheid wil bepalen met ‘voor iedere regel’;
- Je wilt alleen de eerste xx regels ophalen.
Werking
Om een GetConnector te starten dienen 3 verplichte velden gevuld te worden:
- Token : Vanuit de wachtwoorden kluis
- OmgevingsID: Meestal overgenomen vanuit de wachtwoorden kluis
- GetConnector : Een lijst van alle beschikbare GetConnectoren in de AFAS AppConnector wordt getoond.
Unieke kenmerken:
Met Unieke kenmerken is het mogelijk om Flow te herkennen welke regels eerder zijn verwerkt. Komt een regel met dezelfde waarden nog een keer voor, dan zal deze niet worden ingeladen in deze Flow.
Let op: De unieke kenmerken worden alleen opgeslagen indien de regel succesvol is verwerkt.
Skip / Take (geavanceerd)
In de standaard GetConnector zal Flow een skip/take toepassen van 0/100 en in batches alles ophalen. Met de geavanceerde GetConnector actie is het mogelijk om zelf de skip/take in te stellen. WIl je bijvoorbeeld alleen de eerste regel? Dan is dat mogelijk door 0/1 in te voeren.
Het vinkje ‘alles ophalen’ zet je dan uit. Met Alles ophalen kun je zelf beinvloeden of Flow na de eerste skip/take actie door moet gaan met ophalen of juist niet.
De Take wil je klein houden om zo eventuele fouten uit AFAS te voorkomen, maar zo groot mogelijk om snelheid te behouden.. Advies vanuit AFAS is om aan te houden: “Aantal kolommen ” x ” Aantal rijen” < 150.000.
In flow hanteren we standaard een take van 100 zodat je hier geen last van zult hebben. Experimenteel ophogen wordt toegestaan maar zal weinig performance verschil maken.
Getconnector filter:
Met de GetConnector filters is het mogelijk extra filters aan te brengen in de GetConnector. Je kunt ook een veld selecteren uit een eerder stap door {{veldnaam}} te hanteren in de Filterwaarde.
Complex filter: Gebruik het complex filter als je zoekt op een tekstveld waarin mogelijk een komma (,) voorkomt. De snelle filter optie heeft (vanuit AFAS), geen ondersteuning voor kommavelden. Hiervoor moet het complex filter aanstaan.
GetConnector sortering
In de ‘GetConnector geavanceerd’ is het mogelijk om te sorteren. Dit kan bijvoorbeeld handig zijn als je dit combineert met ‘eerste item uit reeks‘, of ‘laatste item uit reeks‘. Je kunt dan precies bepalen wat de volgorde is van aanlevering vanuit AFAS. Geadviseerd wordt om niet meer dan 3 kolommen te sorteren.
Gebruik altijd een sortering bij het uitvoeren van een opdracht met skip/take (lees: meer dan de 100 regels in de GetConnector). Sorteer bij voorkeur op een uniek veld, zoals factuurnummer of medewerkercode, of een combinatie van velden.
Indien je slecht/niet sorteert bestaat de kans dat een nieuw aangemaakte regel vooraan wordt toegevoegd, als dit tijdens het ophalen gebeurd, mis je 1 regel. Deze kans is erg klein, maar wel aanwezig.
Aandachtspunten bij GetConnector geavanceerd
De makkelijkste manier van een GetConnector is de standaard GetConnector. Met de geavanceerde GetConnector moet je rekening houden met:
a) Als je de geavanceerde Flow gebruikt als actie? Dan dien je ‘voor elke regel’ of ‘voor elke regel parallel’ te gebruiken om daadwerkelijk de regels te zien. Bij veldnaam kies je voor ‘Objectnaam.rows’. In geval van GetConnector geavanceerd als startactie kies je ‘rows’ als veldnaam
