Работа с Tessa Applications и приложениями¶

Настройка рабочего места и приложение Tessa Applications¶

На рабочем месте пользователя нужно установить:

Для Windows 7 SP1 и Windows 8.1 должен быть установлен .NET Framework 4.6.2 или выше. Windows 10 должна быть обновлена минимум до версии 1809 (номер сборки 10.0.17763), или любая версия старше. Для Windows 11 требования отсутствуют.
Приложение Tessa Applications из комплекта поставки.

Приложение Tessa Applications выполняет следующие функции:

Выполняет логин и получает с сервера Tessa список доступных пользователю приложений.
Позволяет одновременно подключаться к разным серверам Tessa.
Устанавливает приложения в профиль пользователя.
При запуске приложения проверяет обновления и обновляет приложения.
В том числе обновляет само себя.
Открывает ссылки tessa://...

В процессе установки необходимо будет указать адрес для подключения к серверу Tessa. Обычно он имеет вид https://servername/tessa.

В вашей поставке, полученной от партнера или вендора может присутствовать файл трансформы (mst), где уже указан правильный адрес подключения. При его использовании правильный адрес будет указан в настройках по умолчанию. В этом случае устанавливать приложение необходимо через файл setup.bat. При установке через групповые политики домена необходимо указать файл трансформы в настройках групповой политики.

Приложение Tessa Applications показывает доступные пользователю приложения. Предварительно приложения должны быть опубликованы администратором на сервере. Если пользователь администратор – то ему доступны и рабочее место администратора Tessa Admin, и рабочее место пользователя TessaClient. Если у пользователя нет прав администратора, то по умолчанию ему доступно только рабочее место пользователя TessaClient.

Второй важной задачей приложения является обработка ссылок на объекты СЭД TESSA. Если на компьютере установлен Tessa Applications, то при открытии ссылок вида tessa://tessaclient.tessa/... (так выглядят ссылки Tessa) – объект, на который ведет ссылка, откроется в приложении Tessa Client. При этом Tessa Applications и сам Tessa Client могут быть не запущены в момент открытия ссылки – они запустятся автоматически.

Также запустить Tessa Applications или сразу приложения Tessa Client/Tessa Admin можно с помощью ссылок: tessa://tessaappmanager, tessa://tessaclient.alias, tessa://tessaadmin.alias, где alias - это псевдоним сервера для запуска нужного приложения.

Important

Псевдоним сервера должен совпадать со значением параметра ServerCode, указанном в конфигурационном файле сервера (более подробно см. Руководство по установке СЭД TESSA). Если данные значения не совпадают, то некорректно будет работать обработка ссылок Tessa для открытия карточек и файлов.

Если при запуске Tessa Applications не смог авторизоваться на сервере при использовании Windows-аутентификации (Kerberos\NTLM), то он выдаст приглашение на ввод логина\пароля.

Основное окно Tessa Applications выглядит следующим образом:

Также, запущенное приложение видно в системном трее. Запускать приложения можно как из основной формы, так и из значка в трее:

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

Note

Если пользователю доступно только одно приложение, то оно запускается автоматически при запуске Tessa Applications.

Note

Пользователь обязательно должен быть предварительно занесен в справочник сотрудников Tessa (см. Создание карточки сотрудника).

Также, если приложение уже запущено, есть возможность запустить второй экземпляр приложения: удерживая клавишу [Ctrl] нажать на приложение; или же с помощью контекстного меню - нажав правую кнопку мыши на приложении и выбрав “Запустить второй экземпляр приложения”.

Обработка ссылок на объекты Tessa¶

Warning

Речь идет только про ссылки, обрабатываемые “толстым” клиентом. Для легкого web-клиента ссылки имеют привычный формат https://servername/tessa/web/....

Ссылки, с которыми умеет работать система, имеют вид:

tessa://tessaclient.tessa?param1=value1&param2=value2

В структуру ссылки входят:

Алиас приложения, для которого предназначается ссылка.
Код сервера. Определяет, для какого сервера будет запущено приложение.
Список параметров.

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

Ссылка на карточку.
Ссылка на файл.
Ссылка на версию файла.
Ссылка на узел дерева.

Получить ссылку на нужный объект можно в контекстном меню объекта (для узла дерева, файла и его версии) или в левой контекстной панели для карточки.

