Repository navigation
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) отвечает на шагеqueryfailedс причиной «база данных отвергла запрос; причина — в логе 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».