Help Centre Forum

TOTECS Forums

TOTECS Platform Release 10.00
Author
Thread

Author moderator
9th September 2015

New Features





TOT-3133 - Data API endpoint for users to export product stock level data



The Data API in the platform has now been modified to allow users to export product stock data programmatically from a TOTECS project.

This can allow 3rd party customer systems to obtain and display up-to-date product stock data in their own website, or business systems by using the data API to export the data. This is particularly valuable where products are drop shipped using a supplier who has a TOTECS project.

A new Administration Centre interface has been created under the Data menu, called Data API that displays the logs of requests that are made to the API to obtain product stock data. This allows administrators to see which users are exporting product stock data, and how many products are having their stock data exported. Additionally A Data API settings interface has been created also within the Data menu that contains a setting labelled "Allow Users To Use Data API". This setting controls if all or no users can utilise the Data API.

Additionally within the Administration Centre interface, under the Inventory menu, in the Product Settings interface a setting has been added labelled "Limit Stock Quantity To An Upper Value In Data API" that controls if the product stock quantity extracted out with the Data API is limited to an upper number, based on the "Stock Quantity Upper Threshold" setting.

To allow users to use the data API to export out product stock data the user must be assigned to a Facility Permission Role that has the "Data API Product Stock Export" permission to Allow.

When the user exports product stock data from the API, the products that are returned from the API endpoint will be limited to the products that the user has access to view based on the Inventory Permissions Role assigned to the user accessing the API.

Limits have been put in place to ensure that the API in not abused by users, or outside intruders. A maximum of 15 login requests can occur in a 20 minute window create sessions for the API. When exporting product stock data its API endpoint can only be called 5 times within a 30 minute window.

Usage of the Data API is billed per 5000 requests. Check the Edition usage fees for a project's assigned to edition to see the pricing.

If you wish to use the feature please contact the service team and they can show you how to access, and use the API, as well as train your associated customers on how to use the functionality.



Functionality Affected: Data API

Impact: Normal



Improvements





TOT-3076 - Basket Summary content managed web page area to have hook to display total products in basket integer number



Within the Administration Centre, under the Websites menu, when expanding the Web Area Format Libraries tree, under the Shopping Basket node, in the Basket Summary node, within the Basket Summary Format node, modifying a Basket Summary format in the Edit Web Area Format dialog, the Area Format Hooks list now contains a hook labelled "cart_TotalItem_Integer".

This hook displays the number of unique products added to a user's basket, with the number rounded to a whole number.



Functionality Affected: Basket Summary content managed web page area

Impact: Minor



TOT-3125 - Settings to control the pixel dimensions for product flag images



Within the Administration Centre, under the Inventory menu, in the Images settings interface, a new section has been added labelled "Product Flag Icon Image Settings" that allows the administrator user to configure the pixel dimensions for the small and large sized product flags.

Additionally the admin user can set the method for how the images are resized, and if any cropping occurs.

Note that after changing these settings the administrator user would have to upload the product flag images for the settings to come into effect.



Functionality Affected: Product Flag Image Upload, Image Settinsg Administration Centre interface

Impact: Normal



TOT-3127 - Order Checkout/Submission content managed web page area to automatically select the payment type when only one payment method is assigned to the user's account



On a content managed web page containing an Order Checkout/Submission area, or a Guest Order Checkout/Submission area, both areas have been modified so that if there is only one payment type available for the user to select when setting the order's details, then that payment type will be automatically selected when the order details form displays in the area.



Functionality Affected: Order Checkout/Submission area, Guest Order Checkout/Submission area

Impact: Normal



TOT-3129 - Allow users to enter hyphen characters into Email Confirmation field on the Order Details page of the Trade interface



Within the Trade interface, after a user has gone to the View Basket page, then clicked the Next button, on the Order Details page the user is now able to enter the hyphen character into the Confirmation Email field.

Previously the user was not able to enter a hyphen character into the Email field.



Functionality Affected: Order Details Trade interface page

Impact: Normal



TOT-3131 - All Emails sent out to set the sent date with the message data



For any Email sent out by the TOTECS platform, the send date is now set in the Email's messsage. This helps the Email pass incoming SMTP servers which may have rules to reject Emails that don't have the sent date set.



Functionality Affected: Email Sending

Impact: Normal



TOT-3132 - Settings to allow product and category images to be re-sized and cropped to exactly fit dimensions for image sizes



We have created a new the way that category and product images are resized when uploaded into a TOTECS project, either when being uploaded through the Administration Centre, or through the Connector.

This new resizing method called "Resize And Crop To Fit" will resize an image so that it exactly matches the pixel dimensions set for the different image sizes. In order to do this the image resizing process may crop out parts of the image to make it exactly fit the image dimensions.

