rdp-cli

Автоматизация отчёта LibreOffice Calc по RDP

Версия и платформа: macOS · Windows 11 RDP · LibreOffice Calc 26.8.0

Что вы создадите

Загрузите книгу с примером данных за двенадцать месяцев, создайте диаграмму и три итога в удалённом LibreOffice Calc, затем скачайте сохранённый XLSX. Руководство охватывает загрузку, редактирование и получение результата.

Исходная книга · Пример результата

Выбирайте координаты на своём снимке и используйте значения наблюдения из текущего сеанса.

Книга Calc в Windows 11 с данными сервиса за 12 месяцев, двумя рядами точек и суммами 15230, 14933 и 14140

Открыть исходный снимок — Светлое ↗ · Открыть исходный снимок — Тёмное ↗

Скачать результат, соответствующий снимкам: Светлая тема · Тёмная тема

Подготовка разрешённого сеанса RDP

Установите версию для Mac, включите CLI и подключитесь по краткому руководству. На удалённом Windows уже должен быть установлен Calc и разрешено перенаправление дисков. Вызывающей стороне нужны права на файлы и ввод. Вместо SESSION используйте возвращённый data.session, а не ID из чужого журнала.

Сохраните исходный файл service-activity.xlsx в текущем локальном каталоге. Его размер — 4 489 байт. Проверьте сеанс и загрузите файл в корень обменного диска:

rdp-cli status --session SESSION
rdp-cli files upload --session SESSION --local ./service-activity.xlsx --path service-activity.xlsx

Сохраните data.transfer_id загрузки как TRANSFER_ID и дождитесь completed:

rdp-cli files status --session SESSION --transfer-id TRANSFER_ID

queued означает только принятие запроса. --path относится к обменному диску сеанса, а не к произвольным дискам Windows. VNC не поддерживает этот файловый процесс. Передача каталогов и перезапись описаны в руководстве по файлам.

Открытие книги и создание диаграммы

rdp-cli screenshot --session SESSION --out calc-before.png

Прочитайте calc-before.png и сохраните data.observation. Откройте Calc на удалённом рабочем столе, затем service-activity.xlsx с перенаправленного диска сеанса. Выбирайте реальные элементы по свежим снимкам экрана; открытие локальной таблицы не заменяет эту удалённую задачу.

В Calc выделите A5:C17 вместе с заголовками. Вставьте диаграмму, где месяцы — категории, а Requests и Resolved — два ряда данных. Используйте точки без соединительных линий, заголовок “Monthly service activity” и подписи осей “Month” / “Requests”. Поместите диаграмму справа от данных. Ищите элементы в текущем интерфейсе: меню и координаты в вашей среде могут отличаться.

Ввод формул и проверка результатов

Выберите B18. Ниже показан один из вариантов ввода. Замените X, Y фактическими координатами ячейки, а OBSERVATION — токеном только что просмотренного снимка.

rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out calc-focused.png

Прочитайте calc-focused.png, убедитесь, что активна нужная ячейка, и используйте data.observation этого ответа как NEW_OBSERVATION:

rdp-cli type --session SESSION --text "=SUM(B6:B17)" --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out calc-formula.png

Проверьте текст формулы на calc-formula.png. Подставьте токен этого ответа в FORMULA_OBSERVATION, подтвердите ввод и посмотрите результат:

rdp-cli key --session SESSION --keys ENTER --observation FORMULA_OBSERVATION
rdp-cli screenshot --session SESSION --out calc-total.png

Повторите наблюдение → выбор → ввод → подтверждение для остальных ячеек, каждый раз заменяя формулу и токены:

Ячейка Формула Ожидаемая сумма
B18 =SUM(B6:B17) 15 230
C18 =SUM(C6:C17) 14 933
D18 =SUM(D6:D17) 14 140

Выделите итоговую строку полужирным. Успешный ответ на ввод подтверждает отправку, но не принятие формулы Calc. Проверьте следующий снимок и сохранённую книгу.

Сохранение, скачивание и проверка XLSX

Сохраните как service-report.xlsx на том же перенаправленном диске. При вопросе Calc оставьте формат XLSX и дождитесь окончания сохранения. Затем получите файл:

Оставьте скачанный с сайта архивный образец под именем service-report.xlsx. Следующая команда сохранит ваш собственный удалённый результат локально как service-report-reproduced.xlsx, чтобы файлы не смешивались.

rdp-cli files list --session SESSION
rdp-cli files download --session SESSION --path service-report.xlsx --local ./service-report-reproduced.xlsx

Запросите files status с новым data.transfer_id скачивания и продолжайте только после completed. Убедитесь, что книга открывается, содержит три формулы и суммы, а редактируемая диаграмма ссылается на A6:A17, B6:B17 и C6:C17. В записанном результате не было ссылок на внешние книги.

shasum -a 256 ./service-report-reproduced.xlsx

Проверьте формулы, итоги и редактируемую диаграмму сохранённой книги. Ожидаемые итоги: 15 230, 14 933 и 14 140. Метаданные могут измениться при сохранении, поэтому хеш не обязан совпадать с примером для скачивания.

Если шаг не удаётся

  • Нет обменного диска или прав: проверьте перенаправление дисков RDP и возможности вызывающей стороны. Сохранение только на удалённый Рабочий стол не помещает результат в каталог обмена.
  • Текст вводится не туда: изучите новый снимок и восстановите правильный фокус. Не продолжайте отправлять формулы без проверки.
  • Токен устарел, ввод приостановлен или управление у человека: остановите ввод. После разрешённой передачи управления получите и прочитайте новый снимок.
  • FILE_BUSY или сохранение не закончено: дождитесь приложения, проверьте файл и состояние передачи. Скачивание в очереди ещё не готовый результат.
  • Истёк срок вызова ввода: запросите rdp-cli operations status --session SESSION --request-id REQUEST_ID с исходным ID и изучите экран перед повтором. Неизвестный результат не доказывает, что ничего не произошло.

командный процесс Agent · файловые возможности RDP