Приложение Excel
Excel workbook
Last updated
Excel workbook
Last updated
Контейнер, который производит подключение к приложению Microsoft Excel и открывает указанный файл. Настройки подключения и путь до файла указываются в свойствах контейнера.
Вы можете добавлять в контейнер Приложение Excel другие элементы из группы Excel для работы с открытым файлом. В конце работы используйте элемент Сохранить документ, чтобы все изменения в файле применились.
Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. здесь.
Драйвер [LTools.Office.Model.InteropTypes] — тип драйвера подключения: DX или Interop. Драйвер определяет особенности работы с файлом. По умолчанию используется DX. Сравнительная таблица драйверов
| Характеристика | DX (DevExpress) | Interop |
|---|---|---|
Тип подключения | Работает с файлом без Microsoft Office. Это означает, что Microsoft Excel на компьютере робота может отсутствовать | Работает с файлом через запуск приложения Microsoft Excel |
ОС | Windows, Linux, MacOS | Только Windows |
Поддерживает макросы и скрипты VBA | Нет | Да |
Скорость работы | Выше | Ниже |
Путь к файлу [String] — путь к файлу документа Excel. Пример: @"C:\folder\file.xlsx". Символ @ используется для экранирования обратного слеша.
Пароль [String] — пароль для открытия защищенного файла Excel.
Пароль (зашифрованный) [SecureString] — зашифрованный пароль от файла. В целях безопасности пароль в формате SecureString не хранится в открытом виде. Получить его можно, например, из программы «Диспетчер учетных данных» (Credential Manager), после чего вставить в это поле.
Проверять файл [Boolean] — определяет, нужно ли проверять наличие указанного файла Excel. Возможные значения:
чекбокс установлен — если проверка обнаружит, что указанного файла не существует, робот завершит работу с ошибкой;
чекбокс снят — робот выполнит работу без ошибок, даже если файла не существует. При попытке записать информацию в несуществующий файл, будет создан файл Excel с указанным именем. В конце работы этот файл потребуется сохранить.
Массив байтов [byte[]] — массив байтов документа. Если указан массив, то свойство «Путь к файлу» заполнять не нужно. Свойство работает с обоими драйверами.
Присоединяться [Boolean] — только для Interop. Установка чекбокса позволяет присоединиться к файлу, который открыт вручную. Закрывать такой файл тоже придется вручную.
Открывать только на чтение [Boolean] — только для Interop. Определяет, нужно ли открывать указанный файл только для чтения. По умолчанию чекбокс не установлен. Настройка будет проигнорирована в следующих случаях:
если включено свойство «Присоединяться»;
если указан массив байтов;
если используется файл в формате текста с разделителями.
Загружать AddIn-ы [Boolean] — только для Interop. Определяет, нужно ли переподключать установленные дополнения (надстройки). Общие сведения о надстройках Excel приведены здесь. Подробнее о работе этого свойства см. ниже, в подразделе Надстройки Excel.
Отображать Excel [Boolean] — только для Interop. Если параметр включен, на экране будет отображаться приложение Excel.
R1C1 [Boolean] — только для DX. Установка чекбокса позволяет указывать диапазон ячеек в элементах Excel, используя стиль ссылок R1C1. По умолчанию чекбокс выключен, а диапазоны указываются в формате A1. При использовании стиля R1C1, убедитесь, что он также установлен в файле Excel — подробнее см. в подразделе Стиль ссылок R1C1.
Сохранить изменения [Boolean] — По умолчанию чекбок неактивен, что позволяет избежать случайного сохранения изменений. При активации чекбокса внесенные изменения будут сохранены автоматически. Функция доступна с версии 1.24.10
Разделитель [String] — разделитель колонок в файле с расширением *.csv. По умолчанию ";". Для режима Interop необходима кодировка UTF-8 BOM или UTF-16 LE.
Excel может использовать стиль ссылок R1C1, в котором строки и столбцы представлены в виде чисел на рабочем листе. Стиль ссылок R1C1 полезен для вычисления позиций строк и столбцов в макросах. В стиле R1C1 Excel указывает расположение ячейки с "R", за которой следует номер строки, и "C", за которой следует номер столбца.
Чтобы установить/снять в Excel стиль R1C1, выполните действия:
Запустите Microsoft Excel.
В меню Файл щелкните пункт Параметры.
Откройте вкладку Формулы.
В разделе Работа с формулами щелкните, чтобы установить/снять чекбокс Стиль ссылок R1C1, затем нажмите кнопку ОК.
При установке чекбокса Стиль ссылок R1C1 будет изменен стиль ссылок заголовков строк и столбцов, а ссылки на ячейки из стиля A1 изменятся на стиль R1C1.
Чтобы воспользоваться установленными надстройками в Excel, их требуется перезагрузить. За это в контейнере отвечает свойство Загружать AddIn-ы: с его помощью будет совершена попытка переподключить все активные надстройки. Список активных надстроек можно просмотреть в Excel в меню Файл > Параметры > Надстройки.
Однако бывают случаи, когда использование свойства не помогает загрузить какую-то надстройку. Например, если для нее нужны права администратора, или если есть конфликт с центром безопасности MS Office. В этом случае воспользуйтесь рекомендациями ниже, в зависимости от выбранного способа запуска приложения.
Например, права администратора нужны для установки/удаления надстроек COM. Свойство Загружать AddIn-ы не сможет их установить.
Если запуск робота не приводит к перезагрузке надстроек, то, вероятно, происходит вмешательство центра безопасности MS Office. Например, источник файла расценивается как неблагоприятный. В этом случае следует правильным образом сконфигурировать MS Office: необходимо, чтобы при вызове приложения по ярлыку (Пуск > Программы > Excel) оно загружало требуемые надстройки без ограничений от центра безопасности. Тогда Еxcel, запущенный через контейнер Приложение Excel, тоже загрузит нужные надстройки.
Запуск Excel из командной строки обычным образом не загружает все надстройки, поэтому меню и функциональность приложения могут отличаться. Чтобы этого не происходило, команда запуска должна содержать дополнительный ключ /x:
"/x Starts a new instance (a separate process) of Excel."
Пример:
Если к командной строке добавить этот переключатель, то вид Еxcel, запущенный из командной строки, будет соответствовать внешнему виду приложения, запущенному через контейнер Приложение Excel (Interop). Подробнее про особенности командной строки можно прочитать здесь.
Вся команда в элементе Командная строка должна быть в кавычках.
Пример использования элемента в процессе с типом Только код (Pure code):
