Diffuser des données à partir d'instances ServiceNow

Datastream est compatible avec la réplication des événements de modification à partir d'une instance ServiceNow. ServiceNow est une plate-forme cloud pour les opérations d'entreprise. Vous pouvez répliquer des données à partir de cette plate-forme comme vous le feriez à partir d'autres sources compatibles avec Datastream.

Cette page contient des informations sur les points suivants :

  • Les termes clés que vous devez comprendre lorsque vous effectuez une réplication à partir de ServiceNow.
  • Le comportement de Datastream lorsqu'il gère les données qu'il extrait d'une instance ServiceNow.
  • Les versions de ServiceNow compatibles avec Datastream.
  • Les limites connues de l'utilisation de ServiceNow comme source.

Termes clés

ServiceNow fonctionne à l'aide de tables, d'enregistrements et de champs :

  • Une instance ServiceNow est un environnement cloud ServiceNow dédié et isolé, par exemple company.service-now.com.
  • Une table est une structure de données principale dans ServiceNow, équivalente à une table de base de données.
  • Un enregistrement est une entrée individuelle dans une table, équivalente à une ligne dans une base de données.
  • Un champ est un élément de données individuel dans un enregistrement, équivalent à une colonne de base de données.
  • Le connecteur utilise l'API Table comme interface RESTful principale pour accéder directement aux données des tables ServiceNow.
  • La pagination basée sur le décalage est une méthode de navigation dans les enregistrements d'une table ServiceNow en transmettant un numéro de décalage à l'API Table. Cette méthode est sensible aux suppressions d'enregistrements lors de la pagination, ce qui peut entraîner l'omission de données par le connecteur.
  • La pagination basée sur un ensemble de clés est une méthode dans laquelle le connecteur gère la pagination en effectuant le suivi des valeurs d'enregistrement uniques, telles que les identifiants ou les codes temporels, et de leur ordre. Cette méthode est efficace même si des enregistrements sont supprimés lors de la pagination.

Comportement

La prise en charge de la source ServiceNow dans Datastream repose sur l'API REST Table de ServiceNow. Datastream est compatible avec deux méthodes de réplication principales pour garantir l'intégrité et les performances des données.

Remplissage de données historiques

  • Lors de la réplication des données de modification à partir d'une instance ServiceNow, Datastream effectue une synchronisation historique complète de tous les enregistrements existants dans une table.
  • Pour garantir la cohérence des données et éviter la perte d'enregistrements lors d'extractions volumineuses, le connecteur utilise la pagination basée sur un ensemble de clés. Le connecteur gère ce processus en effectuant le suivi des valeurs d'enregistrement uniques et de leur ordre, ce qui rend l'extraction robuste aux suppressions d'enregistrements et empêche le connecteur d'ignorer ou de dupliquer des enregistrements.
  • Datastream trie les données par propriétés d'enregistrement sys_updated_on et sys_id pour fournir un ordre stable pour le chargement initial. Pour la table sys_journal_field, qui contient des enregistrements immuables et ne comporte pas de champ sys_updated_on, le connecteur trie par propriétés sys_created_on et sys_id.

Synchronisation incrémentielle

  • Lors de la réplication des données de modification à partir d'une instance ServiceNow, Datastream capture les modifications, telles que les insertions et les mises à jour, qui se produisent après le remplissage initial.
  • Synchronisation incrémentielle côté serveur : le connecteur interroge l'API ServiceNow pour les enregistrements modifiés depuis la dernière synchronisation réussie à l'aide d'un filtre sur les propriétés sys_updated_on et sys_id (ou sys_created_on et sys_id pour la table sys_journal_field).
  • Le processus de synchronisation utilise un curseur composé de marqueurs sys_updated_on (ou sys_created_on pour la table sys_journal_field) et sys_id. Les marqueurs sys_updated_on et sys_created_on garantissent que seuls les enregistrements dont l'horodatage est égal ou postérieur à une heure spécifiée sont synchronisés lors du cycle suivant, tandis que le marqueur sys_id assure la cohérence des enregistrements avec des horodatages égaux.

Versions

Le connecteur ServiceNow fonctionne avec l'API REST Table de ServiceNow (V2). La fonctionnalité compatible avec Datastream est validée par rapport à la version Zurich.

Objets répliqués

Le connecteur ServiceNow utilise un mécanisme de découverte dynamique pour identifier l'ensemble des tables (objets) d'une instance. Pour vous assurer de ne répliquer que des données d'entreprise à forte valeur ajoutée, le connecteur applique un processus de filtrage multicouche afin d'exclure l'architecture interne, les journaux techniques et les tables de métadonnées système.

Logique de filtrage

  • Accès aux services Web : vous ne pouvez répliquer que les tables que vous configurez explicitement avec l'accès aux services Web activé (ws_access=true). Si cette configuration est manquante, le connecteur ne peut pas récupérer les données d'enregistrement de la table.
  • Superclasses exclues : le connecteur exclut les tables qui héritent de la table de configuration système sys_metadata ou qui font partie d'une hiérarchie de tables pivotées pour éviter de répliquer des métadonnées techniques ou des instantanés incohérents.
  • Préfixe système interne : le connecteur filtre les tables commençant par des préfixes techniques spécifiques représentant la plomberie de la plate-forme ou des fonctionnalités héritées.
  • Liste d'autorisation (exceptions système) : bien que le connecteur exclue la plupart des tables sys_, il autorise explicitement les entités commerciales critiques, telles que sys_user, sys_choice et sys_journal_field.

Préfixes système filtrés par défaut

Catégorie Préfixes Description
Internes de base v_, ts_, imp_, ecc_, wf_, sh$, bin_, var_, gs_ Tables virtuelles, index de recherche, zone de préparation de l'importation, files d'attente ECC et contextes de workflow.
Analyses et IA pa_, ua_, ml_, ais_, promin_, di_ Scores Performance Analytics, télémétrie des fournisseurs, vecteurs ML et profils de recherche IA.
Modules techniques sa_, sla_, atf_, cxs_, automation_, ids_ Modèles de mappage de services, journaux du moteur SLA et pistes d'audit de sécurité.
Héritage et administration pf_, clone_, upgrade_, rollback_, expert_, dscy_ Historique des correctifs d'instance, journaux de mise à niveau et modules hérités obsolètes.

Tables système autorisées

  • Utilisateurs et sécurité : sys_user, sys_user_group, sys_user_grmember, sys_user_role, sys_user_has_role.
  • Référence de base : sys_choice (options de menu déroulant), sys_company, sys_domain, sys_location.
  • Pistes d'audit : sys_journal_field (notes de travail et historique des commentaires).

Limitations connues

Les limites connues d'utilisation de ServiceNow en tant que source incluent les suivantes :

  • Datastream n'est pas compatible avec la capture des enregistrements supprimés.
  • Datastream exclut par défaut de nombreuses tables de plate-forme internes, par exemple les tables commençant par ts_, v_ ou imp_.
  • Vous ne pouvez répliquer que les tables que vous configurez explicitement avec l'accès aux services Web activé (ws_access=true). Il s'agit de la valeur par défaut pour la plupart des tables.
  • Le connecteur réplique les valeurs de champ telles qu'elles apparaissent dans l'instance de base de données ServiceNow sous-jacente. Ces valeurs sont appelées valeurs réelles. Cela signifie que les valeurs réelles que Datastream réplique vers la destination peuvent différer des valeurs affichées dans l'interface utilisateur ServiceNow (appelées valeurs d'affichage). Pour en savoir plus, consultez la base de connaissances ServiceNow.

Étape suivante