Конфигурация "Библиотека Интернет-поддержки пользователей", редакция 2.4
Версия 2.4.1
После выполнения описанных ниже действий по переходу на новую версию библиотеки, для проверки правильности внедрения рекомендуется выполнить тесты, размещенные в файле Tests.zip, входящим в комплект поставки Библиотеки Интернет-поддержки пользователей.
Версия 2.4.2
Версия 2.4.2 является развитием редакции 2.4 продукта 1С:Библиотека интернет-поддержка пользователей. Версия 2.4.2 предназначена для разработки конфигураций, которые рассчитаны для работы на платформе «1С:Предприятие 8.3» версии 8.3.14 и выше. Для работы библиотеки необходимо наличие в конфигурации встроенной библиотеки стандартных подсистем (БСП) версии не ниже 3.1.2. Для работы библиотеки в конфигурации, рассчитанной на работу в модели сервиса, необходимо наличие в конфигурации встроенной библиотеки «Технология сервиса» (БТС) версии не ниже 1.2.1.
Новые возможности и изменения
-
Базовая функциональность Интернет-поддержки:
- Добавлены новые методы для перехода на страницы Портала 1С:ИТС;
- Добавлен метод сохранения параметров аутентификации Интернет-поддержки пользователей;
- Добавлена возможность переопределения номера версии программы при обращении к сервисам Интернет-поддержки пользователей.
-
Интеграция с платежными системами:
- В состав библиотеки включена новая подсистема "Интеграция с платежными системами". Ключевые функции:
- Регистрация новой учетной записи в платежной системе SWIP;
- Настройка интеграции с платежной системой SWIP;
- Выполнение оплаты и возвратов платежей через платежную систему.
-
Интеграция с 1С-Коннект:
- В состав библиотеки включена новая подсистема "Интеграция с 1С-Коннект". Ключевые функции:
- Хранение настроек подключения к программе 1С-Коннект;
- Запуск приложения 1С-Коннект.
-
Подключение сервисов сопровождения:
- Функциональность подключения тестовых периодов выделена в отдельную подсистему из подсистемы "Базовая функциональность Интернет-поддержки". Новая подсистема "Подключение сервисов сопровождения" реализует функции:
- Определение списка сервисов сопровождения, с которыми может взаимодействовать конфигурация;
- Получение информации о доступности подключения тестового периода;
- Выполнение подключения тестового периода.
-
Получение обновлений программы:
- В обработку "Обновление программы" добавлена интеграция с подсистемой "Центр мониторинга";
- Уточнено сообщение о рекомендуемой версии платформы;
- В обработку загрузки поставляемых данных исправлений (патчей) добавлены новые возможности:
- установка прокси-сервера отличного от учетной системы;
- увеличены таймауты на "тяжелые запросы";
- повторы вызовов операций в случае завершения получения данных по таймауту.
-
Новости:
- Метод ПоказатьКонтекстныеНовости общего модуля ОбработкаНовостейКлиент:
- Параметр ПараметрыОткрытияФормы, добавлена обработка новых ключей:
- Ключ СписокНовостей - позволяет дополнять список контекстных новостей;
- Ключ СортировкаСпискаНовостей - позволяет задавать произвольную сортировку;
- Ключ ПропуститьЗаполнениеНовостями - в комбинации с ключом СписокНовостей позволяет полностью переопределить список показываемых новостей.
- Подробное описание подсистем см. в документации по внедрению и настройке библиотеки (
http://its.1c.ru/db/uisldoc).
Переход на версию 2.4.2 с версии 2.4.1
Базовая функциональность Интернет-поддержки
- Добавлены новые методы программного интерфейса. Необходимо ознакомиться с описанием методов в коде и при необходимости задействовать их:
- ИнтернетПоддержкаПользователей.СохранитьДанныеАутентификации. Сохраняет логин и пароль пользователя в подсистеме Интернет-поддержки в безопасном хранилище;
- ИнтернетПоддержкаПользователейКлиент.ОткрытьГлавнуюСтраницуПортала. Открывает главную страницу Портала;
- ИнтернетПоддержкаПользователейКлиент.ОткрытьСтраницуРегистрацииНовогоПользователя. Открывает страницу Портала для регистрации нового пользователя;
- Добавлены новые переопределяемые методы. Необходимо ознакомиться с описанием методов в коде и при необходимости задействовать их:
- ИнтернетПоддержкаПользователейПереопределяемый.ПриОпределенииНомераВерсииПрограммы. Позволяет переопределить номер версии конфигурации, который используется для сервисов сопровождения.
- Процедура ИнтернетПоддержкаПользователейПереопределяемый.ПриОпределенииСервисовСопровождения отмечена как устаревшая и оставлена для обратной совместимости. Рекомендуется перенести реализацию в новую процедуру ПодключениеСервисовСопровожденияПереопределяемый.ПриОпределенииСервисовСопровождения.
Интеграция с платежными системами
- Добавлены новые методы программного интерфейса. Необходимо ознакомиться с описанием методов в коде и при необходимости задействовать их:
- ИнтеграцияСПлатежнымиСистемами.ДоступнаОплатаВПлатежныхСистемах. Определяет доступность использования функциональности оплаты в платежной системе;
- ИнтеграцияСПлатежнымиСистемами.ОписаниеЗаказаНаОплату. Формирует новое описание заказа на оплату в платежной системе;
- ИнтеграцияСПлатежнымиСистемами.ОплатитьВПлатежнойСистеме. Создает новый заказ на оплату в платежной системе;
- ИнтеграцияСПлатежнымиСистемами.ОтменитьЗаказНаОплату. Отменяет заказ на оплату, если оплата не была ранее подтверждена покупателем;
- ИнтеграцияСПлатежнымиСистемами.ОтменитьОплату. Отменяет оплату в платежной системе;
- ИнтеграцияСПлатежнымиСистемами.ВозвратОплаты. Выполняет возврат оплаты покупателю по ранее созданному заказу на оплату;
- ИнтеграцияСПлатежнымиСистемами.ИнформацияОЗаказеНаОплату. Производит поиск заказа на оплату в платежной системе по идентификатору;
- ИнтеграцияСПлатежнымиСистемамиКлиент.НастройкиИнтеграции. Открывает форму настройки интеграции с платежными системами;
- ИнтеграцияСПлатежнымиСистемамиКлиент.ПечатьИнформацииДляТехПоддержки. Формирует информацию для тех. поддержки платежной системы;
- ИнтеграцияСПлатежнымиСистемамиКлиент.УдалитьИдентификаторОплаты. Удаляет идентификатор оплаты платежной системы из информационной базы.;
- Добавлены новые переопределяемые методы. Необходимо ознакомиться с описанием методов в коде и при необходимости задействовать их:
- ИнтеграцияСПлатежнымиСистемамиПереопределяемый.ПриОпределенииДоступностиРегистрацииSWIP. Для конфигураций, которые не ведут учет по организациям, можно отключить функциональность регистрации нового пользователя SWIP;
- ИнтеграцияСПлатежнымиСистемамиПереопределяемый.ПриОпределенииДанныхОрганизацииSWIP. Определяются данные организации, которые необходимы для регистрации нового пользователя в платежной системе SWIP;
- ИнтеграцияСПлатежнымиСистемамиПереопределяемый.ПриОпределенииДанныхБанковскогоСчетаSWIP. Определяются данные банковского счета, которые необходимы для регистрации нового пользователя в платежной системе SWIP;
- ИнтеграцияСПлатежнымиСистемамиКлиентПереопределяемый.ПриОткрытииФормыНастроекИнтеграции. Открывает форму настройки интеграции с платежными системами в момент настройки торговой точки;
Интеграция с 1С-Коннект
Функциональность подсистемы ВызовОнлайнПоддержки перенесена из Библиотеки стандартных подсистем в Библиотеку интернет-поддержки. В будущем подсистема ВызовОнлайнПоддержки будет удалена из Библиотеки стандартных подсистем и на текущий момент оставлена для плавного перехода на новую реализацию. Для корректной миграции объектов метаданных в новую реализацию подсистемы необходимо:
- Снять все объекты подсистемы ВызовОнлайнПоддержки с поддержки
- Удалить все объекты подсистемы ВызовОнлайнПоддержки (в том числе и саму подсистему) кроме Константа.ИспользоватьОнлайнПоддержку и Роль.ВызовОнлайнПоддержки
- Выполнить перенос объектов подсистемы ИнтеграцияСКоннект Библиотеки интернет-поддержки. Оставшиеся объекты должны встать на поддержку новой версии Библиотеки интернет-поддержки.
- Удалить информацию о подсистеме ВызовОнлайнПоддержки из справки формы ИнтернетПоддержкаИСервисы обработки ПанельАдминистрированияБСП.
- Перенести информацию о подсистеме ИнтеграцияСКоннект из справки формы ИнтернетПоддержкаИСервисы обработки ПанельАдминистрированияБСП. Информацию необходимо переносить из поставки Библиотеки интернет-поддержки.
После завершения всех вышеописанных шагов необходимо ознакомиться с программным интерфейсом общих модулей ИнтеграцияСКоннект и ИнтеграцияСКоннектКлиент, а также с документацией по внедрению подсистемы.
Для корректной работы подсистемы необходимо обновить Библиотеку стандартных подсистем до версии 3.1.2.291
Подключение сервисов сопровождения
Функциональность подключения тестовых периодов выделена в отдельную подсистему из подсистемы "Базовая функциональность Интернет-поддержки". Подсистема может быть встроена в программу в случае использования функциональности подключения тестовых периодов. При переходе на новую реализацию следует учитывать:
- Если функциональность подключения тестовых периодов использует библиотека, и подсистема не является обязательной для встраивания (для этой библиотеки), следует перед вызовом программного интерфейса добавить проверку существования функциональности подключения тестовых периодов;
Если ОбщегоНазначения.ПодсистемаСуществует("ИнтернетПоддержкаПользователей.ПодключениеСервисовСопровождения") Тогда
   МодульПодключениеСервисовСопровождения = ОбщегоНазначения.ОбщийМодуль("ПодключениеСервисовСопровождения");
   РезультатПроверки = МодульПодключениеСервисовСопровождения.ДоступноПодключениеТестовогоПериода(Идентификаторы);
КонецЕсли;
- Процедура ИнтернетПоддержкаПользователейПереопределяемый.ПриОпределенииСервисовСопровождения отмечена как устаревшая и оставлена для обратной совместимости. Рекомендуется перенести реализацию в новую процедуру ПодключениеСервисовСопровожденияПереопределяемый.ПриОпределенииСервисовСопровождения.
В остальном программный интерфейс и логика работы функциональности не изменились.
Получение обновлений программы
Необходимо обновить обработку поставляемых данных ПолучениеИсправленийПоставляемыеДанные в Менеджере сервиса.
Версия 2.4.1
Версия 2.4.1 является развитием редакции 2.3 продукта 1С:Библиотека интернет-поддержка пользователей. Версия 2.4.1 предназначена для разработки конфигураций, которые рассчитаны для работы на платформе «1С:Предприятие 8.3» версии 8.3.14 и выше. Для работы библиотеки необходимо наличие в конфигурации встроенной библиотеки стандартных подсистем (БСП) версии не ниже 3.1.1. Для работы библиотеки в конфигурации, рассчитанной на работу в модели сервиса, необходимо наличие в конфигурации встроенной библиотеки «Технология сервиса» (БТС) версии не ниже 1.2.1.
Новые возможности и изменения
-
Базовая функциональность Интернет-поддержки:
- Реализована интеграция с библиотеками: Стандартные подсистемы (БСП) и Технология сервиса (БТС).
-
Работа с классификаторами:
- В целях оптимизации обращений к сервису, в подсистему добавлена возможность кэширования файлов классификаторов непосредственно в информационной базе;
- Для уведомления пользователей об устаревании классификаторов, добавлена функциональность определения даты последнего обновления;
- В настройках подсистемы появилась возможность выбрать режим обновления классификаторов:
- По расписанию через Интернет;
- По расписанию из файла;
- Оптимизирована интерактивная загрузка классификаторов из файла;
- При интерактивном обновлении классификаторов, пользователь может выполнить загрузку, несмотря на актуальный номер версии классификатора.
- Подробное описание подсистем см. в документации по внедрению и настройке библиотеки (
http://its.1c.ru/db/uisldoc).
Переход на версию 2.4.1 с версии 2.3.4
Базовая функциональность
Получение обновлений программы
- Добавлены новые методы программного интерфейса. Необходимо ознакомиться с описанием методов в коде и при необходимости задействовать их.
- ПолучениеОбновленийПрограммыКлиент.ПриПроверкеВерсииПлатформыПриЗапуске(). Отображает при начале работы программы форму помощника "Переход на новую версию платформы 1С:Предприятие"
Работа с классификаторами
- Добавлены новые методы программного интерфейса. Необходимо ознакомиться с описанием методов в коде и при необходимости задействовать их.
- РаботаСКлассификаторами.УстановитьДатуОбновленияКлассификатора();
- РаботаСКлассификаторами.ДатаОбновленияКлассификатора();
- В целях оптимизации обращений к сервису, в подсистему добавлена возможность кэширования файлов классификаторов непосредственно в информационной базе. Настройка кэширования определяется при регистрации классификатора в переопределяемом методе РаботаСКлассификаторамиПереопределяемый.ПриДобавленииКлассификаторов. Данные из кэша получаются при вызове метода программного интерфейса РаботаСКлассификаторами.ПолучитьФайлыКлассификаторов. Так как файлы физически хранятся в информационной базе, не следует использовать кэш для хранения больших классификаторов. Если классификатор имеет значительный размер, лучше создать для хранения его данных отдельный объект метаданных.
Монитор Портала 1С:ИТС
- Удалены ранее отмеченные как устаревшие процедуры:
- МониторИнтернетПоддержкиКлиент.ОткрытьМониторИнтернетПоддержки();
1СПАРК Риски
- Методы программного интерфейса перенесены в служебный программный интерфейс, т.к. используются только для интеграции подсистем библиотеки:
- СПАРКРискиКлиент.ПриОбработкеВыбораТабличногоДокумента();
- СПАРКРискиКлиент.ПриОбработкеРасшифровки();
- СПАРКРискиКлиент.ИнтернетПоддержкаИСервисы_ИспользоватьСервисСПАРКРискиПриИзменении();
Новости
- Удалены неиспользуемые картинки:
- СтатусНовости_ГотоваКПубликации;
- СтатусНовости_Опубликована;
- СтатусНовости_Отсутствует;
- СтатусНовости_Черновик.
- Следующие методы перенесены из "СлужебныеПроцедурыИФункции" в "ПрограммныйИнтерфейс" без изменения функциональности:
- ОбработкаНовостейКлиент.ПанельКонтекстныхНовостей_ЭлементПанелиНовостейНажатие;
- ОбработкаНовостейКлиент.ПанельКонтекстныхНовостей_ЭлементПанелиНовостейОбработкаНавигационнойСсылки;
- Следующие методы перенесены из "ПрограммныйИнтерфейс" в "СлужебныеПроцедурыИФункции" без изменения функциональности:
- ОбработкаНовостейПовтИсп.РазрешенаРаботаСНовостями;
- ОбработкаНовостейПовтИсп.РазрешенаРаботаСНовостямиТекущемуПользователю;
- ОбработкаНовостейПовтИсп.РазрешенаРаботаСНовостямиЧерезИнтернет;
- ОбработкаНовостейПовтИсп.ПолучитьИмяПользователяИБ;
- ОбработкаНовостейПовтИсп.ПолучитьПользователяПоИмениПользователяИБ;
- ОбработкаНовостейПовтИсп.ЕстьРолиЧтенияНовостей;
- ОбработкаНовостейПовтИсп.ЕстьРольПолныеПрава;
- ОбработкаНовостейПовтИсп.ЕстьРольАдминистраторСистемы;
- ОбработкаНовостейПовтИсп.ЭтоАдминистратор;
- ОбработкаНовостейПовтИсп.ПараметрыТекущегоПользователя;
- ОбработкаНовостейПовтИсп.ПолучитьСписокРедакторовНовостей;
- ОбработкаНовостейПовтИсп.ПолучитьЛентуНовостейПоКоду;
- ОбработкаНовостейПовтИсп.ПолучитьОтключенныеЛентыНовостей;
- Добавлены методы в "ПрограммныйИнтерфейс":
- ОбработкаНовостей.РазрешенаРаботаСНовостями;
- ОбработкаНовостей.РазрешенаРаботаСНовостямиТекущемуПользователю;
- ОбработкаНовостей.РазрешенаРаботаСНовостямиЧерезИнтернет;
- ОбработкаНовостей.ПолучитьЛентуНовостейПоКоду;
- ОбработкаНовостей.ПолучитьОтключенныеЛентыНовостей;
- ОбработкаНовостей.ПараметрыТекущегоПользователя;