Tesseron Ticket (предварительная версия)

Этот соединитель позволяет использовать Tesseron Ticket для создания, редактирования и поиска билетов.

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

Услуга 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)
Контакт
Имя Поддержка Tesseron
URL https://www.docs.tesseron.de
Адрес электронной почты development@llnet.de
Метаданные соединителя
Publisher Тессерон Луитл + Luithle GmbH
Веб-сайт https://www.tesseron.de
Политика конфиденциальности https://www.llnet.de/data-protection/
Категории ИТ-операции; Коммуникация

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

Предпосылки

Для продолжения вам потребуется следующее:

  • Экземпляр Tesseron
  • Лицензированный пользователь Tesseron
  • Ключ API (служба: билет)

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

Проверка подлинности выполняется с помощью ключа API. Укажите ключ API и параметры подключения URL-адреса экземпляра als.

Поддерживаемые операции

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

  • Создание билета: создание билета в экземпляре Tesseron
  • Создание позиции билета: добавление новой позиции в билет (сведения, конец отчета, повторное открытие)
  • Получение билета: получение всех сведений о билете или номере ссылки
  • Запрос поиска: получение номера билета путем предоставления ссылочного номера
  • Запрос поиска по параметру: получение сведений о билете путем предоставления поискового запроса
  • GetTicketFieldGroupConfig: конфигурация группы полей recieve на основе типа билета, идентификатора билета или идентификатора параметров.
  • GetAllTicketTypes: получение всех существующих типов билетов
  • GetAllAreas: получение всех областей билетов.
  • GetAllStartAreas: получение всех начальных областей для билетов.

Инструкции по развертыванию

Так как REST API Tesseron использует ключи API для проверки пользователя, сначала необходимо обратиться к системному администратору, чтобы создать ключ API для пользователя. После завершения вы можете создать подключение Tesseron.

  1. Проверьте права пользователя с помощью этого соединителя вы сможете выполнять действия активов в экземпляре Tesseron. Поэтому необходимо иметь обязательные права пользователя.

  2. Примените ключ API в настоящее время, ключи API могут создаваться только системным администратором. Поэтому запросите ключ API от системного администратора.

  3. Создание нового подключения

    • Укажите URL-адрес экземпляра Tesseron
    • Введите ключ API Tesseron

Известные проблемы и ограничения

  • Достаточные права пользователя являются обязательными.

Распространенные ошибки и средства устранения неполадок

Часто задаваемые вопросы

Взимается ли дополнительная плата с помощью этого соединителя? нет

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

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

По умолчанию

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

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

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

Имя Тип Description Обязательно
URL-адрес экземпляра струна URL-адрес экземпляра Tesseron True
API-Key securestring Ваш Tesseron API-Key (услуга: билет) True

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

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

Действия

Добавление ресурсов в билеты

Добавление ресурсов в существующие билеты
Запрос поиска

Поиск номера билета
Поиск по параметру

Поиск с помощью строки поиска
Получение всех начальных областей

Получите все начальные области.
Получение всех областей

Получите все области.
Получение конфигурации группы полей билета

Получение конфигурации группы полей билета
Получение сведений о билете

Получение сведений о билете
Получение типов билетов

Получение всех типов билетов.
Создание билета

CreateTicket
Создание позиции билета

CreateTicketPosition

Добавление ресурсов в билеты

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

Добавление ресурсов в существующие билеты

Параметры

Имя Ключ Обязательно Тип Описание
Ссылочный номер
 referenceNumber True string

Укажите билет или номер ссылки
Связанные ресурсы
 RelatedAssetIds True array of integer

Укажите связанные ресурсы.

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Код состояния
 StatusCode integer

Код состояния

Запрос поиска

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

Поиск номера билета

Параметры

Имя Ключ Обязательно Тип Описание
Ссылочный номер
 referencenumber True string

Введите билет или номер ссылки

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Билеты
 TicketNumber array of string

Билеты
Номер позиции билета
 TicketPositionNumber string

Номер позиции билета
Номер позиции билета
 TicketPositionTextPlain string

TicketPositionNumber
TicketStatus
 TicketStatus array of object
Припаркован?
 TicketStatus.IsParked boolean

Значение, если запрошенный билет припаркован.
Припаркован из
 TicketStatus.ParkedFrom string

