API для пользователей сервисов (сервис InformationCenterIntegration)

Для доступа к обращениям пользователей от лица пользователей сервисов и работе с этими обращениями, приложение 1С:Управление службой поддержки предоставляет веб-сервис ImformationICenterIntegration.
Веб-сервис построен по технологии SOAP и может использоваться как приложениями облачных сервисов Фреш, так и сервисами на основе других технологий. Контракт работы с веб-сервисом описан в этом документе. Примеры работы с веб-сервисом можно посмотреть и в конфигурации  1С:Библиотека технологии сервиса .

Операция getIncidents

Операция предназначена для получения списка обращений.
Возвращаемое значение: IncidentListPresentation

Пример вызова операции на языке 1С:Предприятие при использовании библиотеки 1С:Библиотека технологии сервиса:

WSПрокси = ИнформационныйЦентрСервер.ПолучитьПроксиСлужбыПоддержки();
Результат = WSПрокси.getIncidents(Строка(ИдПользователя), ТекущаяСтраница, "New", "LastInteractionDate");

▲ в начало

Операция getIncident

Операция предназначена для получения одного обращения.
Возвращаемое значение: Incident

Пример вызова операции на языке 1С:Предприятие при использовании библиотеки 1С:Библиотека технологии сервиса:

WSПрокси = ИнформационныйЦентрСервер.ПолучитьПроксиСлужбыПоддержки();
Результат = WSПрокси.getInteraction(Строка(ИдПользователя), Строка(ИдВзаимодействия), ТипВзаимодействия, Входящее);

▲ в начало

Операция getInteractions

Операция предназначена для получения списка взаимодействий.
Возвращаемое значение: string

Пример вызова операции на языке 1С:Предприятие при использовании библиотеки 1С:Библиотека технологии сервиса:

WSПрокси = ИнформационныйЦентрСервер.ПолучитьПроксиСлужбыПоддержки();
Результат = WSПрокси.getInteractions(Строка(ИдПользователя), Строка(ИдОбращения), ТекущаяСтраница);

▲ в начало

Операция getInteraction

Операция предназначена для получения одного взаимодействия.
Возвращаемое значение: Interaction

Пример вызова операции на языке 1С:Предприятие при использовании библиотеки 1С:Библиотека технологии сервиса:

WSПрокси = ИнформационныйЦентрСервер.ПолучитьПроксиСлужбыПоддержки();
Результат = WSПрокси.getInteraction(Строка(ИдПользователя), Строка(ИдВзаимодействия), ТипВзаимодействия, Входящее);

▲ в начало

Операция getInteractionFile

Операция предназначена для получения присоединенного файла из взаимодействия.
Возвращаемое значение: File

Пример вызова операции на языке 1С:Предприятие при использовании библиотеки 1С:Библиотека технологии сервиса:

// Получение файла 
WSПрокси = ИнформационныйЦентрСервер.ПолучитьПроксиСлужбыПоддержки();
Результат = WSПрокси.getInteractionFile(Строка(ИдПользователя), Строка(ИдВзаимодействия), Строка(ИдФайла), ТипВзаимодействия, Входящее);
// Помещение ответа во временное хранилище
АдресХранилища = ПоместитьВоВременноеХранилище(Результат.Data, УникальныйИдентификатор);
ИмяФайла = Результат.Name + "." + Результат.Extension;

▲ в начало

Операция setInteractionsViewed

Операция предназначена для установки признака просмотренности для списка взаимодействий.
Возвращаемое значение: boolean

Пример вызова операции на языке 1С:Предприятие при использовании библиотеки 1С:Библиотека технологии сервиса:

WSПрокси = ИнформационныйЦентрСервер.ПолучитьПроксиСлужбыПоддержки();
Фабрика = WSПрокси.ФабрикаXDTO;
ТипСписокВзаимодействий = Фабрика.Тип("http://www.1c.ru/1cFresh/InformationCenter/SupportServiceData/1.0.0.1", "ListInteraction");
СписокВзаимодействийXDTO = Фабрика.Создать(ТипСписокВзаимодействий);
МассивСтрок = Элементы.СписокВзаимодействий.ВыделенныеСтроки;
Для Каждого ЭлементМассива Из МассивСтрок Цикл 
	...
	ВзаимодействиеXDTO = СформироватьВзаимодействиеXDTO(НайденнаяСтрока, Фабрика);
	СписокВзаимодействийXDTO.Interactions.Добавить(ВзаимодействиеXDTO);
КонецЦикла;
WSПрокси.setInteractionsViewed(Строка(ИдентификаторПользователя), СписокВзаимодействийXDTO);

▲ в начало

Операция addComments

Операция предназначена для добавления комментария пользователя.
Возвращаемое значение: boolean

Пример вызова операции на языке 1С:Предприятие при использовании библиотеки 1С:Библиотека технологии сервиса:

WSПрокси = ИнформационныйЦентрСервер.ПолучитьПроксиСлужбыПоддержки();
СписокФайловXDTO = СформироватьСписокФайловXDTO(WSПрокси.ФабрикаXDTO);
WSПрокси.addComments(Строка(ИдПользователя), Строка(ИдОбращения), ТемаСообщения, ТекстHTML, СоздаватьОбращение,  СписокФайловXDTO, ОбластьДанных, АдресДляОтвета);

▲ в начало

Свойства операций

Класс Filter

Определяет отбор обращений 
Значения перечисления:

• All – Все (без отбора)
• Closed – Закрытые
• InProgress – В работе
• NeedAnswer – Требующие ответа
• New – Новые

▲ в начало

Класс Sort

Определяет порядок сортировки обращений 
Значения перечисления:

• CreateDate – По дате создания
• LastInteractionDate – По дате последнего взаимодействия

▲ в начало

Класс TypeInteracion

Определяет типы взаимодействий с пользователем 
Значения перечисления:

• Email – Электронное письмо
• Comment – Комментарий пользователя
• PhoneCall – Телефонный звонок

▲ в начало

Класс ListInteraction

Содержит список взаимодействий

▲ в начало

Класс ListFile

Содержит список файлов

▲ в начало

Обращения

Класс Incident

Описывает обращение в службу поддержки.
Работу с классом можно посмотреть в обработке ИнформационныйЦентр в форме ОбращенияВСлужбуПоддержки.

▲ в начало

Класс IncidentListPresentation

Описывает представление страницы со списком обращений

▲ в начало

Свойства класса

Класс UserIncidenStatus

Определяет состояния обащений 
Значения перечисления:

• Closed – Закрыто
• InProgress – В работе
• NeedAnswer – Требует ответа
• New – Новое

▲ в начало

Взаимодействия

Класс Interaction

Описывает объекты взаимодействий с пользователем сервиса в службе поддержки.
Пример работы с классом можно посмотреть в обработке ИнформационныйЦентр в форме ВзаимодействиеПоОбращению.

▲ в начало

Класс InteractionListPresintation

Описывает представление страницы со списком взаимодействий

▲ в начало

Файлы

Класс File

Описывает присоединенные файлы к обращению службы поддержки.
Пример работы с классом можно посмотреть в обработке ИнформационныйЦентр в форме ВзаимодействиеПоОбращению.

▲ в начало