Blog posts by Cecilia von Wachenfeldt

Blog posts by Cecilia von Wachenfeldt2011-07-13T23:48:48.0000000Zhttps://world.optimizely.com/blogs/Cecilia-von-Wachenfeldt/ Optimizely World An example using Business Foundation in EPiServer CommerceThe current EPiServer Commerce project I am working on has a requirement to allow logged-in customers to register products they have purchased, including those not purchased via the e-commerce site. They should then be able to see all of their registered products on their account page. I decided to use the Business Foundation (BF) technology in EPiServer Commerce. You do this by creating a ‘Business Object’ in Commerce Admin, which you can read more about <a href="http://docs.mediachase.com/display/ECFG52CommerceGuide/Creating+a+New+Contract+Object" target="_blank">here</a>. My business object is called RegisteredProduct and contains two properties: CatalogEntryId and ContactId: <a href="/link/5b901159e3254d218d0faac092a25bf7.png"><img style="background-image: none; border-bottom: 0px; border-left: 0px; padding-left: 0px; padding-right: 0px; display: inline; border-top: 0px; border-right: 0px; padding-top: 0px" title="businessobject" border="0" alt="businessobject" src="/link/1ad10d0733ee44ca8acfbd71fe26d1af.png" width="351" height="154" /></a> The CatalogEntryId will hold the id of the product being registered (note that the product has to be in the e-commerce site catalog even if purchased elsewhere) and the ContactId holds the id of the logged-in customer registering the product. In the code-behind for the ‘Register Products’ page, I have a method to create an instance of a RegisteredProduct BF object using the BusinessManager class. The properties are set from the values collected in the form and then the object is saved, again using the BusinessManager class: <pre class="language-csharp"><code> private void SaveRegisteredProduct() { var customerContact = CustomerContext.Current.CurrentContact; if (customerContact == null) return; // Creates an instance of your Business Object var registeredProduct = BusinessManager.InitializeEntity("RegisteredProduct"); // Set values to properties in your Business Object registeredProduct.Properties["ContactId"].Value = customerContact.PrimaryKeyId; registeredProduct.Properties["RegisteredProduct"].Value = DropDownListProductModel.SelectedItem.Text; registeredProduct.Properties["CatalogEntryId"].Value = int.Parse(DropDownListProductModel.SelectedValue); BusinessManager.Create(registeredProduct); }</code></pre> <style type="text/css"> .csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas, "Courier New", courier, monospace; background-color: #ffffff; /*white-space: pre;*/ } .csharpcode pre { margin: 0em; } .csharpcode .rem { color: #008000; } .csharpcode .kwrd { color: #0000ff; } .csharpcode .str { color: #006080; } .csharpcode .op { color: #0000c0; } .csharpcode .preproc { color: #cc6633; } .csharpcode .asp { background-color: #ffff00; } .csharpcode .html { color: #800000; } .csharpcode .attr { color: #ff0000; } .csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; } .csharpcode .lnum { color: #606060; }</style> To present a logged-in customer registered products, the BusinessManager’s List method is used. The method takes the name of the BF object type to query, the property to query on and a value to match against, in this case the logged-in customer’s id. Then for each RegisteredProduct object returned, the product can be read from the commerce catalog using the CatalogEntryId property as the key: <pre class="language-csharp"><code> private void ShowRegisteredProducts() { var customer = CustomerContext.Current.CurrentContact; if (customer == null) return; var registeredProducts = BusinessManager.List ("RegisteredProduct", new[] { FilterElement.EqualElement ("ContactId", customer.PrimaryKeyId) }).ToList(); var entries = registeredProducts.Select (registeredProduct => CatalogContext.Current.GetCatalogEntry ((int) registeredProduct.Properties["CatalogEntryId"].Value)).ToList(); RepeaterRegisteredProducts.DataSource = entries; RepeaterRegisteredProducts.DataBind(); }</code></pre> <style type="text/css"> .csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas, "Courier New", courier, monospace; background-color: #ffffff; /*white-space: pre;*/ } .csharpcode pre { margin: 0em; } .csharpcode .rem { color: #008000; } .csharpcode .kwrd { color: #0000ff; } .csharpcode .str { color: #006080; } .csharpcode .op { color: #0000c0; } .csharpcode .preproc { color: #cc6633; } .csharpcode .asp { background-color: #ffff00; } .csharpcode .html { color: #800000; } .csharpcode .attr { color: #ff0000; } .csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; } .csharpcode .lnum { color: #606060; }</style> As I am new to EPiServer Commerce I don’t know if this is the best way to solve the problem. If anyone has an alternative solution then I welcome any feedback you have.2011-07-13T23:48:48.0000000Z

Blog post