Определяет начало парковки.
Припаркованный до
 TicketStatus.ParkedUntil string

Определяет конец периода парковки.
Текст состояния парка
 TicketStatus.ParkStatusText string

Определяет текст состояния периода парковки.

Поиск по параметру

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

Поиск с помощью строки поиска

Параметры

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

Введите строку поиска
Взять
 take True integer

Укажите, сколько билетов вы хотите получить
Пропустить
 skip True integer

Укажите, сколько билетов вы хотите пропустить

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Идентификатор билета
 TicketId integer

Идентификатор билета
Номер билета
 TicketNumber string

Номер билета
Ссылочный номер
 ReferenceNumber string

Номер ссылки на билет
Header
 TicketHeader string

Заголовок билета
Description
 TicketText string

Описание билета
Description
 TicketTextPlain string

Описание билета без форматирования.
Дата создания
 CreationDate string

Дата создания билета.
Дата создания (текст)
 CreationDateText string

Дата создания билета (текст).
Состояние
 TicketStatus string

Состояние билета.

Получение всех начальных областей

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

Получите все начальные области.

Параметры

Имя Ключ Обязательно Тип Описание
Тип ответа
 ResponseType True integer

Введите нужный тип ответа.
Искать
 Search string

Введите строку поиска.
Размер страницы
 PageSize True integer

Укажите количество типов билетов, которые вы хотите получить.
Пропустить
 Skip True integer

Укажите, сколько типов билетов вы хотите пропустить.
Порядок по возрастанию
 OrderByAsc boolean

Укажите, сколько типов билетов вы хотите пропустить.

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Начальные области
 Areas array of object

Все начальные области
Идентификатор области
 Areas.AreaId integer

Идентификатор области
Имя области
 Areas.AreaName string

Имя области
Типы билетов
 Areas.TicketTypes array of object

Типы билетов
Идентификатор типа билета
 Areas.TicketTypes.TicketTypeId integer

Идентификатор типа билета.
Имя типа билета (английский)
 Areas.TicketTypes.TicketTypeName_en string

Имя типа билета на английском языке.
Имя типа билета (немецкий)
 Areas.TicketTypes.TicketTypeName_de string

Имя типа билета на немецком языке.
Описание типа билета (английский язык)
 Areas.TicketTypes.TicketDescrpition_en string

Описание типа билета на английском языке.
Описание типа билета (немецкий)
 Areas.TicketTypes.TicketDescrpition_de string

Описание типа билета на немецком языке.

Получение всех областей

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

Получите все области.

Параметры

Имя Ключ Обязательно Тип Описание
Тип ответа
 ResponseType True integer

Введите нужный тип ответа.
Искать
 Search string

Введите строку поиска.
Размер страницы
 PageSize True integer

Укажите количество типов билетов, которые вы хотите получить.
Пропустить
 Skip True integer

Укажите, сколько типов билетов вы хотите пропустить.
Порядок по возрастанию
 OrderByAsc boolean

Укажите, сколько типов билетов вы хотите пропустить.

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Области
 Areas array of object

Все области
Идентификатор области
 Areas.AreaId integer

Идентификатор области
Имя области
 Areas.AreaName string

Имя области
Параметры области
 Areas.AreaOptions array of object

Параметры области
Имя типа билета (английский)
 Areas.AreaOptions.TicketTypeName_en string

Имя типа билета на английском языке.
Имя типа билета (немецкий)
 Areas.AreaOptions.TicketTypeName_de string

Имя типа билета на немецком языке.
Описание типа билета (английский язык)
 Areas.AreaOptions.TicketDescrpition_en string

Описание типа билета на английском языке.
Описание типа билета (немецкий)
 Areas.AreaOptions.TicketDescrpition_de string

Описание типа билета на немецком языке.

Получение конфигурации группы полей билета

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

Получение конфигурации группы полей билета

Параметры

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

Введите идентификатор типа билета
Идентификатор билета
 TicketId string

Введите идентификатор билета
Идентификатор параметров группы полей
 FieldGroupSettingsId string

Введите идентификатор параметров группы полей

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Идентификатор параметров
 TicketFieldGroupSettingsId string

Идентификатор параметров группы полей
Идентификатор группы
 Group ID string

