⌘ K

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

Обновление других ИТ-активов

Обновление 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 в ответе.

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

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

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

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

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

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

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

 

 

Пример XML для обновления точки доступа:

 

 

Примечание: Поскольку все ИТ-активы используют те же атрибуты, что точка доступа, применяйте этот XML также для обновления других ИТ-активов.

Иллюстрация 2: Обновление других ИТ-активов

Примечание:  

  • Поскольку все ИТ-активы используют атрибуты, подобные точке доступа, применяйте этот XML также для обновления других ИТ-активов.

 

 

 

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

<API version="1.0" >        

    <citype>

        <name>Access Point</name>

        <criterias>

            <criteria>

                <parameter>

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

                    <value>192.168.112.33</value>

                </parameter>

            </criteria>

        </criterias>

        <newvalue>

        <record>

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

            <!--parameter><name>CI Name</name><value>(empty)</value></parameter-->

            <!--parameter><name>CI Type</name><value>My Test Access1</value></parameter-->

            <!--parameter><name>Product Name</name><value>My Access Point1</value></parameter-->

            <parameter><name>Site</name><value>chennai</value></parameter>

            <parameter><name>Asset Tag</name><value>MY RES TAG-1</value></parameter>

            <parameter><name>Serial Number</name><value>KIJH-KPOJ-IOO9-IO98-EXT</value></parameter>

            <parameter><name>Barcode</name><value>MY BAR CODE</value></parameter>

            <parameter><name>Cost</name><value>68884.98</value></parameter>

            <parameter><name>Vendor</name><value>Zoho Corp</value></parameter>

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

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

            <parameter><name>Acquisition Date</name><value>2011-09-23</value></parameter>

            <parameter><name>Location</name><value>Porur</value></parameter>

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

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

            <parameter><name>Description</name><value>Mydescription</value></parameter>



            <!-- Multi value parameters -->

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

                <record>

                   <parameter><name>Associate to Asset</name><value>sdp-w2k3-13</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>2010-09-21</value></parameter>

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

                </record>

            </multi-valued-parameter>

        </record>

        </newvalue>

    </citype>

</API>