AssetExplorer

    Add Other IT Asset(s) CIs



    To add asset CIs (other than workstations) use the following URL format:

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


    Assuming you are adding a CI in the local server with port number 8080, the URL should be given as:

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


    Keypoints:

    1. Input is an XML string sent as "POST attribute" with key "INPUT_DATA".

    2. The operation name "add"  should be sent as a "POST attribute" with key "OPERATION_NAME".

    3. The technician key should be sent as a "POST attribute" with key "TECHNICIAN_KEY".


    Note:  

    • Product Names will get added dynamically in case they are not already avilable in the application. In the below example, the product Cisco 123 ACC will be created while adding this workstation CI (in case the product is not already available in the application).

    • Technician with rights to adding assets (asset addition role) can perform add operations on assets CIs like workstaions,printers etc.

    • Technician having SDAdmin role can perform add operations on admin CIs like Business Service, Department etc.

    • CI-ID of the newly added entry is returned along with the CI Name in the response.

    • Technicians can add more than one C(s) using the <record> </record> tags.

    • CI Attributes, Global Attributes and custom CI Attributes for the corresponding CI Type can be added.

    • All asset additional attributes can be added

    • Parameter Result Format - Optional. specifies the return format ( XML or JSON )

    • If no result format specified then API will return output in JSON format.


    Sample Input for adding other IT Assets (Access Point):


    Note:  

    • Refer the below xml for adding all IT assets like Firewall, Keyboard, Printer, Projector, Router, Scanner, Storage Device and Switch

     

     

    <?xml version="1.0" encoding="UTF-8"?>
    <API version="1.0" locale="en">
        <records>
        <record>
            <parameter><name>Name</name><value>192.168.112.1</value></parameter>
            <parameter><name>CI Type</name><value>Access Point</value></parameter>
            <parameter><name>Product Name</name><value>Cisco 123 ACC</value></parameter>
            <parameter><name>Site</name><value>Japan</value></parameter>
            <parameter><name>Business Impact</name><value>High</value></parameter>        
            <parameter><name>Asset Tag</name><value>MY RES TAG</value></parameter>
            <parameter><name>Resource Serial No.</name><value>KIJH-KPOJ-IOO9-IO98</value></parameter>
            <parameter><name>Bar Code</name><value>(empty)</value></parameter>
            <parameter><name>Cost</name><value>23.98</value></parameter>
            <parameter><name>Vendor</name><value>Zoho Corp</value></parameter>
            <parameter><name>Expiry Date</name><value>2010-08-23</value></parameter>
            <parameter><name>Warranty Expiry Date</name><value>2010-08-23</value></parameter>
            <parameter><name>Acquisition Date</name><value>2008-8-23</value></parameter>
            <parameter><name>Location</name><value>(empty)</value></parameter>
            <parameter><name>Asset State</name><value>in use</value></parameter>        
            <parameter><name>Location</name><value>Japan</value></parameter>
            <parameter><name>Description</name><value>Japan - AXL</value></parameter>
            <parameter><name>Barcode</name><value>101001100010101</value></parameter>
            <!-- Asset Additional parameters Start -->
            <parameter><name>Cost Center</name><value>Sales</value></parameter>
            <parameter><name>Account Number</name><value>0166440001754</value></parameter>
            <parameter><name>Resolution</name><value>NO RESULT</value></parameter>
            <parameter><name>Bank Account</name><value>112</value></parameter>
            <parameter><name>Depreciation Amount</name><value>2022</value></parameter>
            <parameter><name>Renewal Date</name><value>2010-10-23</value></parameter>
            <parameter><name>Asset Data</name><value>My data&#xA;Textas</value></parameter>
            <parameter><name>Asset Date</name><value>2011-09-23</value></parameter>
            <parameter><name>Asset Number</name><value>98765</value></parameter>
            <!-- Asset Additional parameters Start -->
            <multi-valued-parameter name="Assign Ownership">
             <record>
                <parameter><name>Associate to Asset</name><value>192.168.11.29</value>
                 <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>
        </records>
    </API>

     


     

    Copyright © 2017, ZOHO Corp. All Rights Reserved.