Note

При помощи механизма расширений можно определять новые типы ссылок.

В случае перехода пользователем по ссылке, Tessa Applications определяет по коду сервера и алиасу приложения, для какого приложения надо выполнить ссылку, и передаёт этому приложению соответствующую команду с набором параметров. Если ссылка не содержит кода сервера, то считается, что используется сервер, отмеченный в Tessa Applications как сервер по умолчанию. Если приложение не запущено, оно будет запущено автоматически. Tessa Applications также может быть не запущено в момент открытия ссылки - оно также запустится автоматически.

Публикация приложений¶

Note

Публикация всех приложений выполняется автоматически при установке TESSA на этапе выполнения Setup.bat или Upgrade.bat. Описанные ниже способы публикации используются, если необходимо опубликовать какие-либо изменения в приложении (например, проектные клиентские расширения).

Публикация приложений может осуществляться двумя способами:

При помощи специальных параметров запуска приложений и Tessa Applications. В этом случае приложения самостоятельно подключаются к серверу, указанному в параметрах командной строки или конфигурационном файле приложения и публикует само себя. Такой метод работает только для Windows. Этот подход описан в данном разделе.
При помощи утилиты командной строки tadmin. Такой подход работает и на Windows и на Linux. Сначала приложение упаковывается в формат jcard при помощи команды PackageApp, а затем публикуется на сервере при помощи административного импорта.

Пример публикации TessaClient.

Откройте папку в командной строке Applications\TessaClient.

Выполните команду, заменив SERVER_NAME на сетевое имя сервера приложений:

TessaClient.exe /publish /a:https://SERVER_NAME/tessa

Приложение подключится к серверу, указанном в параметре /a, выполнит логин при помощи Windows-аутентификации и опубликует приложение, если логин успешен и у пользователя есть права администратора. Если сервер не задан, то будет использоваться сервер, указанный в конфигурационном файле приложения app.json.

Note

Разрядность публикуемого приложения определяется автоматически, в папке “TessaClient” это 64-битная версия, в папке “TessaClient32” - 32-битная версия. Вы можете явно переопределить разрядность как 32-битную ключом /32bit, как 64-битную - ключом /64bit.

Note

Разрядность доступных пользователю для скачивания приложений определяется исходя из разрядности операционной системы или настройки “Архитектура приложений” в карточке сотрудника (установить настройку может администратор, см. Создание карточки сотрудника).

Аналогичный пример для публикации TessaAdmin.

Откройте папку в командной строке Applications\TessaAdmin.

Выполните команду, заменив SERVER_NAME на сетевое имя сервера приложений:

TessaAdmin.exe /publish /a:https://SERVER_NAME/tessa /admin

Параметр /admin публикует приложение с установленным флажком “Только для администраторов”.

В обоих случаях после выполнения команды появится небольшое окно с индикатором загрузки. Через некоторое время окно исчезнет, что означает, что публикация выполнена успешно.

При публикации можно указать логин/пароль по которыми будет производиться аутентификация. Пример такой публикации для Tessa Admin:

TessaAdmin.exe /publish /u:Admin /p:password /a:https://SERVER_NAME/tessa /admin

Так же примеры команд для публикации приложений есть в файлах publish_admin_demo.bat и publish_client_demo.bat для Tessa Admin и Tessa Client соответственно. Они находятся в папке “Applications” сборки платформы. Подробный список параметров можно найти в разделе Параметры командной строки приложений.

Опубликованные приложения становятся карточками системы специального типа “Приложение”.

Список опубликованных приложений можно посмотреть в Tessa Client, вкладка Администратор, представление Служебные → Приложения. В представлении отображен список карточек всех опубликованных приложений:

В карточке добавлены файлы опубликованного приложения, а также отображается информация по данному приложению:

Note

При изменении приложении и/или их расширений необходимо повторять публикацию, чтобы Tessa Applications мог обновить данные на рабочем месте пользователя.

Каждый раз при запуске приложения Tessa Applications получает с сервера информацию о списке файлов, опубликованных на сервере, и хеши от их контента. Далее проверяются локальные файлы приложения в профиле пользователя, если они отличаются по составу или хэшу - с сервера получаются необходимые файлы и обновляются\создаются\удаляются локальные файлы.

