Skip to Content

Подключиться

alt

Элемент устанавливает локальное или удалённое соединение с 1С. Дочерние активности внутри этого контейнера используют подключённый клиент.

Как устроено подключение

В реальном режиме участвуют три компонента:

  1. Тестируемый клиент 1С - приложение, с которым работает робот (/TESTCLIENT).
  2. Менеджер тестирования 1С - отдельный процесс 1С с открытым встроенным PrimoOneSLoader.epf, который получает и запускает драйвер (/TESTMANAGER).
  3. Мост Primo - локальный HTTP-канал между Robot и внешней обработкой.

Контейнер Подключиться создаёт или использует это соединение. Все действия с 1С следует размещать внутри контейнера.

Свойства

Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.

  1. Подключаться к - Local - запуск/подключение к 1С на ЭТОМ компьютере. Remote - подключение к Primo.1C.Automation.Agent, запущенному на другом компьютере с 1С (см. группу свойств удалённого агента ниже); свойства локального подключения в этом случае не используются.
  2. Путь к 1С* - Путь к исполняемому файлу 1С (1cv8 или 1cv8c без расширения .exe), используется только когда свойство “Подключаться к” = Local (в этом случае свойство обязательно для заполнения).
  3. Режим базы - File - файловая информационная база (ключ /F). Server - клиент-серверная база (ключ /S) - требует заполнения свойства “Сервер”.
  4. Информационная база - Режим File: путь к файловой базе. Режим Server: ссылочное имя базы на сервере (используется вместе с “Сервер”).
  5. Сервер* - Адрес сервера 1С в формате “сервер” или “сервер:порт” (например, “srv1c:1541”). Используется только в режиме базы Server (в этом случае свойство обязательно для заполнения).
  6. Пользователь - Имя пользователя информационной базы.
  7. Пароль - Пароль пользователя информационной базы.
  8. Порт 1С (менеджер-клиент) - TCP порт, который сама 1С использует для связи менеджера и клиента тестирования (ключ /TPort) - внутренний протокол 1С, не связан с портом моста Primo ниже.
  9. Порт моста - HTTP-порт моста между Primo и 1С (PrimoOneSDriver). Необязателен при включённом “Присоединяться к запущенным” - если не указан, порт уже запущенного /TESTMANAGER будет найден автоматически. Указывайте явно только если запущено несколько менеджеров тестирования одновременно.
  10. Присоединяться к запущенным - Присоединяться к уже запущенным вручную процессам - и клиенту тестирования, и менеджеру тестирования с загруженным драйвером - вообще не запуская никаких новых процессов 1С (для итеративной отладки без 60-150 сек ожидания перезапуска 1С). TCP порт должен совпадать с тем, на который заранее настроен уже запущенный менеджер тестирования.
  11. Закрывать приложения - Завершать (закрывать) запущенные процессы 1С при отключении. Снимите флажок, чтобы оставить 1С открытой после завершения сценария (например, для последующего присоединения через “Присоединяться к запущенным”). Не действует, если процессы не запускались данной активностью (был включен признак “Присоединяться к запущенным”).
  12. Путь к драйверу (необязательно) - Необязательный путь к собственному EPF-загрузчику или драйверу (режим Real). По умолчанию заполнять не нужно: встроенный загрузчик и драйвер используются автоматически.
  13. Тайм-аут подключения, сек - Тайм-аут ожидания подтверждения подключения, в секундах (по умолчанию 180 - реальный запуск 1С может занимать 60-150 сек).
  14. Транспорт агента - FileBus - общая папка, доступная и этому компьютеру, и компьютеру агента, без открытых портов. Tcp - прямое TCP-соединение с агентом, быстрее, но требует сетевой связности и открытого порта. Используется только когда свойство “Подключаться к” = Remote.
  15. Адрес агента* - Адрес удалённого агента одной строкой. Используется при “Подключаться к:” = Remote (в этом случае свойство обязательно для заполнения). Формат зависит от свойства “Транспорт агента”: для Tcp - “host:port” (например, 192.168.50.183:9500) или “host:auto;папка” - порт своей сессии агент объявляет в этой папке файлом tcp-endpoint.json (обычно это папка шины, например C:\Users\Ivanov\Documents\termitinterop\1c-filebus); для FileBus - “БазоваяПапка;AgentId[;SessionId]” (SessionId необязателен, по умолчанию “default”).
  16. Ключ доступа к агенту - Ключ доступа клиента (accessKey в конфигурации агента). Нужен, если ключ задан у агента: команды без верного ключа агент отклоняет. Сам ключ по сети не передаётся. Пусто - без ключа. Храните ключ в защищённой переменной или хранилище учётных данных.
  17. Переменная клиента - Переменная, в которую сохраняется инстанс Primo.Automation1C.OneSClient - используется дочерними активностями через свойство Client.
  18. Подпись на схеме - необязательное пользовательское имя шага, отображаемое в процессе и журнале

Для первого запуска рекомендуется оставить порты пустыми и позволить активности выбрать свободные значения автоматически.

Релизы