Compiling Customer's Canvas from Source Code

You can request Customer's Canvas source code if you purchased the on-premises version. Customer's Canvas source code is a Visual Studio solution designed for Visual Studio 2015.

To build the solution:

  1. Extract archive to your file system.
  2. Download and install Visual C++ Redistributable Packages for Visual Studio 2013, both vcredist_x64.exe and vcredist_x86.exe.
  3. Download and install TypeScript 2.0 or higher for Visual Studio 2015.
  4. Open \src\CustomersCanvas.sln in Visual Studio.
  5. Check if Web Developer Tools is installed in your Visual Studio.
  6. Open the Tools -> Extensions and Updates... menu:

    Extensions and Updates menu in Visual Studio 2015.

  7. You should see them in the list under Installed -> Tools:

    Web Tools in the list of installed extensions.

  8. If Web Developer Tools is not installed in your Visual Studio, you can repair your Visual Studio installation (in Control Panel click Programs, then click Programs and Features) and check the Web Developer Tools in the list of optional components.
  9. Finally, select a build configuration from the Solution Configurations drop down menu: select Release.

    List of available configurations.

  10. Build the solution: press Ctrl+Shift+B or click Build -> Build Solution in the menu.
  11. Copy your license file (Aurigma.GraphicsMill.lic) to the \src\SimplePolygraphy\bin\ folder.
  12. Include the license file in the project; this way the license file will be sent to the server when the project is published. To include the file in the project perform the following steps:
  13. Click the Show All Files icon in the Solution Explorer

    Show All Files in Solution Explorer.

  14. The \bin\ folder should appear.

    \bin\ folder in the Project.

  15. Open the \bin\ folder, find Aurigma.GraphicsMill.lic, right-click it and then click Include In Project.

    Including Aurigma.GraphicsMill.lic to the Project.

  16. Set SimplePolygraphy as a startup project: right-click SimplePolygraphy in Solution Explorer and click Set as StartUp Project.

    Setting as StartUp Project.

  17. Start the project: press Ctrl+F5 or click Debug -> Start Without Debugging in the menu. In your browser you should see a page containing an image carousel allowing you to select a product and the web-to-print designer.
  18. To deploy the project right-click SimplePolygraphy in Solution Explorer and click Publish.... To publish under IIS create a new publish profile. For more information about Customer's Canvas see the Deploying Customer's Canvas to Windows Server topic.

    If you face a compilation problem, refer to Troubleshooting topic for a solution.

  19. Problem. When you compile the solution, Visual Studio throws an error that it can only be compiled for ECMAScript 6 or higher.

    The TypeScript version error.

    Solution. Update your TypeScript dependency to the version 1.8 or install Visual Studio 2015 update 2 (it already includes Typescript 1.8).

  20. See Also