Print

Übersicht

Die Aktion Print druckt eine oder mehrere Dateien auf einem Drucker, der auf diesem PC installiert ist – zum Beispiel jede eingehende Rechnung zusätzlich auf Papier. Es öffnet sich kein Fenster; der Druck läuft ohne Rückfrage.

Dateityp	Endungen
PDF	`.pdf`
Bilder	`.png`, `.jpg`, `.jpeg`, `.bmp`, `.gif`, `.tif`, `.tiff` (mehrseitige TIFF-Dateien Seite für Seite)
Text	`.txt`, `.log`, `.csv`, `.xml`, `.json` (Schrift Consolas 9 pt, ohne eingestellte Ränder 1,27 cm Rand, zu lange Zeilen werden abgeschnitten)

PDF-Seiten und Bilder werden auf den bedruckbaren Bereich des Papiers (oder den Bereich innerhalb der eingestellten Ränder) verkleinert, wenn sie größer sind, aber nie vergrößert, und mittig gesetzt. Ohne feste Ausrichtung (Landscape) wird jede Seite so gedreht, wie sie angelegt ist: Querformat-Seiten quer, Hochformat-Seiten hoch.

Fehler: RUNOS prüft vor der ersten Seite den Drucker, alle Dateien, die Dateitypen und die Optionen. Ist etwas davon ungültig, schlägt die Aktion fehl, ohne etwas zu drucken. Danach werden die Dateien nacheinander gedruckt. Schlägt eine fehl, werden die übrigen nicht mehr gedruckt (Skipped) und die Aktion schlägt fehl. Wie bei jeder Aktion endet der Lauf dann bzw. greift die Fehlerbehandlung des Workflows.

Im Workflow-Editor stellen Sie die Aktion in einem Formular zusammen und probieren sie mit Schritt testen aus.

Den umgekehrten Weg, vom Drucken eines Programms in einen Ordner, beschreibt PDF-Drucker.

Struktur

{
  "Type": "Print",
  "Name": "Drucken",
  "Parameters": {
    "Source": "{{FilePath}}",
    "Printer": "default",
    "Copies": 1,
    "Duplex": "LongEdge"
  }
}

Parameter	Standard	Bedeutung
`Source`	–	Die zu druckende(n) Datei(en): ein Pfad, mehrere getrennt durch `;` oder Zeilenumbrüche, eine Liste oder ein Muster wie `C:\Out\*.pdf`. Die Dateien werden in dieser Reihenfolge gedruckt; Treffer eines Musters alphabetisch.
`MissingFiles`	`Error`	`Error`: Fehlt eine Datei oder findet ein Muster nichts, schlägt die Aktion fehl. `Skip`: ohne sie weiterdrucken, mit Warnung. Fehlen alle, druckt die Aktion nichts und endet erfolgreich mit Warnungen.
`Printer`	`default`	`default` = der Standarddrucker von Windows, sonst der Name eines installierten Druckers, wie er unter Einstellungen → Drucker & Scanner steht (Groß-/Kleinschreibung egal). Ist der Drucker nicht installiert, schlägt die Aktion fehl; die Fehlermeldung nennt die installierten Drucker.
`Copies`	`1`	Anzahl Exemplare jeder Datei (sortiert). Kann der Druckertreiber nicht so viele Kopien, wird die Datei entsprechend oft gedruckt.
`Duplex`	`default`	`Simplex` (einseitig), `LongEdge` (beidseitig, Bindung an der langen Kante) oder `ShortEdge` (an der kurzen Kante). Kann der Drucker nicht beidseitig drucken, wird einseitig gedruckt, mit Warnung.
`FromPage`, `ToPage`	`default`	Erste und letzte Seite (ab 1), bei jeder Datei; bei Textdateien zählen die gedruckten Seiten. Ein `ToPage` hinter der letzten Seite druckt bis zum Ende; ein `FromPage` hinter der letzten Seite ist ein Fehler.
`Color`	`default`	`true` = farbig, `false` = schwarzweiß. Druckt der Drucker nicht farbig, gibt es eine Warnung.
`Landscape`	`default`	`true` = quer, `false` = hoch. `default`: PDF-Seiten und Bilder nach ihrer eigenen Ausrichtung, Text wie im Drucker eingestellt.
`PaperSize`	`default`	Papierformat, wie der Drucker es nennt, z. B. `A4` oder `Letter`.
`PaperSource`	`default`	Papierfach, wie der Drucker es nennt, z. B. `Fach 2`.
`Resolution`	`default`	`High`, `Medium`, `Low`, `Draft` oder dpi wie `600` bzw. `600x600`.
`MarginTop`, `MarginBottom`, `MarginLeft`, `MarginRight`	`default`	Rand in Millimetern vom Papierrand, z. B. `15` oder `12.5`. Der Inhalt wird in den Bereich innerhalb der Ränder eingepasst. Ein Rand kleiner als der nicht bedruckbare Rand des Druckers zählt als dieser. `default`: der Rand des Druckers, bei Textdateien zusätzlich 1,27 cm. Lassen die Ränder weniger als 1,27 cm Platz, schlägt die Aktion fehl.

