Introduction
Pour synchroniser les valeurs entre Table et Pingview, vous devrez créer des requêtes sur les tables souhaitées. Vous devrez aussi préalablement créer un jeton API sécurisé :
1. Choisissez la base que vous souhaitez connecter à Pingview
Ouvrez-la dans votre navigateur.
Vous retrouverez sur le menu de gauche une liste de vos différentes tables, sélectionnez celle qui vous intéresse.
Cela vous permet d’identifier dans l’URL de votre navigateur des informations utiles à la requête que vous construirez par la suite.
Requête type
Les identifiants (chiffres) indiqués sont à remplacer avec les vôtres.
Voici la requête type que vous devez écrire pour synhcroniser une table de Table à Pingview :
https://table.pingflow.io/api/database/rows/table/140/?view_id=2139
- 140 = l’identifiant de votre table
- view_id=2139 = la vue à récupérer (Table vous permet de recupérer directement une vue précise, que vous auriez au préalable filtré ou trié)
Paramètres utiles pour votre requête
D’autres paramètres utiles peuvent être ajoutés dans votre requête pour affiner le résultat.
user_field_names=true
Permet de récupérer les noms des champs définis dans Table directement dans Pingview
order_by=
Permet de trier les données dans l’ordre souhaité. Après le =
indiquez le nom de votre champ. Vous pouvez insérerez un -
avant le nom du champ pour inverser l’ordre
Avec ces 2 paramètres, la requête initiale deviendrait donc :
https://table.pingflow.io/api/database/rows/table/140/ view_id=2139&user_field_names=true&order_by=Date
Autres paramètres utiles
&filter_type=OR&filter__field_14960__contains=tous&filter__field_14960__contains={%Zone%}
Permet de filtrer les résultats selon au moins 2 champs.
- OR indique que le filtre prendra en compte la valeur du premier filtre ou celle du deuxième.
- AND indique que le filtre prendra en compte la valeur du premier filtre et celle du deuxième.
-
Il y a deux tirets du bas après le terme filter et après l’identifiant de la colonne
-
Il faut bien préciser field_XXXXX (avec X étant la valeur du champ).
-
Dans cette requête d’exemple nous avons également utilisé une variable Pingview {%variable%}
Vous retrouvez toutes ces infos, ainsi que les valeurs de vos champs dans la documentation de l’API, accessible sur n’importe quelle base en cliquant sur les trois petits points gris à côté du nom de la base.
2. Créez une source Webservice dans Pingview
Copiez-coller votre requête dans le champ URL
Allez dans les paramètres avancés :
- Saisissez Authorization dans le premier champ, Token dans le deuxième champ.
- Insérez votre clé API après Token (laissez un espace entre Token et votre clé).
3. Testez votre source et vérifiez que vous recevez bien des informations.
La réponse renvoyée devrait ressembler à cela :
Cliquez ensuite sur la petite flèche mise en surbrillance afin de déclarer votre tableau « records » comme racine. Il ne vous reste plus qu’à accéder aux différents fields ( champs ) et sélectionner ceux que vous souhaitez récupérer pour afficher dans Pingview