Skip to main content

PayComplete™™ Help Center

Creating a new project

You create a new project when you want to create a new receipt. The project is the container for all the included receipt files.

Receipt Builder needs to know the root folder for all receipt files to locate project files, such as images, headers and footers. When you open a standard receipt project from its default location it recognizes the path and automatically selects a root folder. If you have saved the receipt files in a different folder, the Select root folder for receipt files browser is opened.

You select a root folder for the new receipt project, so that references to receipt files, such as images and external templates, automatically become relative.

Note

  • When a receipt is printed from Connect on-Device, it assumes that all paths are relative to the installation root folder, that is, the Connect on-Device installation folder.

  • If you have created a folder for the custom receipt with the path [installation folder]\resources\configurable\receipts\customreceipts\myreceipt, the installation folder is the root folder.

  • It's mandatory to have a language file. If you don't want to use any language file, create the file and leave it empty.

Task. Create a new project
  1. Start Receipt Builder.

  2. On the File menu, select New project. Optionally, select the set_root_folder_button.png button.

  3. Select the root folder for the receipt file.

  4. Select Open to open the Project properties dialog box.

  5. Next to the Layout file box, select Create file.

  6. Browse to your receipt folder and name the layout file, for example, layout.xsl.

  7. Next to the Language file box, do one of the following:

    • To use the standard language file or a common language file for all your receipts, select Load file, select the file, and then select Open.

    • To use a local language file for this receipt only or not use any language file at all, select Create file, name the file, and then select Save.

  8. Leave Last print data file empty. You can reopen the project when you have printed the first receipt and select the last printed receipt file then.

  9. Next to Default data file, select Load file, and select the data example file you have created. For example, dataExample.xml.

    For more information, see Create a new receipt — workflow.

  10. Select Close.

  11. On the File menu, select Save or Save project as.

  12. Name the project and select Save.

Note

  • The receipt project file is only used by Receipt Builder. You can open it to edit the project.

  • The receipt project file is not used when printing receipts.