Enterprise-Funktion

BI-Export für Power BI, Tableau und Excel

Ein einziger OData-v4-Endpunkt. Sechs Entitätssätze. Audit-sichere Antwort-Header, die jede Zahl auf eine Zeile im CarbonTrace-Audit-Log zurückführen. Verbinden Sie Ihr bevorzugtes BI-Tool in unter zehn Minuten.

BI-Export einrichtenSchnellstart

Endpunkt

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

Authentifizieren Sie sich mit einem CarbonTrace-API-Schlüssel (beginnt mit ct_live_), für den der BI-Export aktiviert ist. Verwenden Sie HTTP-Basic-Authentifizierung: API-Schlüssel als Benutzername, leeres Passwort. Oder Authorization: Bearer ct_live_….

Vier Persona-Dashboards

Erstellen Sie diese Dashboards in Power BI oder Tableau mit demselben Datenmodell, das wir mit unseren In-App-Widgets ausliefern (N70).

CIO

Gesamter IT-Fußabdruck, Jahresvergleichstrend, emissionsstärkste Kategorien, Verhältnis von Ausgaben zu CO₂.

  • •Gesamter Fußabdruck (kg CO₂e)
  • •Jahreswachstum %
  • •Kosten pro kg CO₂e

ESG-Verantwortliche/r

SBTi-Fortschritt vs. Zielpfad, CSRD-ESRS-E1-Angaben, Scope-Aufschlüsselung.

  • •SBTi-Tempolücke
  • •Scope 3 Kat. 1 + 2 + 11
  • •CSRD-fertige Tabellen

Einkauf

Lieferantenvergleich, Wiederverwendung vs. Neukauf, vermiedene Emissionen durch Aufbereitung.

  • •Ø kg CO₂e pro Gerät
  • •Einsparung durch Wiederverwendung %
  • •Top-Lieferanten

Audit

Methodik-Nachweis, Konfidenzverteilung, Abdeckung der Datenquellen.

  • •% Zeilen mit hoher Konfidenz
  • •Abdeckung der Methodikkarten
  • •Quellenmix (Blancco / PCF / parametrisch)

Schnellstart

Power BI Desktop

  1. Öffnen Sie Power BI Desktop → Get Data → OData feed
  2. URL: https://carbontrace.cloud/api/v1/odata
  3. Authentifizierung: Basic. Benutzername = Ihr API-Schlüssel. Lassen Sie das Passwort leer.
  4. Wählen Sie die gewünschten Entitätssätze aus und klicken Sie auf Load.
  5. Erstellen Sie Visualisierungen. Klicken Sie auf Refresh, um die neuesten Daten abzurufen.
Beispiel für ein DAX-Measure:
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

  1. Connect → Web Data Connector
  2. URL: https://carbontrace.cloud/connectors/tableau/
  3. Fügen Sie den OData-Endpunkt und Ihren API-Schlüssel ein und klicken Sie auf Connect to Tableau
  4. Alle sechs Entitätssätze erscheinen als Tabellen — ziehen Sie sie auf die Arbeitsfläche.

Excel

  1. Data → Get Data → From Other Sources → From OData Feed
  2. URL: https://carbontrace.cloud/api/v1/odata
  3. Authentifizierung: Basic. Benutzername = API-Schlüssel, Passwort leer.
  4. Wählen Sie Tabellen aus und laden Sie sie in das Arbeitsblatt. Power Query aktualisiert bei Bedarf.

Entitätssätze

Assets

Denormalisierter Asset-Fakt — jedes Gerät in Ihrem Bestand mit vollständiger CO₂-Aufschlüsselung.

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

Certificates

Ausgestellte CO₂-Zertifikate — öffentliche Aussagen + Compliance-Audit-Trail.

certificate_numberbrand, mpnfootprint_total_kgissued_atis_public

Products

Die Produktbibliothek Ihrer Organisation.

brand, mpn, categoryweight_kglast_calculated_at

EmissionFactors

Für Ihre Organisation sichtbare Emissionsfaktoren (Plattform + organisationsspezifisch).

factor_typevalue, unitsourcedata_year

SbtiTargets

Science-Based Targets — Basislinien, Ziele und Zielpfade.

baseline_year, target_yearbaseline_emissions_kgtarget_reduction_pctscope

MonthlyEmissions

Vorab aggregierte monatliche Emissionen nach Kategorie und Land — bereit für Zeitreihendiagramme.

monthcategorycountrytotal_kg_co2e

Unterstützte Filtersyntax

