Überblick
Parameter: CLIENTCODE
Kategorie: Custom
Standardwert: "" (leer)
Produkt: eTASK.Sonstige (Custom)
Was macht dieser Parameter?
Dieser Parameter definiert ein eindeutiges Kundenkürzel für die Portal-Installation. Er wird hauptsächlich verwendet, um kundenspezifische PostUpdate-Scripts nach Systemaktualisierungen automatisch auszuführen. Das Kürzel dient als Identifikator für die Kundeninstallation und ermöglicht die zielgerichtete Ausführung von kundenindividuellen Anpassungen im Update-Prozess.
Wofür wird dieser Parameter verwendet?
Identifikation der Kundeninstallation für PostUpdate-Scripts
Steuerung kundenspezifischer Anpassungen nach System-Updates
Tracking von App-Nutzungsdaten und Aktivitäten
Zuordnung von Telemetriedaten zu spezifischen Kunden
Unterscheidung mehrerer Portal-Instanzen bei Multi-Mandanten-Szenarien
Aktivierung kundenspezifischer Funktionalitäten oder Konfigurationen
Technische Details (für Administratoren)
Format: Freitext (String), typischerweise Kurzform/Kürzel
Standardwert: "" (leer)
Wichtige Hinweise:
Das Kürzel sollte eindeutig und konsistent sein
Typischerweise kurz gehalten (3-10 Zeichen)
Wird bei leeren Wert nicht für PostUpdate-Scripts verwendet
Kann in HTTP-Headern der Web API übertragen werden
Wird für Activity-Tracking in der eTASK App verwendet
Änderungen können Auswirkungen auf laufende Update-Prozesse haben
Der Parameter ist nicht sichtbar im Standard-Setup (ReadOnly: false)
Zusammenspiel mit anderen Parametern:
BUILDNUMBER: Zeigt die aktuelle Build-Nummer der Installation (kann mit CLIENTCODE für versionsabhängige Scripts kombiniert werden)
PORTALCOMPANYID: Definiert die Firmen-ID, während CLIENTCODE als technisches Kürzel dient
Wann sollten Sie diesen Wert ändern?
Wert befüllen (Kundenkürzel setzen), wenn:
Kundenspezifische PostUpdate-Scripts nach Updates ausgeführt werden sollen
Eine eindeutige Identifikation der Installation erforderlich ist
App-Aktivitäten kundenspezifisch getrackt werden sollen
Mehrere Portal-Instanzen für verschiedene Kunden betrieben werden
Telemetriedaten kundenspezifisch ausgewertet werden müssen
Spezielle Anpassungen nach Updates automatisch erfolgen sollen
Wert leer lassen (Standard), wenn:
Keine kundenspezifischen PostUpdate-Scripts erforderlich sind
Standard-Updates ohne Sonderanpassungen ausreichen
Eine Standardinstallation ohne kundenspezifische Identifikation betrieben wird
Keine App-Activity-Tracking benötigt wird
Test- oder Entwicklungsumgebungen ohne Produktivdaten betrieben werden
Wichtige Hinweise
Nicht nachträglich ändern
Das Kürzel sollte bei der Erstinstallation festgelegt und nicht mehr geändert werden. Eine Änderung kann zu Inkonsistenzen bei Tracking-Daten und Update-Scripts führen.Nur für kundenspezifische Installationen
Dieser Parameter ist primär für Installationen mit kundenspezifischen Anpassungen relevant. Standard-Installationen benötigen in der Regel kein Kundenkürzel.Koordination mit eTASK-Support
Das Kundenkürzel sollte in Abstimmung mit dem eTASK-Support vergeben werden, da es für die Bereitstellung von PostUpdate-Scripts verwendet wird.Keine sensiblen Daten verwenden
Das Kürzel wird in Logdateien und HTTP-Headern übertragen. Verwenden Sie keine sensiblen oder personenbezogenen Informationen.
Sicherheit
Hat eine Änderung dieses Parameters Auswirkungen auf die Sicherheit?
Nein, dieser Parameter hat keine direkten Sicherheitsauswirkungen.
Praktisches Beispiel
Ausgangssituation:
Ein Unternehmen "Beispiel GmbH" betreibt eine eTASK Portal-Installation mit spezifischen Anpassungen in der Datenstruktur und individuellen Formularen. Bei jedem System-Update müssen spezielle SQL-Scripts ausgeführt werden, um die kundenspezifischen Anpassungen zu aktualisieren. Bisher mussten diese Scripts manuell nach jedem Update ausgeführt werden, was zeitaufwändig und fehleranfällig war.
Konfiguration:
Der Administrator setzt den Parameter CLIENTCODE in Abstimmung mit dem eTASK-Support auf:"BEISPIEL"
Nach der Änderung:
PostUpdate-Scripts erkennen automatisch die Kundeninstallation
Kundenspezifische Anpassungen werden automatisch nach Updates ausgeführt
App-Aktivitäten werden mit dem Kürzel "BEISPIEL" getrackt
Telemetriedaten können kundenspezifisch ausgewertet werden
Manuelle Nacharbeiten nach Updates entfallen weitgehend
Ergebnis:
Der Update-Prozess ist vollständig automatisiert und die kundenspezifischen Anpassungen werden zuverlässig nach jedem Update angewendet. Die Fehlerquote sinkt deutlich und die Wartungszeiten werden minimiert.
Empfohlene Einstellung
Für Standard-Installationen: "" (leer)
Begründung:
Standard-Installationen ohne kundenspezifische Anpassungen benötigen kein Kürzel
PostUpdate-Scripts für Standard-Installationen laufen unabhängig vom CLIENTCODE
Leere Werte verursachen keine Probleme oder Nebenwirkungen
Ausnahmen (Kundenkürzel empfohlen):
Installationen mit kundenspezifischen Datenbankanpassungen
Umgebungen mit individuellen Formularen oder Workflows
Multi-Mandanten-Szenarien mit mehreren Produktivinstanzen
Kunden mit Service-Level-Agreements für spezifische Anpassungen
Installationen mit App-Activity-Tracking-Anforderungen
Tipp: Verwenden Sie ein kurzes, prägnantes Kürzel (3-6 Großbuchstaben), das den Kunden eindeutig identifiziert. Koordinieren Sie das Kürzel mit dem eTASK-Support, um Konflikte zu vermeiden.