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 nécessite un Connexion au flux abonnement. Pour plus d'informations, consultez https://www.servicenow.com/products/automation-engine.html.
• Le module d’extension ServiceNow 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, consultez Créer un flux Kafka.

Procédure

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

   Tableau 1. Consommateur de script Kafka

   Champ	Description
   Nom	Nom du consommateur de script.
   Garantie de livraison	En cas de défaillance d’un nœud, option permettant de spécifier la garantie de remise pour les 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 plus d’une fois. Une fois ou pas du tout : un message n’est pas délivré plus d’une fois. Certains messages peuvent ne pas être livrés 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 en savoir plus 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 figure pas dans la table de schéma, le système importe le schéma dynamiquement, à l’aide de la connexion REST configurée.

4. Sélectionnez Enregistrer.

Exemple

Cet exemple montre un exemple de script pour le 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.