Within the Administration Centre, under the Inventory menu, in the Images settings interface, under the Product Image Settings, Category Image Settings, and Product Flag Image Settings sections, new settings labelled "Image Resizing Method" have been added. Two options are available for these settings, they are:



 




  • Resize

  • Resize And Crop To Fit



These settings are used to resize product, category, and product flag images when the are uploaded from the Administration Centre, Connector image imports, or through the Bulk Image Resizing feature.

Previously when a product, category image, or product flag was uploaded, the platform only supported the resizing and scale up or down the image to fit within the set dimensions. This meant that unless the image width/height ratio exactly matched the set dimension ratio, then image heights or widths would be smaller than the set dimensions. Because of this images could be of several different widths and heights.

If this setting is changed to "Resize And Crop To Fit" the platform will now have the ability to resize and scale and image up or down, as well as crop the sides of the image so that all images exactly fit within the set dimensions.

If the Resize And Crop To Fit setting is turned on, then the setting underneath it in the Image settings admin interface labelled "Image Resizing Cropping Position" will be used to determine how images are cropped when the aspect ratio does not exactly match the pixel dimensions for each image size. This "Image Resizing Cropping Position" setting can be configured to one of 9 values which position where the bounding box is anchored over the image. Anything that does not fit within with the bounding box will be cropped out of the image.

So for example if an image with the pixel dimensions 150w x 100h needs to be resized to be 100w x 100h, and the "Image Resizing Cropping Position" setting is configured to Top Left. Then 50 pixels will be cut off from the right hand side of the image to make it fit within the 100 pixel width. If an image contains the pixel dimensions of 100w x 150h then and the setting was configured to Top Left, then the bottom 50px of the dimension would be cut off to make it fit.

Using these two settings allows images to be guaranteed to fit in the pixel dimensions set for different image sizes of product, category, and product flag images, which helps content managed website layouts look visually consistent.



Functionality Affected: Product, Category, Product Flag image import process

Impact: Normal



TOT-3137 - Set additional product fields in "Product Description Field For Orders" setting to control the product description in orders sent to the Connector



Within the Administration Centre, under the Stores menu, in the Order settings interface, for the "Product Description Field For Orders" we have added the following product field to the options:




  • "Product Code"

  • "Name"

  • "Brand"

  • "SEO Code"

  • "barcode"

  • "Inner Barcode"



This allows different product data to be placed into the order product description field when an order is sent to the Connector.



Functionality Affected: Store Settings Administration Centre interface, order submission process

Impact: Normal



TOT-3141 - Emedia Messaging Admin Centre interface shows the completion percentage of Emedia Emails being sent out



Within the Administration Centre, under the Marketing menu, within the Emedia Messaging interface, once a user has clicked on the Send button for an Emedia Email, then clicked on the Send button in the Send Emedia Email dialog, in the Status column of the Emedia being sent, a bar graph with display behind the processing status.

Every 30 seconds the bar graph will update to show the percentage of Emails that have been processed. This provides a visual way for the Administrator user to know how many Emails have been sent out, and how many Emails are still to send out.

Note that if the Admin user logs out, then logs in again and views the Emedia Email interface, that the graph will no longer display. This is because the user no longer has the same session as the session that is sending out the data, and as such has no access to the progress status dadta.



Functionality Affected: Emedia Messaging Administration Centre interface

Impact: Normal



TOT-3142 - Cloning of existing Emedia items within the Emedia Messaging Admin Centre interface



Within the Emedia Messaging interface of the Administration Centre there is now the ability to clone a Emedia item so that a new Emedia item can be created that contains the same configurations, and messsage information from another Emedia item.

Within the Administration Centre, under the Marketing menu, within the Emedia Messaging interface a button labelled "Clone" has been added beneath the Emedia table.

Once a user has clicked on an Emedia row, then clicked on the Clone button, a new Emedia item will be created that contains all the same settings as the Emedia that was selected. The new Emedia will be renamed with the text " (Cloned)" appended to its name to denote the newly created Emedia item.

If the Emedia was an Email that had Rich Text messaging to turned on and was associated to a content managed web page, then that content managed web page would be cloned as well to ensure that if the content of the old Emedia Email is does not change when the new Emedia Email is modified.



Functionality Affected: Emedia Messaging Administration Centre interface

Impact: Normal



TOT-3146 - Product, Category, and Product Flag Image settings moved to Images Administration Centre interface



We have moved several of the Product and Category image settings to now all be located in the one place within the Administration Centre. This makes its easier for usability, as well outlines how the same settings affect images being uploaded from different places.

Within the Administration Centre, under the Inventory menu, in the Image Settings interface 3 new sections have been created called Product Image Settings, Category Image Settings, and Product Flag Image Settings.

For each section there are settings control the pixel dimensions for each sized image, as well as settings to how the images are resized, and if the images get overwritten when imported.

