AGNEKO ToolkitServiceDesk Plus
⌘ K
ToolkitДля администраторов

ServiceDesk Plus · Для администраторов

Обновление рабочей станции

Оригинал обновлён: Снимок: Перевод АГНЕКО · 2026-10-14

Обновление CI рабочей станции

Для обновления CI используйте следующий формат URL:

http://<servername>:<portnumber>/api/cmdb/ci/

Если вы обновляете CI на локальном сервере с портом 8080, URL должен иметь следующий вид:

http://localhost:8080/api/cmdb/ci

Основные моменты:

  1. Входные данные представляют собой строку XML, передаваемую как атрибут POST с ключом "INPUT_DATA".

  2. Имя операции "update" необходимо передать как атрибут POST с ключом "OPERATION_NAME".

  3. Ключ специалиста необходимо передать как атрибут POST с ключом "TECHNICIAN_KEY".

Иллюстрация 1: Обновление рабочей станции

Примечание:  

Если формат результата не указан, API возвращает выходные данные в формате JSON ..

  • Специалист с ролью обновления активов (Asset update role) может выполнять эти операции.

  • CI-ID обновлённой записи возвращается вместе с CI Name в ответе.

  • Атрибуты CI, Глобальные атрибуты и пользовательские атрибуты CI для соответствующего типа CI можно обновлять.

  • Все дополнительные поля рабочих станций можно обновлять для рабочей станции или сервера.

  • Все дополнительные атрибуты активов можно обновлять.

  • Если поле задано на другом языке, его можно указать в XML для обновления данных.

  • Все дополнительные атрибуты активов можно обновлять.

  • Для обновления активов можно использовать фильтры с операциями отношений .

  • Параметр Result Format — необязательный. Указывает формат возвращаемых данных (XML или JSON).

Пример входных данных XML для обновления сервера: рабочую станцию можно обновлять тем же набором полей.

 

?xml version="1.0" encoding="UTF-8"?>

