Пред.   След.

NetToolsTaskRun (ZWS)

Запуск задачи расчета с указанными параметрами.

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

<xs:element name="zulu-server">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="Command">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="NetToolsTaskRun">
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="Layer" type="xs:string" />
                                    <xs:element name="Model" type="xs:string" />
                                    <xs:element name="Task" type="xs:integer" />
                                    <xs:element name="Settings">
                                        <xs:complexType>
                                            <xs:sequence>
                                                <xs:element name="Sources" type="xs:integer" />
                                            </xs:sequence>
                                        </xs:complexType>
                                    </xs:element>
                                </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="NetToolsTaskRun">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="TaskHandle" type="xs:string" />
                    </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>
        <NetToolsTaskRun>
            <Layer>drain:drain</Layer>
            <Model>drain</Model>
            <Task>1</Task>
            <Settings>
                <Sources>28</Sources>
            </Settings>
        </NetToolsTaskRun>
    </Command>
</zulu-server>

Где:

  • Layer — имя слоя вместе с пространством имен, указывается в формате namespace:layername (пространство_имен:имя_слоя).

  • Model — модель инженерной сети.

  • Task — номер задачи, указывающий какой расчет запускать (см. таблицу ниже).

    • Settings — настройки проведения расчета. Указываются номера источников и опции расчета — представлены в таблице ниже для каждой модели сети. Также доступны примеры запросов на запуск расчета.

      Модель

      Расчет

      Task

      (номер задачи)

      Settings

      (параметры проведения расчета)

      thermo

      Наладочный расчет

      1

      Sources — идентификатор (ID/SYS) источника, для которого проводится расчет.

      DHW — с учетом ГВС с учетом утечек no - без ГВС yes - с ГВС.

      Leaks — с учетом утечек no - без утечек yes - с утечками.

      Nozzle — Гашение избыточного напора: no - шайбами, yes - соплом элеватора.

      HeatLoss — учет тепловых потерь: 0 - без учета, 1 - по нормативным потерям, 2 - по изоляции.

      Поверочный

      2

      Sources — идентификатор (ID/SYS) источника, для которого проводится расчет.

      Leaks — с учетом утечек no - без утечек yes - с утечками.

      UseAdjusted — сопла и шайбы из наладки - no - фактические шайбы yes - шайбы из наладки.

      Конструкторский

      3

      —

      Надежность

      6

      Sources — идентификатор (ID/SYS) источника, для которого проводится расчет.

      Leaks — с учетом утечек no - без утечек yes - с утечками.

      UseAdjusted — сопла и шайбы из наладки - no - фактические шайбы yes - шайбы из наладки.

      TOpenAirAvg — Тнв.сред, °C - средняя температура наружного воздуха за отопительный период.

      HeatingPeriodTime — t отоп.пер, ч - указывается продолжительность отопительного периода в часах, например 5000.

      DurationAirTBelowNorma — t ниж.расч, ч - указывается продолжительность (часы) стояния температуры наружного воздуха ниже расчетной для отопления.

      hydro

      Поверочный

      1

      Sources — идентификатор (ID/SYS) источника, для которого проводится расчет.

      NotFixed — нефиксированный отбор: no - фиксированный отбор yes - нефиксированный отбор.

      Конструкторский

      2

      —

      gas

      Поверочный

      1

      —

      Конструкторский

      2

      —

      drain

      Поверочный

      1

      —

      Конструкторский

      2

      		—

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

Выполнить наладочный расчет ZuluThermo для источника ID=123 с учетом ГВС, утечек, гашение избыточного напора шайбами и с учетом нормативных тепловых потерь:

<?xml version="1.0" encoding="UTF-8"?>
<zulu-server service="zws" version="1.0.0">
    <Command lang="ru">
        <NetToolsTaskRun>
            <Layer>samples:piter</Layer>
            <Model>thermo</Model>
            <Task>1</Task>
            <Settings>
                <Sources>123</Sources>
                <DHW>yes</DHW>
                <Leaks>yes</Leaks>
                <HeatLoss>1</HeatLoss>
                <Nozzle>no</Nozzle>
            </Settings>
        </NetToolsTaskRun>
    </Command>
</zulu-server>

Выполнить расчет надежности ZuluThermo для источника ID=123 с учетом тепловых потерь и шайб из наладки. Тнв.сред, °C = 0 °C, t отоп.пер, ч = 5000 ч, t ниж.расч, ч = 48 ч.:

<?xml version="1.0" encoding="UTF-8"?>
<zulu-server service="zws" version="1.0.0">
    <Command lang="ru">
        <NetToolsTaskRun>
            <Layer>2:teplosam</Layer>
            <Model>thermo</Model>
            <Task>6</Task>
            <Settings>
                <Sources>289</Sources>
                <Leaks>yes</Leaks>
                <HeatLoss>1</HeatLoss>
                <UseAdjusted>yes</UseAdjusted>
                <TOpenAirAvg>0</TOpenAirAvg>
                <HeatingPeriodTime>5000</HeatingPeriodTime>
                <DurationAirTBelowNorma>48</DurationAirTBelowNorma>
            </Settings>
        </NetToolsTaskRun>
    </Command>
</zulu-server>

Выполнить поверочный расчет ZuluHydro для источника ID=345 с нефиксированный отбором воды:

<?xml version="1.0" encoding="UTF-8"?>
<zulu-server service="zws" version="1.0.0">
    <Command lang="ru">
        <NetToolsTaskRun>
            <Layer>NetTools:fromapi</Layer>
            <Model>hydro</Model>
            <Task>1</Task>
            <Settings>
                <Sources>345</Sources>
                <NotFixed>yes</NotFixed>
            </Settings>
        </NetToolsTaskRun>
    </Command>
</zulu-server>

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

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

Где:

  • TaskHandle — уникальный идентификатор задачи (хендлер), который следует использовать для дальнейшей работы с данной задачей.