Le pack Excel turf.bzh, pas à pas

Étape 1Vérifier votre version d'Excel

Le classeur est conçu pour Excel pour Windows : Microsoft 365, Excel 2021, 2019 ou 2016, dont Power Query fait partie d'origine (onglet Données, groupe Récupérer et transformer les données). Les captures et les animations de ce tutoriel viennent d'Excel pour Microsoft 365, en thème sombre : les couleurs d'Excel peuvent différer chez vous, les noms des boutons et des onglets restent les mêmes.

Étape 2Réunir la licence et la clé

Le classeur lit l'API avec votre clé personnelle. Elle suppose 2 conditions : la Licence API, achetée une seule fois, et un abonnement turf.bzh actif. La clé se génère sur la page Ma clé API, où elle ne s'affiche qu'une fois : copiez-la tout de suite. Le chapitre 6.2 du guide détaille cette page, captures à l'appui.

Étape 3Télécharger et ouvrir le classeur

Depuis la page Modèles prêts à l'emploi, cliquez sur « Télécharger le pack Excel ». Enregistrez le fichier turfbzh-pack-excel.xlsx sur votre ordinateur, par exemple dans le dossier Documents, puis ouvrez-le avec Excel. Si Excel affiche le bandeau « Affichage protégé », cliquez sur « Activer la modification » : sans cela, les requêtes ne peuvent pas s'actualiser.

Étape 1Ouvrir l'onglet Réglages

À l'ouverture, le classeur affiche la feuille Réglages. Les 3 premiers onglets (repères 1 à 3) sont des feuilles de service : Réglages, Mode d'emploi et Catalogue. Les onglets bleus (repère 4) sont les feuilles de données, une par point d'accès de l'API ; ils portent un préfixe qui désigne leur groupe (J, P, C, H, N ou R, voir le chapitre 4). Dans Réglages, seules les cellules jaunes de la colonne B se modifient.

Agrandir

Étape 2Coller la clé

Cliquez dans la cellule jaune Clé API (repère 1 de la première capture), collez la clé, puis validez par Entrée. Le contrôle de la clé (repère 2) passe de « Collez votre clé ci-dessus » à « Format correct ». Ce contrôle ne porte que sur la forme de la clé, qui commence par tbz_live_ ; sa validité est confirmée à la première actualisation.

Agrandir

Agrandir

Étape 3Lancer l'actualisation

Ouvrez l'onglet Données du ruban (repère 1), puis cliquez sur Actualiser tout (repère 2). Le bouton Requêtes et connexions (repère 3) ouvre le volet qui suit le chargement.

Agrandir

Pour une première fois, une voie plus prudente existe : actualisez d'abord la seule feuille R Compte. Cliquez dans son tableau, puis dans Données, ouvrez la flèche sous Actualiser tout et choisissez Actualiser. Votre licence et votre abonnement s'affichent et la clé est confirmée en 1 seul appel. Ensuite, chaque feuille s'actualise de la même façon, ou toutes d'un coup avec Actualiser tout.

Étape 4Répondre à la fenêtre d'accès au contenu web

À la première actualisation, Excel demande comment accéder à https://www.turf.bzh (fenêtre « Accéder au contenu web »). Gardez Anonyme, sélectionné par défaut (repère 1), puis cliquez sur Se connecter (repère 2). Si une liste de niveaux est proposée, gardez https://www.turf.bzh/. La clé n'a pas à être saisie dans cette fenêtre : le classeur la transmet lui-même, dans l'en-tête Authorization de chaque appel.

Agrandir

Si Excel demande aussi un niveau de confidentialité, choisissez Public, ou cochez Ignorer les niveaux de confidentialité. Excel mémorise ces réponses sur votre poste, jamais dans le classeur.

Étape 5Suivre le chargement

Le volet Requêtes et connexions s'ouvre à droite. Il annonce le nombre de requêtes du classeur (repère 1 : 71, expliquées au chapitre 8) et, pour chacune, le nombre de lignes chargées (repère 2 : 455 lignes pour J_Partants au 20/10/2026). Une requête qui indique « 1 ligne chargée » a répondu sans donnée à afficher : au moment de la capture, les résultats du jour n'étaient pas publiés, comme l'explique le chapitre 5.

Agrandir

Étape 6Lire le premier tableau

