Hoe abonneer ik met op Live Evenementen met Canvas Data services?
Als beheerder kun je je abonneren op Live Evenementen en in realtime een set evenementen uit je Canvas-account ontvangen. Je kunt kiezen op welke evenementen in Canvas je je wilt abonneren. Je zult een Amazon Web Services wachtrij moeten onderhouden om gegevens van Live Evenementen te ontvangen.
Opmerking: Om Live Evenementen te ontvangen moet je je abonneren op Amazon Web Services zodat je een wachtrij kunt onderhouden.
Account openen
Klik op de link Beheerder (Admin) [1] en klik daarna op de naam van het account [2].
Data Services openen
Klik op de link Data Services in Accountnavigatie.
Gegevensstroom toevoegen
Klik op de knop Stroom toevoegen (Add Stream) om een nieuwe gegevensstroom voor je account te maken.
Gegevensstroom configureren
Voer een titel voor je stroom in het veld Naam/titel (Name/Title) [1] in.
Selecteer een SQS- of HTTPS-in de vervolgkeuzelijst Levermethode (Delivery Method) [2]. Voer vervolgens je AWS SQS of een URL van een HTTPS-eindpunt in het URL-veld in [3].
Opmerkingen:
- Per abonnement is er maar één leveringsmethode toegestaan.
- Canvas gebruikt JWT om aan te melden bij evenement. Als de service niet beschikbaar is en Canvas ze niet kan bereiken, kan het zijn dat de evenementen die tijdens de serviceuitval plaatsvinden niet worden afgeleverd.
Amazon SQS-gegevensstroom configureren
Als je wilt dat een verificatie voor een Amazon SQS-URL vereist is, selecteer je de AWS-aanmeldgegevens (AWS Credentials) in het veld Verificatie (Authentication) [1]. Als er geen verificatie vereist is, kan dit veld ingesteld worden op de optie Geen (None).
Als er AWS-aanmeldgegevens vereist zijn, voer je de AWS-sleutel (AWS key) [2], het AWS-geheim (AWS secret) [3] en de AWS-regio (AWS region) [4] in.
Selecteer het formaat van het evenement in het veld Berichttype (Message Type) [5]. Berichttype (Message type) kan worden ingesteld op Canvas of Calipher 1.1.
Opmerking: Het veld Applicatietype (Application Type) kan alleen ingesteld worden op de optie Streamen van gegevens (Data Streaming).
HTTPS-gegevensstroom configureren
De HTTPS-leveringsmethode bevat een optie om samen met je gegevensstroom de payloadgegevens van het broneindpunt weer te geven. Selecteer het selectievakje Payload ondertekenen (Sign Payload) [1] om de payloadgegevens weer te geven.
Selecteer het formaat van het evenement in het veld Berichttype (Message Type) [2]. Berichttype (Message type) kan worden ingesteld op Canvas of Calipher 1.1.
Opmerking: Het veld Applicatietype (Application Type) kan alleen ingesteld worden op de optie Streamen van gegevens (Data Streaming).
Abonnementen selecteren
Selecteer de abonnementen die je wilt opnemen in je gegevensstroom.
Je kunt naar specifieke evenementen zoeken door de naam van het evenement in het veld Evenementen zoeken (Search Events) te typen [1].
Klik op het selectievakje Abonnementen (Subscriptions) om alle evenementen in je stroom op te nemen. Wanneer je deze optie kiest, worden alle soorten evenementen opgenomen alsook door gebruikers en het systeem gegeneerde acties.
Om je te abonneren op evenementen die worden geactiveerd door een actie rechtstreeks uitgevoerd door een eindgebruiker, klik je op het selectievakje Door gebruiker gegenereerd (User Generated) [3]. Door gebruikers gegeneerde evenementen omvatten informatie over webaanvragen, browser- en gebruikersgegevens in metadata van een evenement, en details over objecten die zijn beïnvloed door de wijziging.
Klik op het selectievakje Door systeem gegenereerd (System Generated) [4] om je te abonneren op evenementen die zijn geactiveerd door asynchrone taken. Door het systeem gegenereerde evenementen bevatten gegevens over processen die een evenement hebben geactiveerd en details over de objecten die zijn beïnvloed door de wijziging.
Je kunt je ook abonneren op evenementgroepen. Klik op het selectievakje voor de groep [5] om je op alle items in een groep te abonneren. Je kunt er ook voor kiezen om alleen door een gebruiker of door het systeem gegenereerde gegevens op te nemen [6].
Om je op aparte evenementen te abonneren klik je eerst op het pictogram met het pijltje voor de abonnementsgroep [7] en vervolgens op het selectievakje voor het abonnement dat je wilt toevoegen [8].
Opmerking: De afbeelding in deze stap toont abonnementsopties voor het Canvas-berichttype. De opties voor de Caliper 1.1-berichttypes zijn verschillend, maar de stappen om je te abonneren zijn hetzelfde.
Gegevensstroom opslaan
Klik op de knop Opslaan en afsluiten (Save & Publish) [1] om je gegevensstroom op te slaan.
Gegevensstromen bekijken
Je kunt je gegevensstromen bekijken en beheren op de pagina Opties gegevensstromen (Data Streaming Options).