CIUtils - Global

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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)

    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
    CI_sys_id Cadeia de caracteres O sys_id de um item de configuração (cmdb_ci) a ser verificado.
    Tabela 2. Retorna
    Tipo Descrição
    Matriz Uma matriz de valores de sys_id para registros cmdb_ci descendentes de (ou afetados por) o item especificado.

    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 Tarefa GlideRecord, por exemplo, incident, change_request ou problem.
    Tabela 4. Retorna
    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.

    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