ГОСТ Р 56947—2016
12.4.3.3 Схема XML-ответа для API «WriteTEDS» («Записать ЭТДП»)
Если формат ответа — «ХМ1_», то для ответа должна быть использована следующая схема:
<?xml v e rs io n -» l. О» encoding-»UTF-8»?>
<xs : schema xmlns :x s -» h ttp : / /
wmw
. w3. org/2001/XMLScheraa»
xm lns: s tm l-
h ttp ://g ro u p e r. ie e e . org/groups/1451/0/1451HTTPAPI
< xs: complexType name-"WriteTEDSHTTPResponse">
<xs:sequence>
<xs:elem er.t r.am e-"errorC ode" ty p e -v’s tm l:t’ln c l6 v’/>
<xs:elem ent r.ame-tttim ld " ty p e -"s tm l :U In ti 6A rray"/>
<xs:elem ent name-wte d s ld ” ty p e -"s tm l:L ’Ir.tl6 "/>
<xs:elem ent r.ame-wtedsType" ty p e -” s tm i:U In t8 w/>
< /x s : sequence>
</xs:com plexType>
</xs:schem a>
12.4.4 Интерфейс «WriteRawTEDS» («Записать предварительную ЭТДП»)
В данном API осуществляется запись данных «rawTEDS» («Предварительной ЭТДП») для задан
ного ИМП заданного СПП (хоста). Данный метод записывает нужный блок ЭТДП в ИМП в обход кэш
памяти ЭТДП. Предоставляемая информация ЭТДП кодируется в форму «кортежа» в байтовый массив
OctetArray. Данный API соответствует A rgs: :U ln tl6 writeRawTeds (), как описано в 10.4.4.
Для целей настоящего API все ЭТДП имеют бинарные структуры. Для того чтобы кодировать эти
структуры в заданный формат, необходимо кодировать их в виде текста. Для достижения этой цели все
содержимое ЭТДП должно быть закодировано с использованием кодировки Base64. описанной в RFC
2045 (подраздел 6.8).
Путь «Path»: 1451/TEDSManager/WriteRawTEDS.
Метод «POST» («Отправить»): записывает данные предварительной ЭТДП (rawTEDS) преоб
разователя. доступного в заданном ИМП СПП (хоста), и отображает результат в заданном формате.
12.4.4.1 Входные параметры
Следующие параметры должны поставляться вместе с вызовом данного API:
- u :n t!6 tim id - значение «timid» заданного ИМП;
- и in t i 6 channel id — значение «channellD» заданного канала преобразователя или значение
«0». если ЭТДП применяется ко всему ИМП;
- Tim eD uration tim eout — данный аргумент определяет время ожидания после записи данных
без генерации ошибки тайм-аута в случае неполучения ответа. Значения «secs==0» и «nsecs==-1»
указывают на непрерывное (бесконечное) время ожидания. Использование значения «непрерывное
(бесконечное) время ожидания» является крайне опасным, поскольку при этом ресурс может быть за
блокирован;
- L’lr.tS tedsType — данный аргумент задает «tedsType» («тип ЭТДП»), как указано в таблице 17.
где он называется «TEDS Access Code» («Код доступа к ЭТДП»),
- O cte tA rra y rawTEDS — данные предварительной ЭТДП заданного канала преобразователя
или заданного ИМП;
- _ s trin g KesponseFormat — задает формат ответа, как это определено в 12.1.2.
12.4.4.2 HTTP-ответ для API «WriteRawTEDS» («Записать предварительную ЭТДП»)
Ответ на вызов данного API должен содержать следующие параметры:
- u :n t!6
- u in tl€
- u in tl6
errorC ode — информация об ошибке, как определено в 9.3.1.2;
tim id — значение «timid» заданного ИМП;
cha nn elid — значение «channellD» заданного канала преобразователя;
- L’lr.tS tedsType — данный аргумент задает «tedsType» («тип ЭТДП»), как указано в таблице 17,
где он называется «TEDS Access Code» («Код доступа к ЭТДП»),
12.4.4.3 Схема XML-ответа для API «WriteRawTEDS» («Записать предварительную ЭТДП»)
Если формат ответа — «XML», то для ответа должна быть использована следующая схема:
<?xml v e rs io n -» 1.0» encoding-»UTF-8»?>
<xs: schema xm ln s:xs-»
h ttp ://w w w .
w3.org/2001/XMLSchema»
x m ln s :s tm l-
h ttp ://g ro u p e r. ie e e . org/groups/1451/0/1451HTTPAPI
<xs: complexType name-"WriteRawTED3HTTPRespor.sen>
<xs:sequence>
<xs:elem er.t r.ame-“ errorC ode” ty p e -"s tm l: U ln tl6 "/>
1 9 7