Использование API бизнес-сценариев в Microsoft Graph (предварительная версия)
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
API бизнес-сценариев позволяет создавать бизнес-сценарии и управлять ими, которые настраивают интеграцию данных в Microsoft Graph и управляют ими.
Структура бизнес-сценария
Бизнес-сценарий представлен сущностью businessScenario . Ресурс businessScenario указывает общие сведения о сценарии, приложениях, которые используют этот сценарий, а также конфигурации для сущностей, которыми приложения могут управлять для поддержки сценария. Приложения могут идентифицировать экземпляр businessScenario по свойству uniqueName в формате обратного доменного имени.
Сущности, доступные в бизнес-сценариях
API бизнес-сценариев предназначен для того, чтобы службы Microsoft Graph могли расширить его для поддержки конкретных сценариев, характерных для клиентов.
В настоящее время Планировщик расширил API. API поддерживает пользовательские данные сценария для Планировщика в сущности businessScenarioTask .
Примечание.
Существует ли у вас сценарий, в котором требуется перенос пользовательских данных в качестве сущностей в другую службу Microsoft 365? Предложите функцию или проголосуйте за существующие запросы функций.
Создание бизнес-сценария
Бизнес-сценарии могут создаваться приложениями с помощью делегированного разрешения BusinessScenarioConfig.ReadWrite.OwnedBy. Для создания бизнес-сценария требуется указать отображаемое имя и уникальное имя. Уникальное имя должно быть в формате обратного DNS, чтобы предотвратить конфликт между независимыми сценариями. Обратный формат DNS принимает доменное имя, принадлежаемое создателю сценария, и отменяет его. Например, если разработчик, владеющий apps.contoso.com , создает сценарий, уникальное имя сценария должно начинаться с com.contoso.apps. Затем можно добавить дополнительные сегменты, чтобы дифференцировать сценарии или группы сценариев; например, com.contoso.apps.customerSupport.ticketManagement. Уникальное имя сценария должно отличаться от всех других сценариев, развернутых в клиенте.
Дополнительные сведения см. в разделе Create businessScenario.
Настройка поведения для сущностей
Каждая служба, поддерживаемая бизнес-сценариями, предоставляет конфигурации в этом сценарии. Приложения должны иметь разрешение на BusinessScenarioConfig.Read.OwnedBy доступ к этим конфигурациям BusinessScenarioConfig.ReadWrite.OwnedBy и разрешение на их изменение. Каждая конфигурация зависит от конкретной службы. Дополнительные сведения см. в следующих разделах, относящихся к службам:
- Планировщик предоставляет следующие конфигурации:
Создание данных для бизнес-сценария и управление ими
Каждая служба, поддерживаемая бизнес-сценариями, предоставляет доступ к данным в сценарии. Приложения должны быть указаны в качестве владельца в сценарии для работы с данными в сценарии. Приложения также должны иметь BusinessScenarioData.Read.OwnedBy разрешение на чтение данных и BusinessScenarioData.ReadWrite.OwnedBy разрешение на создание новых данных или изменение ранее созданных данных. Дополнительные сведения см. в следующих разделах, относящихся к службам:
- Планировщик со следующими поддерживаемыми сущностями:
Удаление бизнес-сценария
Приложения, владеющие бизнес-сценарием, могут удалить сценарий, если у них есть BusinessScenarioConfig.ReadWrite.OwnedBy разрешение. При удалении сценария также удаляются все данные, связанные со сценарием.
Дополнительные сведения см. в разделе Удаление businessScenario.
Основные варианты использования
| Варианты использования | Ресурсы REST | См. также |
|---|---|---|
| Создание, чтение, обновление и удаление бизнес-сценариев | businessScenario | Методы бизнесаСценарио |
| Настройка бизнес-сценариев для Планировщика | plannerPlanConfigurationplannerTaskConfiguration | Методы plannerPlanConfigurationMethods of plannerTaskConfiguration |
| Создание, чтение, обновление и удаление задач бизнес-сценария в Планировщике | businessScenarioTask | businessScenarioTask |
Дальнейшие действия
API бизнес-сценариев позволяет приложениям моделировать и интегрировать реальные рабочие бизнес-процессы со службой Microsoft 365 через Microsoft Graph. Чтобы узнать больше:
- Изучите подробнее методы и свойства ресурсов, наиболее полезных для вашего сценария.
- Опробуйте API в песочнице Graph.