Configurer un consommateur de script

Utilisez un script pour importer et traiter les données de votre environnement Kafka.

Avant de commencer

• Rôle requis : integration_hub_admin
• Ce consommateur a besoin d’un Connexion au flux abonnement. Pour plus d'informations, consultez https://www.servicenow.com/now-platform/workflow-data-fabric.html.
• Le ServiceNow module d’extension Stream Connect Installer [com.glide.hub.stream_connect.installer] est requis.

Pourquoi et quand exécuter cette tâche

Pour configurer un consommateur, vous devez créer deux enregistrements.

1. Enregistrement consommateur, qui spécifie la manière d’importer et de traiter les données.
2. Un enregistrement pour le flux Kafka, qui définit le flux de données vers votre consommateur.

Cette tâche couvre la création du consommateur. Pour obtenir des instructions sur la création d’un flux Kafka, reportez-vous à la section Créer un flux Kafka.

Procédure

1. Accédez à la Tous > Centre d'intégration > Consommateurs > Consommateur de script.
2. Sélectionnez Nouveau.
3. Renseignez les champs du formulaire.

   Tableau 1. Consommateur de script

   Champ	Description
   Nom	Nom du consommateur de script.
   Garantie de livraison	En cas de défaillance de nœud, option permettant de spécifier la garantie de livraison des messages entrants. Sélectionnez l'une des options suivantes : Pas de pertes, mais des doublons : tous les messages sont remis au moins une fois. Certains messages peuvent être remis plusieurs fois. Une fois ou pas du tout : un message n’est pas remis plus d’une fois. Certains messages peuvent ne pas être remis du tout.
   Format de sérialisation	Le format de sérialisation du message. Sélectionnez l'une des options suivantes : Texte brut : sélectionnez cette option pour tous les messages en texte brut. Il s’agit du format par défaut. Codé : sélectionnez cette option pour les messages au Apache format Avro. La conversion de messages en texte brut au format Avro nécessite un schéma. Sélectionnez le registre de schémas dans le champ Registre de schémas . Pour plus d’informations sur les schémas, reportez-vous à la section Gestion des schémas dans Connexion au flux.
   Consommateur d'événement	Script à utiliser pour utiliser les messages reçus de la rubrique Kafka.
   Application	Périmètre de l’application pour le consommateur de carte de transformation.
   Registre de schémas	Registre pour le schéma sélectionné. Sélectionnez l'une des options suivantes : Registre de schémas autonome Registre de schémas Confluent Ce champ s’affiche uniquement lorsque le format de sérialisation est défini sur Codé. Pour le registre de schémas Confluent, si l’ID de schéma du message reçu ne se trouve pas dans la table de schémas, le système importe le schéma de manière dynamique, à l’aide de la connexion REST configurée.

4. Sélectionnez Enregistrer.

Exemple

Cet exemple montre un exemple de script de traitement des messages.

(function process(messages) {
 // Add your code here to consume kafka messages 
 // sample message [ { 'key' : 'message_key' , 'message' : 'message' , 'headers' : [ { 'key' : 'header_key' , 'value' : 'header_value' } ] } ] 

 for (var i = 0; i < messages.length; i++) {
     var message = JSON.parse(messages[i].message);
     gs.info('Number ' + message.number + ', short description ' + message.short_description +
         ', headers ' + JSON.stringify(messages[i].headers));
 }
})(messages);

Que faire ensuite

Créer un flux Kafka pour ce consommateur. Une fois le flux activé, vous pouvez commencer à recevoir des messages de votre environnement Kafka.