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 — операция не была выполнена или произошла ошибка.