You are here: Make It Look Good! > Punch-Ins



Punch-ins are links that hook into specific pages in the system. They can be used to navigate directly from one page to another within your application. They can also be used to jump into a specific page from an external web site. External punch-ins must contain the username and password information so that an authentication can be performed to ensure that a valid user is trying to access the page.


ClosedCreating a Custom Punch-In

  1. Navigate from: Admin Home Page > Styles and Templates > Home Page.
  2. Select the product line/model you need to create a punch-in for in the selector punch-in column.
  3. Click the New button.
  4. Enter the name and variable name for the punch-in.
  5. To hide a punch-in on the home page, select the corresponding checkbox under the Hide column.

You can only hide default punch-ins.

  1. You can set the following punch inputs in the parameters column:
    • To set attribute values on selector configuration or model configuration, use variableName1=variableValue1&variableName2=variableValue2...
    • To trigger conditions to pick up the right configuration flow in model configuration, use variableName1+variableValue1+variableName2+variableValue2...
    • To enable selector recommendations for model configuration, use variableName1@variableValue1@variableName2@variableValue2...
    • Change: &_variable_name_punchin=true....This parameter controls whether to use the Label or variable name for parameters. It is defaulted to false.
  1. Click on Save or Save and Close to save changes. Click on Delete to delete the selected custom punch-ins.
  2. Deploy the homepage.
    1. When the variable is of menu type, the menu values are passed as a tilde delimited string. When the variable is of array type, the array values are separated by "$,$".

Use Cases

ClosedModel Configuration Page Punch-In


ClosedModel Configuration Punch-In (from external source)

ClosedParts Display Page Punch-In

ClosedSelector Punch-In


ClosedArray Attribute Punch-In

Use the separator $,$ to specify multiple values for array attributes in punch-ins. Example: when you want to set the values of attributes as follows: size1 = 4 and arr1[0] = v1, arr1[1]=v2, arr1[2]=, arr1[3]=v4 (here, arr1[2] is a blank value), the punch-in format will look like this ...size1=4&arr1=v1$,$v2$,$,$v4&ldots;

Example of a bm_search_result:&ldots;bm_search_result= size1=4&arr1=v1$,$v2$,$,$v4



Related Topics Link IconSee Also