Créer une source de données de type REST (Hub d'intégration)
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
Procédure
- Accédez à la Tout > Ensembles de données à importations système > Administration > Sources de données.
- Cliquez sur Nouveau.
-
Renseignez le formulaire.
Champ Description Nom Nom unique pour cette source de données. Étiquette de la table des ensembles de données à importer Étiquette pour la table intermédiaire du jeu d’importation à utiliser. Nom de la table des ensembles de données à importer Utilise Now Platform l’étiquette que vous avez saisie pour créer un nom de table unique. Cela évite les collisions d’espace de noms avec une table déjà existante. Type REST (Centre d’intégration). Format L’un des formats suivants : Personnalisé (analyser par script), JSON ou XML. Utiliser l'importation par lots Si cette option est sélectionnée, le chargement des données doit être regroupé 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 propriété 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 de 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 glide.import_set_load_usebatch pas définie et que le 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é = false et le champ Utiliser l’importation par lots = vrai, n’utilisez pas l’importation par lots, car la propriété est définie sur false.
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 Hub d'intégration. Une fois l’action de demande publiée dans Hub d'intégration, vous pouvez la choisir comme 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électionnez cette option 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, commencez 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 : la ligne actuelle à analyser par le script
- lineNumber : numéro de ligne de la ligne actuelle dans l’ensemble de la charge utile de 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 deviendront des lignes dans la table de jeu d’importation. Le chemin d’accès doit être pour les objets JSON. Ignorer les tableaux Sélectionnée pour ignorer les tableaux JSON en tant que valeur. Désélectionnée pour sérialiser des tableaux JSON en tant que valeur. Étendre l'enfant 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. Désélectionné si la valeur de la 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 fichiers 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 deviendront les colonnes des lignes. - Cliquez sur Envoyer.