Microsoft Dataverse

Die Microsoft Dataverse-Integration gibt deinen SymbioBots Zugriff auf strukturierte Geschäftsdaten aus Microsoft Dataverse — den Daten-Layer hinter Dynamics 365 und Power Apps. Du kannst Umgebungen, Tabellen und Datensätze direkt im AI Chat erkunden, auswerten und — nach separater Admin-Freigabe — Datensätze erstellen oder aktualisieren.

Funktionen

• Umgebungen auflisten — Zeigt die Dataverse-Umgebungen an, die ein Administrator für deine Organisation freigegeben hat
• Tabellen durchsuchen — Listet die Tabellen einer Umgebung auf, mit logischem Namen und Anzeigename
• Spalten anzeigen — Zeigt die Felder einer Tabelle samt Datentypen, damit klar ist, was abgefragt werden kann
• Daten abfragen — Fragt Zeilen einer Tabelle per OData ab: ausgewählte Felder ($select), Filter ($filter), Sortierung ($orderby) und eine maximale Zeilenzahl ($top)
• Mit SQL abfragen — Führt lesende SQL-Abfragen mit Joins, Filtern und Aggregationen aus
• Datensätze erstellen und aktualisieren — Schreibt Datensätze nach expliziter Admin-Freigabe und Bestätigung im Chat

Die Ergebnisse erscheinen als Tabelle direkt im Chat. Du musst die OData- oder SQL-Syntax nicht kennen — beschreibe einfach in natürlicher Sprache, was du sehen möchtest, und der Assistent baut die Abfrage für dich.

In Workflows verwenden

Neben dem AI Chat kannst du Dataverse auch in SymbioFlows nutzen: Die Node Integrations-Aktion führt genau eine Aktion mit einer fest hinterlegten Konfiguration aus — ohne KI und damit ohne KI-Token. Zur Auswahl stehen dort die vier Dataverse-Aktionen sowie je eine lesende Aktion für Power BI und Microsoft 365 Excel; eine Node führt immer genau eine davon aus. Beachte den Hinweis zu Schreibaktionen unter Schritt 3.

In interaktiven Seiten verwenden

Eine interaktive Seite kann Dataverse direkt lesen und — nach Rückfrage — Datensätze anlegen oder ändern, etwa als Kundenliste mit Bearbeitungsformular für dein Team. Die Seite läuft dabei immer als die Person, die sie gerade ansieht: mit deren eigener Microsoft-Verbindung, deren Sicherheitsrollen in Dataverse und den Aktionen, die ein Administrator ihr freigegeben hat. Zwei Kolleginnen mit unterschiedlichen Rollen sehen auf derselben Seite deshalb unterschiedliche Datensätze.

• Eigene Verbindung nötig — wer die Seite nutzen will, muss seinen Microsoft-Account unter Einstellungen > Integrationen verbunden haben. Ohne Verbindung zeigt die Seite eine Meldung statt Daten.
• Schreiben nur nach Bestätigung — vor jedem Anlegen oder Ändern erscheint der Dialog Aktion ausführen?. Er nennt unter Wo die Tabelle und unter Was gespeichert wird die Feldwerte, die tatsächlich geschrieben werden — nicht die Beschriftung der Schaltfläche.
• Nachvollziehbar — in Dataverse steht die Person als Bearbeiter, die geklickt hat, und jeder Schreibvorgang wird unter ihrem Namen im Audit-Log protokolliert.
• Dieselben Freigaben — es gelten die Aktions-Freigaben aus Schritt 3 und die Schreibfreigabe pro Umgebung. Löschen ist auch hier nicht möglich.

Beispiel-Prompts

• “Welche Dataverse-Umgebungen stehen mir zur Verfügung?”
• “Liste die Tabellen in der Umgebung Vertrieb auf”
• “Welche Felder hat die Tabelle Firmen (account)?”
• “Zeig mir die 20 Firmen mit dem höchsten Jahresumsatz”
• “Welche offenen Verkaufschancen gibt es, sortiert nach Abschlussdatum?”
• “Wie viele aktive Kontakte sind in der Tabelle Kontakte?”
• “Wie viele Kontakte gehören zu jedem Kunden? Nutze einen Join und gruppiere nach Kunde.”
• “Erstelle einen neuen Kunden mit dem Namen Acme GmbH.”
• “Aktualisiere den Kunden mit der ID … und setze den Umsatz auf 100000.”

Große Ergebnismengen

Bei umfangreichen Abfrageergebnissen werden die Daten automatisch an die Datenanalyse übergeben. So kann der Assistent direkt Auswertungen rechnen, Diagramme erstellen und dir die Daten als CSV- oder Excel-Datei zum Download bereitstellen — ohne dass du etwas konfigurieren musst. Liefert eine Abfrage mehr Zeilen, als auf einmal abgerufen werden, lädt der Assistent die nächste Seite automatisch nach.

Voraussetzungen

• Eine Microsoft Dataverse-Umgebung (z. B. aus Dynamics 365 oder Power Apps)
• Die Umgebung liegt in der EU/EWR (siehe Einschränkungen)
• Admin-Zustimmung wurde von einem Microsoft 365-Administrator erteilt
• Die Integration wurde von einem Administrator in symbiofy aktiviert und die gewünschten Umgebungen freigegeben (siehe unten)
• Du hast deinen Microsoft-Account in den Einstellungen verbunden

