Le corps de la demande doit contenir le tableau JSON d’objets (charge utile) à insérer dans la table Import Set. Chaque objet équivaut à une ligne dans la table, chaque paire nom-valeur équivaut à une colonne. La charge utile JSON doit tirer parti des noms de champs du jeu d’importation sans le préfixe « u_ ». Par exemple, le nom de champ « u_matching_record » doit être « matching_record » dans la charge utile du corps de la demande. Si la table d’ensembles de données à importer existe, le point de terminaison ajoute les lignes (objets) à la table d’ensembles de données à importer existante. Aucune vérification des doublons ou mise à jour des enregistrements existants n’est effectuée.

Si vous créez initialement une application, vous devez d’abord créer l’enregistrement de source de données associé dans votre instance avant d’appeler ce point de terminaison. Si vous utilisez simplement ce point de terminaison pour ajouter des enregistrements à une table d’ensembles de données à importer existante, vous n’avez pas besoin de créer l’enregistrement de source de données, mais vous devez connaître son sys_id. L’enregistrement de source de données décrit la table d’ensembles de données à importer dans laquelle insérer la charge utile spécifiée. Cette table doit étendre la table Lignes de jeux d’importation [sys_import_set_row]. En outre, la source de données doit être définie sur Pièce jointe et le format défini sur JSON. Pour plus d’informations sur les sources de données, consultez Sources de données.

Si la table d’ensemble d’importation définie dans l’enregistrement de source de données n’existe pas, le point de terminaison joint la charge utile transmise à l’enregistrement de source de données. Pour créer la table d’ensemble d’importation initiale, vous devez importer manuellement les données dans la table d’ensemble d’importation. Pour importer les données, dans le formulaire Source de données associé, cliquez sur le lien Tester le chargement de 20 enregistrements ou Charger tous les enregistrements dans la section Liens connexes. Une fois la table Import Set créée, vous ne pouvez pas ajouter de colonnes à la table à l’aide de ce point de terminaison. Si des paires nom-valeur qui n’existent pas dans la table d’ensembles de données à importer sont transmises ultérieurement, elles sont ignorées sans avertissement. Si vous devez modifier les colonnes de la table Jeu d’importation, vous pouvez les ajouter manuellement à la table. Vous pouvez également supprimer ou renommer la table Import Set, puis appeler à nouveau le point de terminaison à l’aide de la nouvelle charge utile.

Vous devez disposer du rôle cmdb_import_api_admin pour accéder à ce point de terminaison.

Format d'URL

URL versionnée : /api/now/{api_version}/cmdb/ingest/{data_source_sys_id}

URL par défaut : /api/now/cmdb/ingest/{data_source_sys_id}

Paramètres de demande pris en charge