Transformateur - Inclus, Global

L’API Transformer manipule les données de séries chronologiques pour préparer les données à l’évaluation et à l’analyse.

Vous pouvez appeler cette API dans les scripts serveur inclus dans le périmètre et globaux. Lorsque vous utilisez la classe Transformer , utilisez l’identificateur d’espace de noms sn_clotho.

Le cas d’utilisation général consiste à déterminer la période à évaluer, à sélectionner les enregistrements dans la table avec le champ de mesure, à définir le type de transformation à exécuter, puis à exécuter la transformation.

// 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);

Cette classe fait partie de l’application MetricBase .

Transformateur : transformateur( GlideRecord sourceRecords)

Créez un objet Transformer.

Tableau 1. Paramètres

Nom	Type	Description
sourceRecords	GlideRecord	Contient les enregistrements pour lesquels les mesures doivent être évaluées. Il peut s’agir d’un ou de plusieurs enregistrements.

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

Transformateur : execute(GlideDateTime début, fin GlideDateTime)

Exécutez la transformation.

Utilisez les méthodes metric() et groupBy() avant d’appeler execute(). La méthode execute() ne peut être appelée qu’une seule fois pour chaque objet Transformer.

Les actions effectuées dans le cadre de la transformation ne modifient pas les données de la MetricBase base de données.

Tableau 2. Paramètres

Nom	Type	Description
début	GlideDateTime	Début de la période à évaluer.
fin	GlideDateTime	Fin de la période à évaluer.

Tableau 3. Renvoie

Type	Description
TransformResult (en anglais seulement)	Les données transformées.

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

Transformateur : groupBy (champ de chaîne)

Spécifie le champ à utiliser pour regrouper les données.

Si vous comptez utiliser la méthode groupBy(), vous devez l’appeler must avant d’appeler la méthode execute().

Tableau 4. Paramètres

Nom	Type	Description
champ	Chaîne	Champ de la table à utiliser pour regrouper les résultats de la transformation.

Tableau 5. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart que vous pouvez utiliser pour spécifier les caractéristiques de transformation.

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

Transformateur : metric(String metricName)

Spécifiez le champ de mesure à utiliser dans la transformation.

Vous pouvez spécifier plusieurs mesures à utiliser dans la transformation. La méthode metric() ne peut pas être appelée après l’appel de la méthode execute().

Tableau 6. Paramètres

Nom	Type	Description
metricName	Chaîne	Nom du champ de mesure.

Tableau 7. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

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