Compiling Customer's Canvas from Source Code

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

Prerequisites

  1. Download and install Microsoft Visual C++ 2017 Redistributable Package (x64).
  2. Download and install Microsoft .NET Framework 4.6.2 or higher.
  3. Download Visual Studio 2017 and install it with the ASP.NET and web development workload enabled.

    ASP.NET and web development workload.

  4. Download and install TypeScript 2.4.0 for Visual Studio. Note that you may obtain compilation errors if you install a different version of TypeScript.
  5. Download and install node.js 8.11.3 (x64) or higher.

Compiling the Application

To build the solution:

  1. Extract the CustomersCanvasSrc.zip archive to your file system.
  2. Open \src\CustomersCanvas.sln in Visual Studio.
  3. Navigate to Tools > Options > Projects and Solutions > Web Package Management > External Web Tools and move $(PATH) above the .\node_modules\.bin internal path.

    Set up external paths.

  4. Install npm packages: in Solution Explorer, right-click package.json in the SimplePolygraphy project and click Restore Packages.

    Restore npm packages.

  5. Next, select Release on the Solution Configurations menu and Any CPU in Solution Platforms.

    The list of available configurations.

  6. Build the solution: press Ctrl+Shift+B or click Build > Build Solution on the menu.
  7. Copy your license file (Aurigma.GraphicsMill.lic) to the \src\SimplePolygraphy\bin\ folder or use an alternative way of registering your license keys.
  8. 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:
  9. Click the Show All Files icon in the Solution Explorer.

    Show All Files in Solution Explorer.

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

    Including Aurigma.GraphicsMill.lic to the project.

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

    Setting as StartUp Project.

  12. Start the project: press Ctrl+F5 or click Debug > Start Without Debugging on 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.
  13. If you run Visual Studio as an administrator, you can deploy this application: right-click SimplePolygraphy in Solution Explorer and click Publish. You can find more information on the deployment in the Deploying Customer's Canvas to Windows Servers topic.

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

See Also

Manual

Other