Идентификатор группы полей
Имя
 Name string

Имя группы полей
Fields
 Fields array of object

Поля группы полей
Идентификатор параметров поля
 Fields.TicketFieldSettingsId string

Идентификатор параметров поля
Имя поля
 Fields.Name string

Имя параметров поля
Идентификатор типа поля
 Fields.FieldType integer

Идентификатор типа поля
Значение поля
 Fields.Value string

Значение поля
Options
 Fields.Options array of object

Параметры поля
Имя параметра
 Fields.Options.OptionName string

Имя параметра поля
Значение параметра
 Fields.Options.Value string

Имя параметра поля

Получение сведений о билете

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

Получение сведений о билете

Параметры

Имя Ключ Обязательно Тип Описание
Ссылочный номер
 referenceNumber True string

Введите билет или номер ссылки

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Номер билета
 TicketNumber string

Номер билета
Идентификатор типа билета
 TicketType integer

Идентификатор типа билета
Имя типа билета
 TicketTypeName string

Имя типа билета
Header
 TicketHeader string

Тема билета
Description
 TicketText string

Описание билета
Ссылочный номер
 ReferenceNumber string

Номер ссылки на билет
Идентификатор типа входа
 EntranceType integer

Идентификатор типа входа билета
Имя типа входа
 EntranceTypeName string

Имя типа входа билета
Идентификатор области
 AreaId integer

Идентификатор области билета
Имя области
 AreaName string

Имя области билета
Код проекта
 ProjectId string

Идентификатор связанного проекта
Идентификатор этапа проекта
 ProjectPhaseId string

Этап связанного проекта
Идентификатор задачи этапа проекта
 ProjectPhaseTaskId string

Задача связанного проекта
Метки
 Tags array of string

Метки
Выпущенный параметр
 ReleasedOption boolean

ReleasedOption
Приватный параметр
 PrivateOption boolean

PrivateOption
Внутренний параметр
 InternalOption boolean

InternalOption
Идентификатор срочности
 UrgencyType integer

Идентификатор срочности билета
Имя срочности
 UrgencyTypeName string

Имя срочности билета
Идентификатор эффектов
 EffectsType integer

Эффекты билета
Имя эффектов
 EffectsTypeName string

Имя эффектов билета
Идентификатор контракта службы
 ServiceContractId integer

Идентификатор связанного контракта
Корпоративный идентификатор
 EnterpriseId integer

Идентификатор основного предприятия билета
Корпоративное имя
 EnterpriseName string

Имя основного предприятия билета
Код контактного лица
 ContactId integer

Идентификатор основного контакта билета
Имя контактного лица
 ContactName string

Имя основного контакта по билету
Группы полей
 FieldGroups array of object

Укажите группы полей для билеты cynamic.
Группа полей
 FieldGroups.Name string

Спецификация группы полей.
Fields
 FieldGroups.properties array of object

Укажите поля, содержащие группу полей.
Имя
 FieldGroups.properties.name string

Укажите имя поля.
Ценность
 FieldGroups.properties.value string

Укажите значение поля.

Получение типов билетов

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

Получение всех типов билетов.

Параметры

Имя Ключ Обязательно Тип Описание
Тип ответа
 ResponseType True integer

Введите нужный тип ответа.
Искать
 Search string

Введите строку поиска.
Размер страницы
 PageSize True integer

Укажите количество типов билетов, которые вы хотите получить.
Пропустить
 Skip True integer

Укажите, сколько типов билетов вы хотите пропустить.
Порядок по возрастанию
 OrderByAsc boolean

Укажите, сколько типов билетов вы хотите пропустить.

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Типы билетов
 TicketTypes array of object

Все типы билетов
Идентификатор типа билета
 TicketTypes.TicketTypeId integer

Идентификатор типа билета
Имя типа билета (английский)
 TicketTypes.TicketTypeName_en string

Имя типа билета на английском языке.
Имя типа билета (немецкий)
 TicketTypes.TicketTypeName_de string

Имя типа билета на немецком языке.
Описание типа билета (английский язык)
 TicketTypes.TicketDescrpition_en string

Описание типа билета на английском языке.
Описание типа билета (немецкий)
 TicketTypes.TicketDescrpition_de string

Описание типа билета на немецком языке.

