Product-Documentation

Troubleshooting

Compatibility

Only Kit Components are considered in within the document loop of Product Notifications. This means the top-level Kits never appear in the notifications.

If the Kit’s notification recipient Metadata Field is defined, then all of its components treat this address as their recipient email address, regardless of whether those products have a different email address defined in their metadata fields.

On the other hand, if the Kit’s email address is blank, then the email recipient in the Kit Component’s metadata is used to determine who to notify. If both of these values are blank, then no notifications are sent for the Kit Component.

Limitations

The extension does not take part in events raised by the Split-Payment nor Split-Shipping procedures.
Emails are sent right after an Order is placed.
In case download links to the final output artwork are included in the notification, the email notifications are delayed until the artwork has been rendered.

The extension rules out designs which are marked by other extensions by setting the designs’s PrintingField ExcludedFromProductNotifications.

This is the case with the RightMarket Document Workflow extension which marks Designs derived from Templates set up as a Download Product.

Known Issues

Not applicable.

Logging

The site-log contains messages recorded by the Extension as the ordered Designs are processed. Please look for the messages which contain the Product Notifications text. The messages contain the information on what has been sent to whom.

Debugging

The site-log should always contain any exceptions thrown during the Extension function. Please look for error messages which contain the text Product or Notifications.

When a user places an Order, this Extension checks each ordered Design. If there is a Design to be approved among the ordered Designs or if there’s a need to wait for the final rendering, then an Order Field value is recorded for that specific Order in the OrderFieldValues database table. It is called ProductNotificationsDocBatch and can be displayed using this query:

SELECT a.OrderGroupID, a.FieldValue
FROM OrderFieldValues a JOIN Names b ON b.NameID = a.FieldNameID
WHERE b.StringValue = 'ProductNotificationsDocBatch'
ORDER BY a.OrderGroupID DESC

The value itself may look like this:

120388:Done,120396: 120397:,120398:Done
The pipe “ ” character separates the “batches”, the comma “,” character separates the Designs. A batch represents one or more Designs referred to in one single email. The Extension sends the email after all of the Designs in a batch are rendered (or approved). In such a case, all of the values after the colon are “Done”.

In the example above, there are two batches, both of which have a design which is not “Done”, so neither would have sent notifications.