ICUtils - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • . ICUtils Inclusão de script é 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 glide.relationship.max_depth propriedade.

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

    . ICUtils a classe está disponível para scripts do lado do servidor.

    ICUtils - servicesAffectedByCI(cadeia de caracteres ci_sys_id)

    Determina quais serviços de negócio são afetados pelo item de configuração (IC) específico.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    IC_sys_id Cadeia de caracteres O sys_id de um item de configuração (cmdb_ci) a ser verificado.
    Tabela 2. Retornos
    Tipo Descrição
    Matriz Uma matriz de valores sys_id para registros cmdb_ci downstream do item especificado (ou afetado por).

    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)

    Determina quais serviços de negócio são afetados pela tarefa especificada.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    tarefa GlideRecord GlideRecord de tarefa, por exemplo, incidente, change_request ou problema.
    Tabela 4. Retornos
    Tipo Descrição
    Matriz Lista de valores sys_id para ICs downstream do (ou afetados por) o item de configuração referenciado pelo campo cmdb_ci da tarefa.

    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