> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Fabric für Langdock konfigurieren

> Bereite als Fabric-Owner oder Workspace-Admin eine API für GraphQL vor und konfiguriere die Integration in Langdock.

Nutze diesen Guide, wenn du Admin des Fabric-Workspace, Owner der API für GraphQL oder Admin des Langdock-Workspace bist. Nachdem du die Konfiguration abgeschlossen hast, müssen einzelne User nur noch ihre Verbindung hinzufügen. Entscheidungen zu Zugriff und Schreiboperationen findest du unter [Zugriff und Mutationen](./permissions-and-mutations).

## Vor dem Start

Du benötigst:

* Einen Fabric-Workspace mit Fabric-, Trial- oder Premium-Kapazität.

## API für GraphQL in Fabric einrichten

Bereite als Admin des Fabric-Workspace oder Owner der API die API für Langdock vor:

<Steps>
  <Step title="API für GraphQL erstellen">
    Erstelle im Fabric-Workspace ein Element vom Typ **API für GraphQL (API for GraphQL)**.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/Qf5Qu5evYldeh9ke/de/images/integrations/microsoft-fabric/create-api.png?fit=max&auto=format&n=Qf5Qu5evYldeh9ke&q=85&s=f8950a4c9b0ae97e7c0baf6e021922d1" alt="API für GraphQL im Bereich Neues Element in Microsoft Fabric" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="de/images/integrations/microsoft-fabric/create-api.png" />
    </Frame>
  </Step>

  <Step title="Verbindung der API zu ihren Datenquellen wählen">
    Wähle **Einmaliges Anmelden (Single sign-on, SSO)** (empfohlen), wenn User mit ihrer eigenen Identität auf die Quelle zugreifen sollen. Wähle **Gespeicherte Anmeldeinformationen (Saved credentials)**, wenn alle User der API eine zentral verwaltete Quellidentität verwenden sollen. Jede GraphQL-API verwendet für ihre Quellen einen einheitlichen Modus.

    Wenn du unsicher bist, welche Option passt, [vergleiche, wie die Authentifizierungsmodelle Identitäten, Berechtigungen und Zugriffe handhaben](./permissions-and-mutations#datenzugriff-in-fabric-auswählen).

    <Frame>
      <img src="https://mintcdn.com/langdock-34/Qf5Qu5evYldeh9ke/de/images/integrations/microsoft-fabric/connectivity-option.png?fit=max&auto=format&n=Qf5Qu5evYldeh9ke&q=85&s=e80c6c581947b73b6bc64632fdd3c4b3" alt="Konnektivitätsdialog in Microsoft Fabric mit ausgewählter SSO-Authentifizierung" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="de/images/integrations/microsoft-fabric/connectivity-option.png" />
    </Frame>
  </Step>

  <Step title="Daten für die API auswählen">
    Füge die relevanten Datenquellen hinzu und wähle Tabellen, Views, gespeicherte Prozeduren und Spalten aus. Definiere Beziehungen zwischen Objekten derselben Quelle, wenn User zusammengehörige Datensätze in einer Abfrage abrufen sollen. Beziehungen sind zwischen Objekten derselben Quelle verfügbar.

    Richte das Schema auf den vorgesehenen Anwendungsfall aus und nimm nur die Objekte und Operationen auf, die User benötigen.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/Qf5Qu5evYldeh9ke/de/images/integrations/microsoft-fabric/choose-data.png?fit=max&auto=format&n=Qf5Qu5evYldeh9ke&q=85&s=345e6a1eb744b3748008f02cbb06271e" alt="Ausgewählte Tabellen, View und gespeicherte Prozedur im Dialog Daten auswählen in Microsoft Fabric" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="de/images/integrations/microsoft-fabric/choose-data.png" />
    </Frame>
  </Step>

  <Step title="Introspection aktivieren">
    Öffne **API-Einstellungen (API Settings)**, wähle **Introspection** aus und aktiviere sie. Introspection ist standardmäßig deaktiviert. Nach der Aktivierung kann Langdock Typen, Felder, Argumente, Abfragen und Mutationen erkennen. Diese Schemametadaten sind dann für alle User mit Zugriff auf den Endpunkt der API sichtbar.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/Qf5Qu5evYldeh9ke/de/images/integrations/microsoft-fabric/introspection.png?fit=max&auto=format&n=Qf5Qu5evYldeh9ke&q=85&s=e0b2f8d7c5d2394a3e1c3789eaf53331" alt="Aktivierte Introspektion in den Einstellungen einer API für GraphQL in Microsoft Fabric" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="de/images/integrations/microsoft-fabric/introspection.png" />
    </Frame>
  </Step>

  <Step title="Zugriff gewähren">
    Gib jedem User für das API-Element die Berechtigung **Ausführen von Abfragen und Mutationen (Run Queries and Mutations)**. Der Freigabedialog verwendet diese Bezeichnung. Unter **Direkter Zugriff (Direct access)** wird dieselbe Berechtigung als **Ausführen (Execute)** verwaltet.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/Qf5Qu5evYldeh9ke/de/images/integrations/microsoft-fabric/api-permission.png?fit=max&auto=format&n=Qf5Qu5evYldeh9ke&q=85&s=a107a7f7d16a066159b287778340763c" alt="Ausgewählte Berechtigung „Ausführen von Abfragen und Mutationen“ im Freigabedialog einer API für GraphQL in Microsoft Fabric" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="de/images/integrations/microsoft-fabric/api-permission.png" />
    </Frame>

    Bei SSO benötigt jeder User zusätzlich die erforderlichen Rechte auf jeder zugrunde liegenden Quelle. Bei gespeicherten Anmeldeinformationen benötigt stattdessen die gespeicherte Identität die erforderlichen Quellberechtigungen. Siehe [Lese- und Schreibzugriff steuern](./permissions-and-mutations#lese--und-schreibzugriff-steuern).
  </Step>

  <Step title="Schema aktualisieren und prüfen">
    Wähle nach dem Hinzufügen, Entfernen oder Ändern von Quellobjekten **Schema aktualisieren (Update schema)** und prüfe das Ergebnis im **Schema-Explorer (Schema explorer)**. So verwendet die API das aktuelle Quellschema.

    Führe in Fabric eine gezielte Abfrage aus und prüfe, ob die erwarteten Quellobjekte und Ergebnisse verfügbar sind, bevor du User verbindest.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/Qf5Qu5evYldeh9ke/de/images/integrations/microsoft-fabric/graphql-query.png?fit=max&auto=format&n=Qf5Qu5evYldeh9ke&q=85&s=b95a8c7326b44b0b2dfd670c41da603d" alt="GraphQL Editor in Microsoft Fabric mit einer Abfrage zu regionalen Umsätzen und erfolgreichen Ergebnissen" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="de/images/integrations/microsoft-fabric/graphql-query.png" />
    </Frame>
  </Step>
</Steps>

## Integration in Langdock aktivieren

Aktiviere als Admin des Langdock-Workspace Microsoft Fabric. Langdock kann anschließend APIs finden, ihre Schemas prüfen, Daten abfragen und Mutationen verwenden, ohne dass User IDs oder URLs der Endpunkte angeben müssen. Die Mutationsaktion fragt vor der Ausführung nach einer Bestätigung.

<Frame>
  <img src="https://mintcdn.com/langdock-34/Qf5Qu5evYldeh9ke/de/images/integrations/microsoft-fabric/action-access.png?fit=max&auto=format&n=Qf5Qu5evYldeh9ke&q=85&s=ec76b4f3166c47355d77a33238b96464" alt="Aktivierte Aktionen zum Lesen und für Mutationen in den Einstellungen des Langdock-Workspace" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="de/images/integrations/microsoft-fabric/action-access.png" />
</Frame>

Wenn neu aktivierte Aktionen zusätzliche Microsoft-Berechtigungen hinzufügen, bitte bestehende User einmalig um eine erneute Verbindung.

## User verbinden

Fordere alle User dazu auf, Microsoft Fabric in Langdock zu öffnen, **Verbindung hinzufügen** auszuwählen und sich mit dem Microsoft-Konto anzumelden, dem du Zugriff gewährt hast.

Verweise User auf den [Guide mit drei Schritten](../microsoft-fabric#microsoft-fabric-verwenden). Wenn eine API nicht über ihren Namen gefunden wird, nutze die [Fehlerbehebung](./troubleshooting).

## Einrichtung prüfen

Prüfe mit einem repräsentativen Business-User, ob der vorgesehene Zugriff funktioniert:

1. Führe als dieser User eine gezielte Abfrage im GraphQL-Editor von Fabric aus.
2. Stelle in Langdock eine Frage, die dieselben Daten benötigt, und gleiche das Ergebnis mit der Quelle ab.
3. Wenn du Mutationen bereitstellst, verwende einen entbehrlichen Datensatz, bestätige die Operation in Langdock und prüfe die Änderung in Fabric.

Wenn eine Prüfung fehlschlägt, findest du unter [Fehlerbehebung](./troubleshooting) Hinweise zu Erkennung, Schema und Berechtigungen.
