Créer une source de données de type de fichier
Créez un enregistrement de source de données de type de fichier pour définir les données qu’un jeu d’importation doit importer.
Avant de commencer
Pourquoi et quand exécuter cette tâche
Procédure
- Accédez à la Tous > Ensembles de données système à importer > Administration > Sources de données.
- Cliquez sur Nouveau.
-
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 Fichier. Format Seul le format de fichier XML par défaut (.xlsx) est pris en charge, sauf s’il est enregistré sous « Document XML ouvert strict ». Compressé (zippé) Sélectionné si le fichier d’importation est compressé. 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.
Méthode de récupération de fichier Méthode de récupération de ce fichier. Chemin d'accès au fichier Le chemin vers le fichier à importer. Vous pouvez inclure une valeur de propriété système dans ce champ au format ${system.property.name}. Lorsque la connexion est établie, la variable est remplacée par la valeur de la propriété spécifiée.Remarque :Pour les fichiers récupérés à l’aide de HTTP ou HTTPS, la propriété doit avoir la valeur vrai pour utiliser l’extension de propriété glide.ds.file.http.variable_replacement système.Par exemple, vous pouvez spécifier la valeur du chemin d’accès au fichier/countries.csv ?key=${datasource.apikey}. Lorsque la connexion est établie, la valeur de la datasource.apikey propriété système est transmise comme valeur du key paramètre.
Remarque :Pour les protocoles HTTP et HTTPS, le chemin d’accès au fichier est automatiquement encodé par URL. Ne spécifiez pas de chemin d’accès au fichier encodé par URL lorsque vous utilisez l’un ou l’autre de ces protocoles.Délimiteur CSV Caractère délimiteur du fichier CSV. Script d'analyse Script utilisé pour analyser une seule ligne d’entrée. Au fur et à mesure que vous tapez le script, la saisie semi-automatique de script présente les choix qui s’offrent à vous. Pour plus d'informations, consultez Type de fichier Sources de données. Numéro de feuille Numéro de feuille Excel pour charger les données. Ligne d’en-tête Numéro de ligne Excel pour charger les étiquettes de colonne. 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. Méthode d’authentification de SCP Choix d’authentification avec un nom d’utilisateur et un mot de passe ou avec une clé publique. Remarque :Vous ne pouvez pas vous authentifier auprès des sources de données avec une paire de clés public-privé. Utilisez plutôt une authentification par nom d’utilisateur et mot de passe.Serveur Nom du serveur à partir duquel les tables seront importées. Port Port à utiliser pour se connecter au serveur spécifié. Ce champ s’affiche si vous sélectionnez HTTP ou HTTPS comme méthode de récupération de fichier. Nom d'utilisateur Nom d’utilisateur pour l’authentification sur le serveur JDBC. Mot de passe Mot de passe pour l’authentification sur le serveur JDBC. Fichier de clés privées lors de l’utilisation de fichiers de clés publiques-privées SCP hérités. Remarque :- Vous ne pouvez pas vous authentifier auprès des sources de données avec une paire de clés public-privé. Utilisez plutôt l’authentification par nom d’utilisateur et mot de passe.
- N’utilisez pas cette option héritée. Bien qu’il soit disponible pour utilisation, il n’est pas pris en charge.
Magasin de clés système Sélectionné pour valider le certificat du serveur FTPS par rapport à tous les certificats enregistrés. Ce certificat peut être de n’importe quel type pris en charge par l’instance. Si cette option n’est pas sélectionnée, l’instance utilise le certificat Java par défaut pour valider le serveur FTPS. Ce champ est disponible uniquement pour les sources de données dont la valeur de méthode de récupération de fichierest FTPS. Toutes les méthodes de récupération de fichiers FTPS sont prises en charge, y compris le TLS d’authentification, le SSL d’authentification, le SSL implicite et le TLS implicite. - Cliquez sur Envoyer.