Fonctionnalité Enterprise

Export BI pour Power BI, Tableau et Excel

Un seul point de terminaison OData v4. Six jeux d'entités. Des en-têtes de réponse à l'épreuve de l'audit qui relient chaque chiffre à une ligne du journal d'audit CarbonTrace. Connectez votre outil de BI préféré en moins de dix minutes.

Configurer l'export BI Démarrage rapide

Point de terminaison

https://carbontrace.cloud/api/v1/odata

Authentifiez-vous avec une clé d'API CarbonTrace (commençant par ct_live_) pour laquelle l'export BI est activé. Utilisez l'authentification HTTP Basic : clé d'API comme nom d'utilisateur, mot de passe vide. Ou Authorization: Bearer ct_live_….

Quatre tableaux de bord par persona

Construisez ces tableaux de bord dans Power BI ou Tableau à l'aide du même modèle de données que celui fourni avec nos widgets intégrés (N70).

DSI

Empreinte IT totale, tendance annuelle, catégories les plus émettrices, ratio dépenses/carbone.

•Empreinte totale (kg CO₂e)
•Croissance annuelle %
•Coût par kg CO₂e

Responsable ESG

Progression SBTi vs trajectoire, déclarations CSRD ESRS E1, répartition par scope.

•Écart de rythme SBTi
•Scope 3 Cat. 1 + 2 + 11
•Tableaux prêts pour la CSRD

Achats

Comparaison de fournisseurs, réemploi vs achat neuf, émissions évitées grâce au reconditionnement.

•Moy. kg CO₂e par appareil
•Économies par réemploi %
•Principaux fournisseurs

Audit

Traçabilité méthodologique, distribution de la confiance, couverture des sources de données.

•% de lignes à haute confiance
•Couverture des fiches méthodologiques
•Mix de sources (Blancco / PCF / paramétrique)

Démarrage rapide

Power BI Desktop

Ouvrez Power BI Desktop → Get Data → OData feed
URL : https://carbontrace.cloud/api/v1/odata
Authentification : Basic. Nom d'utilisateur = votre clé d'API. Laissez le mot de passe vide.
Sélectionnez les jeux d'entités souhaités et cliquez sur Load.
Créez des visuels. Cliquez sur Refresh pour récupérer les dernières données.

Exemple de mesure DAX :

Total Footprint (kg) = SUM( Assets[total_kg_co2e] )

YoY Growth % =
  VAR curr = CALCULATE( [Total Footprint (kg)], YEAR(Assets[purchase_date]) = YEAR(TODAY()) )
  VAR prev = CALCULATE( [Total Footprint (kg)], YEAR(Assets[purchase_date]) = YEAR(TODAY())-1 )
  RETURN DIVIDE( curr - prev, prev )

Tableau Desktop

Connect → Web Data Connector
URL : https://carbontrace.cloud/connectors/tableau/
Collez le point de terminaison OData et votre clé d'API, puis cliquez sur Connect to Tableau
Les six jeux d'entités apparaissent sous forme de tables — faites-les glisser sur le canevas.

Excel

Data → Get Data → From Other Sources → From OData Feed
URL : https://carbontrace.cloud/api/v1/odata
Authentification : Basic. Nom d'utilisateur = clé d'API, mot de passe vide.
Sélectionnez les tables et chargez-les dans la feuille de calcul. Power Query s'actualise à la demande.

Jeux d'entités

Assets

Fait d'actif dénormalisé — chaque appareil de votre inventaire avec une répartition carbone complète.

asset_idbrand, mpn, categorytotal_kg_co2e + phase breakdownpurchase_date, retirement_datecountry, department, cost_center

Certificates

Certificats CO₂ émis — déclarations publiques + piste d'audit de conformité.

certificate_numberbrand, mpnfootprint_total_kgissued_atis_public

Products

La bibliothèque de produits de votre organisation.

brand, mpn, categoryweight_kglast_calculated_at

EmissionFactors

Facteurs d'émission visibles par votre organisation (plateforme + spécifiques à l'organisation).

factor_typevalue, unitsourcedata_year

SbtiTargets

Science-Based Targets — références, objectifs et trajectoires.

baseline_year, target_yearbaseline_emissions_kgtarget_reduction_pctscope

