Configuration: Fast Flow

Owned by Marty Niessen
Last updated: Jun 10, 2022 by Sarah Holst
10 min read

 

Setup Checklist

POS Tasks (RTP|One Only)

 

  1. Deploy stored procedure with specific validation rules to POS Required

  2. Create a Rule in POS that links to the stored procedure Required

  3. Create prompt code associated with the stored procedure Required

  4. Configure a product header that these Fast Flow products will book Required

  5. If the products that will be sold through the Fast Flow configuration have age restrictions, add Age Rules to the RTP|One product header. optional

Prerequisites

Infrastructure Tasks

 

  1. Install and enable the Fast Flow Plugin Required

  2. Enable AW’s Selective Guest Checkout (see link for setup): Configuration: Guest Checkout optional

PrerequisiteS

Aspenware Commerce Tasks

 

  1. Configure Fast Flow plugin settings Required

  2. Define QR Code Regex if prompting guests to scan QR codes on media. optional

  3. Ensure that the products to which you are assigning Fast Flow Functionality to are set up in Aspenware Commerce. Required

PrerequisiteS

1. Configure Fast Flow product Required

  • Enable Fast Flow on the product Required

  • Enable Pass Scanner functionality on the product optional

  • Set Prompt Code if different from the default prompt code configured in overall settings Required

  • Set QR Code Regex. Work with Aspenware Professional Service if using this functionality. optional

  • Define custom content to display for this product within the Fast Flow area if different from the defaults defined in the plugin settings. optional

2. Enable Aspenware’s Selective Guest Checkout on the Fast Flow product optional

3. Add Attributes to the product if using. optional

4. Enable “Group Member” assignment on the product detail page. optional

5. Set the product to Autofulfill Required

Detailed setup

Prerequisite Tasks

POS Tasks

1. Deploy stored procedure with specific validation rules to POS

Fast Flow uses a stored procedure in the POS to validate if the pass number entered is eligible. This eligibility is based on settings in the stored procedure which can be customized to look for specific active media, specified age ranges, etc. This ensures the resort is only allowing guests that meet their criteria to purchase the Fast Flow product.

NOTE: Aspenware has custom-built stored procedures for Fast Flow that can be shared with the resort. If capable, resorts can edit these on their own. But for complex changes and initial setup the resort may request Aspenware Professional Services for assistance.

 

2. Create a Rule in RTP|One that links to the stored procedure (provided by Aspenware). Then create a prompt that links to the newly created Rule.

See steps 1 and 2 in this RTP|One Stored Procedure Validated Prompt Setup guide.

NOTE: The prompt code is required for Aspenware Commerce to run the stored procedure when a guest inputs their pass number on the PDP.

 

3. Configure a product header that these Fast Flow products will book

To complete any order to RTP|One a product header must be configured. Set this up like any standard product to be sold from Aspenware Commerce to RTP|One.

4. (Optional) Add Age Rules to the RTP|One product header

Only add if the products that will be sold through the Fast Flow configuration have age restrictions.

IMPORTANT: The stored procedure will use the age rules set in RTP|One to determine who is eligible for Fast Flow assignment and will NOT use the age rules set in Aspenware Commerce. An exception to this is if the “Group Member” assignment is set up on the PDP. In this case follow standard the Aspenware Commerce Age Rule Configuration Guide.

Infrastructure Tasks

1. Install and enable the Fast Flow Plugin

  • Go to Configuration > Local Plugins and change the “Group” filter to “Aspenware.”

  • Locate the “Fast Flow Plugin” and click Install.

  • Restart the application by clicking the green Restart application to apply changes button.

  • Once complete, ensure the application is installed and enabled

 

2. (Optional) Enable Aspenware Commerce’s Selective Guest Checkout (see link for setup)

Aspenware Commerce Tasks

1. Configure Fast Flow Plugin Settings and Language Strings

The settings defined in the Fast Flow plugin will cascade down to all Fast Flow products unless more specific settings are set up at the product level.

  • Go to Aspenware Commerce > Fast Flow to customize the adjustable languages and settings.

 

Languages:

Language Name

Location & Stored Proc Tokens

Image Example

(click to expand)

Language String (if viewing content through the Language Editor Screen)

Language Name

Location & Stored Proc Tokens

Image Example

(click to expand)

Language String (if viewing content through the Language Editor Screen)

Title

Fast Flow box, text bolded at the top of the box

aspenware.fastflow.title

Sub-title

Fast Flow box below the bolded Title text

aspenware.fastflow.subtitle

Textbox Placeholder

Fast Flow box’s entry field text that is displayed before any text has been populated in the field

Directly above Fast Flow box’s entry field after text has been input in the entry field

aspenware.fastflow.textbox.placeholder

Button Validate Text

Fast Flow box’s button text before a validation has been attempted

aspenware.fastflow.button.validate.text

Button Validated Text

Fast Flow box's button text after a validation has succeeded

aspenware.fastflow.button.validated.text

Button Invalid Text

Fast Flow box's button text after a validation has failed

aspenware.fastflow.button.invalid.text

Message Validated Text

Fast Flow box's bottom text after a validation has succeeded.

Tokens that can be returned on validate from the stored procedure:

  • {{username}}

  • {{message}}

aspenware.fastflow.message.media.assigned

Message Invalid Text

