How to Install and Configure a Printer on your StreamServe Host Windows Server

Scenario: I am continuously being asked to set up printers so that they can communicate with StreamServe. The best way to do this is to configure a printer on the Test host server, make sure its successfully printing and then replicate in the Live host server. This tutorial shall instruct you how to add a printer to a Windows Server.

PLEASE NOTE: The printer I am adding is a ZEBRA label printer for the Goods Intake Bay of a warehouse

  1. Click Start and select Devices and Printers and select the Add a printer option (Figure 1)
Figure 1
  1. Select Add a local or network printer as an administrator (Figure 2)
Figure 2
  1. Select Add a local printer (Figure 3)

    Figure 3
  2. Select the Create a new port option and make sure it is a Standard TCP/IP port (see Figure 4)
  3. Click Next

    Figure 4
  4. Type the new IP address into the Hostname or IP address textbox (Figure 5). This will automatically input the same IP into the Port name textbox

TIP: If the IP address is already being used then the suffix _1 will be appended to the IP address in the Port name textbox e.g.  xx.xx.xx.xxx_1

  1. Click Next
Figure 5
  1. The IP of the printer is queried and detected as long as it is online on the network
  2. Select the Generic Network Card as the Device Type (Figure 6)
  3. Click Next
Figure 6
  1. Select the Manufacturer and Printer model you are configuring (Figure 7)

TIP: Click the Windows Update button to update the list of models / drivers from a central Microsoft repository.

  1. Click Next
Figure 7
  1. Type the Printer name – you should make this a meaningful name. In this case the name is INTAKE_BAY (Figure 8).
  2. Click Next to install the printer
Figure 8
  1. Select the Share this printer … option , type in a meaningful Location and type the IP address into the Comment textbox (Figure 9)
  2. Click Next
Figure 9

IMPORTANT: The printer is now installed. I advise you to run a test page (Figure 10) to make sure it is printing OK.

Figure 10

IMPORTANT: The printer is now visible in Devices and Printers (Figure 11)

Figure 11

How to Simultaneously Output the Same Document via Email and via Printer

Scenario: The business have made a request for the delivery note to not only be emailed to the M3 user but also to be printed to a particular office printer.

Currently the delivery note (MMS480PF) is emailed to a particular M3 user via the following runtime configuration (Figure 1):

Figure 1: Runtime configuration for an EMAIL-only Delivery Note
  1. Open the Message
  2. Change the name fof the Delivery_Note process to EMAIL_Delivery_Note
  3. Copy the EMAIL_Delivery_Note process
  4. Paste the copied process and rename it Printer_Delivery_Note
  5. Right click on the Printer_Delivery_Note process and select Script…
  6. Insert the following code:

setdestpath("PrinterName"); //for more info on this click here

  1. Open the Runtime
  2. Right-click on each process node and select Settings…
  3. Uncheck the Select automatically checkbox
  4. Connect the new Printer_Delivery_Note process node to your Printer output connector (mine is named PCL6
    • The EMAIL_Delivery_Note process node should be alreadyu connected to the MAIL output connector
  5. Right-click on the each process node and select Connector Selection…
  6. Select the Variable Connection Type and enter a variable name (see Figure 2)
Figure 2
  1. Make sure that the Default Connector is the PCL6 output connector for the new Printer_Delivery_Note process node and MAIL for the EMAIL_Delivery_Note process node (see Figure 3)
Figure 3: Runtime configuration for an Emailed AND printed document
  1. Open the Message
  2. Right-click on the message node and select Script…
  3. Insert the following code:

$SelectedOutputConnector = “MAIL”;
$SelectedOutputConnector = “PCL6”;

Export and deploy and test!

Troubleshoot: Control Center Producing the Fatal error: OutputMode set to Document or Job mode and current Message does not belong to a Job definition. (Connector):MAIL

Explanation: You are deploying an export but the referenced output connector in your message script does not match the selected output connector in your runtime.

  1. Open the message and right-click on the message icon and select Script…
  2. Examine the script and identify the output connector being referenced in the runtime. Figure 1 displays the MAIL output connect being called in our example.
Figure 1: The message script
  1. Open the runtime examine the connection between the process (e.g. Invoice) and the output connector.
  2. You need to ensure that the process is referencing the correct output connector. Right-click on the process and select Connector Selection… Figure 2 shows that the process Invoice is referencing the correct MAIL output connector.
Figure 2: The connector selection method

Export, deploy and test!

Troubleshoot: Control Center Producing the EOF: Fatal error: No output connector:purchase_order

Explanation: You are deploying an export but have forgotten to connect the process purchase_order to an output connector in the Runtime Configuration

Figure 1: Runtime Configuration
  1. Open the Runtime
  2. Click on the x icon on the purchase_order process and drag the connection line up to the MAIL Output Connector
  3. Click on the yellow arrow on the MAIL Output Connector and click on the Edit Mail button
  4. Complete the MAIL configuration similar to Figure 2

Export, deploy and test!

Figure 2: MAIL Configuration