default (oder ein leerer Wert) lässt die Einstellung des Druckers unverändert. Kennt der Drucker ein angegebenes Papierformat, Fach oder eine Auflösung nicht, schlägt die Aktion fehl; die Fehlermeldung nennt die verfügbaren Werte. Alle Werte dürfen Platzhalter enthalten, auch Zahlen und Ja/Nein-Werte ("true", "ja", "1").

Ergebnis

"Response": {
  "Results": [
    {
      "Source": "C:\\RUNOS\\Out\\RE-1001.pdf",
      "Printer": "Brother HL-L2350DW",
      "Status": "Printed",
      "Pages": 2,
      "Copies": 1,
      "Message": "Sent to the print queue of 'Brother HL-L2350DW'."
    }
  ],
  "SuccessCount": 1,
  "ErrorCount": 0
}

Status ist Printed, Error (die Datei, an der es scheiterte) oder Skipped (nach einem Fehler nicht mehr gedruckt). Pages zählt die Seiten eines Exemplars. Schlägt schon die Prüfung vor dem Druck fehl (Drucker, Datei, Option), ist Results leer und ErrorCount 1; die Meldung steht in Status.Errors. Warnungen (kein Duplex, keine Farbe, übersprungene Dateien) stehen in Status.Warnings.

Formular im Editor

Im Diagramm des Workflow-Editors hat die Aktion ein Formular (im Einstellungsfeld und in der mittleren Spalte der Testansicht):

Was gedruckt wird: Dateien und was bei fehlenden Dateien passiert (Fehler oder Überspringen).
Drucker: die installierten Drucker, der Standarddrucker zuerst, nicht erreichbare mit offline markiert; die Schaltfläche daneben liest sie neu ein. Dazu Exemplare, Beidseitig, Ab Seite / Bis Seite, Farbe und Ausrichtung.
Papier, Fach und Ränder: Papierformat, Papierfach und Auflösung mit Vorschlägen des gewählten Druckers sowie die Ränder Oben, Unten, Links und Rechts in mm (leer = Standard).

Jedes Feld nimmt auch {{…}}-Platzhalter und Werte, die Sie in der Testansicht aus der Spalte Eingabe hineinziehen; Auswahllisten, Schalter und Zahlenfelder werden mit einem {{…}} zu einem Textfeld. Parameter, die das Formular nicht kennt, stehen unter Weitere Parameter. Schritt testen führt die Aktion sofort einmal aus, mit den Daten der Schritte davor, und zeigt das Ergebnis mit Fehlern und Warnungen. Der Test druckt wirklich.

Beispiel

Jede Rechnung, die im Ordner C:\RUNOS\Rechnungen ankommt, zweimal beidseitig auf dem Drucker „Buchhaltung“ ausgeben:

{
  "Name": "Rechnungen drucken",
  "Autostart": true,
  "Trigger": { "Type": "File", "Name": "Rechnungen", "Parameters": { "Pool": "C:\\RUNOS\\Rechnungen", "Filter": "*.pdf" } },
  "Actions": [
    {
      "Type": "Print",
      "Name": "Drucken",
      "Parameters": {
        "Source": "{{FilePath}}",
        "Printer": "Buchhaltung",
        "Copies": 2,
        "Duplex": "LongEdge",
        "PaperSize": "A4"
      }
    }
  ]
}

Mehrere Dateien auf einmal, z. B. alle PDFs und ein Deckblatt:

"Source": "C:\\RUNOS\\Deckblatt.pdf; C:\\RUNOS\\Out\\*.pdf"