Fast Flow box's bottom text after a validation has failed.

Tokens that can be returned on invalid from the stored procedure:

  • {{message}}

aspenware.fastflow.message.invalid.text

Message Media Assigned Text

Fast Flow box's bottom text after a product has been added to cart.

Tokens that can be returned after product assignment from the stored procedure:

  • {{username}}

aspenware.fastflow.message.media.assigned

Qr Code Validated Text

Fast Flow pop-up when the QR code scan returns a successful value

aspenware.fastflow.qrscan.validated.text

Qr Code Invalid Text

Fast Flow pop-up when the QR code scan returns an invalid value

aspenware.fastflow.qrscan.invalid.text

N/A

Fast Flow box's bottom text will display “Please select a date” when the product is date-based on and no date has not been selected.

Note: This is hard-coded and the text cannot be changed.

 

 

Settings:

Store-wide Setting

Use

Setting

(if viewing content through the All Settings Screen)

Store-wide Setting

Use

Setting

(if viewing content through the All Settings Screen)

RTP Prompt Code

Sets the defaut prompt code that will be used for all Fast Flow products that do not have a Fast Flow Prompt Code defined at the product-level.

productassignmentsettings.promptcode

QR Code Regex (Value In Group 1)

Sets the defaut Regex that will be used for all Fast Flow products that do not have a Regex defined at the product-level.

This is an optional setting only required if using QR codes that have values that are not the guest’s exact media#. See notes below for more info.

productassignmentsettings.qrcodeformat

 

2. (Optional) Define the QR Code Regex

A QR code, like a bar code, is an encoded piece of data. The data in a QR code can be alphanumeric, numeric, or binary. The “QR Code regex” (or “regular expression”) specifies how to parse the data within the QR code. Resort’s QR codes may include URLs, pass media values, or other information related to the guest or resort. For example, the QR Code below contains the following URL: https://coppercolorado.com/media-scan?16142028098375385829=UID&mediaType=light

  • For this example, to properly capture only the RFID# 1614202809375385829; the Regex required to parse this is:

media[iI][dD]=([^&#]*)

 

3. Ensure that the products to which you are assigning Fast Flow Functionality to are set up in Aspenware Commerce

Create a typical standard Core product as documented in Configuration: Product Shell.

Detailed Setup Guide

  1. Configure Product for Fast Flow

  2. (Optional) Enable Aspenware’s Selective Guest Checkout on the Fast Flow product

  3. (Optional) Enable “Group Member” assignment on the PDP

  4. Set Product to Autofulfill

  5. (Optional) Construct a URL that includes media ID and date (If using QR Code flow) 

1. Configure Product for Fast Flow

  • From Catalog > Products, select the desired product and choose to Edit.

  • Scroll towards the bottom of the product editor page and expand the dropdown Additional Product Settings.

  • Under the Fast Flow header, complete the following:

    1. Is Fast Flow enabled?: Check this setting to enable Fast Flow on the product.

    2. Is Pass Scanner enabled?: Check this setting to enable the QR code scanning on the PDP. Uncheck this setting to disable QR code scanning on the PDP.

    3. RTP Prompt Code: Optionally overrides the plugin-level prompt code for this specific product. The prompt code should align with the prompt code associated with the stored proc in RTP.

    4. QR Code Regex (Group 1 Value): Optionally overrides the plugin-level Regex value for this specific product. Review the Fast Flow Plugin settings section above for more details on Regex use and setup.

    5. Title: Optionally overrides the plugin-level Title text for this specific product.

    6. Sub-title: Optionally overrides the plugin-level Sub-title text for this specific product.

    7. Textbox Placeholder: Optionally overrides the plugin-level Textbox Placeholder text for this specific product.

2. (Optional) Enable Aspeneware’s Selective Guest Checkout on the Fast Flow product

Fast Flow will most often be used with Aspenware’s Selective Guest Checkout feature. This enables guests to complete their orders without requiring the guest to log in when only Selective Guest Checkout defined products are in their cart. To enable, follow the steps outlined in Selective Guest Checkout documentation.

 

3. (Optional) Enable “Group Member” assignment on the PDP & add age rules if required

Aspenware’s Fast Flow feature works alongside RTP|One configured Age Rules. If a product is configured with Fast Flow and has age restrictions on the product header being sold in RTP|One, then upon entry of the media ID, the customer whose media ID is entered will be checked for both media and age eligibility. If the customer is not eligible, they will be returned invalid with an error message indicating why.

4. Set Product to Autofulfill

5. (Optional) Construct a URL that includes media ID and date (If using QR Code flow) 

When passing in a media ID in the URL for a product detail page, so that a guest doesn’t need to manually enter their media ID but it is pre-loaded for them, the date attribute must also be included with the media ID in the URL. Below is an example of such a URL: https://cycle-a.aspenwarecommerce.net/s/lift-tickets/p/add-on-premier-pass-w-fast-flow?2130=2021-07-21&mediaId=16142026970374355581

  • To include a date in the URL do the following:

    • Navigate to the product editor page in the admin.

    • Scroll down to the attribute table and select Edit next to the “Start Date” attribute

    • Note the number at the end of the URL: this is the Start Date attribute mapping ID

    • When constructing URLs that pass in the date use the attribute mapping ID and the date in the following format: attributemappingid=year-month-day