Создание билета

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

CreateTicket

Параметры

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

Выберите идентификатор типа билета.
Header
 ticketHeader True string

Укажите тему билета.
Description
 ticketText True string

Укажите описание билета.
Корпоративный идентификатор
 enterpriseId True integer

Укажите идентификатор бизнес-партнера.
Код контактного лица
 contactId integer

Выберите основной контакт.
Связанные ресурсы
 RelatedAssetIds array of integer

Укажите связанные ресурсы.
Идентификатор параметров группы полей
 TicketFieldGroupSettingsId string

Спецификация группы полей.
Идентификатор группы полей билета
 TicketFieldGroupId string

Спецификация группы полей билета.
Идентификатор параметров поля
 TicketFieldSettingsId string

Укажите идентификатор параметров поля.
Ценность
 value string

Укажите значение поля.
Ссылочный номер
 referenceNumber string

Укажите билет или номер ссылки.
Метки
 tags string

Укажите теги, разделенные точкой с запятой.
Идентификатор типа входа
 entranceType True integer

Укажите тип входа.
Идентификатор области
 areaId True integer

Выберите область
Выпущенный параметр
 releasedOption True boolean

Укажите, является ли билет освобожденным билетом
Приватный параметр
 privateOption True boolean

Укажите, является ли билет частным билетом
Внутренний параметр
 internalOption True boolean

Укажите, является ли это внутренним билетом
"Срочность";
 urgencyType True integer

Выберите срочность.
Эффекты
 effectsType True integer

Выберите эффекты.
Код проекта
 projectId string

Укажите идентификатор проекта билета
Идентификатор контракта службы
 serviceContractId integer

Введите идентификатор контракта службы
Редактор билетов
 delegatedTicketEditor integer

Введите редактор билета

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Билеты
 TicketNumber array of string

Билеты
Номер позиции билета
 TicketPositionNumber string

Номер позиции билета
Обычный текст позиции билета
 TicketPositionTextPlain string

Обычный текст позиции билета
TicketStatus
 TicketStatus array of object
Припаркован?
 TicketStatus.IsParked boolean

Значение, если запрошенный билет припаркован.
Припаркован из
 TicketStatus.ParkedFrom string

Определяет начало парковки.
Припаркованный до
 TicketStatus.ParkedUntil string

Определяет конец периода парковки.
Текст состояния парка
 TicketStatus.ParkStatusText string

Определяет текст состояния периода парковки.

Создание позиции билета

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

CreateTicketPosition

Параметры

Имя Ключ Обязательно Тип Описание
Ссылочный номер
 referenceNumber True string

Укажите билет или номер ссылки
Позиционный текст
 ticketPositionText True string

Введите текст позиции билета
Тип позиции
 TicketPositionType True integer

Укажите тип позиции
Видимость
 TicketPositionVisibility True integer

Укажите видимость положения (все пользователи или внутренние)
Идентификатор параметров группы полей
 TicketFieldGroupSettingsId string

Спецификация группы полей.
Идентификатор группы полей билета
 TicketFieldGroupId string

Спецификация группы полей билета.
Имя
 name string

Укажите имя поля.
Ценность
 value string

Укажите значение поля.
Парк до
 ParkUntil date-time

Укажите конец периода парковки.
Причина парка
 ParkingReason integer

Укажите причину
Причина парка
 ParkingPositionText string

Укажите повторную настройку парка.
Парк действий
 AfterParkingAction integer

Укажите видимость положения (все пользователи или внутренние)

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

Имя Путь Тип Описание
Message
 Message string

Message
Success
 Success boolean

Success
Билеты
 TicketNumber array of string

Билеты
Идентификатор позиции билета
 TicketPositionNumber string

Идентификатор созданной позиции билета
TicketStatus
 TicketStatus array of object
Номер билета
 TicketStatus.TicketNumber string

Номер билета
Припаркован?
 TicketStatus.IsParked boolean

Значение, если запрошенный билет припаркован.
Припаркован из
 TicketStatus.ParkedFrom string

Определяет начало парковки.
Припаркованный до
 TicketStatus.ParkedUntil string

Определяет конец периода парковки.
Текст состояния парка
 TicketStatus.ParkStatusText string

Определяет текст состояния периода парковки.