PDF

  • 24 Feb

    How to check the printer status before sending a pdf to the printer

    How to check the printer status before sending a pdf to the printer

    Q: We are rolling out a process at one of our customers which requires printing a PDF to a printer. With our tooling, we are not getting confirmation if this printout succeeded/ failed. Can we use Limagito to read a folder, send the PDF to the fixed printer and then return something to our bot? That may be something like a separate file, with the details of the job.

    A: We added some extra options in version v2024.2.24.0 to achieve this. The following blog article is just an example, other possibilities are available. Just let us know if you need any help.

    • We used a Windows Folder as Source:

    limagito file mover windows folder as source

    • Filename include filter is set to *.pdf because we only want to handle pdf files:

    limagito file mover filename include filter

    • We enabled ‘File Memory’ because we only want to print the same pdf file once:

    limagito file mover file memory option

    • The Function is set to ‘Copy’ because we want to leave the original pdf at the source (this is not a must, also ‘Move’ is possible):
      • Destination Options is set to ‘Exit Cyclus on Error’.
        • This ‘Exit Cyclus on Error’ will skip the next Destination in case of error.

    limagito file mover function setup check the printer status

    • We added two destinations:
      • First destination is our ‘Pascal Script’ option: This script will check the printer status and if the status is not OK then it will not print the pdf. The error status can be used to trigger an email event.
      • Second destination  is our ‘PDF’ option: This destination will print the pdf file.

    limagito filemover destination check the printer status

    • First Destination: Pascal Script
      • Please add the following script: link
      • We added the following Const values which you’ll need to adjust:
        • ctCheckPrinterConnection: This will add the possibility to check the printer using its IP (or Hostname) + Port.
          • Set this value to ‘TRUE’ if you want to use this option, otherwise set this Const to ‘FALSE’.
        • cpPrinterIP: If ‘ctCheckPrinterConnection := True;’ then add the IP (or Hostname) of the Printer we need to check.
        • ctPrinterPort: If ‘ctCheckPrinterConnection := True;’ then add the Port of the Printer we need to check. We used port 23 which is the default Telnet port. Most printers are able to received commands directly on that port.
        • ctPrinterError: In case the status of the printer (received from the Windows Spooler) contains 2 then we’ll handle this as Error.
        • ctOutputPathError: In case of Error we’ll write a txt file in this path (must end with a \ ). The text file has the name of the source file but with ‘.txt’ as extension.
          • The content of this text file contains the source filename + the error received.
          • This can be adjusted, please let us know if needed.
      • Don’t forget to adjust the Printer name needed to check that status from the Windows Spooler

    limagito file mover check the printer status

    • Second Destination: PDF
      • Click ‘Add’
      • Adjust Description
      • Check ‘Enabled’
      • Select ‘Print PDF File’
      • Switch to ‘Print’ Tab

    limagito file mover pdf as destination

      • Disable ‘Use Default Printer’
      • Select the printer you need from the combobox ‘Available Devices’
      • Click the + button

    limagito file mover pdf as destination

    • RunTime Log Result:

    We detected that the printer connection was available but the Windows spooler returned an error status. This is why we didn’t print the pdf and returned an error which can be used to send the ‘On Error’ email event. In this event you can use the parameter %VSE which contains the status information from the printer.

    limagito file mover check the printer status runtime log

    • Error Event Setup
      • Please open our ‘Rule Events’ option:

    limagito file rule events option

      • Select and enable the ‘On Error’ event
        1. Check ‘Enable Mail’
        2. > SMTP Setup
        3. > Message Setup
        4. When done, this setup can be tested using our ‘Test’ button

    limagito file mover on error event

      • Message Setup:
        • Always use a valid ‘From’ email address because some SMTP servers will reject the message without returning an error.
        • We used our parameter %VSE in the body because it contains the error information from the printer.

    limagito file mover on error event

    If you need any help with this ‘check the printer status’ request, please let us know.

    Best Regards,

    Limagito Team

    #pdf #managedfiletransfer #filetransfer #filemanagement

  • 31 Oct

    How to email a list of filenames after pdf split

    Email list of filenames after pdf split

    Q: I was wondering if there was a way to add the file names from a pdf split to VSA, much like you can when unzipping.

    I’d like to send an email confirmation on completion when pdfs are sent through this workflow. The PDF’s will vary in page counts, and the recipients are non-technical users.

    Below is a log file, from which I’d like to send an email like:

    “the following files have been sent:

    cmg_tabloid_NT_SP1_20231026_001_S.pdf

    cmg_tabloid_NT_SP1_20231026_002_S.pdf

    cmg_tabloid_NT_SP1_20231026_003_S.pdf

    cmg_tabloid_NT_SP1_20231026_004_S.pdf

    cmg_tabloid_NT_SP1_20231026_005_S.pdf

    cmg_tabloid_NT_SP1_20231026_006_S.pdf

    cmg_tabloid_NT_SP1_20231026_007_S.pdf

    cmg_tabloid_NT_SP1_20231026_008_S.pdf”

    Can I add a destination variable like %VSA

    A: We added a new option in our ‘PDF as Destination’ to achieve this, available since version v2023.10.29.0 (29th of October 2023).

    Open (or add) your PDF as Destination:

    limagito file mover pdf as destination

    The new option is available after you add a ‘Output PDF File’ Action:

    limagito file mover output pdf file action

    We enabled ‘Split Pages’ and selected ‘Filename(s)’ as ‘Output successful files to %VSA var’.

    limagito file mover list of filenames after pdf split

    Now you can use the %VSA var in your email setup, it will contain the splitted files when the new option is selected.
    We did a test and this is the email we received when using %VSA as body of the email;
    limagito file mover list of filenames after pdf split
    Feedback customer:
    Thank you for this. The speed that you knock out feature request is unparalleled.

    #pdf #filetransfer #filemanagement #filehandling

    If you need any help with this ‘list of filenames after pdf split’ option, please let us know.

    Best Regards,

    Limagito Team

    By Limagito-Team How-to PDF
  • 06 Nov

    Sign a PDF using SmartCard or HSM

    Sign a PDF using SmartCard or HSM (Hardware Security Module) added in Limagito File Mover v2023.0.11.6

    In this example we are going to a sign a PDF using a Smartcard or HSM (hardware security module).

    • As source we are going to use a Windows folder [WIN]:

    Limagito file mover Windows folder as source

    • Be sure to only allow .pdf files. Please set the Include Filename Filter:

    Limagito file mover file filter setup

    • Add ‘SIGN’ as Destination

    Limagito file mover sign pdf as destination

    • Setup ‘SIGN’ as Destination. The default setup has 5 ‘actions’:

    Limagito file mover sign pdf setup

    • Select the first Action ‘Load PDF to be signed’ and an extra tab will appear in the top menu bar. Select this ‘Pdf Load’ tab.

    The default setup here is %SFP%SFN which translates to Source File Path and Source File Name. In most cases you don’t need to change this.

    • Back to the ‘Setup’ tab and select ‘Options for PDF signing’ in the Action list and next ‘Pdf Options’ Tab.
    1. Enable ‘Set Signing Certifcate V2 attribute’ (is enabled by default)
    2. Enable ‘Set Signing Time attribute’ (is enabled by default)

    Sign pdf options setup

    • Back to the ‘Setup’ tab and select ‘Appearance of the PDF signature’ in the Action list and ‘Pdf Signature’ Tab.

    We used the ‘Custom-JPG’ to add a custom logo at the left side of the signature. We also have a couple of built-in graphics available.

    Sign pdf signature appearance setup

    • Back to the ‘Setup’ tab and select ‘Load certificate for PDF signing’ in the Action list and ‘Pdf Certificate’ Tab.

    We are going to use a Smartcard or HSM (hardware security module) so we keep the ‘Certificate File’ field empty.

    1. Enable ‘Use load from Smartcard’
    2. Set the Smartcard CSP option
      • Load the certificate on the smartcard currently in the reader (or on the USB token).
      • Leave this field empty to allow us to automatically choose the CSP (Cryptographi Service Provider).
    3. Set the Smartcard PIN (password)

    Sign pdf smartcard certificate

    • Back to the ‘Setup’ tab and select ‘Sign and save the PDF’ in the Action list and ‘Pdf Signing’ Tab.

    Limagito file mover sign and save pdf

    • Next we enabled the Rule and triggered it manually:

    Limagito file mover enable and trigger rule

    • Result of the RunTime Log:

    sign and save pdf setup

    • Signed PDF result:

    digitally signed pdf using smartcard example

    #FileTransfer #pdf #smartcard #hsm

    If you need any info about this new ‘Sign a PDF using SmartCard or HSM’ option, please let us know.

    Best regards,

    Limagito Team

    By Limagito-Team PDF , , ,
1 2 3 4
SEARCH