---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CimCIData - Global

# CimCIData - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura

A inclusão de script CimCIData fornece um wrapper para manipulação de dados de item de configuração (IC) do modelo de informação comum (CIM).

Use com qualquer script de descoberta do lado do servidor.

## CimCIData - addSerial(tipo de cadeia de caracteres, cadeia de caracteres serial) {#ariaid-title2}

Adiciona um número de série ao item de configuração (IC) atual, por tipo.
{#r_CCD-addSerial_S_S__table_nsj_pdc_rt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tipo | Cadeia de caracteres | Tipo de número de série. Para o sistema base, use a enumeração CimCIData.serialType. |
| série | Cadeia de caracteres | Número de série a ser adicionado. |
[Tabela 1. Parâmetros]

{#r_CCD-addSerial_S_S__table_nsj_pdc_rt} {#r_CCD-addSerial_S_S__table_osj_pdc_rt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | IC atual |
[Tabela 2. Retorna]

{#r_CCD-addSerial_S_S__table_osj_pdc_rt}  
O exemplo a seguir carrega os dados de IC do IC atual e passa o objeto de dados para o método CimCIData.addSerial() que adiciona o número de série a CimCIData e CIData.

    var cidata = new CIData();  //Instantiate a new CIData class object
    cidata.loadFromCI('0c43b0f5c6112275019abd2bb3dcd78f');  // Load the current data from a CI record. use sys_id or ci name
    var cimcidata = new CimCIData(cidata);  // Instantiate a new CimCIData class object and pass the CIdata 
    var cimdata = cimcidata.addSerial('baseboard','XK0HKSN6');  // Add serial number to the CIData and CimCIData
    gs.info(JSON.stringify(cimdata, null ,4));  // The JSON payload in string format with added serial number and serial number type
    gs.info("serial number : "+cimdata.serials.records[1].serial_number);  // Display serial number which is added
    gs.info("serial type : "+ cimdata.serials.records[1].serial_number_type);  // Display serial type which is added

Saída:

    {
      "cidata": {
        "ignoreFields": {
          "sys_created_by": true,
          "sys_updated_by": true,
          "sys_mod_count": true
        },
        "GlideRecordUtil": {},
          "debug_flag": false,
          "data": {
            "sys_id": "0c43b0f5c6112275019abd2bb3dcd78f",
            "operational_status": "1",
            "os_service_pack": "Service Pack 1",
            "cpu_manufacturer": "0c43b088c6112275011a4bd46a4e6cc4",
            "sys_updated_on": "2021-07-05 18:03:59",
            "discovery_source": "Other Automated",
            "ram": "503",
            "cpu_speed": "1993",
            "sys_domain_path": "/",
            "disk_space": "37.26",
            "cost_center": "d9d07bddc0a80a647cf932056ed24652",
            "assigned": "2020-08-31 08:00:00",
            "cd_speed": "-1",
            "can_print": "0",
            "sys_class_name": "cmdb_ci_computer",
            "manufacturer": "add7b97737e3100044e0bfc8bcbe5d96",
            "cpu_count": "1",
            "vendor": "adb3d8ce37413000158bbfc8bcbe5d15",
            "assigned_to": "5137153cc611227c000bbd1bd8cd2007",
            "os_version": "5.1.2600",
            "cd_rom": "0",
            "unverified": "0",
            "asset": "aac1ba8837f3100044e0bfc8bcbe5d3b",
            "skip_sync": "0",
            "sys_created_on": "2005-05-24 01:14:19",
            "sys_domain": "global",
            "cpu_type": "GenuineIntel",
            "install_date": "2020-05-19 07:00:00",
            "asset_tag": "P1000143",
            "install_status": "1",
            "name": "ANDREWDWXP",
            "subcategory": "Computer",
            "virtual": "0",
            "sys_class_path": "/!!/!2/!(",
            "company": "31bea3d53790200044e0bfc8bcbe5dec",
            "department": "221f3db5c6112284009f4becd3039cc9",
            "cost": "1299.99",
            "os": "Windows XP Professional",
            "monitor": "0",
            "model_id": "0c43b0c6c611227501522de2b64679ac",
            "cost_cc": "USD",
            "location": "db9a923c0a0a0a6501068d6eaec25ee0",
            "category": "Hardware",
            "fault_count": "0",
            "serial_number": "XK0HKSN6"
          },
          "rl_map": {
            "cmdb_serial_number:cmdb_ci": {
              "GlideRecordUtil": {},
              "ignoreFields": {
                "sys_created_by": true,
                "sys_updated_by": true,
                "sys_mod_count": true
              },
              "records": [
                {
                  "serial_number_type": "baseboard",
                  "serial_number": "XK0HKSN6",
                  "valid": true
                }
              ],
              "m2m_records": [],
              "table_name": "cmdb_serial_number",
              "field_name": "cmdb_ci",
              "cmdb_ci": "ANDREWDWXP",
              "debug_flag": false,
              "isM2M": false,
              "target_table_name": null,
              "target_ref_field_name": null
            }
          },
          "cmdb_ci": "ANDREWDWXP",
          "related": {}
        },
        "data": {
          "sys_id": "0c43b0f5c6112275019abd2bb3dcd78f",
          "operational_status": "1",
          "os_service_pack": "Service Pack 1",
          "cpu_manufacturer": "0c43b088c6112275011a4bd46a4e6cc4",
          "sys_updated_on": "2021-07-05 18:03:59",
          "discovery_source": "Other Automated",
          "ram": "503",
          "cpu_speed": "1993",
          "sys_domain_path": "/",
          "disk_space": "37.26",
          "cost_center": "d9d07bddc0a80a647cf932056ed24652",
          "assigned": "2020-08-31 08:00:00",
          "cd_speed": "-1",
          "can_print": "0",
          "sys_class_name": "cmdb_ci_computer",
          "manufacturer": "add7b97737e3100044e0bfc8bcbe5d96",
          "cpu_count": "1",
          "vendor": "adb3d8ce37413000158bbfc8bcbe5d15",
          "assigned_to": "5137153cc611227c000bbd1bd8cd2007",
          "os_version": "5.1.2600",
          "cd_rom": "0",
          "unverified": "0",
          "asset": "aac1ba8837f3100044e0bfc8bcbe5d3b",
          "skip_sync": "0",
          "sys_created_on": "2005-05-24 01:14:19",
          "sys_domain": "global",
          "cpu_type": "GenuineIntel",
          "install_date": "2020-05-19 07:00:00",
          "asset_tag": "P1000143",
          "install_status": "1",
          "name": "ANDREWDWXP",
          "subcategory": "Computer",
          "virtual": "0",
          "sys_class_path": "/!!/!2/!(",
          "company": "31bea3d53790200044e0bfc8bcbe5dec",
          "department": "221f3db5c6112284009f4becd3039cc9",
          "cost": "1299.99",
          "os": "Windows XP Professional",
          "monitor": "0",
          "model_id": "0c43b0c6c611227501522de2b64679ac",
          "cost_cc": "USD",
          "location": "db9a923c0a0a0a6501068d6eaec25ee0",
          "category": "Hardware",
          "fault_count": "0",
          "serial_number": "XK0HKSN6"
        },
        "serials": {
          "GlideRecordUtil": {},
          "ignoreFields": {
            "sys_created_by": true,
            "sys_updated_by": true,
            "sys_mod_count": true
          },
          "records": [
            {
              "serial_number_type": "baseboard",
              "serial_number": "XK0HKSN6",
              "valid": true
            }
          ],
          "m2m_records": [],
          "table_name": "cmdb_serial_number",
          "field_name": "cmdb_ci",
          "cmdb_ci": "ANDREWDWXP",
          "debug_flag": false,
          "isM2M": false,
          "target_table_name": null,
          "target_ref_field_name": null
        },
        "serialMap": {
          "baseboard": {
            "XK0HKSN6": true
          }
        }
      }

    serial number : XK0HKSN6
    serial type : baseboard

## CimCIData - SerialRecord (tipo de cadeia de caracteres, cadeia de caracteres serial) {#ariaid-title3}

Cria um novo registro serial.
{#r_CCD-SerialRecord_S_S__table_avy_2dc_rt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tipo | Cadeia de caracteres | O tipo de série a ser atribuído ao IC. Se estiver pronto para uso, usará a enumeração CimCIData.serialType. |
| série | Cadeia de caracteres | O número de série a ser atribuído. |
[Tabela 3. Parâmetros]

{#r_CCD-SerialRecord_S_S__table_avy_2dc_rt} {#r_CCD-SerialRecord_S_S__table_bvy_2dc_rt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 4. Retorna]

{#r_CCD-SerialRecord_S_S__table_bvy_2dc_rt}

## CimCIData - set MakeAndModel(cadeia de caracteres marca, cadeia de caracteres modelo) {#ariaid-title4}

Define a marca e o modelo do item de configuração (IC) atual.
{#r_CCD-setMakeAndModel_S_S__table_tqp_12c_rt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fazer | Cadeia de caracteres | Nome do fabricante a ser definido para o IC. |
| modelo | Cadeia de caracteres | Nome do modelo a ser definido para o IC. |
[Tabela 5. Parâmetros]

{#r_CCD-setMakeAndModel_S_S__table_tqp_12c_rt} {#r_CCD-setMakeAndModel_S_S__table_uqp_12c_rt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 6. Retorna]

{#r_CCD-setMakeAndModel_S_S__table_uqp_12c_rt}  
O exemplo a seguir mostra como usar o método set MakeAndModel() para definir a marca e o modelo do IC especificado.

    var cidata = new CIData(); // Instantiate a new CIData class object
    cidata.loadFromCI('0c43b0f5c6112275019abd2bb3dcd78f'); // Load the current data from a CI record. Use sys_id or CI name
    var cimcidata = new CimCIData(cidata); // Instantiate a new CimCIData class object and pass the CIdata 
    cimcidata.setMakeAndModel('IBM','Thinkpad T20'); // Set make(manufacturer) and model in the CIData and CimCIData
    gs.info(JSON.stringify(cimcidata, null, 4)); // Display JSON payload in string format with added manufacturer sys_id
    gs.info("model= "+cimcidata.data.model_id); // Display model sys_id which is added from cmdb_hardware_product_model table

Saída:

    {
        "cidata": {
            "ignoreFields": {
                "sys_created_by": true,
                "sys_updated_by": true,
                "sys_mod_count": true
            },
            "GlideRecordUtil": {},
            "debug_flag": false,
            "data": {
                "sys_id": "0c43b0f5c6112275019abd2bb3dcd78f",
                "operational_status": "1",
                "os_service_pack": "Service Pack 1",
                "cpu_manufacturer": "0c43b088c6112275011a4bd46a4e6cc4",
                "sys_updated_on": "2022-01-06 18:07:50",
                "discovery_source": "Other Automated",
                "ram": "503",
                "cpu_speed": "1993",
                "sys_domain_path": "/",
                "disk_space": "37.26",
                "cost_center": "d9d07bddc0a80a647cf932056ed24652",
                "assigned": "2020-08-31 08:00:00",
                "cd_speed": "-1",
                "can_print": "0",
                "sys_class_name": "cmdb_ci_computer",
                "manufacturer": "b7e7c073c0a801690143e7b7d29eb408",
                "cpu_count": "1",
                "vendor": "adb3d8ce37413000158bbfc8bcbe5d15",
                "assigned_to": "5137153cc611227c000bbd1bd8cd2007",
                "os_version": "5.1.2600",
                "cd_rom": "0",
                "unverified": "0",
                "asset": "aac1ba8837f3100044e0bfc8bcbe5d3b",
                "skip_sync": "0",
                "sys_created_on": "2005-05-24 01:14:19",
                "sys_domain": "global",
                "cpu_type": "GenuineIntel",
                "install_date": "2020-05-19 07:00:00",
                "asset_tag": "P1000143",
                "install_status": "1",
                "name": "ANDREWDWXP",
                "subcategory": "Computer",
                "virtual": "0",
                "sys_class_path": "/!!/!2/!(",
                "company": "31bea3d53790200044e0bfc8bcbe5dec",
                "department": "221f3db5c6112284009f4becd3039cc9",
                "cost": "1299.99",
                "os": "Windows XP Professional",
                "monitor": "0",
                "ip_address": "198.11.23.111",
                "cost_cc": "USD",
                "location": "db9a923c0a0a0a6501068d6eaec25ee0",
                "category": "Hardware",
                "fault_count": "0",
                "model_id": "0c43b124c611227501522de2a381613e"
            },
            "rl_map": {},
            "cmdb_ci": "0c43b0f5c6112275019abd2bb3dcd78f",
            "related": {}
        },
        "data": {
            "sys_id": "0c43b0f5c6112275019abd2bb3dcd78f",
            "operational_status": "1",
            "os_service_pack": "Service Pack 1",
            "cpu_manufacturer": "0c43b088c6112275011a4bd46a4e6cc4",
            "sys_updated_on": "2022-01-06 18:07:50",
            "discovery_source": "Other Automated",
            "ram": "503",
            "cpu_speed": "1993",
            "sys_domain_path": "/",
            "disk_space": "37.26",
            "cost_center": "d9d07bddc0a80a647cf932056ed24652",
            "assigned": "2020-08-31 08:00:00",
            "cd_speed": "-1",
            "can_print": "0",
            "sys_class_name": "cmdb_ci_computer",
            "manufacturer": "b7e7c073c0a801690143e7b7d29eb408",
            "cpu_count": "1",
            "vendor": "adb3d8ce37413000158bbfc8bcbe5d15",
            "assigned_to": "5137153cc611227c000bbd1bd8cd2007",
            "os_version": "5.1.2600",
            "cd_rom": "0",
            "unverified": "0",
            "asset": "aac1ba8837f3100044e0bfc8bcbe5d3b",
            "skip_sync": "0",
            "sys_created_on": "2005-05-24 01:14:19",
            "sys_domain": "global",
            "cpu_type": "GenuineIntel",
            "install_date": "2020-05-19 07:00:00",
            "asset_tag": "P1000143",
            "install_status": "1",
            "name": "ANDREWDWXP",
            "subcategory": "Computer",
            "virtual": "0",
            "sys_class_path": "/!!/!2/!(",
            "company": "31bea3d53790200044e0bfc8bcbe5dec",
            "department": "221f3db5c6112284009f4becd3039cc9",
            "cost": "1299.99",
            "os": "Windows XP Professional",
            "monitor": "0",
            "ip_address": "198.11.23.111",
            "cost_cc": "USD",
            "location": "db9a923c0a0a0a6501068d6eaec25ee0",
            "category": "Hardware",
            "fault_count": "0",
            "model_id": "0c43b124c611227501522de2a381613e"
        },
        "serials": null,
        "serialMap": {}
    }
    model= 0c43b124c611227501522de2a381613e


