Serverseitige ID-Generierung und Validierung von Projektattributen

Sie können eine Vorlage einrichten, um in der Registerkarte "Ansicht" mithilfe von benutzerdefinierten Routinen Projekt-IDs zu generieren und Werte zu validieren (einschließlich der generierten ID), wenn das Projekt, der Plan oder das Programm gespeichert sind.

Um einen benutzerdefinierten ID-Generator zu erstellen, müssen Sie eine Java™-Klasse schreiben, die die Benutzeroberfläche com.unicacorp.uap.project.helper.PidGenerate implementiert. Innerhalb der Vorlagendefinition können Sie dann Ihren Java™-Klassennamen als Wert für das pidGenClass-Attribut und alle gewünschten Präfixe angeben, die der generierten ID mithilfe des pidprefix-Attributs angehängt werden sollen. Auf ähnliche Weise können Sie außerdem benutzerdefinierte Routinen definieren, um Attributtype eines Projekts, Plans oder Programms zu validieren. Um eine benutzerdefinierte Validierungsroutine zu definieren, müssen Sie eine Java™-Klasse schreiben, die die folgende Benutzeroberfläche implementiert: com.unicacorp.uap.common.template.IdValidate.

Innerhalb der Projektvorlagendefinition können Sie dann Ihre Java™-Klasse als Wert für das validateClass-Attribut angeben.

Beispiel für serverseitige ID-Generierung

Nehmen wir beispielsweise an, dass Sie eine Marketingobjektvorlage für Angebote haben und dass Sie benutzerdefinierte Codes für alle Angebote generieren müssen, die mit dieser Vorlage erstellt wurden. Die Codes müssen über folgende Merkmale verfügen:

Der erste Code sollte bei 900001 liegen.

Der Bereich der Codes liegt zwischen 900001 und 999999.

Codes sollten nacheinander generiert werden.

Führen Sie hierzu folgende Schritte durch:

1.	Erstellen Sie eine benutzerdefinierte Java™-Implementierung namens CustomComponentPidGenerateImpl.java.

Beachten Sie Folgendes:

Diese Implementierung verwendet eine Datei, IDRange.properties, um die Mindest- und Höchstwerte für die benutzerdefinierten IDs aufzunehmen.

Sie verwendet eine Datenbanktabelle, CUST_GENIDS, um den aktuellen Wert der benutzerdefinierten ID für jeden Objekttyp aufzunehmen, der die Klasse für die Generierung benutzerdefinierter IDs verwendet.

2.	Kompilieren Sie die Klasse. Die kompilierte Klasse wird CustomComponentPidGenerateImpl.class genannt.

3.	Kopieren Sie diese Klassendatei in folgenden Ordner in der Installation von Marketing Operations:

\unwar\WEB-INF\classes\com\unica\uap\component\helper

4.	Erstellen Sie eine Datei namens IDRange.properties und fügen Sie in der Datei folgenden Text ein:

mktOBJId.min=900001

mktOBJId.max=999999

5.	Kopieren Sie diese Datei in den Ordner \unwar\WEB-INF in der Installation von Marketing Operations.

6.	Erstellen Sie mithilfe Ihres Datenbankmanagementprogramms eine Tabelle namens CUST_GENIDS mit folgenden Spalten:

ENTITY_NAME; Zeichenfolge, Länge 50

ID_VALUE; Ganzzahl (alles im Dateiformat)

7.	Führen Sie einen Neustart Ihres Web-Servers durch.

8.	Erstellen oder bearbeiten Sie eine Marketingobjektvorlage, die diese benutzerdefinierte Klasse verwenden kann, und navigieren Sie zu der Seite mit den Vorlageneigenschaften.

9.	Geben Sie im Feld ID der Generierungsklasse die benutzerdefinierte Klasse mithilfe des vollständig qualifizierter Klassennamens oder des kanonischer Namens an, wie hier dargestellt:

CustomComponentPidGenerateImpl

Wenn Sie das erste customIDs-Marketingobjekt erstellen, beachten Sie, dass dessen ID 900001 ist.