Портал Cireson Service Manager

Создание и обновление рабочих элементов с помощью портала Cireson для System Center Service Manager

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	Cireson
URL	https://cireson.com
Адрес электронной почты	support@cireson.com

Метаданные соединителя
Publisher	Cireson
Веб-сайт	https://cireson.com/
Политика конфиденциальности	https://cireson.com/privacy-statement/
Категории	Искусственный интеллект; Сайт

Расширьте инвестиции на портал Cireson Service Manager в экосистему M365 с возможностью управления рабочими элементами из Power Automate.

Предпосылки

Вам потребуется активная лицензия на портал Cireson Service Manager, и ваш портал должен иметь доступ к Интернету.

Получение учетных данных

Создайте маркер платформы (API) на портале Service Manager, как описано ниже https://kb.cireson.com/article/user-guide-authentication-tokens-and-knowledge-base-reporting/2507.

Начало работы с соединителем

Поддерживаются несколько распространенных операций, например:

При добавлении нового комментария
- Это событие происходит в любое время добавления комментария к любому рабочему элементу. Это событие можно отфильтровать в комментариях аналитика или примечаниях конечных пользователей.
При создании нового рабочего элемента
- Это событие происходит в любое время создания рабочего элемента. Это событие можно отфильтровать по инциденту, запросу на обслуживание, запросу на изменение, проблеме или записи выпуска
Создание и обновление рабочего элемента
- Это действие можно использовать для изменения общих свойств рабочего элемента, такого как название, описание, приоритет, срочность, а также назначенный или затронутый пользователь по адресу электронной почты. Используя адрес электронной почты пользователя, вы можете связать другие интеграции M365, где для идентификации пользователя используется электронная почта.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
URL-адрес портала	струна	URL-адрес портала Service Manager	True
APIKey	securestring	APIKey для этого API	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Добавление комментария в рабочий элемент	Добавление комментариев журнала действий в рабочий элемент
Обновление записи выпуска	Обновление ReleaseRecord
Обновление запроса на изменение	Обновление запроса на изменение
Обновление запроса службы	Обновление запроса службы
Обновление инцидента	Обновление инцидента
Получение рабочего элемента	Получение данных рабочего элемента с идентификатором
Проблема обновления	Проблема обновления
Создание записи выпуска	Создание записи выпуска
Создание запроса на изменение	Создание запроса на изменение
Создание запроса на обслуживание	Создание запроса на обслуживание
Создание инцидента	Создание инцидента
Создание проблемы	Создание проблемы
Удаление рабочего элемента	Удаление рабочего элемента

Добавление комментария в рабочий элемент

Идентификатор операции:: AddCommentLog

Добавление комментариев журнала действий в рабочий элемент

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор рабочего элемента	id	True	string	Идентификатор рабочего элемента
Комментарий	Description		string	Комментарий
Кем добавлено	EnteredBy		string	Кем добавлено
Является частным	IsPrivate		boolean	Является частным
Тип комментария	ActionType		string	Тип комментария

Возвращаемое значение

Тело: WorkItem_ActionLogResponse

Обновление записи выпуска

Идентификатор операции:: UpdateReleaseRecord

Обновление ReleaseRecord

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор рабочего элемента	Id	True	string	Идентификатор рабочего элемента
Название	Title		string	Название
Description	Description		string	Description
Тип	Type		string	Тип
Категория	Category		string	Категория
Воздействие	Impact		string	Воздействие
Риск	Risk		string	Риск
Priority	Priority		string	Priority
Состояние	Status		string	Состояние
Назначенный пользователь	AssignedWorkItem		string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedSRResponse

Обновление запроса на изменение

Идентификатор операции:: UpdateChangeRequest

Обновление запроса на изменение

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор рабочего элемента	Id	True	string	Идентификатор рабочего элемента
Название	Title		string	Название
Description	Description		string	Description
Priority	Priority		string	Priority
Area	Area		string	Area
Воздействие	Impact		string	Воздействие
Риск	Risk		string	Риск
Состояние	Status		string	Состояние
Назначенный пользователь	AssignedWorkItem		string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedSRResponse

Обновление запроса службы

Идентификатор операции:: UpdateServiceRequest

