modifyMeasure()

Home > @gooddata/sdk-model > modifyMeasure

modifyMeasure() function

Creates a new measure by applying modifications on top of an existing measure.

Signature:

export declare function modifyMeasure<T extends IMeasureDefinitionType>(measure: IMeasure<T>, modifications?: MeasureModifications<MeasureBuilderBase<IMeasureDefinitionType>>): IMeasure<T>;

Parameters

Parameter	Type	Description
measure	IMeasure<T>	measure to use as template for the new measure
modifications	MeasureModifications<MeasureBuilderBase<IMeasureDefinitionType>>	(Optional) modifications to apply

Returns:

IMeasure<T>

new instance

Remarks

This generic function can accept measure of any type and thus in returns allows modifications on the properties that are common in any type of measure.

This operation is immutable and will not alter the input measure.

The returned measure will have the same localIdentifier as the original measure. If you would like to assign new/different local identifier to the measure, you can do that using the modifications where you can provide either new custom localId or indicate that the measure should fall back to the auto-generated localId.