---
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


---

# CIUtils - Global

# CIUtils - Global {#ariaid-title1}

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

A inclusão de script CIUtils é uma classe de utilitário que fornece métodos para trabalhar com itens de configuração (IC).

Por padrão, ao percorrer relacionamentos de IC, o sistema usa uma profundidade máxima de 10. Você pode substituir este valor modificando a propriedade glide.relationship.max_details.

O número máximo de itens retornados é 1000. Você pode substituir este valor modificando a propriedade glide.relationship.threshold.

A classe CIUtils está disponível para scripts do lado do servidor.

## CIUtils - ServicesAffectedByCI(cadeia de caracteres CI_sys_id) {#ariaid-title2}

Determina quais serviços de negócio são afetados pelo item de configuração (IC) específico.
{#r_CIUtils-servicesAffectedByCI_S__table_ity_vh1_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| CI_sys_id | Cadeia de caracteres | O sys_id de um item de configuração (cmdb_ci) a ser verificado. |
[Tabela 1. Parâmetros]

{#r_CIUtils-servicesAffectedByCI_S__table_ity_vh1_4t} {#r_CIUtils-servicesAffectedByCI_S__table_jty_vh1_4t__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de valores de sys_id para registros cmdb_ci descendentes de (ou afetados por) o item especificado. |
[Tabela 2. Retorna]

{#r_CIUtils-servicesAffectedByCI_S__table_jty_vh1_4t}  
Este exemplo exibe os nomes dos serviços afetados pelos itens de IC com o nome = lnux100.

    var CIUtil = new CIUtils();
     
    //get a server record
    var server = new GlideRecord("cmdb_ci_server");
    server.addQuery("name", "lnux100");
    server.query();
    if (server.next()) {
      //get the affected services, array of ids
      var serviceIds = CIUtil.servicesAffectedByCI(server.getUniqueValue());
      for (var i=0; i < serviceIds.length; i++) {
        //get the service record
        var service = new GlideRecord("cmdb_ci_service");
        service.get(serviceIds[i]);
        gs.print(service.getDisplayValue());
      }
    }

Saída:

    Client Services
    IT Services
    Bond Trading

## CIUtils - ServicesAffectedByTask(tarefa GlideRecord) {#ariaid-title3}

Determina quais serviços de negócio são afetados pela tarefa especificada.
{#r_CIUtils-servicesAffByTask_GR__table_dml_r31_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tarefa | GlideRecord | Tarefa GlideRecord, por exemplo, incident, change_request ou problem. |
[Tabela 3. Parâmetros]

{#r_CIUtils-servicesAffByTask_GR__table_dml_r31_4t} {#r_CIUtils-servicesAffByTask_GR__table_eml_r31_4t__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Lista de valores de sys_id para ICs descendentes (ou afetados por) do item de configuração referenciado pelo campo cmdb_ci da tarefa. |
[Tabela 4. Retorna]

{#r_CIUtils-servicesAffByTask_GR__table_eml_r31_4t}  
Este exemplo exibe os nomes dos serviços afetados pelo incidente INC00050.

    var CIUtil = new CIUtils();
     
    //get an incident record
    var inc = new GlideRecord("incident");
    inc.addQuery("number", "INC00050");
    inc.query();
    if (inc.next()) {
      //get the affected services, array of ids
      var serviceIds = CIUtil.servicesAffectedByTask(inc);
      for (var i=0; i < serviceIds.length; i++) {
        //get the service record
        var service = new GlideRecord("cmdb_ci_service");
        service.get(serviceIds[i]);
        gs.print(service.getDisplayValue());
      }
    }

Saída:

    IT Services
    Email
    Windows Mobile
    Electronic Messaging
    Outlook Web Access (OWA)
    Blackberry