Triggers - Bericht ontvanger

Bericht ontvanger in U-Turn

Met het bouwblok Bericht ontvanger kun je vanuit een andere applicatie berichten naar U-Turn sturen. U-Turn zet het bericht om naar een tabel. Daarna werk je in dezelfde koppeling verder: filteren, kolommen berekenen, wegschrijven, enzovoort.

Voor je begint

1. Onder de U-Turn-omgeving moet het tabblad Berichtontvangers zichtbaar zijn. Ontbreekt dat tabblad, dan is de functionaliteit voor jullie omgeving nog niet vrijgegeven.

2. Zet de module eerst op de omgeving aan, en voeg daarna het bouwblok toe aan de koppeling. Anders kan het ontvangstadres niet worden aangemaakt.

3. Inkomende berichten gebruiken de gepubliceerde versie van de koppeling, niet het concept.

Stap 1 - Schakel de listener in op de omgeving

1. Open de juiste U-Turn-omgeving.

2. Ga naar Berichtontvangers.

3. Zet Bericht ontvangers module actief aan.

U-Turn toont dan het extra bouwblok in de gereedschapskist van koppelingen. Staat de schakelaar uit, dan zijn nieuwe berichten niet welkom en is het bouwblok niet beschikbaar.

Stap 2 - Voeg het bouwblok toe aan de koppeling

1. Open of maak de koppeling.

2. Sleep Bericht ontvanger uit de gereedschapskist (triggers) op het canvas, bij voorkeur aan het begin van de keten.

3. Open het bouwblok.

U-Turn maakt nu een persoonlijk ontvangstadres (url) voor deze koppeling.

Stap 3 - Stel de url veilig

Let op: de url wordt maar één keer volledig getoond.

Bij de eerste keer openen zie je de complete url, inclusief een geheim deel. Kopieer die url meteen naar een wachtwoordkluis of een andere veilige plek, en geef hem alleen door aan de applicatie die mag aanroepen. Bij een volgende keer openen is het geheime deel vervangen door sterretjes en is het niet terug te halen.

De volledige url is een geheim: wie hem heeft, kan berichten naar jullie koppeling sturen. Zet hem niet in e-mail, tickets of documentatie in platte tekst.

Url kwijt? Maak een nieuw bouwblok Bericht ontvanger, bewaar de nieuwe url, wissel die uit met de andere partij en verwijder het oude blok.

Stap 4 - Richt de koppeling in met testgegevens

Je hoeft nog geen echte berichten te versturen om de rest van de koppeling te bouwen.

1. Open het bouwblok.

2. Zet onder Maak gebruik van test gegevens de optie Gebruik test gegevens aan.

3. Plak een voorbeeldbericht dat lijkt op wat de andere applicatie later stuurt (meestal JSON).

4. Stel onder Resultaat in hoe dat bericht een tabel moet worden.

5. Controleer Resultaten na uitvoer (de kolommen).

6. Sla het concept op en voer de koppeling uit. U-Turn gebruikt dan de testdata; er wordt niets bij de andere applicatie opgehaald.

7. Bouw de vervolgstappen op die tabel.

Haal testdata weer uit voordat de koppeling live berichten moet verwerken. Anders wordt het voorbeeld gebruikt in plaats van het echte bericht.

Stap 5 - Publiceer en laat live berichten binnenkomen

1. Controleer dat testdata uit staat als je echte berichten wilt.

2. Publiceer de koppeling.

3. Laat de andere applicatie een HTTP POST sturen naar de bewaarde url, met het bericht in de body.

U-Turn bevestigt de ontvangst. De verwerking gebeurt daarna in de gepubliceerde koppeling. Het HTTP-antwoord is niet het eindresultaat van de hele flow. Het resultaat bekijk je in het logboek van de koppeling.

Uitzetten of verwijderen

• Module op de omgeving uit: nieuwe berichten worden geweigerd; het bouwblok verdwijnt uit de gereedschapskist.

• Bouwblok uit de koppeling verwijderen: dit ontvangstadres wordt uitgeschakeld. De oude url werkt daarna niet meer. Publiceer na het verwijderen als de live koppeling mee moet veranderen.

Als het niet lukt

Samengevat

Omgeving aan → bouwblok toevoegen → url meteen veilig opslaan → met testdata de koppeling afbouwen → testdata uit → publiceren → andere partij POST’en naar de url.