Skip to content
English
Kontakt
  • There are no suggestions because the search field is empty.

Set up the printing service from Humanizing

This page will walk you through the setup process of our printing service.

This page is currently under construction.
This documentation page provides a step-by-step guide to setting up and utilizing the printing service from Humanizing. Learn how to install the necessary dependencies, configure the service, and integrate it into your projects for seamless printing functionality.
 

Prerequesites

These are the things you have to do at the start.
 

Install Python

  •  Download the latest Python version
  •  Launch the installer
  •  Make sure to select the "Add python.exe to PATH" option
 
 
  • Wait for the installation to be finished
  •  Open a terminal and type python --version to make sure that Python was installed successfully ​

Set up the printing service from Humanizing

These are the things to make our printing service working.
 

Install the printing service from Humanizing

You can get the necessary files for this step from your contact person at Humanizing. Note that this is a paid service.
  • Unpack the .zip file to the following path: C:\printing_service
  •  Launch a terminal in the same folder
  •  Run the command pip install -r requirements.txt in this folder to install all dependencies
  •  After the installation is finished you can close the terminal

Create a self-signed certificate with OpenSSL

  •  Open a terminal in the folder of the printing service
  •  Enter the following command: openssl req -x509 -newkey rsa:4096 -nodes -out cert.pem -keyout key.pem -days 365
  •  Create yourself a certificate by just pressing enter until the terminal stops prompting 
  • You should be good to go

Add the "start_service" file to your autostart folder 

Save the following code as a batch file called "start_service.bat":
 
start_service.bat
@echo off
start "" pythonw "C:\printing_service\printingServer.py"
exit
 
  • Save the start_service.bat file from above.
  •  Save it to your autostart folder
  •  Restart your PC
  •  If necessary, accept the insecure connection
​​
  • If everything works out you should now see the following message:

How to find the autostart folder?

  •  Press the Window button + R and a dialog box will appear as shown in the image below. Enter shell:startup and click on “OK”.
 
  • A window will appear as shown in the image below and it will be the startup folder.
 

Use the printing service from Humanizing in Plural 

This section will show you how to connect your Avatar flow with our printing service.
 

Create an API-Call inside your flow 

  •  Let's create a new project. Something like this: (Note: we only need the API-Call actually) 
 
  • In the API-Call Element set the Endpoint URL to http://127.0.0.1/print and switch it to be a POST request.
 
 
 
  • Set the Body to Raw JSON and use the following sample payload: (Note: you have to change the printerName to use the actual name of your printer)
     
1
{
2
"htmlContent":"<html><body><h1>Hello, World!</h1><p>This is some <b>styled</b> text.</p></body></html>",
3
"printerName":"HP Printer 1",
4
"width_mm":50,
5
"height_mm":72
6
}
 
  • Click on Save
  •  Test with the Avatar
 

Adapt the payload for the printing service 

The request body must be in JSON format and include the following fields:
  •  htmlContent (string): The HTML content of the name badge to be printed.
  •  printerName (string): The name of the printer to use for printing the badge.
  •  width_mm(int): The width in mm of the badge.
  •  height_mm(int): The height in mm of the badge.
 

Example Request Body:

 
jsonCopy code{
 
"htmlContent":"<html><head><style>h1 { color: red; }</style></head><body><h1>Hello, World!</h1><p>This is some <b>bold</b> text.</p></body></html>",
 
"printerName":"Name of your printer",
 
"width_mm":50,
 
"height_mm":72
 
}

Response

  •  Status Code: 200 (OK) if the name badge was printed successfully, or 500 (Internal Server Error) if an error occurred.
  •  Response Body (JSON):
     
    •  status: "OK" if the printing process was successful, or "Fail" if it failed.
    •   message: A message indicating the result of the printing process.
 

Usage

To print a name badge, follow these steps:
  •  Make a POST request to the /print endpoint with the required fields in the request body: htmlContent and printerName.
  •  Provide the HTML content of the name badge in the htmlContent field. Customize the HTML content according to your requirements.
  •  Specify the name of the printer to use in the printerName field.
  •  Upon receiving the request, the server will generate a PDF file from the HTML content and send it to the specified printer for printing.
  •  The server will respond with a status indicating the success or failure of the printing process.