Ouvrez la feuille J Programme : elle contient les courses du jour, une ligne par course. La ligne d'en-tête (repère 1) porte les boutons de tri et de filtre d'Excel. La course du Quinté+ (repère 2) se reconnaît à la valeur 1 dans la colonne is_quinte. Le tableau se nomme J_Programme, le nom de la feuille avec un tiret bas, et commence à la cellule A1.

Agrandir

Étape 1Changer la date du jour

Par défaut, la cellule Date du jour contient la date courante (la formule =AUJOURDHUI()), donc le classeur lit la journée en cours. Pour consulter une journée passée, saisissez une autre date, dans le format de votre Excel (ici 19/10/2026), puis validez par Entrée. La période se recalcule d'elle-même : Période : au reprend la date du jour et Période : du recule de 6 jours. Il reste à actualiser la feuille voulue : l'animation montre le geste complet, avec J Programme.

Étape 2Régler la période des feuilles P

Les feuilles P (P Programme, P Partants, P Résultats et P Rapports) lisent la période définie par Période : du et Période : au, avec un appel par jour. La période compte 93 jours au plus. La ligne Contrôle des dates de Réglages indique le nombre de jours et d'appels d'une feuille P, ou signale une période invalide (« Au doit être postérieur à Du », « Plage trop longue (93 jours au plus) »).

La feuille J Stats premium lit aussi la période, par tranches de 31 jours. Sur la capture, la période par défaut commence 6 jours avant la date du jour, soit le 14/10/2026.

Agrandir

Étape 3Actualiser une feuille, ou toutes

Pour une seule feuille, cliquez dans son tableau, puis dans Données, ouvrez la flèche sous Actualiser tout et choisissez Actualiser. Un clic droit sur le tableau, puis Actualiser, fait la même chose. Actualiser tout lance toutes les feuilles d'un coup : comptez une soixantaine d'appels avec la période par défaut de 7 jours, et quelques minutes si le quota de 60 appels par minute est atteint (le classeur attend et reprend tout seul).

Étape 1Les 6 groupes de feuilles de données

Le nom de chaque feuille de données commence par une lettre qui désigne son groupe.

Étape 2Lire le Catalogue

La feuille Catalogue détaille chaque feuille de données sur une ligne. La colonne Feuille (repère 1) est un lien qui ouvre la feuille. La colonne Point d'accès (repère 2) donne l'adresse de l'API appelée, par exemple GET /v1/programme. La colonne Réglages lus (repère 3) liste les cellules de Réglages dont dépend la feuille. Plus à droite, le Catalogue donne le contenu, les colonnes, l'adresse sans la clé et un lien d'essai pour rejouer l'appel dans un navigateur.

Agrandir

Étape 3Relire le mode d'emploi du classeur

La feuille Mode d'emploi reprend l'essentiel de ce tutoriel en 8 sections numérotées : démarrer en 3 étapes (repère 1), la première actualisation (repère 2), lire une feuille de données, les groupes de feuilles, les quotas, l'adaptation du classeur, les questions fréquentes et l'assistance.

Agrandir

Étape 1Trier, filtrer et calculer

Chaque feuille de données ne contient que son tableau, à partir de la cellule A1 : Excel insère ou supprime des colonnes entières à chaque changement de structure, c'est pourquoi rien d'autre n'y est placé. Les nombres sont typés en nombres et les dates en dates : vous pouvez trier, filtrer et calculer directement. Le nom du tableau (par exemple J_Partants) s'utilise dans vos formules et vos tableaux croisés dynamiques.

Pour vos propres calculs, ouvrez une feuille vierge et faites-y référence au tableau, plutôt que d'écrire dans la feuille de données.

Étape 2Comprendre les messages de la colonne info

Avant la première actualisation, chaque tableau ne contient qu'une colonne info, avec une consigne. Après actualisation, une seule colonne info signifie que l'appel a abouti mais que rien n'est disponible pour ces réglages : une date sans course, une course sans cotes. Le message l'explique (repère 1).

Agrandir

Si le tableau affiche les colonnes statut_http, erreur_code, erreur_message, conseil et adresse, l'API a refusé l'appel. Le conseil indique quoi corriger ; l'adresse permet de rejouer l'appel dans un navigateur. Le chapitre 9 récapitule les cas.

Étape 3Afficher correctement les identifiants

