Comment m'abonner à des événements en direct à l'aide de Canvas Data Services ?
En tant qu'administrateur, vous pouvez vous abonner aux événements en direct et recevoir un ensemble d'événements en temps réel depuis votre compte Canvas. Vous pouvez choisir les événements de Canvas auxquels vous souhaitez vous abonner. Vous devrez maintenir une file d'attente des services AWS (Amazon Web Services) pour recevoir les données des événements en di....
Remarque : Pour recevoir les données des événements en direct, vous devrez vous abonner aux services AWS afin de maintenir une file d'attente.
Ouvrir un compte
Cliquez sur le lien Administrateur (Admin) [1], cliquez ensuite sur le nom du compte [2].
Ouvrir les Services de données
Dans la navigation du compte, cliquez sur le lien Services de données (Data Services).
Ajouter un flux de données
Pour créer un nouveau flux de données pour votre compte, cliquez sur le bouton Ajouter un flux (Add Stream).
Configurer le flux de données
Ajoutez un titre à votre flux dans le champ Nom/Titre (Nom/Title) [1].
Sélectionnez une méthode de livraison SQS ou HTTPS dans le menu déroulant Méthode de livraison (Delivery Method) [2]. Entrez ensuite votre AWS SQS ou une URL de point final HTTPS dans le champ URL [3].
Remarques :
- Un seul mode de livraison est autorisé par abonnement.
- Canvas utilise JWT pour inscrire un événement. Si le service est indisponible et que Canvas ne peut pas l'atteindre, les événements survenus pendant la panne de service risquent de ne pas être délivrés.
Configurer le flux de données Amazon SQS
Si vous souhaitez exiger une authentification pour une URL Amazon SQS, sélectionnez les informations d'identification AWS dans le champ Authentification (Authentication) [1]. Si l'authentification n'est pas requise, ce champ peut être défini sur l'option Aucune (None).
Si les informations d'identification AWS sont requises, saisissez la clé AWS [2], le code secret AWS [3] et la région AWS [4].
Sélectionnez le format de l'événement dans le champ Type de message (Message Type) [5]. Le type de message peut être défini sur Canvas ou Caliper 1.1.
Remarque : Le champ Type d'application (Application Type) ne peut être défini que sur l'option Flux de données (Data Streaming).
Configurer le flux de données HTTPS
La méthode de livraison HTTPS inclut une option permettant d'afficher les données de charge du point final source avec votre flux de données. Pour afficher les données de charge, cochez la case Signer les données de charge (Sign Payload) [1].
Sélectionnez le format de l'événement dans le champ Type de message (Message Type) [2]. Le type de message peut être défini sur Canvas ou Caliper 1.1.
Remarque : Le champ Type d'application (Application Type) ne peut être défini que sur l'option Flux de données (Data Streaming).
Sélectionner les abonnements
Sélectionnez les abonnements que vous souhaitez inclure dans votre flux de données.
Pour chercher des événements spécifiques, tapez le nom de l'événement dans le champ Chercher des événements (Search Events) [1].
Pour inclure tous les événements dans votre flux, cochez la case Abonnements (Subscriptions) [2]. La sélection de cette option inclut tous les types d'événements ainsi que les actions générées par l'utilisateur et le système.
Pour vous abonner aux événements déclenchés par une action directement effectuée par un utilisateur final, cochez la case Généré par l'utilisateur (User Generated) [3]. Les événements générés par l'utilisateur incluent des informations sur les requêtes Web, les données du navigateur et de l'utilisateur dans les métadonnées d'événement, ainsi que des détails sur les objets affectés par la modification.
Pour vous abonner aux événements déclenchés par des tâches asynchrones, cochez la case Généré par le système (System Generated) [4]. Les événements générés par le système incluent des données sur les processus qui ont déclenché un événement ainsi que des détails sur les objets affectés par la modification.
Vous pouvez également vous abonner à des groupes d'événements. Pour vous abonner à tous les éléments d'un groupe, cochez la case du groupe [5]. Vous pouvez également choisir d'inclure uniquement les données générées par l'utilisateur ou le système [6].
Pour vous abonner à des événements individuels, cliquez sur l'icône de flèche du groupe d'abonnements [7] et cochez la case de l'abonnement que vous souhaitez ajouter [8].
Remarque : L'image de cette étape montre les options d'abonnement pour le type de message Canvas. Les options pour les types de messages Caliper 1.1 sont différentes, mais les étapes d'abonnement sont les mêmes.
Enregistrer le flux de données
Pour enregistrer votre flux de données, cliquez sur le bouton Enregistrer et Quitter (Save & Exit).
Afficher les flux de données
Vous pouvez afficher et gérer vos flux de données sur la page Options de flux de données (Data Streaming Options).