NetToolsTaskGetStatus (ZWS)

Получение статуса выполнения расчета: завершился ли он или еще в процессе выполнения. Статусы и их описание представлены в таблице ниже.

Статус

Описание статуса

stopped

Расчет остановлен принудительно.

finished

Расчет успешно завершен.

stopping

Расчет в процессе остановки.

process

Расчет в процессе выполнения.

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

<xs:element name="zulu-server">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="Command">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="NetToolsTaskGetStatus">
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="TaskHandle" type="xs:string"/>
                                </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="NetToolsTaskGetStatus">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="TaskHandle" type="xs:string"/>
                        <xs:element name="Status" type="xs:string"/>
                        <xs:element name="NetToolsRetVal" type="xs:integer"/>
                    </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>
        <NetToolsTaskGetStatus>
            <TaskHandle>A6E0BABE-A01D-4BAE-8EF3-3AA901B6BFD7</TaskHandle>
        </NetToolsTaskGetStatus>
    </Command>
</zulu-server>

Где:

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

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

<?xml version="1.0" encoding="UTF-8"?>
<zwsResponse>
    <NetToolsTaskGetStatus>
        <TaskHandle>A6E0BABE-A01D-4BAE-8EF3-3AA901B6BFD7</TaskHandle>
        <Status>finished</Status>
        <NetToolsRetVal>0</NetToolsRetVal>
    </NetToolsTaskGetStatus>
    <RetVal>0</RetVal>
</zwsResponse>

Где:

  • Status — текущий статус расчета. Например finished означает, что расчет завершился.

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

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

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