MonthlyEmissions

Émissions mensuelles pré-agrégées par catégorie et par pays — prêtes pour les graphiques de séries temporelles.

monthcategorycountrytotal_kg_co2e

Syntaxe de filtre prise en charge

Un sous-ensemble sûr d'OData v4. Les opérateurs non pris en charge renvoient 501 Not Implemented avec la liste de ce qui est pris en charge dans le corps de la réponse — pas d'échecs silencieux.

Pris en charge	Exemple
eq	category eq 'laptop'
ne	status ne 'retired'
gt / ge / lt / le	total_kg_co2e gt 200
and / or	country eq 'BE' and category eq 'laptop'
startswith()	startswith(department, 'Finance')
contains()	contains(product_name, 'Pro')
endswith()	endswith(serial_number, 'X1')

Non pris en charge	Raison
$expand	Les entités sont pré-dénormalisées. Utilisez MonthlyEmissions pour les agrégats.
$apply	L'agrégation côté serveur n'est pas disponible en v1 — agrégez côté client.
$batch	L'export BI est strictement en lecture seule. Utilisez une seule requête par entité.
any() / all() / has()	Les prédicats de collection ne sont pas pris en charge en v1.
$compute / $search	Pas en v1. Utilisez $select + calcul côté client.

En-têtes de preuve forensique

Chaque réponse OData comporte trois en-têtes qui relient les lignes renvoyées au journal d'audit CarbonTrace. Utilisez-les dans vos flux de conformité pour prouver qu'une valeur donnée d'un tableau de bord provient d'une requête spécifique et inviolable.

X-CarbonTrace-ProofID de la ligne audit_log enregistrant cette requête. Chaînée par hachage selon N128.

X-CarbonTrace-Proof-HashSHA256 des lignes renvoyées (déterministe : les lignes sont déjà ordonnées).

X-CarbonTrace-Data-FreshnessHorodatage ISO de la dernière mise à jour sous-jacente d'actif/de calcul.

Mode bac à sable

Testez vos tableaux de bord avant d'envoyer des données réelles. Utilisez une clé bac à sable (ct_test_…) sur le même point de terminaison OData — vous obtenez 50 actifs fictifs, 20 certificats, 15 produits et 24 mois d'émissions agrégées pour une organisation nommée SandboxCorp. Toutes les réponses sont déterministes, de sorte que les tableaux de bord s'affichent de manière identique pour chaque démonstration client.

Limites de débit

Les outils de BI consomment de nombreux petits appels par actualisation. L'export BI utilise un quota dédié de 500 000 requêtes/jour et 2 000/minute par clé d'API, distinct du quota normal de l'API Enterprise (100k/jour). Les clés bac à sable partagent un quota plus réduit de 20k/jour.

FAQ

Pourquoi pas de prise en charge de Looker ?: LookML ne parle pas OData. Un bloc Looker natif est prévu sous le nom N86b — abonnez-vous via Paramètres → Notifications pour être averti.
Puis-je réécrire des données ?: Non. L'export BI est en lecture seule. POST/PUT/PATCH/DELETE renvoient 405. Utilisez l'API REST classique pour les mutations.
Comment planifier une actualisation ?: Du côté de l'outil de BI. Power BI Service, Tableau Server et Excel via Power Query peuvent tous exécuter des actualisations OData selon un planning.
Les données sont-elles mises en cache ?: Non. Chaque réponse OData lit directement les vues Postgres en direct avec sécurité au niveau des lignes. Aucune obsolescence de vue matérialisée.
Qu'en est-il du RGPD / de la résidence des données ?: Toutes les données restent dans eu-west-1. Aucun export vers un cloud tiers. Votre clé d'API est liée à votre organisation — les requêtes inter-organisations sont bloquées au niveau de la couche de sécurité des lignes.
Puis-je me connecter depuis mon propre outil ETL ?: Oui. OData v4 est un protocole standard du W3C. Tout client HTTP capable de parler OData (ou simplement JSON) fonctionne. Consultez la spécification OpenAPI pour le contrat complet.

Prêt à connecter votre outil de BI ?

Activez l'export BI sur une clé d'API dans les Paramètres et vous êtes prêt.

Ouvrir les paramètres d'export BI Documentation de l'API REST