AddFilter(isDefaultFilter, reference, type, label, displayType, defaultValue, helpText, source, maxLength)

Adds a filter on the Bill Payment Processing page. The filter refines the search of bills to be processed.

Parameters

• isDefaultFilter {Boolean true|false} [required] – If value is true, the filter is added to the existing Search Filters group on the Bill Payment Processing page. If value is false, a new group of filters, named Custom Transaction Filters, is added to the Bill Payment Processing page.

• reference {string} [required] – The internal ID name of the field you want to add as a filter. Note that you can only add fields from the transaction record. If you want to source a newly created transaction body field or transaction column field, the reference argument must be the id of the newly created field.

• type {string} [required] – The field type of the filter. Valid arguments are listed below:

  • text

  • date

  • checkbox

  • select

  • multiselect

  • integer

  • currency

  • longtext

• label {string} [required] – The label of the filter displayed on the Bill Payment Processing page.

• displayType {string} [optional] – The display type of the filter on the Bill Payment Processing page. Accepted values are listed below.

  • inline

  • normal

  • hidden

  • disabled

• defaultValue {string} [optional] – The default value of the filter that is displayed automatically when the Bill Payment Processing page loads.

• helpText {string} [optional] – The text displayed when the filter label is clicked. The helpText value describes the data searched for when the filter is used.

• source {string} [optional] – Specifies the source where the filter gets its autopopulated values. An example value is the internal id of a list or record. Note that source must have a value if the type argument is select or multiselect, for the values of the filter to be displayed.

• maxLength {string} [optional] – A whole number that defines the allowed length of the value entered on the filter.

Returns

• void

Throws

• EP_MISSING_FIELDS – Thrown when a required argument is missing. Logs “Please enter required filter parameters: isDefaultFilter, reference, type, label.”

• EP_INVALID_VALUE – Thrown when an invalid argument is passed.

Example

          var epPaymentSelectionForm = new EPPaymentSelectionForm();

epPaymentSelectionForm.AddFilter(false,'custbody_custom_name', 'text', 'Custom Name'); 

        

General Notices