Tessa Applications умеет обновлять сам себя. Для этого нужно опубликовать приложение Tessa Applications (TessaAppManager.exe) на сервере как любое другое приложение. При запуске Tessa Applications проверяет наличие обновлений на сервере по умолчанию (отмечен звёздочкой в списке серверов). Если обновление есть, то оно загружается, затем Tessa Applications перезапускается.

Note

Разрядность скачиваемого приложения определяется в соответствии с настройками в карточке сотрудника, или автоматически по разрядности операционной системы пользователя. Пример обновления доступен в командном файле publish_appmanager_demo.bat.

Отключить автообновление Tessa Applications у конкретного пользователя можно, выставив на вкладке “Серверы” соответствующий флаг:

Note

Выставление данного флага никак не влияет на обновление приложений на любых серверах.

Публикация Deski¶

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

О том, как пользователи могут скачать и установить Deski описано в Руководстве пользователя. Чтобы пользователи смогли скачать данное приложение, оно должно быть опубликовано, а в карточке “Настройки сервера” должен быть снят флаг “Отключить приложение-ассистент web-клиента Deski”.

Note

Установщик Deski не требует прав администратора.

Публикация Deski выполняется автоматически при установке TESSA на этапе выполнения Setup.bat или Upgrade.bat, используя консольную команду tadmin. Если система была установлена вручную без задействования скриптов или же автоматическая публикация по каким-то причинам не прошла, то опубликовать Deski можно вручную с помощью консольной утилиты tadmin, используя команду PackageWebApp.

Чтобы опубликовать приложения Deski для любых операционных систем, можно создать bat файл со следующим содержанием:

Tools\tadmin PackageWebApp "DeskiSetup\Windows\en-US\x86\TessaDeski.msi" /out:app\deski.win32.en.jcard "/n:Windows 32 bit" /d:$Common_WebApplications_Description_Win32 /lang:en /os:Windows

Tools\tadmin PackageWebApp "DeskiSetup\Windows\ru-RU\x86\TessaDeski.msi" /out:app\deski.win32.ru.jcard "/n:Windows 32 bit" /d:$Common_WebApplications_Description_Win32 /lang:ru /os:Windows

Tools\tadmin PackageWebApp "DeskiSetup\Windows\en-US\x64\TessaDeski.msi" /out:app\deski.win64.en.jcard "/n:Windows 64 bit" /d:$Common_WebApplications_Description_Win64 /lang:en /os:Windows /64bit

Tools\tadmin PackageWebApp "DeskiSetup\Windows\ru-RU\x64\TessaDeski.msi" /out:app\deski.win64.ru.jcard "/n:Windows 64 bit" /d:$Common_WebApplications_Description_Win64 /lang:ru /os:Windows /64bit

Tools\tadmin PackageWebApp "DeskiSetup\Linux\x64\deski.zip" /out:app\deski.linux64.jcard "/n:Linux 64 bit" /d:$Common_WebApplications_Description_Linux64 /os:Linux /64bit

Tools\tadmin PackageWebApp "DeskiSetup\macOS\deski.zip" /out:app\deski.macos.jcard "/n:macOS" /d:$Common_WebApplications_Description_macOS /os:macOS /64bit

Tools\tadmin ImportCards app /a:https://SERVER_NAME/tessa /u:admin /p:admin /e

rd /S /Q app

Посмотреть карточки опубликованных приложений можно в Tessa Client, вкладка Администратор → Служебные → Приложения Web.

Подключение к другому серверу Tessa¶

В случае, если пользователю требуется доступ на разные сервера Tessa (например, один - рабочий, второй - тестовый), то необходимо в Tessa Applications добавить нужный сервер:

Перейти на вкладку Сервер и нажать на кнопку Добавить:

В окне добавления сервера укажите псевдоним и адрес тестового веб сервиса Tessa:

В полях логин/пароль можно указать учетные данные для запуска приложений не под текущим пользователем, а под каким-либо другим (зарегистрированном в справочнике сотрудников Tessa).

Также доступны настройки:
- Таймаут подключения - таймаут в секундах, по прошествии которого подключение считается неуспешным. 0 определяет значение по умолчанию, указанное в настройках app.json для TessaAppManager.
- Отключить аутентификацию Windows - если установлен флажок и в параметрах сервера не указан логин/пароль, то всегда отображается окно ввода логина/пароля. Если флажок снят, то сначала выполняется попытка подключения с использованием аутентификации Windows (Kerberos/NTLM), и в случае её неуспешности отображается окно ввода логина/пароля.
Important

