Description: Saves an existing in-memory filter, or copies it to a new or existing filter name and saves that target.
Calling convention: CIP_SaveFilter("FilterName": String, ["NewFilterName": String], ["NewFilterGroup": String], ["NewFilterDescription": String]): Integer
Parameters:
FilterName: existing source filter.
NewFilterName: optional Save As or overwrite target.
NewFilterGroup, NewFilterDescription: optional target metadata; these are safe only when NewFilterName creates or resolves a target filter.
Returns: Database ID of the saved source or target filter. Missing or unknown source filters raise exceptions.
Availability: Default; changes global filter state and writes the filter definition to the database.
Example:
FilterID := CIP_SaveFilter("OpenOrders", "MyOpenOrders", "Personal", "Open orders for the current user");