Einrichtung durch den Administrator

Die Microsoft Dataverse-Integration wird in zwei Schritten durch einen Administrator deiner Organisation eingerichtet.

Schritt 1: Integration aktivieren

Unter Administration > Integrationen aktiviert der Administrator die Integration Microsoft Dataverse im Tab Direkte Integrationen.

Schritt 2: Umgebungen freigeben

Nach der Aktivierung erscheint ein eigener Tab Dataverse. Dort findest du den Bereich Dataverse-Umgebungen mit der Schaltfläche Umgebungen konfigurieren. symbiofy ermittelt automatisch alle Dataverse-Umgebungen, auf die der Administrator Zugriff hat. Wähle die Umgebungen aus, die für deine Nutzer verfügbar sein sollen, und speichere die Auswahl.

Nur EU/EWR-Umgebungen sind auswählbar. Aus Datenschutzgründen lassen sich ausschließlich Umgebungen freigeben, deren Daten in der EU bzw. im EWR liegen. Umgebungen außerhalb der EU/EWR werden in der Liste angezeigt, sind aber blockiert und können nicht ausgewählt werden. EU/EWR-Umgebungen sind mit einem grünen Hinweis gekennzeichnet, Nicht-EU-Umgebungen mit einem roten.

Mit der Schaltfläche Aktualisieren lädt der Administrator die Umgebungsliste bei Bedarf neu.

Schritt 3: Schreibaktionen freigeben

Lesen ist standardmäßig verfügbar, sobald die Integration aktiviert und eine Umgebung freigegeben ist. Die Aktionen Datensatz erstellen und Datensatz aktualisieren kann der Administrator im Bereich der erlaubten Integrationsaktionen unabhängig voneinander freigeben. Im AI Chat muss jede Schreibaktion zusätzlich einzeln bestätigt werden.

Zusätzlich gilt die Schreibfreigabe pro Umgebung: Im Dialog Umgebungen konfigurieren hat jede ausgewählte Umgebung ein eigenes Häkchen Schreiben erlauben. Ohne dieses Häkchen kann in der Umgebung nur gelesen werden — auch wenn die Aktionen oben freigegeben sind. Standardmäßig ist es nicht gesetzt, auch nicht bei Umgebungen, die schon vor Einführung dieser Einstellung freigegeben waren. So lässt sich zum Beispiel eine Testumgebung beschreibbar machen, während die Produktivumgebung nur gelesen wird.

Ein Schreibversuch in einer Umgebung ohne Schreibfreigabe wird abgelehnt, bevor Dataverse überhaupt angefragt wird — im Chat ebenso wie im Workflow. Im Workflow-Editor ist eine solche Umgebung bei schreibenden Aktionen mit dem Zusatz nur lesen gekennzeichnet. Abfrageergebnisse, Bestätigungsdialog und Protokolleintrag nennen jeweils den Namen der Umgebung, auf die sie sich beziehen.

Die Freigabe gilt auch für Workflows. Die Node Integrations-Aktion in SymbioFlows nutzt dieselbe Freigabe, kennt aber keine Bestätigung pro Schreibvorgang: Der Schritt läuft ohne Rückfrage, sobald der Workflow ausgelöst wird. Diese Freigabe ist damit die einzige Stelle, an der du schreibende Zugriffe steuerst.

Account verbinden

Sobald die Integration aktiviert ist, verbindet jeder Nutzer seinen Microsoft-Account einmalig unter Einstellungen > Integrationen. Da die Admin-Zustimmung bereits erteilt wurde, ist die Verbindung ein einziger Klick — es erscheint nur noch die Kontoauswahl, keine zusätzliche Berechtigungsabfrage. In vielen Organisationen übernimmt das Verbinden ein Administrator stellvertretend.

Einschränkungen

• Schreibaktionen sind geschützt — Datensätze können nur mit der jeweiligen Admin-Freigabe und nur in Umgebungen mit Schreiben erlauben erstellt oder aktualisiert werden; im AI Chat und in interaktiven Seiten kommt eine Bestätigung pro Schreibvorgang hinzu, in einem Workflow nicht. Löschen wird derzeit nicht unterstützt
• SQL ist ausschließlich lesend — query_sql unterstützt ein begrenztes T-SQL-Subset mit benannten Spalten, DISTINCT, INNER/LEFT JOIN, WHERE, GROUP BY mit Standardaggregaten und ORDER BY. Unterabfragen, SELECT *, HAVING, UNION, CASE, TOP und OFFSET werden nicht unterstützt
• Nur EU/EWR-Umgebungen — Es werden ausschließlich Umgebungen unterstützt, deren Daten in der EU/EWR liegen. Umgebungen in anderen Regionen können nicht abgefragt werden
• Berechtigungen werden respektiert — Du siehst nur die Daten, für die dein Microsoft-Account in Dataverse berechtigt ist. Reicht deine Sicherheitsrolle in Dataverse nicht aus, bleiben die betroffenen Daten ausgeblendet
• Feldnamen sind case-sensitiv — Abfragen verwenden die exakten logischen Feldnamen aus dem Tabellenschema. Im Zweifel zeigt der Assistent zuerst die Spalten an, bevor er eine Abfrage formuliert
• FetchXML und gespeicherte Ansichten werden derzeit nicht unterstützt (für eine spätere Version geplant)