Псевдоним сервера должен совпадать со значением параметра ServerCode, указанном в конфигурационном файле сервера (более подробно см. Руководство по установке СЭД TESSA). Если данные значения не совпадают, то некорректно будет работать обработка ссылок Tessa для открытия карточек и файлов.
В результате в Tessa Applications вы увидите доступные приложения с разных серверов:

Note

Для отображения приложений добавленного сервера необходимо, чтобы они были опубликованы на сервере и у вас были права доступа к данным приложениям (см. Руководство по установке СЭД TESSA).

Также добавить новый сервер в Tessa Applications можно с помощью специальных ссылок (см. Ссылки для добавления/изменения/удаления серверов в Tessa Applications).

Настройки подключения к серверам Tessa Applications хранятся в xml файле - application_catalogs.xml. Если Tessa Applications установлен в режиме для пользователя, то файл можно найти по пути: C:\Users\<UserName>\AppData\Roaming\tessa\settings\application_catalogs.xml. Если же Tessa Applications установлен в режиме для всех пользователей, то данный файл хранится в папке установки: C:\Program Files\Syntellect\Tessa Applications\app\application_catalogs.xml.

При запуске Tessa Applications считывает настройки подключений к серверам из данного файла. Имя пользователя и пароль (если они указаны для сервера) хранятся в данном файле в зашифрованном виде.

Группировка приложений¶

При необходимости опубликованные приложения можно сгруппировать (для удобства отображения в Tessa Applications).

В карточке приложения (Tessa Client, вкладка Администратор, представление Служебные → Приложения) в поле Группа для нужных приложений указываем название группы.

После обновления в Tessa Applications приложения будут сгруппированы. Можно выбрать группировку по серверам или по группам:

Ссылки для добавления/изменения/удаления серверов в Tessa Applications¶

Для быстрого и удобного изменения параметров сервера в Tessa Applications можно использовать ссылки, перейдя по которым у пользователя пропишутся необходимые настройки.

Для добавления/изменения одного из серверов в Tessa Applications используется ссылка в следующем формате:

tessa://tessaappmanager?Action=ServerParam&Alias=alias&Path=path&UserName=username&Password=password&OpenTimeOut=0&SkipWinAuth=false&IsDefault=true
- Alias - алиас сервера, который добавляется/изменяется, например: prod;
- Path - адрес сервера, например: https://tessa-server/tessa;
- UserName - имя пользователя, если аутентификация не доменная;
- Password - пароль (указывается, если было задано имя пользователя);
- OpenTimeOut - таймаут подключения в секундах или 0, если используется значение по умолчанию (из файла app.json);
- SkipWinAuth - true, если при незаданных логине/пароле будет отображаться окно входа вместо попытки выполнить аутентификацию Windows; false, если аутентификация Windows в этом случае выполняется (по умолчанию);
- IsDefault - true, если сервер назначается основным (т.е. тем, с которого Tessa Applications будет загружать обновления для себя самого). Если не основной - false.
  
  Note
  
  Все параметры необязательны, однако имеет смысл указать хотя бы один параметр при изменении сервера, и хотя бы Alias/Path при добавлении нового сервера.
Для удаления сервера в Tessa Application используется ссылка в следующем формате:

tessa://tessaappmanager?Action=RemoveServer&Alias=alias
- Alias - алиас удаляемого сервера.

Работа удаленных пользователей¶

Необходимо сразу заметить, что все приложения, включая Tessa Applications – взаимодействуют с сервером приложений по протоколу https (обычно это 443 порт).

Например, внутри локальной сети предприятия сервер Tessa доступен по пути https://tessa-ecm/tessa. Один из сотрудников работает из внешней сети, и у него нет доступа к этому адресу. Администраторы настроили сеть таким образом, что извне Tessa доступна по пути https://tessa.company.ru/tessa. В этом случае удаленному пользователю необходимо в Tessa Applications добавить новый сервер с адресом подключения https://tessa.company.ru/tessa (см Подключение к другому серверу Tessa или Ссылки для добавления/изменения/удаления серверов в Tessa Applications).

