Использование 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.