Hvordan abonnerer jeg på livehændelser ved hjælp af Canvas Data Services?

Som administrator kan du abonnere på livehændelser og modtage et realtidssæt af hændelser fra din Canvas-konto. Du kan vælge, hvilke hændelser i Canvas du vil abonnere på. Du skal opretholde en Amazon Web Services-kø for at modtage data om livehændelser.

Bemærk: For at modtage data om livehændelser skal du abonnere på Amazon Web Services for at opretholde en kø.

Åbn konto

Åbn konto

Klik på linket Admin [1], og klik derefter på kontoens navn [2].

Åbn datatjenester

Åbn datatjenester

I Kontonavigation skal du klikke på linket Datatjenester (Data Services).

Tilføj datastrøm

Tilføj datastrøm

For at oprette en ny datastrøm til din konto skal du klikke på knappen Tilføj strøm (Add Stream).

Konfigurer datastrøm

Konfigurer datastrøm

Indtast eller en titel på din strøm i feltet Navn/titel (Name/Title) [1].

Vælg en SQS- eller HTTPS-leveringsmetode i rullemenuen Leveringsmetode (Delivery Method) [2]. Indtast derefter din AWS SQS- eller en HTTPS-slutpunkts-URL i URL-feltet [3].

Bemærkninger:

  • Kun én leveringsmetode er tilladt pr. abonnement.
  • Canvas bruger JWT til at underskrive en hændelse. Hvis tjenesten er utilgængelig, og Canvas ikke kan nå den, bliver de hændelser, der opstår under serviceafbrydelsen, muligvis ikke leveret.

Konfigurer Amazon SQS datastrøm

Konfigurer Amazon SQS datastrøm

Hvis du vil kræve godkendelse for en Amazon SQS-URL, skal du vælge AWS-brugeroplysningerne i feltet Autentifikation (Authentication) [1]. Hvis godkendelse ikke er påkrævet, kan dette felt indstilles til indstillingen Ingen.

Hvis der kræves AWS-brugeroplysningerer, skal du indtaste AWS-nøglen [2], AWS-hemmeligheden [3] og AWS-regionen [4].

Vælg hændelsesformatet i feltet Meddelelsestype (Message Type) [5]. Meddelelsestypen kan indstilles til Canvas eller Caliper 1.1.

Bemærk: Feltet Applikationstype kan kun indstilles til indstillingen Datastreaming.

 

Konfigurer HTTPS-datastrøm

HTTPS-leveringsmetoden inkluderer en mulighed for at vise kildeslutpunktsnyttelastdata med din datastrøm. For at se nyttelastdata skal du markere afkrydsningsfeltet Signer nyttelast (Sign Payload) [1].

Vælg hændelsesformatet i feltet Meddelelsestype (Message Type) [2]. Meddelelsestypen kan indstilles til Canvas eller Caliper 1.1.

Bemærk: Feltet Applikationstype kan kun indstilles til indstillingen Datastreaming.

Vælg abonnementer

Vælg abonnementer

Vælg de abonnementer, du vil inkludere i din datastrøm.

For at søge efter bestemte hændelser skal du skrive et begivenhedsnavn i feltet Søg begivenheder (Search Events) [1].

For at inkludere alle hændelser i din strøm skal du markere afkrydsningsfelt Abonnementer (Subscriptions) [2]. Valg af denne indstilling omfatter alle hændelsestyper samt bruger- og systemgenererede handlinger.

For at abonnere på hændelser, som udløses af en handling, der udføres direkte af en slutbruger, skal du markere afkrydsningsfeltet Brugergenereret (User Generated) [3]. Brugergenererede hændelser omfatter oplysninger om webanmodninger, browser- og brugerdata i hændelsesmetadata og detaljer om objekter, der er påvirket af ændringen.

For at abonnere på hændelser, som udløses af asynkrone job, skal du markere afkrydsningsfeltet Systemgenereret (System Generated) [4]. Systemgenererede hændelser omfatter data om processer, der udløste en hændelse, samt detaljer om objekter, som er påvirket af ændringen.

Du kan også abonnere på hændelsesgrupper. For at abonnere på alle elementer i en gruppe skal du klikke på afkrydsningsfeltet for gruppen [5]. Du kan også vælge kun at inkludere bruger- eller systemgenererede data [6].

For at abonnere på individuelle hændelser skal du klikke på Pil-ikonet for abonnementsgruppen [7] og markere afkrydsningsfeltet for det abonnement, du vil tilføje [8].

Bemærk: Billedet i dette trin viser abonnementsmuligheder for Canvas-meddelelsestypen. Indstillingerne for Caliper 1.1-meddelelsestyperne er forskellige, men trinene for at abonnere er de samme.

Gem datastrøm

Gem datastrøm

For at gemme din datastrøm skal du klikke på knappen Gem & afslut (Save & Exit).

Vis datastrømme

Vis datastrømme

Du kan se og administrere dine datastrømme på siden Indstillinger for datastreaming.