Однако самым безопасным способом доступа извне к серверу Tessa является доступ через VPN в сеть предприятия и затем уже доступ в Tessa поверх VPN.

Изменение расположения папки для загруженных приложений¶

Настройка расположения папки для загруженных приложений производится в конфигурационном файле %appdata%\tessa\settings\application_catalogs.xml в параметре AppPath, по умолчанию указана папка %localappdata%\tessa.

В параметре можно указать любой путь к папке загруженных приложений (подпапка applications от заданного пути) с учётом переменных окружения (%appdata%, %localappdata% и др.), в т.ч. указать путь, не являющийся частью переносимого профиля %appdata%.

Note

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

Приложение Tessa Applications скачивается и обновляется по пути, указанному в конфигурационном файле %ProgramFiles(x86)%\Syntellect\Tessa Applications\TessaAppLauncher.exe.config в параметре LocalAppPath, по умолчанию это папка %LocalAppData%\tessa (подпапка appmanager, appmanager_update и др.). Путь также можно переопределить в переменной окружения %Tessa.LocalAppPath%. Эта настройка работоспособна только для версии Tessa Applications 3.5.0 (и выше), установленной через msi-пакет (а не путем обновления с предыдущей версии).

Параметры командной строки приложений¶

Tessa Admin и Tessa Client

Параметр	Описание
/a	Задаёт базовый адрес подключения. При указании этого параметра адрес в конфигурации приложения игнорируется.
/u	Позволяет явно задать имя пользователя для аутентификации на сервере.
/p	Позволяет явно задать пароль для аутентификации на сервере.
/skipWinAuth	Укажите, чтобы при незаданных логине/пароле отображалось окно входа вместо попытки выполнить аутентификацию Windows.
/publish	Инициирует процесс публикации приложения.
/q	Включает режим тихой публикации, при которой на экран не выводится сообщений, отключается GUI и окно входа (если требуются логин/пароль), а любые ошибки и сообщения логируются. Используется только вместе с параметром /publish.
/64bit	Указывает, что публикуемое приложение использует 64-битную архитектуру. Если не указан этот ключ или /32bit, то используется фактическая разрядность процесса с запускаемым файлом. Используется только вместе с параметром /publish.
/32bit	Указывает, что публикуемое приложение использует 32-битную архитектуру. Если не указан этот ключ или /64bit, то используется фактическая разрядность процесса с запускаемым файлом. Используется только вместе с параметром /publish.
/admin	При публикации приложения устанавливает признак “только для администраторов”.
/hidden	При публикации приложения устанавливается признак “скрывать приложение в менеджере приложений”. Используется только вместе с параметром `/publish`.
/link	Запуск для обработки ссылки. В параметр передаются только параметры ссылки после `?.`, например: `TessaClient.exe "/link:Action=MyAction&Param1=value1"`. Удобно для отладки.
/meta	Переопределяет путь к файлу с клиентской метаинформацией. Если указано имя файла без пути (без слэшей), то используется стандартная папка (по умолчанию `%LocalAppData%\tessa\cache\SERVER_ADDRESS\tessa\APPLICATION_NAME`, где `APPLICATION_NAME` - строка `tessaclient` или `tessaadmin`). Если указан относительный путь, то он рассчитывается от папки с приложением. По умолчанию используется файл с именем `meta.json`. Рекомендуется переопределять только в том случае, если exe-файл запускается для одного и того же сервера приложений с различными логинами (определёнными параметрами `/u /p`). Пример: `TessaClient.exe /u:user1 /p:password /meta:meta.user1.json`.

Tessa Applications

