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
{Booleantrue
|false
} [required] – If value istrue
, the filter is added to the existing Search Filters group on the Bill Payment Processing page. If value isfalse
, 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, thereference
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. ThehelpText
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 thatsource
must have a value if thetype
argument isselect
ormultiselect
, 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');