Zum Hauptinhalt springen

Customizing-Anleitung

Customizing eines SPC clientHeaderCode Scripts​

Schritt 1: Script kopieren und umbenennen​

Script kopieren: Kopieren Sie das vorhandene clientHeaderCode Script.

Umbenennen: Benennen Sie das kopierte Script um, z.B. von clientHeaderCode in ...cust...clientHeaderCode.

Beispiel:

ou.spc.Postman.clientHeaderCode.copy → ou.cust.Postman.clientHeaderCode

Schritt 2: Weitere UserExits einfügen​

UserExits hinzufügen: Wenn zusätzliche UserExits oder andere Skripte benötigt werden, laden Sie diese als Portalskript hoch.

Einfügen in das Script: Fügen Sie die Namen der hochgeladenen Skripte in das userExits Array des neuen clientHeaderCode Scripts ein.

Beispiel:

const userExits = [
    "ou.sp.Postman.custom.filetypeHandler", // Beispiel für ein kundenspezifisches Skript
    "ou.sp.Postman.additional.customExit"   // Weitere Skripte hinzufügen
];

Schritt 3: Script verwenden​

Stellen Sie sicher, dass das angepasste clientHeaderCode Script in der gewünschten Umgebung eingesetzt und getestet wird. Hinweis Alle weiteren Anpassungen und neuen UserExits müssen ebenfalls im userExits Array des clientHeaderCode Scripts eingetragen werden, damit sie korrekt geladen werden.

Anpassen von UserExit-Skripten​

Die im clientHeaderCode geladenen UserExit-Skripte registrieren Callbacks über das exitRegistry (z.B. registerFileFieldExitCallback, registerFileExitCallback). Da pro Feld mehrere Callbacks registriert werden können und alle registrierten Callbacks ausgeführt werden, muss beim Customizing wie folgt vorgegangen werden:

  1. Das Original-Skript komplett kopieren und in ein Cust-Skript umbenennen (z.B. ou.cust.Postman.filetype.userexit.file).
  2. Die gewünschte Stelle im kopierten Skript anpassen.
  3. Das Original-Skript im clientHeaderCode durch das Cust-Skript austauschen — also das Original aus dem userExits-Array entfernen und das Cust-Skript eintragen.
const userExits = [
    // Original entfernt:
    // "ou.sp.Postman.filetype.userexit.file",
    // Cust-Skript stattdessen eingetragen:
    "ou.cust.Postman.filetype.userexit.file",
    /* ... */
];