Параметр	Описание
/a	Задаёт базовый адрес подключения. Используется только вместе с параметром /publish.
/u	Позволяет явно задать имя пользователя для аутентификации на сервере. Используется только вместе с параметром /publish, иначе игнорируется.
/p	Позволяет явно задать пароль для аутентификации на сервере. Используется только вместе с параметром /publish, иначе игнорируется.
/skipWinAuth	Укажите, чтобы при незаданных логине/пароле отображалось окно входа вместо попытки выполнить аутентификацию Windows. Используется только вместе с параметром /publish, иначе игнорируется.
/publish	Инициирует процесс публикации приложения.
/q	Включает режим тихой публикации, при которой на экран не выводится сообщений, отключается GUI и окно входа (если требуются логин/пароль), а любые ошибки и сообщения логируются. Используется только вместе с параметром /publish.
/64bit	Указывает, что публикуемое приложение использует 64-битную архитектуру. Если не указан этот ключ или /32bit, то используется фактическая разрядность процесса с запускаемым файлом. Используется только вместе с параметром /publish.
/32bit	Указывает, что публикуемое приложение использует 32-битную архитектуру. Если не указан этот ключ или /64bit, то используется фактическая разрядность процесса с запускаемым файлом. Используется только вместе с параметром /publish.
/hidden	При публикации приложения устанавливается признак “скрывать приложение в менеджере приложений”. Используется только вместе с параметром `/publish`.
/link	Запуск для обработки ссылки. В параметр передается ссылка целиком, например: `TessaAppManager.exe "/link:tessa://server.alias?Action=MyAction&Param1=value1"`.
/autostart	Запускает приложение в специальном режиме, который рекомендуется для настройки автозапуска в Windows. При этом не отображается окно загрузки и приложение запускается, сразу свёрнутым в трей.

Настройки приложений¶

У приложений есть конфигурационные файлы, в которых хранятся некоторые настройки, которые могут быть полезны в тех или иных случаях. Ниже описаны данные настройки и в каких случаях имеет смысл их менять. Конфигурационные файлы app.json расположены рядом с соответствующими выполняемыми файлами.

Включение аппаратного ускорения при выводе на экран

Включение данной настройки может исправить ошибки совместимости с приложениями, которые организуют терминальные сессии. Для включения аппаратного ускорения при выводе на экран в desktop-приложениях TessaClient, TessaAdmin и Tessa Applications в конфигурационном файле app.json в параметре SoftwareRendering необходимо указать true.

Warning

Включение данной настройки замедляет работу приложения, но может исправить ошибки совместимости с приложениями, которые организуют терминальные сессии. Используйте настройку с осторожностью, только в ситуации, когда она исправляет существующие ошибки, и предварительно убедившись в её работоспособности на компьютерах пользователей. Если эта настройка включена, то также установите настройку FadeAllowed равную false в том же конфигурационном файле.

Включение библиотеки для работы с современными сканерами

В конфигурационном файле app.json параметр NewTwainDSM определяет, будет ли использоваться библиотека twaindsm.dll (значение true), предоставляющая доступ к новым версиям API TWAIN для работы с современными сканерами, или же используется библиотека twain_32.dll (значение false), которая обеспечивает лучшую совместимость со старыми моделями сканеров.

Note

Значение по умолчанию false также подходит для большинства современных сканеров. Установите значение true только в том случае, если наблюдаются проблемы с некоторыми сканерами.

Настройка предпросмотра для 64-битных ОС

Область предпросмотра файлов имеет встроенные средства предпросмотра: изображения, txt, xml, html, pdf (отключается в “Моих настройках” для пользователя) и некоторые другие. Для всех прочих типов файлов используются стандартные обработчики предпросмотра, зарегистрированные в Windows. Например, для файлов docx обычно зарегистрирован предпросмотр Word, для файлов msg - Outlook, и др.

Для 32-битных операционных систем любые обработчики предпросмотра запускаются как 32-битные процессы, и описываемые настройки app.json игнорируются, но для 64-битных ОС они определяют разрядность используемого обработчика предпросмотра.

Для определения разрядности обработчика используется следующий алгоритм:

Выполняется поиск расширения файла в блоке FilePreview64Bit в app.json. Если расширение присутствует со значением true, то используется 64-битный предпросмотр, если false - 32-битный, если оно отсутствует - переходим к п.2.
Через реестр Windows TESSA определяет разрядность приложения предпросмотра. Если разрядность определена, то используется она. Если соответствующих ключей в реестре нет, то переходим к п.3.
В зависимости от настройки UseFilePreview64Bit в app.json используется либо 32-битный просмотр при значении false (в типовой поставке), либо 64-битный предпросмотр при значении true.