Implementing a simple email queue in EPiServer CommerceRecently I’ve been working with a Commerce project where when a customer has placed an order we wanted to send a confirmation email. In the EPiServer Commerce sample site the code to send the confirmation email is in the code behind of the cart checkout control. This isn’t a good practice as if something goes wrong with the email sending, for example, if the SMTP configuration is incorrect, then the user will see an error saying something went wrong with their order, which in this case is not true. What we decided to do was to queue up an email request using the EPiServer Dynamic Data Store and then use an EPiServer Scheduled Job to service the email queue and send out the emails. First of all we created a simple class with the information needed to send the email: <pre class="language-csharp"><code>using System; using EPiServer.Data.Dynamic; namespace Project.Foundation.CMS.Helpers { [EPiServerDataStore(AutomaticallyCreateStore = true)] public class OrderEmailToBeSent { public int OrderId { get; set; } public Guid Id { get; set; } } }</code></pre> <style type="text/css"> .csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas, "Courier New", courier, monospace; background-color: #ffffff; /*white-space: pre;*/ } .csharpcode pre { margin: 0em; } .csharpcode .rem { color: #008000; } .csharpcode .kwrd { color: #0000ff; } .csharpcode .str { color: #006080; } .csharpcode .op { color: #0000c0; } .csharpcode .preproc { color: #cc6633; } .csharpcode .asp { background-color: #ffff00; } .csharpcode .html { color: #800000; } .csharpcode .attr { color: #ff0000; } .csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; } .csharpcode .lnum { color: #606060; }</style> Then when an order is placed we created an instance of the above class, set it’s properties and saved it in the DDS: <pre class="language-csharp"><code>private void SaveOrderId(int orderId) { var store = typeof(OrderEmailToBeSent).GetStore(); var orderEmailToBeSent = new OrderEmailToBeSent { OrderId = orderId }; store.Save(orderEmailToBeSent); }</code></pre> <style type="text/css"> .csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas, "Courier New", courier, monospace; background-color: #ffffff; /*white-space: pre;*/ } .csharpcode pre { margin: 0em; } .csharpcode .rem { color: #008000; } .csharpcode .kwrd { color: #0000ff; } .csharpcode .str { color: #006080; } .csharpcode .op { color: #0000c0; } .csharpcode .preproc { color: #cc6633; } .csharpcode .asp { background-color: #ffff00; } .csharpcode .html { color: #800000; } .csharpcode .attr { color: #ff0000; } .csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; } .csharpcode .lnum { color: #606060; }</style> The Scheduled Job class gets the items from the Dynamic Data Store, loads the order from the Commerce system, sends an email to the customer, and then deletes the item from the DDS: <pre class="language-csharp"><code>[ScheduledPlugIn(DisplayName = "Send order emails")] class SendOrderEmails { public static string Execute() { var store = typeof(OrderEmailToBeSent).GetStore(); int skip = 0; const int count = 50; while (true) { var items = store.Items<OrderEmailToBeSent>().Skip(skip).Take(count); if (items.Count() == 0) break; foreach (var orderEmailToBeSent in items) { var order = CartHelper.FindOrder(orderEmailToBeSent.OrderId); SendEmail(order, "order-purchaseorder-notify"); store.Delete(orderEmailToBeSent); } skip += count; } return "Success!"; } }</code></pre> <style type="text/css"> .csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas, "Courier New", courier, monospace; background-color: #ffffff; /*white-space: pre;*/ } .csharpcode pre { margin: 0em; } .csharpcode .rem { color: #008000; } .csharpcode .kwrd { color: #0000ff; } .csharpcode .str { color: #006080; } .csharpcode .op { color: #0000c0; } .csharpcode .preproc { color: #cc6633; } .csharpcode .asp { background-color: #ffff00; } .csharpcode .html { color: #800000; } .csharpcode .attr { color: #ff0000; } .csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; } .csharpcode .lnum { color: #606060; }</style> And the code for sending the email: <pre class="language-csharp"><code>private static void SendEmail(PurchaseOrder order, string template) { // Add input parameter var dic = new Dictionary<string, object>(); dic.Add("OrderGroup", order); // Execute template processor var body = TemplateService.Process(template, Thread.CurrentThread.CurrentCulture, dic); // Send out emails var msg = new MailMessage(); msg.From = new MailAddress("store@yourcompany.com"); msg.To.Add(new MailAddress("customer@customer.com", " - " + order.Name)); msg.Subject = "Subject"; msg.Body = body; msg.IsBodyHtml = true; var client = new SmtpClient(); client.Send(msg); }</code></pre> The TemplateService class used above takes an XSL template and transforms it into an HTML email. See <a href="http://docs.mediachase.com/display/ecf52devguide/Email+and+Notification+Capabilities" target="_blank">this article</a> for more details about this.2011-07-01T00:19:14.0000000Z

Blog post