Se connecter aux services JSON

Concept Information

Commande ACCESSDATA

JSON (JavaScript Object Notation) est un format de fichier standard utilisé pour transmettre des objets de données composés de paires d'attributs-valeur et de types de données de tableau. JSON est un format courant dans le cadre de la communication avec des services Web.

Remarque

Vous ne pouvez pas utiliser ce connecteur indépendamment d'Analytics. Vous pouvez configurer un DSN pour le pilote du connecteur à l'aide de l'Administrateur de source de données ODBC Windows. Toutefois, vous devez tester la connexion DSN à partir de l'intérieur d'Analytics et non à partir de la boîte de dialogue de configuration DSN Windows du connecteur.

Remarque

Vous ne pouvez pas utiliser le connecteur JSON avec l'édition professionnelle d'ACL Robotics si la connexion requiert une authentification.

Avant de commencer

Pour vous connecter à un service JSON, vous devez déterminer la structure du fichier que vous avez l'intention d'interroger et vous devez développer la syntaxe JSONPath ou XPath nécessaire pour diviser le fichier en une structure tabulaire contenant des lignes. Vous pouvez importer une table par connexion.

Pour obtenir de l'aide concernant la réunion des conditions préalables à la connexion, contactez l'administrateur du service JSON de votre entreprise. Si votre administrateur n'est pas en mesure de vous aider, vous ou votre administrateur devez contacter les services d'assistance du système auquel vous essayez de vous connecter.

Connexions JSON nécessitant une authentification

Si le service JSON auquel vous souhaitez vous connecter requiert une authentification avec un jeton ou les informations d'identification de l'utilisateur, vous devez créer une connexion de données (DSN) dans l'administrateur de source de données ODBC Windows. Une fois que vous avez créé le DSN, incluant les informations d'authentification, vous pouvez le sélectionner dans la fenêtre Accès aux données.

Créer une connexion JSON

  1. Dans le menu principal Analytics, sélectionnez Importer > Base de données et application.Analytics
  2. Depuis l'onglet Nouvelles connexions, sous la section Connecteurs ACL, sélectionnez JSON.

    Astuce

    Vous pouvez filtrer la liste des connecteurs disponibles en indiquant une chaîne de recherche dans la zone Filtrer les connexions. Les connecteurs sont indiqués par ordre alphabétique.

  3. Dans le panneau Paramètres de connexion aux données entrez les paramètres de connexion, et en bas du panneau, cliquez sur Enregistrer et connecter.

    Vous pouvez accepter le nom de connexion proposé par défaut ou en saisir un nouveau.

La connexion correspondant à JSON est enregistrée dans l'onglet Connexions existantes. À l'avenir, vous pourrez vous reconnecter à JSON à partir de la connexion enregistrée.

Une fois la connexion établie, la fenêtre Accès aux données s'ouvre sur la Zone de transit et vous pouvez commencer l'importation des données. Pour obtenir de l'aide concernant l'importation de données à partir de JSON, consultez la rubrique Utilisation de la fenêtre Accès aux données.

Paramètres de connexion

Paramètres de base

Paramètre Description Exemple
Table

JSONPath d'un élément de tableau dans le document JSON (utilisé pour diviser le document en plusieurs lignes).

Cela indique le JSONPath (ou syntaxe XPath) d'un élément de tableau et cela est utilisé pour diviser le document en plusieurs lignes.

Cette propriété sera utilisée pour générer la définition du schéma en cas d'absence de fichier de schéma (RSD).

Remarque

JSONPath et XPath sont des formats de requête standardisés. Pour plus d'informations sur la syntaxe et les mots-clés, consultez une ressource en ligne.

 $.valeur
Emplacement JSON

URI (Uniform Resource Identifier) ou chemin d'accès absolu de la ressource JSON.

 http://sample.example.net/examples.json

Paramètres avancés

Paramètre Description Exemple
Limite de la taille de clé

Longueur maximale d'une colonne de clé primaire. Définir la taille sur 0 fera revenir la longueur de clé à sa longueur d'origine.

Cette propriété force le connecteur à écraser la longueur signalée de toutes les colonnes de clés primaires.

 255
Mapper vers Long Varchar

Contrôle si oui ou non une colonne est renvoyée sous SQL_LONGVARCHAR.

Utilisez ce paramètre pour mapper une ou plusieurs colonnes plus grandes que la taille spécifiée pour qu'elles soient signalées sous SQL_LONGVARCHAR plutôt que sous SQL_VARCHAR.

 -1
Mapper vers WVarchar

Contrôle s'il faut ou non que les types de chaînes mappent vers SQL_WVARCHAR plutôt que SQL_VARCHAR. Cela est défini par défaut.

Les colonnes des chaînes de caractères doivent être mappées vers SQL_WVARCHAR pour s'adapter à différents jeux de caractères internationaux, donc MapToWVarchar est défini sur vrai par défaut. Vous pouvez aussi le définir sur faux pour utiliser SQL_VARCHAR à la place.

 vrai
Colonnes pseudo

Indique s'il faut inclure ou pas des pseudocolonnes comme colonnes dans la table.

Ce paramètre s'avère particulièrement utile dans un cadre d'entité, qui ne vous permet pas de définir une valeur pour une pseudocolonne sauf s'il s'agit d'une colonne de table.

