{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":979,"path":"api-reference/server-api-reference/c_CimCIDataAPI.md","title":"CimCIData - Global","bundle":null,"doc_type":null,"release":"australia","body":"\n# CimCIData- Global\n\nThe CimCIData script include provides a wrapper for Common Information Model \\(CIM\\) configuration item \\(CI\\) data manipulation.\n\nUse with any server-side discovery script.\n\n**Parent Topic:**[Server API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/api-server.md)\n\n## CimCIData - addSerial\\(String type, String serial\\)\n\nAdds a serial number to the current configuration item \\(CI\\), by type.\n\n|Name|Type|Description|\n|----|----|-----------|\n|type|String|Serial number type. For the base system, use the CimCIData.serialType enum.|\n|serial|String|Serial number to add.|\n\n|Type|Description|\n|----|-----------|\n|String|Current CI|\n\nThe following example loads the CI data from current CI and passes the data object to the CimCIData.addSerial\\(\\) method which adds the serial number to CimCIData and CIData.\n\n```\nvar cidata = new CIData();  //Instantiate a new CIData class object\ncidata.loadFromCI('0c43b0f5c6112275019abd2bb3dcd78f');  // Load the current data from a CI record. use sys_id or ci name\nvar cimcidata = new CimCIData(cidata);  // Instantiate a new CimCIData class object and pass the CIdata \nvar cimdata = cimcidata.addSerial('baseboard','XK0HKSN6');  // Add serial number to the CIData and CimCIData\ngs.info(JSON.stringify(cimdata, null ,4));  // The JSON payload in string format with added serial number and serial number type\ngs.info(\"serial number : \"+cimdata.serials.records[1].serial_number);  // Display serial number which is added\ngs.info(\"serial type : \"+ cimdata.serials.records[1].serial_number_type);  // Display serial type which is added\n```\n\nOutput:\n\n```\n{\n  \"cidata\": {\n    \"ignoreFields\": {\n      \"sys_created_by\": true,\n      \"sys_updated_by\": true,\n      \"sys_mod_count\": true\n    },\n    \"GlideRecordUtil\": {},\n      \"debug_flag\": false,\n      \"data\": {\n        \"sys_id\": \"0c43b0f5c6112275019abd2bb3dcd78f\",\n        \"operational_status\": \"1\",\n        \"os_service_pack\": \"Service Pack 1\",\n        \"cpu_manufacturer\": \"0c43b088c6112275011a4bd46a4e6cc4\",\n        \"sys_updated_on\": \"2021-07-05 18:03:59\",\n        \"discovery_source\": \"Other Automated\",\n        \"ram\": \"503\",\n        \"cpu_speed\": \"1993\",\n        \"sys_domain_path\": \"/\",\n        \"disk_space\": \"37.26\",\n        \"cost_center\": \"d9d07bddc0a80a647cf932056ed24652\",\n        \"assigned\": \"2020-08-31 08:00:00\",\n        \"cd_speed\": \"-1\",\n        \"can_print\": \"0\",\n        \"sys_class_name\": \"cmdb_ci_computer\",\n        \"manufacturer\": \"add7b97737e3100044e0bfc8bcbe5d96\",\n        \"cpu_count\": \"1\",\n        \"vendor\": \"adb3d8ce37413000158bbfc8bcbe5d15\",\n        \"assigned_to\": \"5137153cc611227c000bbd1bd8cd2007\",\n        \"os_version\": \"5.1.2600\",\n        \"cd_rom\": \"0\",\n        \"unverified\": \"0\",\n        \"asset\": \"aac1ba8837f3100044e0bfc8bcbe5d3b\",\n        \"skip_sync\": \"0\",\n        \"sys_created_on\": \"2005-05-24 01:14:19\",\n        \"sys_domain\": \"global\",\n        \"cpu_type\": \"GenuineIntel\",\n        \"install_date\": \"2020-05-19 07:00:00\",\n        \"asset_tag\": \"P1000143\",\n        \"install_status\": \"1\",\n        \"name\": \"ANDREWDWXP\",\n        \"subcategory\": \"Computer\",\n        \"virtual\": \"0\",\n        \"sys_class_path\": \"/!!/!2/!(\",\n        \"company\": \"31bea3d53790200044e0bfc8bcbe5dec\",\n        \"department\": \"221f3db5c6112284009f4becd3039cc9\",\n        \"cost\": \"1299.99\",\n        \"os\": \"Windows XP Professional\",\n        \"monitor\": \"0\",\n        \"model_id\": \"0c43b0c6c611227501522de2b64679ac\",\n        \"cost_cc\": \"USD\",\n        \"location\": \"db9a923c0a0a0a6501068d6eaec25ee0\",\n        \"category\": \"Hardware\",\n        \"fault_count\": \"0\",\n        \"serial_number\": \"XK0HKSN6\"\n      },\n      \"rl_map\": {\n        \"cmdb_serial_number:cmdb_ci\": {\n          \"GlideRecordUtil\": {},\n          \"ignoreFields\": {\n            \"sys_created_by\": true,\n            \"sys_updated_by\": true,\n            \"sys_mod_count\": true\n          },\n          \"records\": [\n            {\n              \"serial_number_type\": \"baseboard\",\n              \"serial_number\": \"XK0HKSN6\",\n              \"valid\": true\n            }\n          ],\n          \"m2m_records\": [],\n          \"table_name\": \"cmdb_serial_number\",\n          \"field_name\": \"cmdb_ci\",\n          \"cmdb_ci\": \"ANDREWDWXP\",\n          \"debug_flag\": false,\n          \"isM2M\": false,\n          \"target_table_name\": null,\n          \"target_ref_field_name\": null\n        }\n      },\n      \"cmdb_ci\": \"ANDREWDWXP\",\n      \"related\": {}\n    },\n    \"data\": {\n      \"sys_id\": \"0c43b0f5c6112275019abd2bb3dcd78f\",\n      \"operational_status\": \"1\",\n      \"os_service_pack\": \"Service Pack 1\",\n      \"cpu_manufacturer\": \"0c43b088c6112275011a4bd46a4e6cc4\",\n      \"sys_updated_on\": \"2021-07-05 18:03:59\",\n      \"discovery_source\": \"Other Automated\",\n      \"ram\": \"503\",\n      \"cpu_speed\": \"1993\",\n      \"sys_domain_path\": \"/\",\n      \"disk_space\": \"37.26\",\n      \"cost_center\": \"d9d07bddc0a80a647cf932056ed24652\",\n      \"assigned\": \"2020-08-31 08:00:00\",\n      \"cd_speed\": \"-1\",\n      \"can_print\": \"0\",\n      \"sys_class_name\": \"cmdb_ci_computer\",\n      \"manufacturer\": \"add7b97737e3100044e0bfc8bcbe5d96\",\n      \"cpu_count\": \"1\",\n      \"vendor\": \"adb3d8ce37413000158bbfc8bcbe5d15\",\n      \"assigned_to\": \"5137153cc611227c000bbd1bd8cd2007\",\n      \"os_version\": \"5.1.2600\",\n      \"cd_rom\": \"0\",\n      \"unverified\": \"0\",\n      \"asset\": \"aac1ba8837f3100044e0bfc8bcbe5d3b\",\n      \"skip_sync\": \"0\",\n      \"sys_created_on\": \"2005-05-24 01:14:19\",\n      \"sys_domain\": \"global\",\n      \"cpu_type\": \"GenuineIntel\",\n      \"install_date\": \"2020-05-19 07:00:00\",\n      \"asset_tag\": \"P1000143\",\n      \"install_status\": \"1\",\n      \"name\": \"ANDREWDWXP\",\n      \"subcategory\": \"Computer\",\n      \"virtual\": \"0\",\n      \"sys_class_path\": \"/!!/!2/!(\",\n      \"company\": \"31bea3d53790200044e0bfc8bcbe5dec\",\n      \"department\": \"221f3db5c6112284009f4becd3039cc9\",\n      \"cost\": \"1299.99\",\n      \"os\": \"Windows XP Professional\",\n      \"monitor\": \"0\",\n      \"model_id\": \"0c43b0c6c611227501522de2b64679ac\",\n      \"cost_cc\": \"USD\",\n      \"location\": \"db9a923c0a0a0a6501068d6eaec25ee0\",\n      \"category\": \"Hardware\",\n      \"fault_count\": \"0\",\n      \"serial_number\": \"XK0HKSN6\"\n    },\n    \"serials\": {\n      \"GlideRecordUtil\": {},\n      \"ignoreFields\": {\n        \"sys_created_by\": true,\n        \"sys_updated_by\": true,\n        \"sys_mod_count\": true\n      },\n      \"records\": [\n        {\n          \"serial_number_type\": \"baseboard\",\n          \"serial_number\": \"XK0HKSN6\",\n          \"valid\": true\n        }\n      ],\n      \"m2m_records\": [],\n      \"table_name\": \"cmdb_serial_number\",\n      \"field_name\": \"cmdb_ci\",\n      \"cmdb_ci\": \"ANDREWDWXP\",\n      \"debug_flag\": false,\n      \"isM2M\": false,\n      \"target_table_name\": null,\n      \"target_ref_field_name\": null\n    },\n    \"serialMap\": {\n      \"baseboard\": {\n        \"XK0HKSN6\": true\n      }\n    }\n  }\n\nserial number : XK0HKSN6\nserial type : baseboard\n```\n\n## CimCIData - SerialRecord\\(String type, String serial\\)\n\nCreates a new serial record.\n\n|Name|Type|Description|\n|----|----|-----------|\n|type|String|The serial type to assign to the CI. If out-of-box, uses the CimCIData.serialType enum.|\n|serial|String|The serial number to assign.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\n## CimCIData - setMakeAndModel\\(String make, String model\\)\n\nSets the make and model for the current configuration item \\(CI\\).\n\n|Name|Type|Description|\n|----|----|-----------|\n|make|String|Name of the manufacturer to set for the CI.|\n|model|String|Name of the model to set for the CI.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\nThe following example shows how to use the setMakeAndModel\\(\\) method to set the make and model of the specified CI.\n\n```\nvar cidata = new CIData(); // Instantiate a new CIData class object\ncidata.loadFromCI('0c43b0f5c6112275019abd2bb3dcd78f'); // Load the current data from a CI record. Use sys_id or CI name\nvar cimcidata = new CimCIData(cidata); // Instantiate a new CimCIData class object and pass the CIdata \ncimcidata.setMakeAndModel('IBM','Thinkpad T20'); // Set make(manufacturer) and model in the CIData and CimCIData\ngs.info(JSON.stringify(cimcidata, null, 4)); // Display JSON payload in string format with added manufacturer sys_id\ngs.info(\"model= \"+cimcidata.data.model_id); // Display model sys_id which is added from cmdb_hardware_product_model table\n```\n\nOutput:\n\n```\n{\n    \"cidata\": {\n        \"ignoreFields\": {\n            \"sys_created_by\": true,\n            \"sys_updated_by\": true,\n            \"sys_mod_count\": true\n        },\n        \"GlideRecordUtil\": {},\n        \"debug_flag\": false,\n        \"data\": {\n            \"sys_id\": \"0c43b0f5c6112275019abd2bb3dcd78f\",\n            \"operational_status\": \"1\",\n            \"os_service_pack\": \"Service Pack 1\",\n            \"cpu_manufacturer\": \"0c43b088c6112275011a4bd46a4e6cc4\",\n            \"sys_updated_on\": \"2022-01-06 18:07:50\",\n            \"discovery_source\": \"Other Automated\",\n            \"ram\": \"503\",\n            \"cpu_speed\": \"1993\",\n            \"sys_domain_path\": \"/\",\n            \"disk_space\": \"37.26\",\n            \"cost_center\": \"d9d07bddc0a80a647cf932056ed24652\",\n            \"assigned\": \"2020-08-31 08:00:00\",\n            \"cd_speed\": \"-1\",\n            \"can_print\": \"0\",\n            \"sys_class_name\": \"cmdb_ci_computer\",\n            \"manufacturer\": \"b7e7c073c0a801690143e7b7d29eb408\",\n            \"cpu_count\": \"1\",\n            \"vendor\": \"adb3d8ce37413000158bbfc8bcbe5d15\",\n            \"assigned_to\": \"5137153cc611227c000bbd1bd8cd2007\",\n            \"os_version\": \"5.1.2600\",\n            \"cd_rom\": \"0\",\n            \"unverified\": \"0\",\n            \"asset\": \"aac1ba8837f3100044e0bfc8bcbe5d3b\",\n            \"skip_sync\": \"0\",\n            \"sys_created_on\": \"2005-05-24 01:14:19\",\n            \"sys_domain\": \"global\",\n            \"cpu_type\": \"GenuineIntel\",\n            \"install_date\": \"2020-05-19 07:00:00\",\n            \"asset_tag\": \"P1000143\",\n            \"install_status\": \"1\",\n            \"name\": \"ANDREWDWXP\",\n            \"subcategory\": \"Computer\",\n            \"virtual\": \"0\",\n            \"sys_class_path\": \"/!!/!2/!(\",\n            \"company\": \"31bea3d53790200044e0bfc8bcbe5dec\",\n            \"department\": \"221f3db5c6112284009f4becd3039cc9\",\n            \"cost\": \"1299.99\",\n            \"os\": \"Windows XP Professional\",\n            \"monitor\": \"0\",\n            \"ip_address\": \"198.11.23.111\",\n            \"cost_cc\": \"USD\",\n            \"location\": \"db9a923c0a0a0a6501068d6eaec25ee0\",\n            \"category\": \"Hardware\",\n            \"fault_count\": \"0\",\n            \"model_id\": \"0c43b124c611227501522de2a381613e\"\n        },\n        \"rl_map\": {},\n        \"cmdb_ci\": \"0c43b0f5c6112275019abd2bb3dcd78f\",\n        \"related\": {}\n    },\n    \"data\": {\n        \"sys_id\": \"0c43b0f5c6112275019abd2bb3dcd78f\",\n        \"operational_status\": \"1\",\n        \"os_service_pack\": \"Service Pack 1\",\n        \"cpu_manufacturer\": \"0c43b088c6112275011a4bd46a4e6cc4\",\n        \"sys_updated_on\": \"2022-01-06 18:07:50\",\n        \"discovery_source\": \"Other Automated\",\n        \"ram\": \"503\",\n        \"cpu_speed\": \"1993\",\n        \"sys_domain_path\": \"/\",\n        \"disk_space\": \"37.26\",\n        \"cost_center\": \"d9d07bddc0a80a647cf932056ed24652\",\n        \"assigned\": \"2020-08-31 08:00:00\",\n        \"cd_speed\": \"-1\",\n        \"can_print\": \"0\",\n        \"sys_class_name\": \"cmdb_ci_computer\",\n        \"manufacturer\": \"b7e7c073c0a801690143e7b7d29eb408\",\n        \"cpu_count\": \"1\",\n        \"vendor\": \"adb3d8ce37413000158bbfc8bcbe5d15\",\n        \"assigned_to\": \"5137153cc611227c000bbd1bd8cd2007\",\n        \"os_version\": \"5.1.2600\",\n        \"cd_rom\": \"0\",\n        \"unverified\": \"0\",\n        \"asset\": \"aac1ba8837f3100044e0bfc8bcbe5d3b\",\n        \"skip_sync\": \"0\",\n        \"sys_created_on\": \"2005-05-24 01:14:19\",\n        \"sys_domain\": \"global\",\n        \"cpu_type\": \"GenuineIntel\",\n        \"install_date\": \"2020-05-19 07:00:00\",\n        \"asset_tag\": \"P1000143\",\n        \"install_status\": \"1\",\n        \"name\": \"ANDREWDWXP\",\n        \"subcategory\": \"Computer\",\n        \"virtual\": \"0\",\n        \"sys_class_path\": \"/!!/!2/!(\",\n        \"company\": \"31bea3d53790200044e0bfc8bcbe5dec\",\n        \"department\": \"221f3db5c6112284009f4becd3039cc9\",\n        \"cost\": \"1299.99\",\n        \"os\": \"Windows XP Professional\",\n        \"monitor\": \"0\",\n        \"ip_address\": \"198.11.23.111\",\n        \"cost_cc\": \"USD\",\n        \"location\": \"db9a923c0a0a0a6501068d6eaec25ee0\",\n        \"category\": \"Hardware\",\n        \"fault_count\": \"0\",\n        \"model_id\": \"0c43b124c611227501522de2a381613e\"\n    },\n    \"serials\": null,\n    \"serialMap\": {}\n}\nmodel= 0c43b124c611227501522de2a381613e\n```\n\n"}}