Transformador - Com escopo, Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . Transformador A API manipula dados de série temporal para preparar os dados para avaliação e análise.

    Você pode chamar esta API em scripts de servidor globais e com escopo. Ao usar o. Transformador classe, use sn_clotho identificador de namespace.

    O caso de uso geral é determinar o período a ser avaliado, selecionar os registros na tabela com o campo de métrica, definir o tipo de transformação a ser executada e executar a transformação.
    // create the start and end time
           var start = new GlideDateTime();
    	start.addSeconds(-1 * 60 * 60); 
    	var end = new GlideDateTime();
    	
    	//mb_demo_drone is a table with metric fields. 
    	var drones = new GlideRecord("mb_demo_drone");
    	drones.addQuery("model", "Kingfisher Phantom");
    	drones.query();
    
    	//build a transform that returns a simple average
    	var builder = new sn_clotho.Transformer(drones);
    	builder.metric("mb_demo_mt_rem_battery").avg().label("Original");
    
    	//execute transform and return result for visualization
    	var result = builder.execute(start,end);

    Esta classe faz parte de MetricBase aplicação.

    Transformer - Transformador ( GlideRecord sourceRecords)

    Crie um objeto transformador.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    SourceRecords GlideRecord Contém os registros para os quais as métricas serão avaliadas. Pode ser um registro ou vários.
    //where drones is a GlideRecord created from a table with a metric field
    	var builder = new sn_clotho.Transformer(drones);
    

    Transformador - executar (início GlideDateTime, término GlideDateTime)

    Execute a transformação.

    Use métrica () e. GroupBy() métodos antes de chamar executar() . . executar() O método só pode ser chamado uma vez para cada objeto transformador.

    As ações executadas como parte da transformação não mudam os dados no MetricBase banco de dados.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    início GlideDateTime O início do período a ser avaliado.
    término GlideDateTime O fim do período a ser avaliado.
    Tabela 3. Retornos
    Tipo Descrição
    TransformResult Os dados transformados.
    var minutesAgoStart = 60;
    	var end = new GlideDateTime();
    	var start = new GlideDateTime(end);
    	start.addSeconds(-1 * 60 * minutesAgoStart);
    	
    	// query subject records
    	var grDrone = new GlideRecord('mb_demo_drone');
    	grDrone.query();
    	
    	// building transform; get the average transforms of a metric, grouping by model
    	var transformer = new sn_clotho.Transformer(grDrone);
    	transformer.groupBy("fleet").metric("mb_demo_mt_altitude").avg().label('avg - %g:fleet:');
    
    	// execute and return result for visualization
    	var tfrmResult = transformer.execute(start, end);

    Transformador - groupBy (campo de cadeia de caracteres)

    Especifica o campo a ser usado para agrupar os dados.

    Se você for usar o. GroupBy() método, você deve chamá-lo antes de chamar executar() método.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    Assunto: Cadeia de caracteres O campo na tabela a ser usado para agrupar os resultados da transformação.
    Tabela 5. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que você pode usar para especificar as características de transformação.
    var transformer = new sn_clotho.Transformer(grDrone);
    var trnsfrm = transformer.groupBy("fleet");

    Transformador - métrica (cadeia de caracteres metricName)

    Especifique o campo de métrica a ser usado na transformação.

    Você pode especificar várias métricas a serem usadas na transformação. . métrica () o método não pode ser chamado após executar() o método é chamado.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    metricName Cadeia de caracteres Nome do campo de métrica.
    Tabela 7. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar as características de transformação.
    var transformer = new sn_clotho.Transformer(grDrone);
    var trnsfrm = transformer.metric("mb_demo_mt_altitude");