Обновление запроса службы

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор рабочего элемента	Id	True	string	Идентификатор рабочего элемента
Название	Title		string	Название
Description	Description		string	Description
Priority	Priority		integer	Priority
Classification	Classification		string	Classification
"Срочность";	Urgency		string	"Срочность";
Воздействие	Impact		string	Воздействие
Исходный материал	Source		string	Исходный материал
Группа поддержки	SupportGroup		string	Группа поддержки
Состояние	Status		string	Состояние
Затронутый пользователь	RequestedWorkItem		string	Затронутый пользователь
Назначенный пользователь	AssignedWorkItem		string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedSRResponse

Обновление инцидента

Идентификатор операции:: UpdateIncident

Обновление инцидента

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор рабочего элемента	Id	True	string	Идентификатор рабочего элемента
Название	Title		string	Название
Description	Description		string	Description
Priority	Priority		integer	Priority
Classification	Classification		string	Classification
"Срочность";	Urgency		string	"Срочность";
Воздействие	Impact		string	Воздействие
Исходный материал	Source		string	Исходный материал
Группа поддержки	SupportGroup		string	Группа поддержки
Состояние	Status		string	Состояние
Затронутый пользователь	RequestedWorkItem		string	Затронутый пользователь
Назначенный пользователь	AssignedWorkItem		string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedIRResponse

Получение рабочего элемента

Идентификатор операции:: GetWorkItem

Получение данных рабочего элемента с идентификатором

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор рабочего элемента	WorkItemId	True	string	Идентификатор рабочего элемента

Возвращаемое значение

Тело: WorkItem_GetResponse

Проблема обновления

Идентификатор операции:: UpdateProblem

Проблема обновления

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор рабочего элемента	Id	True	string	Идентификатор рабочего элемента
Название	Title		string	Название
Description	Description		string	Description
Priority	Priority		string	Priority
Исходный материал	Source		string	Исходный материал
Категория	Category		string	Категория
Воздействие	Impact		string	Воздействие
"Срочность";	Urgency		string	"Срочность";
Состояние	Status		string	Состояние
Назначенный пользователь	AssignedWorkItem		string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedIRResponse

Создание записи выпуска

Идентификатор операции:: CreateReleaseRecord

Создание записи выпуска

Параметры

Имя	Ключ	Тип	Описание
Название	Title	string	Название
Description	Description	string	Description
Тип	Type	string	Тип
Категория	Category	string	Категория
Воздействие	Impact	string	Воздействие
Риск	Risk	string	Риск
Priority	Priority	string	Priority
Состояние	Status	string	Состояние
Назначенный пользователь	AssignedWorkItem	string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedSRResponse

Создание запроса на изменение

Идентификатор операции:: CreateChangeRequest

Создание запроса на изменение

Параметры

Имя	Ключ	Тип	Описание
Название	Title	string	Название
Description	Description	string	Description
Priority	Priority	string	Priority
Area	Area	string	Area
Воздействие	Impact	string	Воздействие
Риск	Risk	string	Риск
Состояние	Status	string	Состояние
Назначенный пользователь	AssignedWorkItem	string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedSRResponse

Создание запроса на обслуживание

Идентификатор операции:: CreateServiceRequest

Создание запроса на обслуживание

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Название	Title		string	Название
Description	Description		string	Description
Priority	Priority		string	Priority
Area	Area	True	string	Area
"Срочность";	Urgency	True	string	"Срочность";
Исходный материал	Source	True	string	Исходный материал
Группа поддержки	SupportGroup		string	Группа поддержки
Состояние	Status		string	Состояние
Затронутый пользователь	RequestedWorkItem		string	Затронутый пользователь
Назначенный пользователь	AssignedWorkItem		string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedSRResponse

Создание инцидента

Идентификатор операции:: CreateIncident

Создание инцидента

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Название	Title		string	Название
Description	Description		string	Description
Priority	Priority		integer	Priority
Classification	Classification	True	string	Classification
"Срочность";	Urgency	True	string	"Срочность";
Воздействие	Impact	True	string	Воздействие
Исходный материал	Source	True	string	Исходный материал
Группа поддержки	SupportGroup		string	Группа поддержки
Состояние	Status		string	Состояние
Затронутый пользователь	RequestedWorkItem		string	Затронутый пользователь
Назначенный пользователь	AssignedWorkItem		string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedIRResponse

Создание проблемы

Идентификатор операции:: CreateProblem

Создание проблемы

Параметры

Имя	Ключ	Тип	Описание
Название	Title	string	Название
Description	Description	string	Description
Priority	Priority	string	Priority
Исходный материал	Source	string	Исходный материал
Категория	Category	string	Категория
Воздействие	Impact	string	Воздействие
"Срочность";	Urgency	string	"Срочность";
Состояние	Status	string	Состояние
Назначенный пользователь	AssignedWorkItem	string	Назначенный пользователь

