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 quelles données un jeu d’importation doit importer à partir d’une API REST.
Avant de commencer
Procédure
- Accédez à la Tous > Ensembles d'importation système > 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 de jeux d'importation Étiquette pour la table intermédiaire de jeu d’importation à utiliser. Nom de la table des jeux d'importation utilise Now Platform l’étiquette que vous avez saisie pour construire un nom de table unique. Cela permet d’éviter toute collision d’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 des données ou Tester le chargement de 20 enregistrements. Taille du lot Spécifie la taille des lots. Apparaît uniquement lorsque le champ Utiliser l’importation par lots est sélectionné. Les glide.import_set_load_usebatch propriétés and 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 de lot, quelles que soient les valeurs de champ.
- Par exemple, si glide.import_set_load_usebatch = vrai 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é = 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 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électionnée pour activer la pagination de l’action de demande. La pagination vous aide à réduire les frais de traitement en traitant un nombre spécifié d’enregistrements à la fois, au lieu de traiter tous les enregistrements à la fois. Limite Nombre maximal d’enregistrements par page. Par exemple, pour traiter 50 enregistrements à la fois, entrez une limite de 50. Décalage Décalage initial utilisé pour la pagination. Le décalage correspond au numéro d’enregistrement de début. Par exemple, pour traiter 50 enregistrements à la fois, en commençant par le premier, 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 : - line : la ligne actuelle à analyser par le script
- lineNumber : le 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 deviendront des lignes dans la table de jeu d’importations. Le chemin d’accès doit être // pour les objets JSON. Ignorer les tableaux Sélectionné pour ignorer les tableaux JSON en tant que valeur. Non sélectionné pour sérialiser les tableaux JSON en tant que valeur. Étendre l'enfant de nœud Sélectionnez cette option 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, et non les tableaux. Pour en savoir plus sur 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ée 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. - Cliquez sur Envoyer.