Differences

This shows you the differences between two versions of the page.

Link to this comparison view

control_-_smart_part_search_variable_and_grid [2019/01/30 09:22]
127.0.0.1 external edit
control_-_smart_part_search_variable_and_grid [2019/02/07 10:46] (current)
kcifreo
Line 1: Line 1:
-Part Search Variable ​ +==== Part Search Variable ​====
- +
  
 A new variable type, the Part-Search Variable (PSV), is being used to track and manage the information associated with the Part Search. The PSV permits access to the information within a Part-Search Grid from within CFL. It also provides the mechanism for the persistent storage of settings, and for CFL manipulation of the values. A new variable type, the Part-Search Variable (PSV), is being used to track and manage the information associated with the Part Search. The PSV permits access to the information within a Part-Search Grid from within CFL. It also provides the mechanism for the persistent storage of settings, and for CFL manipulation of the values.
- 
- 
  
 The Part-Search Variable (PSV) is a central object that encapsulates the part-search functionality. It derives from a variable, but consists of additional properties and sub-objects that perform the search functioning. The Part-Search Variable (PSV) is a central object that encapsulates the part-search functionality. It derives from a variable, but consists of additional properties and sub-objects that perform the search functioning.
- 
- 
  
 In the product setup, a unique PSV must be added for each type of search that is to be performed. A single product may have several PSVs, each providing filtering and search on different criteria (e.g, one for shirts, one for hats, one for hoodies, etc.). In the product setup, a unique PSV must be added for each type of search that is to be performed. A single product may have several PSVs, each providing filtering and search on different criteria (e.g, one for shirts, one for hats, one for hoodies, etc.).
- 
- 
  
 The Smart Part Grid, Smart Part Search, and Smart Part Summary pull their underlying data from the PSV. Unlike other variables, the PSV data is not saved. It is reloaded and recomputed any time the order or estimate is edited, cloned, or converted. The Smart Part Grid, Smart Part Search, and Smart Part Summary pull their underlying data from the PSV. Unlike other variables, the PSV data is not saved. It is reloaded and recomputed any time the order or estimate is edited, cloned, or converted.
  
 +{{:​psv_setup.png?​nolink&​}}
  
 +**Fixed Search Criteria**
  
-{{::psv_setup.png?​nolink&​|}}+{{:psv_fixed_search_criteria_setup.png?​nolink&​}}
  
- 
- 
-Fixed Search Criteria ​ 
- 
- 
- 
-{{::​psv_fixed_search_criteria_setup.png?​nolink&​|}} 
   * Blank fields are ignored when filtering results   * Blank fields are ignored when filtering results
   * The field names must be valid properties   * The field names must be valid properties
  
 +**User Search Criteria**
  
 +{{:​psv_user_search_criteria_setup.png?​nolink&​}}
  
-User Search Criteria ​ 
- 
- 
- 
-{{::​psv_user_search_criteria_setup.png?​nolink&​|}} 
   * Caption - controls the label next to the input in the Smart Part Builder component //(! The Caption field must be filled in. !)//   * Caption - controls the label next to the input in the Smart Part Builder component //(! The Caption field must be filled in. !)//
   * Default - is the default search value   * Default - is the default search value
Line 43: Line 27:
   * Help - controls the text that appears when a user hovers above the input   * Help - controls the text that appears when a user hovers above the input
  
-**Grid Columns** ​+**Grid Columns**
  
 +{{:​psv_column_setup.png?​nolink&​}}
  
- 
-{{::​psv_column_setup.png?​nolink&​|}} 
   * The Caption input controls the label on the column in the Smart Part Search Grid   * The Caption input controls the label on the column in the Smart Part Search Grid
   * The Width input controls the width of the column in the Smart Part Search Grid   * The Width input controls the width of the column in the Smart Part Search Grid
Line 54: Line 37:
   * If Sort This Column is checked, parts will be sorted by this value in the Smart Part Search Grid   * If Sort This Column is checked, parts will be sorted by this value in the Smart Part Search Grid
  
- +==== Part Search Grid ====
- +
-Part Search Grid  +
- +
  
 The Part Search Grid is an intelligent grid for displaying a subset of the parts in the system on a pricing form and allowing the user to quickly select the parts and add them to the order. The Part Search Grid is an intelligent grid for displaying a subset of the parts in the system on a pricing form and allowing the user to quickly select the parts and add them to the order.
- 
- 
  
 Each PSGrid relies on two search criteria to filter the parts that are displayed. Each PSGrid relies on two search criteria to filter the parts that are displayed.
-  * The **fixed search criteria** is the overall filter for what parts are accessible from the grid. This is [normally] fixed for a particular grid on the pricing form. It limits the total choices possible for a grid, such as only T-Shirts, only hats, only a certain type of printers, etc. 
-  * The **user search criteria** are user-input filters that limit the search results to the particular parts that the user is currently searching for. This is used to speed up order entry so the user does not have to scan all possible parts that match the primary search criteria. Typical examples might be based on SKU, Color, Style, or other searchable UDF fields. 
  
 +  * The **fixed search criteria** ​ is the overall filter for what parts are accessible from the grid. This is [normally] fixed for a particular grid on the pricing form. It limits the total choices possible for a grid, such as only T-Shirts, only hats, only a certain type of printers, etc.
 +  * The **user search criteria** ​ are user-input filters that limit the search results to the particular parts that the user is currently searching for. This is used to speed up order entry so the user does not have to scan all possible parts that match the primary search criteria. Typical examples might be based on SKU, Color, Style, or other searchable UDF fields.
  
 +{{:​psg.png?​nolink&​}}
  
-{{::​psg.png?​nolink&​|}}+The key uses of the PSGrid are:
  
- 
- 
-The key uses of the PSGrid are: 
   * Display Columns provide the user with additional information about the part. Display columns are read-only. Display columns include:   * Display Columns provide the user with additional information about the part. Display columns are read-only. Display columns include:
-    ​* UDF columns +      ​* UDF columns 
-    * Part Properties (name, SKU, etc.) +      * Part Properties (name, SKU, etc.) 
-    * Inventory Properties (QuantityOnHand,​ QuantityAvailable,​ etc.) for the estimating warehouse.+      * Inventory Properties (QuantityOnHand,​ QuantityAvailable,​ etc.) for the estimating warehouse.
   * Input Columns show quantities that may (or may not) be adjustable by the user. Input Columns include:   * Input Columns show quantities that may (or may not) be adjustable by the user. Input Columns include:
-    ​* Quantity used for the order. +      ​* Quantity used for the order. 
-    * Unit Cost and Extended Cost of the part. +      * Unit Cost and Extended Cost of the part. 
-    * Unit Price and Extended Price of the part. These fields are only valid if parts-based-pricing is used for the product.+      * Unit Price and Extended Price of the part. These fields are only valid if parts-based-pricing is used for the product.
   * Add To Order button allows the user to create multiple part types with differing quantities on the order with one click.   * Add To Order button allows the user to create multiple part types with differing quantities on the order with one click.
- 
-