NetToolsTaskGetOutput (ZWS)

Получение протокола расчета, которые выводятся во время проведения расчетов.

Вы можете указать начальную строку LineNum и максимальное количество строк протокола MaxCount, таким образом получать протокол "небольшими порциями".

Схема запроса

<xs:element name="zulu-server">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="Command">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="NetToolsTaskGetOutput">
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="TaskHandle" type="xs:string" />
                                    <xs:element name="LineNum" type="xs:integer" />
                                    <xs:element name="MaxCount" type="xs:integer" />
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
        </xs:sequence>
    </xs:complexType>
</xs:element>

Схема ответа

<xs:element name="zwsResponse">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="NetToolsTaskGetOutput">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="TaskHandle" type="xs:string"/>
                        <xs:element name="Log">
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="Line" type="xs:string" maxOccurs="unbounded"/>
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="RetVal" type="xs:integer"/>
        </xs:sequence>
    </xs:complexType>
</xs:element>

Пример запроса

<?xml version="1.0" encoding="UTF-8"?>
<zulu-server service='zws' version='1.0.0'>
    <Command>
        <NetToolsTaskGetOutput>
            <TaskHandle>A6E0BABE-A01D-4BAE-8EF3-3AA901B6BFD7</TaskHandle>
            <LineNum>14</LineNum>
            <MaxCount>10</MaxCount>
        </NetToolsTaskGetOutput>
    </Command>
</zulu-server>

Где:

  • TaskHandle — уникальный идентификатор задачи (хендлер).

  • LineNum — номер строки, с которой будет получен протокол, например, не с 1ой, а с N-ой строки.

  • MaxCount — максимальное количество строк протокола сообщений.

Пример ответа

<?xml version="1.0" encoding="UTF-8"?>
<zwsResponse>
    <NetToolsTaskGetOutput>
        <TaskHandle>A6E0BABE-A01D-4BAE-8EF3-3AA901B6BFD7</TaskHandle>
        <Log>
            <Line>--------- Расчет самотечной сети: ID=39 -----------------------------</Line>
            <Line></Line>
            <Line></Line>
            <Line>Погрешность связности (%) .....         0.141</Line>
            <Line></Line>
            <Line>--------- Расчет самотечной сети: ID=43 -----------------------------</Line>
            <Line></Line>
            <Line></Line>
            <Line>Погрешность связности (%) .....         0.129</Line>
            <Line></Line>
        </Log>
    </NetToolsTaskGetOutput>
    <RetVal>30</RetVal>
</zwsResponse>

Где:

  • Log — содержит строки Line с протоколом расчета.

  • RetValкод ответа со статусом выполнения операции:

    • 0 — операция успешно выполнена.

    • -1 — операция не была выполнена или произошла ошибка.