Description: Changes or appends an SQL item in an existing global filter and optionally saves the filter.
Calling convention: CIP_SetFilterItem("TargetFilterName": String, FilterItemIndex: Integer, "FilterGroup": String, "FilterDescription": String, "FilterItemValue": String, SaveFilter: Boolean)
Parameters:
TargetFilterName: existing filter name.
FilterItemIndex: item to change; -1 or an index at or above the count appends one item.
FilterGroup: new group text.
FilterDescription: currently read but not applied.
FilterItemValue: SQL filter expression.
SaveFilter: TRUE persists the filter.
Returns: No defined return value. NULL name/index or an unknown filter raises an exception.
Availability: Default; modifies global filter state and may write it to the database. FilterItemValue is SQL text and must come from a trusted source.
Example:
CIP_SetFilterItem("OpenOrders", 0, "Orders", "Open records", "STATUS = 'OPEN'", True);