Like what you see? Have a play with our trial version.

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

If the filter option “Value Entry Method” is set to “Value List Selection”, as shown below.
Image Modified

In this case, Yellowfin will attempt to generate possible values for the filter. These values can be retrieved from Reference Code Values, Cached Values or a Custom Query. 

...

The filter Athlete Country has the default values of [‘AU’, ‘NZ’]

filter.setValue(['UK', 'US']);

console.log(filter.values); //Outputs {valueList: ['UK', 'US'] }

filter.reset();

console.log(filter.values); //Outputs {valueList: ['AU', 'NZ']


clear(apply)

Returns

Nothing.

...

The filter Athlete Country has the default values of [‘AU’, ‘NZ’]

filter.setValue(['UK', 'US']);

console.log(filter.values); //Outputs {valueList: ['UK', 'US'] }

filter.clear();

console.log(filter.values); //Outputs {valueList: null]}


resetToLastAppliedState()

...

apply - Boolean - Default: false

Example

filter.setValueOne('Relaxation'); //Change the value to Relaxtion but don't immediately run the report

console.log(filter.valueOne); //Should return 'Relaxation'




setValueTwo(value, apply)

...

apply - Boolean - Default: false

Example

//Filter is a between filter (Average Age at Camp)
filter.setValueOne(15);
filter.setValueTwo(35);

console.log(filter.valueOne + " to " + filter.valueTwo); //Should output "15 to 35"



setValueList(valueList, apply)

...

A list filter will treat this as you selecting a single value. It is equivalent to calling:

filter.setValueList(['single value']);


A between or single entry filter will set valueOne to the passed value. Effectively this:

...

Copies the filter's currently staged values, valueOne, valueTwo and valueList to the applied equivalents of those objects. If there are any changes between valueOne and appliedValueOne, valueTwo and appliedValueTwo and valueList and appliedValueList, an ‘applied’ event will be triggered with the values that have changed. See applied event for details. 

Example

Apply the value Adventure to the Demographic filter.

...

When an event is set up a unique ID is assigned to it which is returned as the result of this function. This ID can be used by the removeEventListener function to remove the callback when you are done with it. If you are writing an application that requires loading and unloading reports it is recommended that you keep track of these listenerIds so that you can remove them when no longer needed.

See the event reference section for details about the events that this API will trigger itself.

...

let eventListenerId = filter.addEventListener('changed', function(event) {
    console.log(event.filter.name ' changed value');
    filter.removeEventListener(eventListenerId);
});

...

Any event that is triggered through the FilterObject will have an object that contains the filterUUID and the filter object itself. 

filter.addEventListener('changed', function(event) {
      console.log(event.uuid); //The filters UUID that the event was triggered from
      console.log(event.filter);//The FilterObject that the event was triggered from
});


changed

Description

Occurs when any of the filter values changes. Triggers with an object that contains the values that changed as well as the previous values of all of those values.

...

filter.addEventListener('applied', function(event) {
      console.log(event.filter.name + " has just been applied with the following changed values " + JSON.stringify(event.changed));
});

...

filter.addEventListener('reset', function(event) {
      console.log(event.filter.name + " has just been reset");
});

...

filter.addEventListener(cleared, function(event) {
      console.log(event.filter.name + " has just had its values cleared");
});

...