Excel affiche parfois en notation scientifique (par exemple 1,23E+11) un identifiant très long, comme ceux des colonnes idcheval ou idjockey. Sélectionnez la colonne, ouvrez Accueil, puis le menu Format de nombre, choisissez Nombre et réglez 0 décimale. La valeur n'est pas modifiée, seul son affichage change.

Étape 1Désigner une course

Les feuilles C lisent la date du jour et le réglage Course, un code de réunion et de course compris entre R1C1 et R9C16. Ce code est celui de la colonne code_course de J Programme (chapitre 2). Saisissez-le dans la cellule jaune Course, puis actualisez la feuille C voulue : C Partants pour les engagés, C Cotes pour les cotes, C Arrivée pour l'arrivée, C Dossier pour le dossier de la course. Pour une course passée, changez d'abord la date du jour (chapitre 3).

Étape 2Trouver un cheval

Saisissez un nom, ou un début de nom, dans Recherche cheval, puis actualisez H Recherche. Repérez le cheval et reportez son identifiant (colonne idcheval) dans la cellule Identifiant cheval. Les feuilles H Historique, H Stats, H Lectures et H Renifleur lisent alors ce cheval. L'identifiant figure aussi dans la colonne idcheval de J Partants et de J Quinté.

Étape 3Trouver une personne

Choisissez le Type de personne dans la liste de Réglages (jockey, driver, entraîneur, propriétaire ou éleveur), saisissez un nom dans Recherche personne et actualisez N Recherche. Reportez la valeur de sa colonne id dans Identifiant personne, puis actualisez N Stats.

Étape 4Affiner avec les filtres facultatifs

Plusieurs réglages sont facultatifs : laissés vides, ils ne filtrent rien. La colonne « Valeurs admises » de Réglages rappelle ce que chacun accepte.

Étape 1Saisir ses paris

Saisissez le solde de départ (cellule B3, à remplacer), puis un pari par ligne dans les colonnes A à G, qui sont les cellules claires (repère 1) : Date, Course, Type de pari, Sélection, Mise, Cote et Gain brut. Les colonnes Résultat net et Solde (repère 2) se calculent seules : le résultat net est le gain brut moins la mise, et le solde est le solde de départ plus la somme des résultats nets. La feuille compte 200 lignes de paris. La ligne 5 est un exemple à remplacer.

Agrandir

Étape 1Respecter les quotas

L'API accepte 60 appels par minute et 10 000 par jour. Au-delà, elle répond 429 : le classeur attend le délai demandé et réessaie jusqu'à 3 fois. Si l'erreur persiste, patientez une minute et actualisez la seule feuille utile.

Pour constituer un historique, avancez par périodes de 31 jours avec les feuilles P, en copiant les valeurs obtenues dans un autre classeur entre 2 périodes. Pour de gros volumes, les exports mensuels de la feuille R Exports fournissent des fichiers complets et scellés : c'est la voie la plus économe. Chaque appel à ChatBZH consomme des crédits IA : la feuille R Chat BZH ne lance rien tant que le réglage ChatBZH actif vaut Non.

Étape 2Protéger sa clé

Le classeur contient votre clé en clair dans la cellule Clé API, et ne la transmet qu'à www.turf.bzh. Gardez-le sur votre ordinateur. Avant de l'envoyer à quelqu'un ou de le publier, effacez cette cellule. En cas de doute, régénérez la clé sur la page Ma clé API : l'ancienne est révoquée aussitôt, et la nouvelle se colle dans Réglages.

Étape 3Adapter le classeur

Dans Données, le bouton Requêtes et connexions affiche les 71 requêtes du classeur (repère 1) : les 38 requêtes de données, 31 fonctions partagées et 2 requêtes d'appui. Les fonctions, dont le nom commence par fn (repère 2), gèrent les réglages, l'appel, les erreurs et le typage. Une requête de données tient en quelques lignes.

Agrandir

Un clic droit sur une requête, puis Modifier, ouvre l'éditeur Power Query ; Dupliquer crée une copie pour un autre usage. Pour ajouter un réglage, nommez une cellule de la feuille Réglages (Formules, puis Gestionnaire de noms) et lisez-la dans une requête avec fnTexte("NomDeLaCellule").

Étape 1Le tableau des erreurs et de leurs remèdes