Verwenden der Geschäftsszenario-API in Microsoft Graph (Vorschau)
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 Instanz 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:
- Planner stellt die folgenden Konfigurationen bereit:
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:
- Planner mit den folgenden unterstützten Entitäten:
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.