La valeur de ce paramètre de connexion est au format "Table1=Column1, Table1=Column2, Table2=Column3". Vous pouvez utiliser le caractère « * » pour inclure toutes les tables et toutes les colonnes.

 MyTable=*
Cert de serveur SSL

Certificat à accepter du serveur lors d'une connexion avec TLS/SSL. Vous pouvez spécifier un ou plusieurs des éléments suivants :

  • certificat PEM complet
  • chemin d'accès au fichier local contenant le certificat
  • la clé publique
  • l'empreinte numérique MD5 (les valeurs Hex peuvent aussi être séparées d'un espace ou de deux-points)
  • l'empreinte numérique SHA1 (les valeurs Hex peuvent aussi être séparées d'un espace ou de deux-points)

Si vous utilisez une connexion TLS/SSL, cette propriété peut être utilisée pour spécifier le certificat TLS/SSL à accepter par le serveur. Tous les autres certificats qui ne sont pas considérés comme fiables par la machine seront rejetés.

 C:\cert.cer
Convertir DateHeure en GMT Convertit les champs DateHeure au fuseau horaire GMT pendant l'importation. Si la valeur est fausse, la valeur DateHeure est convertie dans le fuseau horaire du système d'exploitation du poste exécutant Analytics. vrai
Schéma d'authentification du proxy

Type d'authentification à utiliser pour l'authentification au proxy ProxyServer.

Cette valeur spécifie le type d'authentification à utiliser pour l'authentification à un proxy HTTP spécifié par ProxyServer et par ProxyPort.

Remarque

Le connecteur utilisera les paramètres du proxy système par défaut, sans autre configuration nécessaire ; si vous souhaitez vous connecter à un autre proxy, vous devrez définir ProxyAutoDetect sur faux, en plus de ProxyServer et de ProxyPort. Pour l'authentification, définissez ProxyAuthScheme et définissez ProxyUser et ProxyPassword, si nécessaire.

Le type d'authentification peut être l'un des suivants :

  • BASIC Le pilote effectue une authentification HTTP BASIC
  • DIGEST Le pilote effectue une authentification HTTP DIGEST
  • NEGOTIATE Le pilote récupère un jeton NTLM ou Kerberos basé sur le protocole applicable pour l'authentification
  • PROPRIETARY Le pilote ne génère pas un jeton NTLM ou Kerberos. Vous devez fournir ce jeton dans l'en-tête d'autorisation de la requête HTTP
 BASIC
Détection automatique du proxy Indique si oui ou non il faut utiliser les paramètres proxy du système. Définissez ProxyAutoDetect sur FALSE pour utiliser les paramètres de proxy personnalisés. Cela a priorité sur les autres paramètres de proxy. vrai
Utilisateur proxy

Nom d'utilisateur à utiliser pour l'authentification avec le proxy ProxyServer.

Les options ProxyUser et ProxyPassword sont utilisées pour se connecter et s'authentifier par rapport au proxy HTTP spécifié dans ProxyServer.

Vous pouvez sélectionner l'un des types d'authentification disponibles dans ProxyAuthScheme. Si vous utilisez une authentification HTTP, définissez-le sur le nom d'utilisateur d'un utilisateur reconnu par le proxy HTTP. Si vous utilisez une authentification Windows ou Kerberos, définissez cette propriété sur un nom d'utilisateur dans l'un des formats suivants :

  • utilisateur@domaine
  • domaine\utilisateur
 john_doe@exemple.com
Mot de passe proxy

Mot de passe à utiliser pour l'authentification avec le proxy ProxyServer.

Cette propriété est utilisée pour l'authentification à un serveur proxy HTTP prenant en charge l'authentification NTLM (Windows), Kerberos ou HTTP. Pour spécifier le proxy HTTP, vous pouvez définir ProxyServer et ProxyPort. Pour spécifier le type d'authentification, définissez ProxyAuthScheme.

Si vous utilisez l'authentification HTTP, définissez en outre ProxyUser et ProxyPassword sur le proxy HTTP.

Si vous utilisez une authentification NTLM, définissez ProxyUser et ProxyPassword sur votre mot de passe Windows. Vous en aurez peut-être également besoin pour effectuer une authentification Kerberos

  
Serveur proxy

Nom d'hôte ou adresse IP d'un proxy via lequel acheminer le trafic HTTP.

Nom d'hôte ou adresse IP d'un proxy via lequel acheminer le trafic HTTP. Le pilote peut utiliser les types d'authentification HTTP, Windows (NTLM) ou Kerberos pour s'authentifier à un proxy HTTP.

Par défaut, le pilote utilise le proxy du système. Si vous devez utiliser un autre proxy, définissez ProxyAutoDetect sur faux.

 206.174.193.115
Port proxy Port TCP sur lequel le proxy ProxyServer s'exécute. 80
Type de proxy SSL

Type SSL à utiliser pour la connexion au proxy ProxyServer :

  • AUTO Si l'URL est une URL HTTPS, le connecteur utilisera l'option TUNNEL. Si l'URL est une URL HTTP, le connecteur utilisera l'option NEVER (par défaut).
  • ALWAYS la connexion est toujours SSL activée
  • NEVER la connexion n'est pas SSL activée
  • TUNNEL la connexion s'effectue via un proxy de tunneling : le serveur proxy ouvre une connexion vers l'hôte distant et le trafic est échangé par le proxy
 AUTO