Миграция настроек Vinteo Desktop через групповые политики: различия между версиями
Ugr (обсуждение | вклад) |
Alina (обсуждение | вклад) |
||
(не показано 7 промежуточных версий 3 участников) | |||
Строка 2: | Строка 2: | ||
Начиная с версии 3.15, при каждом запуске десктоп-клиента, происходит загрузка настроек из файла ClientSettings для последующей миграции в десктоп-клиент. Файл ClientSettings нужно добавить в определенную папку: | Начиная с версии 3.15, при каждом запуске десктоп-клиента, происходит загрузка настроек из файла ClientSettings для последующей миграции в десктоп-клиент. Файл ClientSettings нужно добавить в определенную папку: | ||
− | * для Windows - %appData%/ | + | * для Windows - %appData%/VinteoDesktop |
* для MacOS - /Users/y/Library/Application Support/VinteoDesktop | * для MacOS - /Users/y/Library/Application Support/VinteoDesktop | ||
* для Linux - /home/.config/VinteoDesktop | * для Linux - /home/.config/VinteoDesktop | ||
Строка 10: | Строка 10: | ||
'''С полным списком настроек, доступных для миграции, можно ознакомиться по [https://schemas.dm1.vinteo.dev/clientSettingsSchema.json ссылке].''' | '''С полным списком настроек, доступных для миграции, можно ознакомиться по [https://schemas.dm1.vinteo.dev/clientSettingsSchema.json ссылке].''' | ||
− | Файл ClientSettings имеет | + | Файл ClientSettings имеет три группы настроек: |
− | * profile - настройки корпоративного профиля | + | * profile - настройки корпоративного профиля; |
− | * settings - настройки приложения | + | * settings - настройки приложения; |
+ | * emailInvitationTemplate - шаблон приглашения по email. | ||
== Параметры мигрируемых настроек == | == Параметры мигрируемых настроек == | ||
Строка 59: | Строка 60: | ||
| minimizeOnClose || boolean || Сворачивание приложения при закрытии | | minimizeOnClose || boolean || Сворачивание приложения при закрытии | ||
|- | |- | ||
− | | disableConfirms || boolean || | + | | disableConfirms || boolean || Выключить все диалоги подтверждения действий |
|- | |- | ||
− | | disableNotifications || boolean || | + | | disableNotifications || boolean || Выключить все уведомления |
|- | |- | ||
− | | disableErrors || boolean || | + | | disableErrors || boolean || Выключить все уведомления об ошибках |
|} | |} | ||
Строка 74: | Строка 75: | ||
=== Настройки корпоративного профиля (profile) === | === Настройки корпоративного профиля (profile) === | ||
− | Группа настроек profile содержит следующие настройки, | + | Группа настроек profile содержит следующие настройки, доступные для миграции корпоративного профиля: |
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
Строка 88: | Строка 89: | ||
<font color = 'red'>'''Важно!'''</font> | <font color = 'red'>'''Важно!'''</font> | ||
− | *Через группу настроек profile нельзя передать пароль пользователя; | + | * Через группу настроек profile нельзя передать пароль пользователя; |
− | * При каждой перезаписи корпоративного профиля | + | * При каждой перезаписи корпоративного профиля пароль предыдущего профиля удаляется из клиента; |
− | Если в группе настроек profile не хватает данных для подключения, то | + | Если в группе настроек profile не хватает данных для подключения, то при запуске клиента откроется диалоговое окно начальных настроек подключения (InitialSetupWizard), в котором необходимо заполнить недостающие данные. Данный шаг можно пропустить. |
'''Примеры недостающих данных в группе настроек profile''' | '''Примеры недостающих данных в группе настроек profile''' | ||
Строка 102: | Строка 103: | ||
Ниже приведен пример файла ClientSettings: | Ниже приведен пример файла ClientSettings: | ||
− | + | <source lang="json"> | |
+ | { | ||
+ | "version": 1, | ||
+ | "values": { | ||
+ | "settings": { | ||
+ | "displayName": { | ||
+ | "value": "Новая подпись", | ||
+ | "overwriteUserSettings": true | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </source> | ||
+ | |||
+ | =<span id = 'email_template'> Шаблоны приглашений по email (emailInvitationTemplate) </span>= | ||
+ | |||
+ | Данный параметр позволяет настраивать шаблон приглашения в конференцию по email. | ||
+ | |||
+ | '''Параметры шаблона''' | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Название !! Тип значения !! Описание | ||
+ | |- | ||
+ | | value || TEmailInvitationTemplate || Шаблон приглашения по email | ||
+ | |- | ||
+ | | overwriteUserSettings || boolean || Флаг использования шаблона. При значении true использует данный шаблон для приглашений по email. Иначе - использует стандартный шаблон приложения. По умолчанию - false. | ||
+ | |} | ||
+ | |||
+ | '''Шаблон приглашения по email (TEmailInvitationTemplate)''' | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Название !! Тип значения !! Описание | ||
+ | |- | ||
+ | | subject || string || Заголовок приглашения | ||
+ | |- | ||
+ | | body || TBodyEmailInvitationTemplate || Тело сообщения | ||
+ | |} | ||
+ | |||
+ | '''Тело сообщения (TBodyEmailInvitationTemplate)''' | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Название !! Тип значения !! Описание | ||
+ | |- | ||
+ | | value || string || Шаблон текста сообщения | ||
+ | |- | ||
+ | | optional || TOptionalBodyEmailInvitationTemplate || Опциональные параметры | ||
+ | |} | ||
+ | |||
+ | '''Опциональные параметры (TOptionalBodyEmailInvitationTemplate)''' | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Название !! Тип значения !! Описание | ||
+ | |- | ||
+ | | pinText || { textWhenFilled: string; textWhenEmpty: string } || Шаблон для отображения пин-кода конференции. Текст параметра textWhenFilled используется, когда конференция имеет пин-код. Иначе - используется текст из параметра textWhenEmpty. | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | '''Заполняемые поля шаблона''' | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Настройка !! Тип значения !! Описание | ||
+ | |- | ||
+ | | {userName} || string || Имя пользователя, отправившего приглашение | ||
+ | |- | ||
+ | | {conferenceUrl} || string || https-ссылка на подключение к конференции | ||
+ | |- | ||
+ | | {dialedNumber} || string || номер-конференции@домен | ||
+ | |- | ||
+ | | {pin} || string || пин-код | ||
+ | |- | ||
+ | | {pinText} || string || Шаблон для отображения пин-кода конференции | ||
+ | |} | ||
+ | |||
+ | '''Примеры''' | ||
+ | |||
+ | Ниже приведен пример файла ClientSettings: | ||
+ | <source lang="json"> | ||
+ | { | ||
+ | "version": 1, | ||
+ | "values": { | ||
+ | "emailInvitationTemplate": { | ||
+ | "value": { | ||
+ | "subject": "mailto:?subject=Приглашение в конференцию", | ||
+ | "body": { | ||
+ | "value": "&body={userName} приглашает вас принять участие в видеоконференции.%0A- ссылка: {conferenceUrl};%0A- номер конференции: {dialedNumber}{pinText}", | ||
+ | "optional": { | ||
+ | "pinText": { | ||
+ | "textWhenFilled": ";%0A- пин-код: {pin}.", | ||
+ | "textWhenEmpty": "." | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | }, | ||
+ | "overwriteUserSettings": false | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </source> |
Текущая версия на 14:40, 31 октября 2024
Содержание
Общее описание
Начиная с версии 3.15, при каждом запуске десктоп-клиента, происходит загрузка настроек из файла ClientSettings для последующей миграции в десктоп-клиент. Файл ClientSettings нужно добавить в определенную папку:
- для Windows - %appData%/VinteoDesktop
- для MacOS - /Users/y/Library/Application Support/VinteoDesktop
- для Linux - /home/.config/VinteoDesktop
Передаваемые настройки, в файле ClientSettings, хранятся в формате json и валидируются json-схемой на этапе чтения файла.
С полным списком настроек, доступных для миграции, можно ознакомиться по ссылке.
Файл ClientSettings имеет три группы настроек:
- profile - настройки корпоративного профиля;
- settings - настройки приложения;
- emailInvitationTemplate - шаблон приглашения по email.
Параметры мигрируемых настроек
Каждая настройка в группе представляет собой простой объект с двумя свойствами:
Свойство | Описание |
---|---|
value | Содержит значение настройки, которое будет мигрировано в приложение. Может иметь типы "string", "number" или "boolean" в зависимости от конкретной настройки |
overwriteUserSettings | Опциональный флаг принудительной миграции. При установке значения true, настройка из файла принудительно перепишет настройку пользователя в клиенте. При значении false или отсутствии флага, настройка будет перезаписана только если пользователь не изменял ее значение с момента первого запуска клиента. |
Настройки клиента (settings)
Группа настроек settings содержит следующие настройки:
Настройка | Тип значения | Описание |
---|---|---|
displayName | string | Отображаемое имя пользователя |
remoteMicControl | boolean | Разрешать модератору включать и выключать микрофон |
remoteCameraControl | boolean | Разрешить модератору включать и выключать камеру |
moveContentVideoToFullscreen | boolean | Запускать входящую презентацию в полноэкранном режиме |
autoOpenChat | boolean | Автоматически открывать чат при старте звонка или трансляции |
autoOpenParticipants | boolean | Автоматически открывать список участников при старте звонка или трансляции |
autoAnswer | boolean | Автоответ при входящем звонке |
autoMute | boolean | Выключение микрофона при автоответе |
autoFullscreen | boolean | Полноэкранный режим при автоответе |
hardwareNotification | boolean | Аппаратное оповещение |
autorun | boolean | Автозапуск |
minimizeOnClose | boolean | Сворачивание приложения при закрытии |
disableConfirms | boolean | Выключить все диалоги подтверждения действий |
disableNotifications | boolean | Выключить все уведомления |
disableErrors | boolean | Выключить все уведомления об ошибках |
Важно! При при попытке включения autoOpenChat и autoOpenParticipants, флаг autoOpenParticipants имеет приоритет. То есть, autoOpenParticipants будет включен, а autoOpenChat останется выключенным. Последовательность и одновременность передачи флагов не имеют значения.
Корпоративный профиль
Корпоративный профиль - это профиль, который создается и обновляется скриптами миграции. Отличие корпоративного профиля от прочих в уникальном uuid, который равен "uuid-corporate-profile-0fa76dd5-9c48-48de-be1b-75b8df1b2208". Данный профиль создается, если его еще нет в списке профилей подключения, либо обновляется при миграции.
Настройки корпоративного профиля (profile)
Группа настроек profile содержит следующие настройки, доступные для миграции корпоративного профиля:
Настройка | Тип значения | Описание |
---|---|---|
name | string | Логин пользователя. Опциональный параметр |
serverUrl | string | Адрес сервера подключения. Может содержать URL или IP сервера |
profileName | string | Имя корпоративного профиля - будет указано в качестве названия для корпоративного профиля подключения. Опциональный параметр |
Важно!
- Через группу настроек profile нельзя передать пароль пользователя;
- При каждой перезаписи корпоративного профиля пароль предыдущего профиля удаляется из клиента;
Если в группе настроек profile не хватает данных для подключения, то при запуске клиента откроется диалоговое окно начальных настроек подключения (InitialSetupWizard), в котором необходимо заполнить недостающие данные. Данный шаг можно пропустить.
Примеры недостающих данных в группе настроек profile
- Не заполнен serverUrl (адрес сервера подключения);
- Не заполнен displayName (отображаемое имя);
- Заполнены displayName, serverUrl и name (не хватает пароля).
Примеры
Ниже приведен пример файла ClientSettings:
{
"version": 1,
"values": {
"settings": {
"displayName": {
"value": "Новая подпись",
"overwriteUserSettings": true
}
}
}
}
Шаблоны приглашений по email (emailInvitationTemplate)
Данный параметр позволяет настраивать шаблон приглашения в конференцию по email.
Параметры шаблона
Название | Тип значения | Описание |
---|---|---|
value | TEmailInvitationTemplate | Шаблон приглашения по email |
overwriteUserSettings | boolean | Флаг использования шаблона. При значении true использует данный шаблон для приглашений по email. Иначе - использует стандартный шаблон приложения. По умолчанию - false. |
Шаблон приглашения по email (TEmailInvitationTemplate)
Название | Тип значения | Описание |
---|---|---|
subject | string | Заголовок приглашения |
body | TBodyEmailInvitationTemplate | Тело сообщения |
Тело сообщения (TBodyEmailInvitationTemplate)
Название | Тип значения | Описание |
---|---|---|
value | string | Шаблон текста сообщения |
optional | TOptionalBodyEmailInvitationTemplate | Опциональные параметры |
Опциональные параметры (TOptionalBodyEmailInvitationTemplate)
Название | Тип значения | Описание |
---|---|---|
pinText | { textWhenFilled: string; textWhenEmpty: string } | Шаблон для отображения пин-кода конференции. Текст параметра textWhenFilled используется, когда конференция имеет пин-код. Иначе - используется текст из параметра textWhenEmpty. |
Заполняемые поля шаблона
Настройка | Тип значения | Описание |
---|---|---|
{userName} | string | Имя пользователя, отправившего приглашение |
{conferenceUrl} | string | https-ссылка на подключение к конференции |
{dialedNumber} | string | номер-конференции@домен |
{pin} | string | пин-код |
{pinText} | string | Шаблон для отображения пин-кода конференции |
Примеры
Ниже приведен пример файла ClientSettings:
{
"version": 1,
"values": {
"emailInvitationTemplate": {
"value": {
"subject": "mailto:?subject=Приглашение в конференцию",
"body": {
"value": "&body={userName} приглашает вас принять участие в видеоконференции.%0A- ссылка: {conferenceUrl};%0A- номер конференции: {dialedNumber}{pinText}",
"optional": {
"pinText": {
"textWhenFilled": ";%0A- пин-код: {pin}.",
"textWhenEmpty": "."
}
}
}
},
"overwriteUserSettings": false
}
}
}