These settings have been removed from the Product Image Import and Category Image Import admin interface.



Functionality Affected: Image Settings Administration Centre interface

Impact: Minor



TOT-3147 - Additional fields to sort products by with the "Product Sort Field" setting



We have added more options on which field can be used to sort products in many aspects of the Trade interface, and content managed websites.

Within the Administration Centre, under the Stores menu, in the Product Search settings interface, for the "Product Sort Field" setting the following product field options have been added:




  • SEO Code

  • Barcode

  • Inner Barcode

  • Brand

  • Description1

  • Description2

  • Description3

  • Description4

  • Class

  • Supplier

  • Stock Quantity



Note that this controls the ordering of products in several places within the Trade interface, and content managed web page areas.



Functionality Affected: Product Search Administration Centre interface

Impact: Normal



TOT-3148 - News Comment Form content managed web page area to send out Email notifications to other users when a comment is posted



On a content managed web page that contains a News Comment Form content managed web page area, when a user posts a comment, Emails will now get sent out to all other users who have posted on the same news/blog item.

Within the Administration Centre, under the Users menu, within the Search Users interface, upon finding a user and clicking on their Login ID, in the User Details interface we have added the setting "Receive News/Blog Notifications" which controls if the user is allowed to receive news/blog item comment Email notifications. The setting has 3 values:




  • Yes - The user will receive Email notifications for any comments associated with News/Blog item they created, or comment on.

  • Only For Own Created News/Blog Items - The user will receive Email notifications only when another user comments on a News/Blog items they created.

  • No - The user will not receive any News/Blog Item comment Email notifications.





Functionality Affected: News Comment Form content managed web page area.

Impact: Normal

 



Bug Fixes



TOT-3113 - Users unable to send out verified Emedia Emails within Emedia Messaging Admin Centre interface



Within the Administration Centre, under the Marketing menu, within the Emedia Messaging interface, if an Emedia Email was being sent out to 1000+ Emails its was possible that an error would display advising that the Emedia could not be found, and the Email send would fail and stay on the VERIFIED status.

We have modified Emedia Email sending process to ensures that the sending process cannot get stuck at the verified stage if different servers in the backend are being used to validate and and send out the Emedia Emails.



Functionality Affected: Emedia Messaging sending process

Impact: Major



TOT-3136 - Product Short Add dialog within the Trade interface still displays the exact stock quantity when the maximum stock threshold setting is turned on



Within the Trade interface, when a user had opened the Product Short Add dialog from either the Home page, or from the Product Search Listing page, the dialog would incorrectly display the exact stock quantity of the product when it should have been displaying the upper stock quantity threshold, if the "Limit Stock Quantity To An Upper Value" setting has been turned on from within the Products settings interface within the Administration Centre.

We have modified the Product Short Add dialog to ensure that the stock quantity is capped to the maximum level based on the "Limit Stock Quantity To An Upper Value" and "Stock Quantity Upper Threshold" settings within the Products settings interface within the Administration Centre.



Functionality Affected: Product Short Add Trade interface dialog

Impact: Normal



TOT-3139 - Combination CSV text file data import doesn't convert web product into combination product when component child product are assigned



Within the Administration Centre, under the Data menu, within the Data Imports interface, upon clicking the Upload File button for the Product Combinations text file import, when the data is importing if a product was previously assigned as a combination product, but then it was changed back to be a web product, the data import will not change the product's type back to a Combination product.

The Product Combinations text file data import has been modified so that if a product is being assigned as a parent combination, the import routine will check to see if the product is marked as a combination product, if it is not then it will be updated to be assigned as a parent combination product.



Functionality Affected: Product Combinations text file data import

Impact: Normal



TOT-3144 - Unable to display details of payment within the Payments Admin Centre interface after searching for payments



Within the Administration Centre, under the Stores menu, in the Payments interface, after a user had clicked on the Search button, then clicked on the Details button of a payment record, the Payment Details dialog was not displaying.

We have modified the Payments Administration Centre interface to ensure that the Payment Details can be shown after the payments table has been reloaded.



Functionality Affected: Payments Administration Centre interface

Impact: Normal



TOT-3145 - Credit card payment transaction number does not match the payment ID



When a custom credit card payment was made from within the Administration Centre's Payments interface, or a invoice is paid via credit from the Account Enquiry feature within the Trade interface, or content managed web page areas, the payment's transaction number was not matching the payment ID. This was confusing since if the payment was submitted to the Connector, then the Connector's payment correctly displayed the payment code, but that does not match up with with the TOTECS platform.

We have modified the payment process to correctly generate a Payment ID and reference it when the payment record is sent to the Connector. This issue was caused by the new High Availability server architecture that no longer generates sequential IDs when creating payment records, and the transaction number assigned to the payment was not reflecting this.



Functionality Affected: Credit Card Payments

Impact: Normal