Возвращаемое значение

Тело: WorkItem_CreatedIRResponse

Удаление рабочего элемента

Идентификатор операции:: DeleteWorkItem

Удаление рабочего элемента

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор рабочего элемента	Id	True	string	Идентификатор рабочего элемента

Возвращаемое значение

Имя	Путь	Тип	Описание
сообщение	message	string	сообщение
success	success	boolean	success
данные	data	string	данные
исключение	exception	string	исключение
BaseId	BaseId	string	BaseId

Триггеры

При добавлении нового комментария	При добавлении нового комментария
При создании нового рабочего элемента	При создании нового рабочего элемента

При добавлении нового комментария

Идентификатор операции:: CreateActionLogWebhook

При добавлении нового комментария

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип комментария	WorkItemClassType	True	string	Тип комментария

Возвращаемое значение

Тело: WorkItem_ActionLogWebhookResponse

При создании нового рабочего элемента

Идентификатор операции:: CreateWebhook

При создании нового рабочего элемента

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип рабочего элемента	WorkItemClassType	True	string	Тип класса рабочих элементов

Возвращаемое значение

Тело: WorkItem_WebhookResponse

Определения

WorkItem_CreatedSRResponse

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Идентификатор
Название	Title	string	Название
Description	Description	string	Description
Priority	Priority	object	Priority
Classification	Classification	object	Classification
"Срочность";	Urgency	object	"Срочность";
Воздействие	Impact	object	Воздействие
Исходный материал	Source	object	Исходный материал
Группа поддержки	SupportGroup	object	Группа поддержки
Состояние	Status	object	Состояние
Назначенный пользователь	AssignedWorkItem	object	Назначенный пользователь
Затронутый пользователь	RequestedWorkItem	object	Затронутый пользователь

WorkItem_CreatedIRResponse

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Идентификатор
Название	Title	string	Название
Description	Description	string	Description
Priority	Priority	integer	Priority
"Срочность";	Urgency	object	"Срочность";
Воздействие	Impact	object	Воздействие
Исходный материал	Source	object	Исходный материал
Группа поддержки	SupportGroup	object	Группа поддержки
Состояние	Status	object	Состояние
Назначенный пользователь	AssignedWorkItem	object	Назначенный пользователь
Затронутый пользователь	RequestedWorkItem	object	Затронутый пользователь

WorkItem_GetResponse

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Идентификатор
Название	Title	string	Название
Description	Description	string	Description
Priority	PriorityText	string	Priority
Classification	Classification	object	Classification
"Срочность";	Urgency	object	"Срочность";
Воздействие	Impact	object	Воздействие
Исходный материал	Source	object	Исходный материал
Группа поддержки	SupportGroup	object	Группа поддержки
Состояние	Status	object	Состояние
Назначенный пользователь	AssignedWorkItem	object	Назначенный пользователь
Затронутый пользователь	RequestedWorkItem	object	Затронутый пользователь

WorkItem_WebhookResponse

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Идентификатор
Название	Title	string	Название
Description	Description	string	Description
Priority	Priority		Priority
Classification	Classification	object	Classification
"Срочность";	Urgency	object	"Срочность";
Воздействие	Impact	object	Воздействие
Исходный материал	Source	object	Исходный материал
Группа поддержки	SupportGroup	object	Группа поддержки
Состояние	Status	object	Состояние
Назначенный пользователь	AssignedWorkItem	object	Назначенный пользователь
Затронутый пользователь	RequestedWorkItem	object	Затронутый пользователь

WorkItem_ActionLogResponse

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Идентификатор
Название	Title	string	Название
Применимо к запросу на проблемы	AppliesToTroubleTicket		Записи журнала действий для инцидентов и проблем
Область применения к WorkItem	AppliesToWorkItem		Записи журнала действий для рабочих элементов

WorkItem_ActionLogWebhookResponse

Имя	Путь	Тип	Описание
Идентификатор рабочего элемента	WorkItemID	string	Идентификатор рабочего элемента
Введено	EnteredBy	string	Введено
Является частным	IsPrivate	boolean	Является частным
Комментарий	Description	string	Комментарий
Дата ввода	EnteredDate	string	Дата ввода
"Дата последнего изменения";	LastModified	string	"Дата последнего изменения";