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


---

# Transformador - com escopo, global

# Transformador - com escopo, global {#ariaid-title1}

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

A API do transformador manipula dados da série temporal para preparar os dados para avaliação e análise.

Você pode chamar esta API em scripts de servidor com escopo e globais. Ao usar a classe Transformer, use o identificador de namespace `sn_clotho`.  
O caso de uso geral é determinar o período a ser avaliado, selecionar os registros da tabela com o campo de métrica, definir o tipo de transformação a ser executada e, em seguida, 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 da aplicação MetricBase.

## Transformador - Transformador (GlideRecord sourceRecords) {#ariaid-title2}

Crie um objeto Transformador.
{#TFMR-transformer_GR__table_w4x_4qr_mbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| registrosDeorigem | GlideRecord | Contém os registros para os quais as métricas serão avaliadas. Pode ser um registro ou vários. |
[Tabela 1. Parâmetros]

{#TFMR-transformer_GR__table_w4x_4qr_mbb}  

    //where drones is a GlideRecord created from a table with a metric field
    	var builder = new sn_clotho.Transformer(drones);

## Transformador - execute (início de GlideDateTime, fim de GlideDateTime) {#ariaid-title3}

Execute a transformação.
Use os métodos metric() e groupBy() antes de chamar execute(). O método execute() 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 banco de dados MetricBase.
{#TFRM-execute_GDT_GDT__table_b2l_4xr_mbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| iniciar | GlideDateTime | O início do período a ser avaliado. |
| terminar | GlideDateTime | O fim do período a ser avaliado. |
[Tabela 2. Parâmetros]

{#TFRM-execute_GDT_GDT__table_b2l_4xr_mbb} {#TFRM-execute_GDT_GDT__table_c2l_4xr_mbb__entry__2}

| Tipo | Descrição |
|-|-|
| Resultado da transformação | Os dados transformados. |
[Tabela 3. Retorna]

{#TFRM-execute_GDT_GDT__table_c2l_4xr_mbb}  

    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(String field) {#ariaid-title4}

Especifica o campo a ser usado para agrupar os dados.
Se você for usar o método groupBy(), deverá chamá-lo antes de chamar o método execute().
{#TFMR-groupBy_S__table_brg_q5r_mbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Assunto: | Cadeia de caracteres | O campo na tabela a ser usado para agrupar os resultados da transformação. |
[Tabela 4. Parâmetros]

{#TFMR-groupBy_S__table_brg_q5r_mbb} {#TFMR-groupBy_S__table_crg_q5r_mbb__entry__2}

| Tipo | Descrição |
|-|-|
| TransformPart | Um objeto TransformPart que você pode usar para especificar as características de transformação. |
[Tabela 5. Retorna]

{#TFMR-groupBy_S__table_crg_q5r_mbb}  

    var transformer = new sn_clotho.Transformer(grDrone);
    var trnsfrm = transformer.groupBy("fleet");

## Transformador - metric(String metricName) {#ariaid-title5}

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. O método metric() não pode ser chamado depois que o método execute() é chamado.
{#TFRM-metric_S__table_g3m_yvr_mbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| metricName | Cadeia de caracteres | Nome do campo de métrica. |
[Tabela 6. Parâmetros]

{#TFRM-metric_S__table_g3m_yvr_mbb} {#TFRM-metric_S__table_h3m_yvr_mbb__entry__2}

| Tipo | Descrição |
|-|-|
| TransformPart | Um objeto TransformPart que pode ser usado para especificar as características de transformação. |
[Tabela 7. Retorna]

{#TFRM-metric_S__table_h3m_yvr_mbb}  

    var transformer = new sn_clotho.Transformer(grDrone);
    var trnsfrm = transformer.metric("mb_demo_mt_altitude");