Freigeben über

Verwenden der Geschäftsszenario-API in Microsoft Graph (Vorschau)

  • Artikel

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Die Geschäftsszenario-API ermöglicht die Erstellung und Verwaltung von Geschäftsszenarien, die die Integration von Daten in Microsoft Graph konfigurieren und verwalten.

Struktur eines Geschäftsszenarios

Ein Geschäftsszenario wird durch die Entität businessScenario dargestellt. Eine businessScenario-Ressource gibt allgemeine Informationen über das Szenario, die Apps, die dieses Szenario verwenden, und Konfigurationen für Entitäten an, die Apps verwalten können, um das Szenario zu unterstützen. Apps können die instance von businessScenario mithilfe der uniqueName-Eigenschaft mithilfe eines umgekehrten Domänennamenformats identifizieren.

In Geschäftsszenarien verfügbare Entitäten

Die Geschäftsszenario-API ist so konzipiert, dass Microsoft Graph-Dienste sie erweitern können, um dienstspezifische Szenarien zu unterstützen, die für Kunden spezifisch sind.

Derzeit hat Planner die API erweitert. Die API unterstützt benutzerdefinierte Szenariodaten für Planner in der Entität businessScenarioTask.

Hinweis

Gibt es ein Szenario, in dem benutzerdefinierte Daten als Entitäten in einen anderen Microsoft 365-Dienst übertragen werden müssen? Schlagen Sie das Feature vor oder stimmen Sie für vorhandene Featureanforderungen ab.

Erstellen eines Geschäftsszenarios

Geschäftsszenarien können von Anwendungen mit der delegierten Berechtigung BusinessScenarioConfig.ReadWrite.OwnedByerstellt werden. Das Erstellen eines Geschäftsszenarios erfordert die Angabe eines Anzeigenamens und eines eindeutigen Namens. Der eindeutige Name sollte im Reverse-DNS-Format vorliegen, um Konflikte zwischen unabhängigen Szenarien zu verhindern. Das Reverse-DNS-Format verwendet den Domänennamen, den der Szenarioersteller besitzt, und kehrt ihn um. Wenn beispielsweise ein Entwickler, der besitzer ist, ein Szenario erstellt, sollte der eindeutige Name des Szenarios apps.contoso.com mit com.contoso.appsbeginnen. Anschließend können weitere Segmente hinzugefügt werden, um Szenarien oder Gruppen von Szenarien zu unterscheiden; Beispiel: com.contoso.apps.customerSupport.ticketManagement. Der eindeutige Name des Szenarios muss sich von jedem anderen Szenario unterscheiden, das in einem Mandanten bereitgestellt wird.

Weitere Informationen finden Sie unter Erstellen von BusinessScenario.

Konfigurieren von Verhaltensweisen für Entitäten

Jeder Dienst, der durch Geschäftsszenarien unterstützt wird, stellt Konfigurationen in diesem Szenario bereit. Anwendungen müssen über die BusinessScenarioConfig.Read.OwnedBy Berechtigung verfügen, um auf diese Konfigurationen zugreifen zu können, und über die BusinessScenarioConfig.ReadWrite.OwnedBy Berechtigung, sie ändern zu können. Jede Konfiguration ist spezifisch für den Dienst. Weitere Informationen finden Sie in den folgenden dienstspezifischen Themen:

Erstellen und Verwalten von Daten für ein Geschäftsszenario

Jeder Dienst, der durch Geschäftsszenarien unterstützt wird, ermöglicht den Zugriff auf Daten innerhalb eines Szenarios. Anwendungen müssen in einem Szenario als Besitzer aufgeführt werden, um mit den Daten im Szenario arbeiten zu können. Anwendungen müssen außerdem über die BusinessScenarioData.Read.OwnedBy Berechtigung zum Lesen der Daten und die BusinessScenarioData.ReadWrite.OwnedBy Berechtigung verfügen, um neue Daten erstellen oder zuvor erstellte Daten ändern zu können. Weitere Informationen finden Sie in den folgenden dienstspezifischen Themen:

Löschen eines Geschäftsszenarios

Anwendungen, die besitzer eines Geschäftsszenarios sind, können das Szenario löschen, wenn sie über die BusinessScenarioConfig.ReadWrite.OwnedBy Berechtigung verfügen. Durch das Löschen des Szenarios werden auch alle dem Szenario zugeordneten Daten entfernt.

Weitere Informationen finden Sie unter Löschen von businessScenario.

Allgemeine Anwendungsfälle

Anwendungsfälle REST-Ressourcen Siehe auch
Erstellen, Lesen, Aktualisieren und Löschen von Geschäftsszenarien businessScenario GeschäftsmethodenScenario
Konfigurieren von Geschäftsszenarien für Planner plannerPlanConfigurationplannerTaskConfiguration Methoden von plannerPlanConfigurationMethoden von plannerTaskConfiguration
Erstellen, Lesen, Aktualisieren und Löschen von Geschäftsszenarioaufgaben in Planner businessScenarioTask businessScenarioTask

Nächste Schritte

Mit der Geschäftsszenario-API können Apps reale Geschäftsprozesse mit einem Microsoft 365-Dienst über Microsoft Graph modellieren und integrieren. So erhalten Sie weitere Informationen:

  • Informieren Sie sich ausführlicher über die Methoden und Eigenschaften der Ressourcen, die für Ihr Szenario am hilfreichsten sind.
  • Probieren Sie die API im Graph-Tester aus.