| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
...
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
POS Tasks (RTP|One Only) | |||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||
Infrastructure Tasks | |||||||||||||||||||||||||||||||||||||
|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Aspenware Commerce Tasks | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1. Configure Fast Flow product
2. Enable Aspenware’s Selective Guest Checkout on the Fast Flow product
3. Add Attributes to the product if using.
4. Enable “Group Member” assignment on the product detail page.
5. Set the product to Autofulfill
|
|
Prerequisite Tasks
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
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.
| Info |
|---|
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
...
...
...
Setupguide.
| Info |
|---|
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.
| Note |
|---|
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 Configuration: Age RulesAge 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)
...
| Info |
|---|
NOTE: Fast Flow often works alongside /wiki/spaces/DB/pages/1907654741 Aspenware’s Selective Guest Checkout feature to enable guests to make purchases without logging in (they can log in if desired). If a guest opts to skip the login and creates a guest account during checkout, then the guest’s purchase will be associated with multiple accounts in the POS (ie: the account already in the POS system that has media AND the guest account they created during checkout). Additionally, there will not be an “assignment step” in checkout for Fast Flow products. If a guest is also purchasing a non-Fast Flow product that requires assignment during checkout, the Fast Flow product will not be displayed on the assignment screen. |
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.
| Info |
|---|
NOTE: These settings can also be defined at the product level, if defined at the product level then these settings will be overwritten for that specific product. |
...
Languages:
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:
|  | 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:
|  | 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:
|  | 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) |
|---|---|---|
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:
| Code Block |
|---|
media[iI][dD]=([^&#]*) |
| Info |
|---|
NOTE: For more information on regex please visit https://regex101.com/r/hT67tA/1. Regex101. If your resorts need technical assistance, reach out to support@aspenware.com and Aspenware can help establish the Regex. |
| Note |
|---|
IMPORTANT: Resorts utilizing the QR scanner on the Fast Flow PDP will REQUIRE use of Regex so that the scanner can trigger validation using the proper pass media values within the QR code (e.g. RFID). |
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
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
...
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:
Is Fast Flow enabled?: Check this setting to enable Fast Flow on the product.
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.
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.
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.
Title: Optionally overrides the plugin-level Title text for this specific product.
Sub-title: Optionally overrides the plugin-level Sub-title text for this specific product.
Textbox Placeholder: Optionally overrides the plugin-level Textbox Placeholder text for this specific 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: /wiki/spaces/DB/pages/1907654741 .
...
| Info |
|---|
NOTE: When Fast Flow and Selective Guest Checkout features are combined and a guest opts not to log in, their order will show under two accounts in the POS. The order will appear under the account that has the media assigned to it and the order will also appear under the Guest Account they created during checkout. Merges can be used to decrease the number of guest accounts in the POS. Fast Flow does not require the use of Aspenware’s Selective Guest Checkout feature but will often be used to increase the speed of checkout. |
...
See configuration for “[Assigned To]” in the following link: Configuration: Product Attributes documentation.
...
| Info |
|---|
NOTE: Aspenware Age Rules will not be used for Fast Flow age restrictions, only age rules configured in RTP|One will be applied to Fast Flow products. |
4. Set Product to Autofulfill
Follow the Autofulfill guide here: the instructions in the Configuration: Autofulfill/Finalize Sale to set the product to autofulfill.
...
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
example: 2130=2021-07-21
...
HINT: For more details on configuring override URLs that pass in additional attributes, refer to this solutions article: https://hub.aspenware.net/main/Deep-Linking%2FOverride-URLs.1311244526.html
...