Eine sichere Teilmenge von OData v4. Nicht unterstützte Operatoren geben 501 Not Implemented zurück, samt der Liste des Unterstützten im Antworttext — keine stillen Fehler.

UnterstütztBeispiel
eqcategory eq 'laptop'
nestatus ne 'retired'
gt / ge / lt / letotal_kg_co2e gt 200
and / orcountry eq 'BE' and category eq 'laptop'
startswith()startswith(department, 'Finance')
contains()contains(product_name, 'Pro')
endswith()endswith(serial_number, 'X1')
Nicht unterstütztGrund
$expandEntitäten sind vorab denormalisiert. Verwenden Sie MonthlyEmissions für Aggregationen.
$applyServerseitige Aggregation ist in v1 nicht verfügbar — aggregieren Sie clientseitig.
$batchDer BI-Export ist strikt schreibgeschützt. Verwenden Sie eine einzige Anfrage pro Entität.
any() / all() / has()Sammlungsprädikate werden in v1 nicht unterstützt.
$compute / $searchNicht in v1. Verwenden Sie $select + clientseitige Berechnung.

Forensische Nachweis-Header

Jede OData-Antwort enthält drei Header, die die zurückgegebenen Zeilen mit dem CarbonTrace-Audit-Log verknüpfen. Verwenden Sie sie in Compliance-Workflows, um nachzuweisen, dass ein bestimmter Dashboard-Wert aus einer spezifischen, manipulationssicheren Abfrage stammt.

X-CarbonTrace-ProofID der audit_log-Zeile, die diese Abfrage protokolliert. Hash-verkettet gemäß N128.
X-CarbonTrace-Proof-HashSHA256 der zurückgegebenen Zeilen (deterministisch: Zeilen sind bereits sortiert).
X-CarbonTrace-Data-FreshnessISO-Zeitstempel der letzten zugrunde liegenden Asset-/Berechnungsaktualisierung.

Sandbox-Modus

Testen Sie Ihre Dashboards, bevor Sie echte Daten übertragen. Verwenden Sie einen Sandbox-Schlüssel (ct_test_…) gegen denselben OData-Endpunkt — Sie erhalten 50 fiktive Assets, 20 Zertifikate, 15 Produkte und 24 Monate aggregierter Emissionen für eine Organisation namens SandboxCorp. Alle Antworten sind deterministisch, sodass Dashboards bei jeder Kundendemo identisch dargestellt werden.

Ratenbegrenzungen

BI-Tools verursachen viele kleine Aufrufe pro Aktualisierung. Der BI-Export nutzt ein dediziertes Kontingent von 500.000 Anfragen/Tag und 2.000/Minute pro API-Schlüssel, getrennt vom normalen Enterprise-API-Kontingent (100k/Tag). Sandbox-Schlüssel teilen sich ein kleineres Kontingent von 20k/Tag.

FAQ

Warum keine Looker-Unterstützung?
LookML spricht kein OData. Ein nativer Looker-Block ist als N86b geplant — abonnieren Sie ihn über Einstellungen → Benachrichtigungen, wenn Sie benachrichtigt werden möchten.
Kann ich Daten zurückschreiben?
Nein. Der BI-Export ist schreibgeschützt. POST/PUT/PATCH/DELETE geben 405 zurück. Verwenden Sie die reguläre REST-API für Mutationen.
Wie plane ich eine Aktualisierung?
Auf der Seite des BI-Tools. Power BI Service, Tableau Server und Excel über Power Query können OData-Aktualisierungen alle nach einem Zeitplan ausführen.
Werden die Daten zwischengespeichert?
Nein. Jede OData-Antwort liest direkt aus Live-Postgres-Views mit Sicherheit auf Zeilenebene. Keine veralteten materialisierten Views.
Was ist mit DSGVO / Datenresidenz?
Alle Daten verbleiben in eu-west-1. Kein Export in Drittanbieter-Clouds. Ihr API-Schlüssel ist an Ihre Organisation gebunden — organisationsübergreifende Abfragen werden auf der Sicherheitsebene der Zeilen blockiert.
Kann ich mich von meinem eigenen ETL-Tool aus verbinden?
Ja. OData v4 ist ein W3C-Standardprotokoll. Jeder HTTP-Client, der OData (oder einfach JSON) spricht, funktioniert. Den vollständigen Vertrag finden Sie in der OpenAPI-Spezifikation.

Bereit, Ihr BI-Tool zu verbinden?

Aktivieren Sie den BI-Export für einen API-Schlüssel in den Einstellungen, und schon kann es losgehen.

BI-Export-Einstellungen öffnenREST-API-Dokumentation