Skip to content

wtctl 0.7.0

Latest

Choose a tag to compare

@ysamtme ysamtme released this 18 Oct 15:50

files.delete и files.list работают в wt_data и trash, когда сервер хранит эти папки в базе данных: файл, записанный files.write, виден в списке и удаляется тем же вызовом, что в веб-админке. Кроме того, исправлены исходы записи: native.physicalDocuments.createFromXml после сброса сессии не создаёт второй документ, objects.patch и objects.delete с id и url разных объектов отвечают отказом, а не правят объект по url, а 0x… считается ID только у целых полей формы. Значения заголовков авторизации и cookie в тексте ошибки закрываются целиком, а MCP-сервер без настроек проверяет первый вызов по его аргументам. Скрипты, которые правят документ объекта через files.write, нужно сверить с разделом «Несовместимые изменения».

Несовместимые изменения:

  • files.delete и files.write в любой папке отклоняют адрес документа объекта (x-local://<папка>/objects/<14 hex>/<2 hex>.xml): FILE_IS_DOCUMENT, исход not_sent. Подсказка называет objects.delete, objects.patch и native.lds.putDoc. Раньше запись по такому адресу меняла документ, но не строку каталога. files.read читает документ по адресу, как прежде.
  • native.physicalDocuments.createFromXml выполняет runtime (HcmClient, CLI, MCP-сервер); NativeGateway из wtctl/native её больше не перечисляет и не вызывает. В wtctl/protocol остаётся session.physicalDocuments.createFromXml.

Добавлено:

  • files.delete удаляет файлы в wt_data и trash, если сервер хранит эти папки в базе данных (DB-STORE-HOOK в его настройках), — тем же вызовом, что веб-админка, под правом write. Раньше там был отказ FILE_NOT_DELETABLE до отправки. Теперь FILE_NOT_DELETABLE с исходом indeterminate означает, что по адресу остался файл или пустая папка на диске сервера: с диска сервер по адресу ничего не удаляет. Адрес длиннее 256 знаков в такой папке — INVALID_ARGUMENT до отправки.
  • files.list в wt_data и trash, если сервер хранит эти папки в базе данных, показывает и файлы из базы: файл — с размером, «папку» — если в базе есть адреса глубже неё. Файл с копией в базе и на диске — одна строка, размер — копии из базы, которую отдаёт files.read. FOLDER_NOT_FOUND — только если по адресу нет ни папки на диске, ни файлов в базе. Раньше список показывал только диск: файла, записанного files.write, в нём не было, а папка с одними такими файлами отвечала FOLDER_NOT_FOUND.

Изменения:

  • web.resources.getImage и native.resources.getImage принимают ID ресурса и в записи 0x…, в которой его отдают каталоги, и сами переводят его в десятичную запись для сервера. Раньше такой ID отклонялся с «значение записано неверно».
  • files.delete в папке данных сначала проверяет адрес не длиннее 256 знаков: если по нему ничего нет, ответ — FILE_NOT_FOUND с исходом not_sent, на сервер ничего не уходит. В папке в базе данных подсказка говорит, что вложенных папок там нет и файлы удаляются по одному. Раньше в обычной папке данных сервер отвечал отказом HTTP 500.

Исправления:

  • native.physicalDocuments.createFromXml после сброса сессии сервером входит заново и повторяет только отклонённый запрос: документ записывается один раз, ответ — ok с его ID. Раньше клиент повторял всю операцию и создавал второй документ, а если сессию открыл сам вызов — отвечал not_sent при записанном документе. Если после записи войти заново не удалось, исход — indeterminate, и details.url называет адрес документа.
  • Отказ отправленного rpc.call даёт UNKNOWN_RPC_TARGET и not_sent, только когда библиотека прочитана целиком и функции в ней нет или такой библиотеки нет на сервере. Если файл библиотеки прочитать не удалось или он лежит в базе данных, остаётся ошибка сервера и исход indeterminate: функция могла выполниться.
  • Запись и код с исходом indeterminate после обрыва соединения, таймаута или потери связи подсказывают проверить, прошла ли запись, прежде чем повторять; у таймаута — ещё увеличить timeoutMs подключения. Раньше подсказка советовала повторить.
  • Шаг записи в runtime.batch, который отказал до отправки из-за неразрешимой $ref, получает mutationOutcome:"not_sent".
  • objects.get, objects.patch и objects.delete с id и url разных объектов отвечают TARGET_MISMATCH до записи и у документов без <id> или с пустым <id>, как у штатных справочников: id сверяется с ID в адресе документа. Если и адрес ID не называет, сверить нечем — тоже TARGET_MISMATCH. Раньше такой вызов правил и удалял объект по url, а отвечал с ID из id. Сообщение называет ID объекта из документа или адреса.
  • objects.create и objects.patch без formUrl берут форму, которую сервер объявляет для типа, как schema.get. Объекты типов тестирования (assessment и других), форма которых лежит вне x-local://wtv, создаются без formUrl; раньше создание отказывало.
  • 0x… и десятичная запись считаются одним ID только у целых полей формы. У строкового поля значения сравниваются как есть: objects.patch с ключом [code=0x1F] не трогает элемент с ключом 31, замена 31 на 0x1F записывается, условие runtime.query со значением "0x10" ищет строку. В contains значение всегда строка. Раньше 0x… превращалось в число у любого поля. Если форму прочитать не удалось, ID узнаётся по виду значения, как прежде.
  • Временный отказ чтения формы, файла языка, переводов названий типов и документа с настраиваемыми полями не запоминается: следующий вызов читает их заново. Раньше после такого отказа MCP-сервер не видел восстановления сервера до перезапуска.
  • runtime.check (hcm_check, wtctl check) отвечает на шаге query failed с причиной «база данных отвергла запрос; причина — в логе spxml_unibridge», если база отвергла пробный запрос. Раньше такой шаг считался пройденным.
  • schema.types, если документ с настраиваемыми полями прочитать не удалось, не показывает в строках customFields и называет это в notes. Раньше у всех типов было customFields: 0.
  • hcm_script с файлом не в UTF-8 отвечает mcp.file_unreadable «Файл с кодом должен быть текстом UTF-8.» и ничего не отправляет на сервер, как wtctl exec --input-file. BOM в начале файла убирается. Раньше кириллица файла в Windows-1251 молча превращалась в знаки U+FFFD и уходила на сервер, а BOM оставался в коде.
  • Значения заголовков Authorization, Proxy-Authorization, Cookie и Set-Cookie в тексте ошибки сервера — в details.scriptError, сообщении и SOAP Fault — закрываются до конца строки. Раньше закрывалось только первое слово: от Authorization: Bearer … оставался токен, от Cookie — все пары после первой.
  • MCP-сервер, запущенный без настроек, с первого вызова проверяет инструмент по эффекту вызова с его аргументами: hcm_api_read с native.lds.loadDoc и tryLock:true отвечает mcp.effect_mismatch и ничего не отправляет на сервер. Раньше первый вызов после появления настроек проверялся без аргументов, и блокировка проходила через инструмент чтения в обход одобрения записи в приложении. Одновременные первые вызовы такого сервера создают одно подключение, а не по одному на вызов; при закрытии сервера оно закрывается.
  • Превью сохранённого ответа runtime.batch помещается в outputLimitBytes: в preview.results — сводки первых шагов, пока помещаются, а подсказка говорит, сколько их из всех, как у списка items. Раньше превью пакета из многих шагов перечисляло все шаги и бывало больше предела.
  • Сохранённый ответ пакета из одного шага читается по шагам и выгружается в jsonl одной строкой. Раньше results.export с format:"jsonl" отвечал INVALID_RESULT_FORMAT. Шаг больше страницы results.read назван в blockedItem, и ответ называет список results.
  • XML-аргумент rpc.call и native.*, который начинается с декларации <?xml …?>, как документ, прочитанный через files.read, уходит внутри SOAP без неё; во вложении (native.lds.putDoc) и в загружаемом файле декларация остаётся как есть. Декларация в другом месте аргумента — INVALID_ARGUMENT до отправки, исход not_sent. Раньше декларация попадала внутрь SOAP, и сервер получал неверный XML. В wtctl/protocol декларацию не в начале так же отклоняет rawXml().
  • maxResponseBytes в параметрах отдельного вызова wtctl/protocol действует у всех SOAP-вызовов (lds, rpc, фоновые задачи) и у страницы /admin: меньший предел отклоняет большой ответ, Infinity снимает предел клиента. Раньше у этих вызовов работал только предел клиента.
  • rpc.list и rpc.describe читают файл библиотеки в той кодировке, которую выбирает сервер: по метке порядка байтов, иначе по encoding в объявлении <?xml …?>, иначе как UTF-8. Библиотека в Windows-1251 с кириллицей больше не попадает в skipped. rpc.describe функции из библиотеки, файл которой прочитать не удалось, отвечает «Библиотеку … прочитать не удалось, описания функции … нет.» и подсказывает, что rpc.call вызывает функцию и без описания. Раньше сообщение говорило, что такой библиотеки на сервере нет.
  • schema.get и schema.types, если файл языка прочитать не удалось, не показывают заголовков, которые берутся из него, и говорят об этом одним примечанием в notes: «Файл языка … прочитать не удалось: заголовков из него в ответе нет.» Примечание есть и у пустого ответа поиска schema.types: тип мог не найтись по такому заголовку. Заголовки, записанные в форме, и переводы названий типов остаются. Раньше вместо заголовка показывался ключ (title: "const=c_person"), schema.types искал по нему и примечания не давал.
  • CLI называет пропущенную или неизвестную команду так, как её набрали, и перечисляет, какие есть, в порядке справки: wtctl server отвечает «Не указана команда после wtctl server: есть info.», wtctl object foo — «Команды wtctl object foo нет: есть get, create, patch, delete.», wtctl srever — «Команды wtctl srever нет.» с подсказкой «Похожие: server.». Раньше ответ был «Неизвестная команда server.», будто нет самой команды server, а wtctl result foo и wtctl rpc foo отвечали «Не хватает аргументов команды.». wtctl help srever отвечает так же, как wtctl srever, с кодом выхода 2; раньше — списком команд и кодом 0. Имя с цифрами или знаками не печатается: в командной строке может оказаться пароль.
  • Справка wtctl exec показывает и код аргументом: wtctl exec 'КОД' [--params-file params.json | --params …]. Раньше в ней были только --input-file и --stdin.
  • wtctl с файлом в --input-file или --params-file, которого нет, отвечает «Файл из --input-file не найден: ПУТЬ.» с кодом выхода 2; если там папка или файл без доступа, сообщение говорит об этом. Раньше ответ был «Команда не завершена.» с подсказкой проверить конфигурацию и кодом 1. Так же wtctl config init с файлом подключений, который не читается, отвечает «Файл подключений не открывается для чтения: ПУТЬ.», а wtctl config path показывает exists:false, только если файла нет; раньше — и у файла без доступа или больше 1 МБ.
  • wtctl types и wtctl schema с --limit больше 1000 отвечают ошибкой аргументов с кодом 2, как остальные команды. Раньше отказ приходил от операции с кодом 1: «limit: нужно целое число от 0 до 1000».