MyQ X Server
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish

Binäres Suchen und Ersetzen

Mit Binary Find & Replace können Administratoren Druckauftragsströme korrigieren oder patchen, bevor diese von MyQ analysiert werden. Dabei wird auf Byte-Ebene eine Abfolge von hexadezimalen Such- und Ersetzungsregeln auf jeden Druckauftrag angewendet, wobei bestimmte PDL-Befehle (PCL, PJL, PostScript) beim Eintritt in eine Warteschlange gezielt bearbeitet werden. Die Regeln werden pro Warteschlange definiert, in einem einzigen Streaming-Durchlauf ausgeführt und treten sofort nach dem Speichern in Kraft – ein Neustart des Dienstes ist nicht erforderlich.

Warnung!
Diese Funktion bearbeitet rohe Byte-Ströme. Eine falsch konfigurierte Regel kann einen Druckauftrag beschädigen oder undruckbar machen. Testen Sie die Funktion zunächst in einer Nicht-Produktionswarteschlange. Sie sollten mit Hex-Daten und der jeweiligen PDL (PCL, PJL, PostScript) vertraut sein.


Binäres Suchen und Ersetzen aktivieren

Die Funktion ist standardmäßig deaktiviert. Um sie zu aktivieren, führen Sie die folgenden Schritte aus.

  1. Bearbeiten Sie die Datei config.ini im Anwendungsverzeichnis (Standard: C:\ProgramData\MyQ) und fügen Sie folgende Zeilen ein:

    [JobProcessor]
    binaryFindReplaceEnabled=true
    
  2. Starten Sie alle MyQ-Dienste mit Easy Config neu.

Dadurch wird Binäres Suchen und Ersetzen aktiviert und das Verzeichnis BinFindReplace im Anwendungsverzeichnis erstellt, sofern es noch nicht vorhanden ist.

Um die Funktion zu deaktivieren, setzen Sie binaryFindReplaceEnabled=false und starten Sie alle MyQ-Dienste neu.


Verwendung der Ersetzungsregeln-Datei

Erstellen Sie die Datei Config.json im Ordner BinFindReplace innerhalb des Datenverzeichnisses (z. B. C:\ProgramData\MyQ\BinFindReplace\Config.json). Änderungen an der Datei werden sofort wirksam; ein Neustart der Dienste ist nicht erforderlich. Sollte die Datei ungültig sein, wird ein Fehler protokolliert und die gesamte Datei übersprungen.

Beispiel:

{
  "queues": {
    "Default": ["FixTraySelection", "InjectWatermarkHeader"],
    "Web": ["GlobalBanner"]
  },
  "filters": {
    "FixTraySelection": {
      "find": "1B266C3148",
      "replace": "1B266C3248"
    },
    "InjectWatermarkHeader": {
      "find": "40504A4C20454E544552",
      "replace": "40504A4C2053455420555345523D2241646D696E220D0A40504A4C20454E544552"
    },
    "GlobalBanner": {
      "find": "1B452A",
      "replace": ""
    }
  }
}

Filter werden in der Datei Config.json mit einem eindeutigen Namen und einem Paar aus Such- und Ersetzungszeichenfolgen definiert. Um die übereinstimmenden Bytes zu löschen, verwenden Sie eine leere Zeichenfolge als Ersetzungswert (wie bei GlobalBanner im Beispiel).

Die Filter in jeder Warteschlange werden nacheinander angewendet, wobei jeder Filter auf die Ausgabe des vorherigen Filter angewandt wird – und zwar in einem einzigen Durchlauf durch die Druckdatei. Zusätzliche Filter können ohne Leistungseinbußen hinzugefügt werden. Das Ergebnis wird direkt an die Ausgabe gestreamt, ohne dass der gesamte Druckauftrag zwischengespeichert wird. Eine Filter-ID kann mehrfach in einer Warteschlange vorkommen, in beliebiger Kombination mit anderen Filtern.

Feldreferenz

Feld

Typ

Beschreibung

queues

Objekt

Ordnet Warteschlangennamen (unter Berücksichtigung der Groß-/Kleinschreibung) einem geordneten Array von Filter-IDs zu. Nicht aufgeführte Warteschlangen bleiben davon unberührt.

filters

Objekt

Benannte Filterdefinitionen, wobei jeder Schlüssel eine Filter-ID und jeder Wert ein Such-/Ersetzungs-Paar ist.

find

Zeichenkette

Zu suchende Hex-Bytes. Muss nicht leer sein, eine gerade Länge aufweisen und ist groß-/kleinschreibungsunabhängig.

replace

Zeichenkette

Hex-Bytes, die ersetzt werden sollen. Eine leere Zeichenkette löscht die übereinstimmenden Bytes. Muss eine gerade Länge haben; Groß- und Kleinschreibung wird nicht berücksichtigt.

Beachten Sie die folgenden Anforderungen:

  • Nur Hexadezimalzeichen: 0–9, a–f, A–F, Groß- und Kleinschreibung spielt keine Rolle

  • Die Zeichenfolgen find und replace müssen eine ganze Anzahl von Bytes enthalten (2 Hexadezimalzeichen pro Byte)

  • Die Suchzeichenfolge find darf nicht leer sein.

  • Die Werte für find und replace müssen unterschiedlich sein.

  • Jede Filter-ID in queues muss in filters definiert sein.

  • Die maximale Größe für jeden find- und replace-Wert beträgt 256 KB.

  • Die Ausgabe eines einzelnen Filters darf nicht mehr als das 64-Fache der Größe seiner Eingabe betragen.


Protokollierung

Ereignisse im Zusammenhang mit dieser Funktion werden unter MyQ > Protokoll angezeigt und sind mit dem Text Binary Find & Replace gekennzeichnet.