Créer une source de données de type REST (Centre d'intégration)

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • Créez un enregistrement de source de données de type REST (Centre d’intégration) pour définir les données qu’un jeu d’importation doit importer à partir d’une API REST.

    Avant de commencer

    Rôles requis : import_admin et action_designer

    Procédure

    1. Accédez à la Tous > Ensembles de données système à importer > Administration > Sources de données.
    2. Cliquez sur Nouveau.
    3. Complétez le formulaire.
      Champ Description
      Nom Nom unique pour cette source de données.
      Étiquette de la table des ensembles de données à importer Une étiquette pour la table intermédiaire de jeu d’importation à utiliser.
      Nom de la table des jeux d'importation utilise ServiceNow AI Platform l’étiquette que vous avez saisie pour créer un nom de table unique. Cela empêche la collision de l’espace de noms avec une table déjà existante.
      Type REST (Centre d’intégration).
      Format L’un des formats suivants : Personnalisé (Analyse par script), JSON ou XML.
      Utiliser l’importation par lots Si cette option est sélectionnée, le chargement des données doit être effectué par lots lorsque vous cliquez sur Charger les données ou Tester le chargement de 20 enregistrements.
      Taille du lot Spécifie la taille des lots. S’affiche uniquement lorsque le champ Utiliser l’importation par lots est sélectionné.
      Les glide.import_set_load_usebatch propriétés et glide.import_set_load_batch_size affectent ces champs. L’ordre de priorité des propriétés et des champs est le suivant : Si la propriété est définie, utilisez la valeur de la propriété. Si ce n’est pas le cas, utilisez la valeur du champ. Si aucune des deux propriétés n’est définie, utilisez la taille de lot par défaut de 1 000.
      • Par exemple, si glide.import_set_load_usebatch = true et glide.import_set_load_batch_size = 200, utilisez 200 comme taille du lot, quelles que soient les valeurs de champ.
      • Par exemple, si glide.import_set_load_usebatch = true et que la propriété n’est glide.import_set_load_batch_size pas définie, utilisez la taille de lot par défaut de 1 000.
      • Par exemple, si la propriété n’est pas définie et que le glide.import_set_load_usebatch champ Utiliser l’importation par lots = vrai, utilisez la valeur du champ Taille du lot (ou la valeur par défaut de 1 000 si la valeur du champ Taille du lot n’est pas définie)
      • Par exemple, si la glide.import_set_load_usebatch propriété = faux et le champ Utiliser l’importation par lots = vrai, n’utilisez pas l’importation par lots, car la propriété est définie sur faux.
      Action de demande Action de demande de source de données qui sera invoquée pour obtenir des données. Vous pouvez choisir uniquement les actions de demande publiées.

      Cliquez sur le lien dans la boîte de dialogue ci-dessous pour créer/configurer une nouvelle action de demande de source de données dans Centre d'intégration. Une fois l’action de demande publiée en Centre d'intégration, vous pouvez la choisir en tant qu’action de demande dans l’enregistrement Source de données. Pour plus d'informations, consultez Définir les propriétés de l’action.
      Pagination de support Sélectionné pour activer la pagination de l’action de demande. La pagination vous aide à réduire les frais généraux de traitement en traitant un nombre spécifié d’enregistrements à la fois, au lieu de traiter tous les enregistrements en même temps.
      Limite Nombre maximal d’enregistrements par page. Par exemple, pour traiter 50 enregistrements à la fois, saisissez une limite de 50.
      Décalage Décalage initial utilisé pour la pagination. Le décalage est le numéro d’enregistrement de départ. Par exemple, pour traiter 50 enregistrements à la fois, en commençant par le premier enregistrement, entrez une limite de 50 et un décalage de 0.
      Script d'analyse Saisissez le script utilisé pour analyser une seule ligne d’entrée. Trois paramètres sont disponibles dans cette fonction :
      • ligne : ligne actuelle à analyser par le script
      • lineNumber : numéro de ligne de la ligne actuelle dans l’ensemble de la charge utile de la réponse
      • Résultat : résultat de sortie
      Chemin d’accès de chaque ligne Expression de chemin d’accès utilisée pour sélectionner des objets JSON, qui vont devenir des lignes dans la table de jeux d’importation. Le chemin d’accès doit être pour les objets JSON.
      Ignorer les tableaux Sélectionnez cette option pour ignorer les tableaux JSON en tant que valeur. Non sélectionné pour sérialiser les tableaux JSON en tant que valeur.
      Étendre les enfants de nœud Sélectionné si les éléments enfants du nœud XML ou de l’objet JSON doivent être convertis en colonnes supplémentaires. Non sélectionné si la valeur de colonne parente doit être un fragment XML ou JSON. Pour JSON, notez que la sélection de cette option développe uniquement les objets, pas les tableaux. Pour la prise en charge des tableaux imbriqués, reportez-vous à la section Exemples d’importation de fichier JSON.
      Données dans une colonne unique Sélectionné pour stocker les données dans une seule colonne.
      Xpath pour chaque ligne Expression XPath qui sélectionne les nœuds qui deviennent des lignes dans la table d’importation. Les enfants des nœuds sélectionnés deviennent les colonnes des lignes.
    4. Cliquez sur Envoyer.

    Que faire ensuite

    Définissez une carte de transformation pour la nouvelle source de données et exécutez une importation.