Recherche et remplacement binaire | MyQ X Server (Print Server)

La fonction Recherche et remplacement binaire permet aux administrateurs de corriger ou de mettre en place des correctifs pour les flux de travaux d’impression avant qu’ils ne soient analysés par MyQ. Elle fonctionne en appliquant une séquence de règles de recherche et de remplacement hexadécimales à chaque travail au niveau de l’octet, en ciblant des commandes PDL spécifiques (PCL, PJL, PostScript) au moment où elles entrent dans une file d’attente. Les règles sont définies par file d’attente, exécutées en un seul passage de traitement et prennent effet immédiatement après l’enregistrement — aucun redémarrage du service n’est nécessaire.

Attention !
Cette fonctionnalité manipule des flux d’octets bruts. Une règle mal configurée peut corrompre un travail d’impression ou le rendre impossible à imprimer. Testez-la d’abord dans une file d’attente hors production. Vous devez être à l’aise avec les données hexadécimales et le langage PDL concerné (PCL, PJL, PostScript).

Recherche et remplacement binaires

Cette fonctionnalité est désactivée par défaut. Pour l’activer, veuillez suivre les étapes suivantes.

Modifiez le fichier `config.ini` situé dans le répertoire des données de l’application (par défaut : `C:\ProgramData\MyQ`) afin d’y inclure les lignes suivantes :
```
[JobProcessor]
binaryFindReplaceEnabled=true
```
Redémarrez tous les services MyQ à l’aide d’Easy Config.

Cela active la fonction Recherche et remplacement binaires et crée le répertoire BinFindReplace dans le répertoire des données d’application, s’il n’existe pas.

Pour désactiver cette fonctionnalité, définissez binaryFindReplaceEnabled=false et redémarrez tous les services MyQ.

Utilisation du fichier de règles de remplacement

Créez le fichier Config.json dans le dossier BinFindReplace situé dans le répertoire de données (par exemple : C:\ProgramData\MyQ\BinFindReplace\Config.json). Les modifications apportées à ce fichier prennent effet immédiatement et ne nécessitent pas de redémarrage des services. Si le fichier n’est pas valide, une erreur est consignée et l’intégralité du fichier est ignorée.

Exemple :

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

Les filtres sont définis dans le fichier Config.json, avec un nom unique et une paire de chaînes de recherche et de remplacement. Pour supprimer les octets correspondants, utilisez une chaîne vide comme valeur de remplacement (comme pour GlobalBanner dans l’exemple).

Les filtres de chaque tableau de file d’attente sont appliqués séquentiellement, chacun agissant sur la sortie du précédent, lors d’un seul passage sur le fichier d’impression. Des filtres supplémentaires peuvent être ajoutés sans impact sur les performances. Le résultat est transmis directement vers la sortie sans mise en mémoire tampon de l’intégralité du travail. Un identifiant de filtre peut apparaître plusieurs fois dans un tableau de file d’attente, dans n’importe quelle combinaison avec d’autres filtres.

Référence des champs

Champ	Type	Description
`queues`	Objet	Associe les noms de files d’attente (sensibles à la casse) à un tableau ordonné d’identifiants de filtre. Les files d’attente qui ne figurent pas dans la liste ne sont pas affectées.
`filters`	Objet	Définitions de filtres nommés ; chaque clé correspond à un identifiant de filtre et chaque valeur à une paire « recherche/remplacement ».
`find`	Chaîne	Octets hexadécimaux à rechercher. Doit être non vide et de longueur paire ; la casse n’a pas d’importance.
`replace`	Chaîne	Octets hexadécimaux à substituer. Une chaîne vide supprime les octets correspondants. Doit être de longueur paire et ne tient pas compte de la casse.

Veuillez noter les contraintes suivantes :

Caractères hexadécimaux uniquement : 0–9, a–f, A–F, sans distinction de majuscules/minuscules
Les chaînes find et replace doivent contenir un nombre entier d’octets (2 caractères hexadécimaux par octet)
La chaîne de recherche find ne peut pas être vide.
Les valeurs des chaînes find et replace doivent être différentes.
Chaque ID de filtre dans les queues doit être défini dans filters.
La taille maximale de chaque valeur find et replace est de 256 Ko.
La sortie d’un filtre donné ne peut pas dépasser 64 fois la taille de son entrée.

Journalisation

Les événements liés à cette fonctionnalité apparaissent dans MyQ > Journal, identifiés par la mention Recherche et remplacement binaires.