Wie abonniere ich Live-Ereignisse mit Canvas Daten-Diensten?

Als Admin können Sie Live-Ereignisse abonnieren und in Echtzeit eine Reihe von Ereignissen von Ihrem Canvas-Konto erhalten. Sie können wählen, welche Ereignisse in Canvas Sie abonnieren möchten. Sie müssen eine Warteschlange in Amazon Web Services einrichten, um Daten zu Live-Ereignissen zu erhalten.

Hinweis: Um Daten zu Live-Ereignissen zu erhalten, müssen Sie sich bei Amazon Web Services anmelden, um eine Warteschlange einzurichten.

Konto öffnen

Konto öffnen

Klicken Sie auf den Link Admin [1] und dann auf den Namen des Kontos [2].

Offene Datendienste

Offene Datendienste

Klicken Sie in der Kontonavigation auf den Link Data Services (Datendienste).

Daten-Stream hinzufügen

Daten-Stream hinzufügen

Um einen neuen Daten-Stream für Ihr Konto zu erstellen, klicken Sie auf die Schaltfläche Add Stream (Stream hinzufügen).

Daten-Stream konfigurieren

Daten-Stream konfigurieren

Geben Sie einen Titel für Ihren Stream im Feld Title (Titel) hinzu [1].

Wählen Sie eine SQS- oder HTTPS-Zustellmethode im Dropdown-Menü Delivery Method (Zustellmethode) [2]. Geben Sie dann Ihre AWS SQS- oder eine HTTPS-Endpunkt-URL in das Feld URL [3] ein.

Hinweise:

  • Pro Abonnement ist nur eine Zustellmethode zulässig.
  • Canvas verwendet JWT zur Signierung von Ereignissen. Wenn der Dienst nicht verfügbar ist und von Canvas nicht erreicht werden kann, werden die Ereignisse, die während des Service-Ausfalls auftreten, möglicherweise nicht zugestellt.

Daten-Stream mit Amazon SQS konfigurieren

Daten-Stream mit Amazon SQS konfigurieren

Wenn Sie eine Authentifizierung für eine Amazon-SQS-URL verlangen möchten, wählen Sie die AWS-Anmeldedaten im Feld Authentication (Authentifizierung) [1]. Wenn keine Authentifizierung erforderlich ist, kann dieses Feld auf die Option „Keine“ gesetzt werden.

Wenn AWS-Anmeldedaten erforderlich sind, geben Sie den AWS-Schlüssel [2], das AWS-Geheimwort [3] und die AWS-Region [4] ein.

Wählen Sie das Format des Ereignisses im Feld Message Type (Nachrichtentyp) [5]. Der Nachrichtentyp kann auf Canvas oder Caliper 1.1 eingestellt werden.

Hinweis: Das Feld Anwendungstyp kann nur auf die Option Daten-Streaming eingestellt werden.

 

Daten-Stream mit HTTPS konfigurieren

Die HTTPS-Zustellmethode enthält eine Option zur Anzeige von Quell-Endpunkt-Nutzdaten mit Ihrem Daten-Stream. Um Nutzdaten anzuzeigen, aktivieren Sie das Kontrollkästchen Sign Payload (Nutzdaten signieren) [1].

Wählen Sie das Format des Ereignisses im Feld Message Type (Nachrichtentyp) [2]. Der Nachrichtentyp kann auf Canvas oder Caliper 1.1 eingestellt werden.

Hinweis: Das Feld Anwendungstyp kann nur auf die Option Daten-Streaming eingestellt werden.

Abonnements auswählen

Abonnements auswählen

Wählen Sie die Abonnements aus, die Sie in Ihren Daten-Stream aufnehmen möchten.

Um nach bestimmten Ereignissen zu suchen, geben Sie den Namen des Ereignisses in das Feld Search Events (Ereignisse suchen) ein [1].

Um alle Ereignisse in Ihren Stream aufzunehmen, klicken Sie auf das Kontrollkästchen Subscriptions (Abonnements) [2]. Wenn Sie diese Option wählen, werden alle Ereignistypen sowie von Benutzer*innen und vom System generierte Aktionen berücksichtigt.

Um Ereignisse zu abonnieren, die durch eine direkt von Benutzer*innen durchgeführte Aktion ausgelöst wurden, klicken Sie auf das Kontrollkästchen User Generated (Benutzergeneriert) [3]. Benutzergenerierte Ereignisse enthalten Informationen über Webanfragen, Browser- und Benutzerdaten in den Ereignis-Metadaten sowie Details zu den von der Änderung betroffenen Objekten.

Um Ereignisse zu abonnieren, die von asynchronen Aufträgen ausgelöst werden, klicken Sie auf das Kontrollkästchen System Generated (Systemgeneriert) [4]. Systemgenerierte Ereignisse enthalten Daten über Prozesse, die ein Ereignis ausgelöst haben, sowie Details über die von der Änderung betroffenen Objekte.

Sie können auch Ereignisgruppen abonnieren. Um alle Objekte in einer Gruppe zu abonnieren, klicken Sie auf das Kontrollkästchen für die Gruppe [5]. Sie können auch auswählen, dass nur benutzer- oder systemgenerierte Daten einbezogen werden [6].

Um einzelne Ereignisse zu abonnieren, klicken Sie auf das Pfeilsymbol für die Abonnementgruppe [7] und dann auf das Kontrollkästchen für das Abonnement, das Sie hinzufügen möchten [8].

Hinweis: Die Abbildung in diesem Schritt zeigt die Abonnementoptionen für den Nachrichtentyp „Canvas“. Die Optionen für die Nachrichtentypen „Caliper 1.1“ sind anders, aber die Schritte zum Abonnieren sind die gleichen.

Daten-Stream speichern

Daten-Stream speichern

Um Ihren Daten-Stream zu speichern, klicken Sie auf die Schaltfläche Save & Exit (Speichern & Beenden).

Daten-Streams anzeigen

Daten-Streams anzeigen

Sie können Ihre Daten-Streams auf der Seite „Optionen für Daten-Streams“ anzeigen und verwalten.