Если приложение предпросмотра завершается с ошибкой COMException E_FAIL, то система пробует запустить предпросмотр с противоположной разрядностью. Например, если выполнялся 32-битный предпросмотр, то запустится 64-битный предпросмотр. Это аналогично поведению Проводника Windows, и позволяет корректно использовать приложения, которые некорректно зарегистрированы в реестре, такие как Adobe Reader. Изменение разрядности может происходить не более одного раза для каждого расширения файла. Система запоминает разрядность успешно выполненного предпросмотра для расширения на время работы TessaClient.

Прочие параметры приложений

Note

Некоторые настройки могут отсутствовать у конкретного приложения. Например, настройка CanSaveCredentials есть только у Tessa Applications.

Параметр	Значение по умолчанию	Описание
BaseAddress	https://localhost/tessa	Адрес сервера приложений с установленными сервисами TESSA
SkipWinAuth	false	Если `true`, то при незаданных логине/пароле будет отображаться окно входа вместо попытки выполнить аутентификацию Windows; если `false`, то по умолчанию выполняется аутентификация Windows. Если указан параметр командной строки `/skipWinAuth`, то аутентификация Windows не выполняется в любом случае
Timeout	00:40:00	Таймаут на взаимодействие с сервером
Logo	-	Путь к файлу с изображением для замены стандартного логотипа при запуске клиента. Рекомендуется добавить изображение в папку приложения, в этом поле указать путь с символом `@`, например: `"@MyLogo.png"`, и опубликовать приложение для пользователей
LogoText	-	Имя, отображаемое под логотипом при запуске клиента. Можно указать строку с символами `\n`, заменяемыми на перевод строки
LogoHideFrame	false	Укажите `true`, чтобы скрыть рамку вокруг логотипа и текста при запуске клиента
LogoHideProgress	false	Укажите `true`, чтобы скрыть прогресс бар вокруг логотипа и текста при запуске клиента
LogoHideText	false	Укажите `true`, чтобы скрыть строку с названием системы при запуске клиента
LogoHideVersion	false	Укажите `true`, чтобы скрыть строку с версией при запуске клиента
LogoForeground	-	Укажите цвет текста и прогресс бара при запуске клиента в виде строки в формате `"#AARRGGBB"`; если `null` или пустая строка `""`, то используется цвет по умолчанию
LogoBackground	-	Укажите цвет фона при запуске клиента в виде строки в формате `"#AARRGGBB"`; если `null` или пустая строка `""`, то используется цвет по умолчанию
Title	-	Название, отображаемое вместо стандартного в заголовке открытого приложения
DefaultWallpaper	-	Путь к файлу для фонового изображения. При запуске TessaClient для пользователя будет установлено это фоновое изображение
WallpaperFolder	wallpapers	Папка для добавления новых фонов, которые будут доступны всем пользователям для выбора
ThemeFolder	themes	Папка с настройками тем оформления
ProbingPath	extensions	Относительный путь к папке, внутри которой будет выполнен поиск сборок .dll в дополнение к основной папке. Может быть указано несколько папок через точку с запятой
FadeAllowed	true	Включить затемнение при неактивном окне приложения (может быть полезным при работе в терминале)
ExtensionTracingMode	Off	Режим трассировки
MaxPreviewInstances	2	Максимальное количество одновременно возможных экземпляров процессов для предпросмотра файлов
CanSaveCredentials	true	Определяет, могут ли логин и пароль пользователя сохраняться локально в зашифрованном виде для любого сервера, к которому подключается Tessa Applications. Указав false, можно скрыть возможность ввести логин или пароль в окне настроек сервера, причём ранее введённые логины и пароли перестают использоваться (т.е. пользователю каждый раз придётся их вводить заново)
ProxyUri	http://127.0.0.1:8888	Адрес и порт для прокси-сервера. Базовый адрес и адрес прокси должны быть указаны как IP-адрес или имя сервера, но не как localhost (loopback-интерфейс игнорирует прокси). По умолчанию настройка закомментирована
ProxyClass	Tessa.UI.LoginDialogProxy, Tessa.UI	Настройка изменяет стандартный прокси-объект System.Net.IWebProxy на класс с указанным именем типа. Класс должен иметь конструктор с единственным параметром типа Uri - это адрес из настройки ProxyUri. Укажите `Tessa.UI.LoginDialogProxy, Tessa.UI`, чтобы использовать прокси с аутентификацией, при этом будет отображаться окно с логином-паролем. По умолчанию настройка закомментирована