<API version="1.0" >

    <citype>

        <name>Windows Workstation</name>

        <criterias>

            <criteria>

                <parameter>

                    <name compOperator="IS">CI Name</name>

                    <value>sdp-w2k3-13</value>

                </parameter>

            </criteria>

        </criterias>

        <newvalue>

        <record>

        <!-- Product Name/Type cannot be updated using Update Operations-->

        <!--parameter><name>Product Name</name><value>Unknown Server</value></parameter-->

        <parameter><name>Site</name><value>China</value></parameter>        

        <parameter><name>Asset Tag</name><value>MY RES TAG_1</value></parameter>

        <parameter><name>Asset State</name><value>In use</value></parameter>

        <parameter><name>Asset Serial No.</name><value>KIJH-KPOJ-IOO9-IO98_1</value></parameter>

        <parameter><name>Cost</name><value>1223.98</value></parameter>

        <parameter><name>Vendor</name><value>HP</value></parameter>

        <parameter><name>Expiry Date</name><value>2012-08-23</value></parameter>

        <parameter><name>Warranty Expiry Date</name><value>2012-08-23</value></parameter>

        <parameter><name>Acquisition Date</name><value>2002-8-23</value></parameter>

        <parameter><name>Location</name><value>Beijing</value></parameter>

        <parameter><name>Business Impact</name><value>High</value></parameter>

        <parameter><name>Description</name><value>Beijing\r\nAXL_EXT</value></parameter>

        <parameter><name>Barcode</name><value>101001100010101_1</value></parameter>



        <!-- Inventory data -->

        <parameter><name>Service Tag</name><value>AXL90OSASASD_1</value></parameter>

        <parameter><name>Total Memory</name><value>2024</value></parameter>

        <parameter><name>Virtual Memory</name><value>2024</value></parameter>

        <parameter><name>OS</name><value>Microsoft Windows XP Professional 2010</value></parameter>

        <parameter><name>Service Pack</name><value>Microsoft Windows XP Professional 2010</value></parameter>

        <parameter><name>Disk space</name><value>22</value></parameter>

        <parameter><name>Manufacturer</name><value>HP</value></parameter>

        <parameter><name>Is Virtual</name><value>true</value></parameter>

        <parameter><name>Monitor Type</name><value>LG 360_EXT</value></parameter>

        <parameter><name>Monitor Manufacturer</name><value>LCD Flat monitor_EXT</value></parameter>

        <parameter><name>Monitor Serial Number</name><value>AADSD90KL88767_EDXT</value></parameter>

        <parameter><name>Mouse Type</name><value>LOGITECH_EXT</value></parameter>

        <parameter><name>Mouse Manufacturer</name><value>Microsoft Corporation</value></parameter>

        <parameter><name>Mouse Serial Number</name><value>MOUSE_AADSD90KL88767_EXT</value></parameter>

        <parameter><name>Keyboard Type</name><value>LG 480_EXT</value></parameter>

        <parameter><name>Keyboard Manufacturer</name><value>Microsoft Corporation</value></parameter>

        <parameter><name>Keyboard Serial Number</name><value>KBD_AADSD90KL88767_EXT</value></parameter>        



        <!-- Asset Additional fields -->

        <parameter><name>Asset Data</name><value>My data\r\nTextas_EXT</value></parameter>

        <parameter><name>Asset Date</name><value>2012-09-23</value></parameter>

        <parameter><name>Asset Number</name><value>987654321</value></parameter>



        <!-- Workstation Additional fields -->

        <parameter><name>WS Data</name><value>My data\r\nTextas_EXT</value></parameter>

        <parameter><name>WS Date</name><value>2013-09-23</value></parameter>

        <parameter><name>WS Number</name><value>987654321</value></parameter>



        <!-- Ownership details -->

        <multi-valued-parameter name="Assign Ownership">

            <record>

                <parameter><name>Department</name><value>Finance</value></parameter>

                <parameter><name>Department's site</name><value>Pleasanton,CA</value></parameter>

            </record>

        </multi-valued-parameter>



        <multi-valued-parameter name="Asset Lease Information">

            <record>

                <parameter><name>Start Date</name><value>2013-09-21</value></parameter>

                <parameter><name>End Date</name><value>2013-09-21</value></parameter>

            </record>

        </multi-valued-parameter>



        <multi-valued-parameter name="Network Details">

            <record>

                <parameter><name>DHCP Server</name><value>www.dbexplorer.com_bak</value></parameter>

                <parameter><name>IP Address</name><value>192.168.112.200</value></parameter>

                <parameter><name>MAC Address</name><value>AS2.168.112.200</value></parameter>

                <parameter><name>NIC</name><value>MY NIC_BAK</value></parameter>

                <parameter><name>Network</name><value>192.168.112.255</value></parameter>

            </record>

            <record>

                <parameter><name>DHCP Server</name><value>www.dbexplorer1.com_BAK</value></parameter>

                <parameter><name>IP Address</name><value>192.168.112.255</value></parameter>

                <parameter><name>MAC Address</name><value>AS2.168.112.255</value></parameter>

                <parameter><name>NIC</name><value>MY NIC-1_BAK</value></parameter>

                <parameter><name>Network</name><value>192.168.112.100</value></parameter>

            </record>

        </multi-valued-parameter>

        <multi-valued-parameter name="Processor Details">

            <record>

                <parameter><name>Processor Count</name><value>2</value></parameter>

                <parameter><name>Processor Type</name><value>Intel Inside 2</value></parameter>

                <parameter><name>Processor Speed</name><value>2025</value></parameter>

                <parameter><name>Processor Manufacturer</name><value>SSL Corporation_BAK</value></parameter>

            </record>

            <record>

                <parameter><name>Processor Count</name><value>2</value></parameter>

                <parameter><name>Processor Type</name><value>Intel Inside 2</value></parameter>

                <parameter><name>Processor Speed</name><value>4025</value></parameter>

                <parameter><name>Processor Manufacturer</name><value>SSL Corporation (India)_bak</value></parameter>

            </record>

        </multi-valued-parameter>

        </record>

        </newvalue>

    </citype>    

</API>