Richtlinien für die Verwendung benutzerdefinierter Makros

Beachten Sie beim Erstellen bzw. Verwenden von Makros die folgenden Richtlinien:

Als Name für ein benutzerdefiniertes Makro dürfen nur alphanumerische Zeichen verwendet werden. In der Zeichenkette für den Makronamen dürfen Sie keine Leerzeichen verwenden, dafür aber Unterstriche (_).

Wenn eine Datenquelle mit der Eigenschaft ENABLE_SELECT_SORT_BY = TRUE konfiguriert wurde, müssen Sie benutzerdefinierte SQL-Makros mit einer SORTIEREN NACH-Klausel versehen. Nur so werden die zurückgegebenen Datensätze anhand der Zielgruppenschlüsselfelder der Zielgruppenebene sortiert, auf der Sie arbeiten. Andernfalls wird für das Makro bei einem Prozess "Momentaufnahme" in einem abgeleiteten Feld und bei nicht erwartungsgemäßer Reihenfolge eine Fehlernachricht ausgegeben.

Wenn Sie den Rückgabewert eines benutzerdefinierten Makros nicht vergleichen, gilt folgende Logik: Wenn der Wert numerisch ist, werden Werte ungleich null als TRUE ausgewertet (die IDs, mit denen Sie verknüpft sind, werden ausgewählt); Werte gleich null ergeben hingegen FALSE. Zeichenketten ergeben immer FALSE.

Wenn Sie ein benutzerdefiniertes Makro aus direktem SQL erstellen, kann eine temporäre Segmenttabelle dazu beitragen, dass sich die Geschwindigkeit bei der Ausführung von direktem SQL wesentlich erhöht. Der Grund hierfür ist eine erhebliche Reduktion der zu bearbeitenden Datenmenge.

Greift ein benutzerdefiniertes Makro auf temporäre Segmenttabellen zurück, wird der Datenbank zwangsläufig eine temporäre Segmenttabelle übermittelt, damit der Code ordnungsgemäß ausgeführt werden kann.

Wird ein benutzerdefiniertes Makro in einem SELECT-Befehl höchster Ebene verwendet, stehen keine Verlaufsinformationen zur Verfügung, mit deren Hilfe Campaign der Datenbank eine temporäre Segmenttabelle übergeben könnte. Folge ist, dass der Code nicht ordnungsgemäß ausgeführt werden kann.

Das bedeutet für Sie, dass Sie beim Erstellen eines benutzerdefinierten Makros mit direktem SQL unter Umständen zwei Versionen des gleichen benutzerdefinierten Makros erstellen müssen. Eines davon verwendet Tokens temporärer Tabellen, das andere nicht.

Das benutzerdefinierte Makro, das ohne Tokens von temporären Tabellen auskommt, sollte auf der obersten Hierarchieebene verwendet werden (z. B. im ersten SELECT-Befehl). Das Makro mit Tokens temporärer Tabellen lässt sich an jeder anderen Stelle der Struktur einsetzen, an der solch ein Einsatz vorteilhaft erscheint.

Eigenständige Verknüpfungen können entstehen, wenn Sie die Rückgabewerte benutzerdefinierter Makros gemeinsam zur Abfrage nicht normalisierter Daten verwenden. Das ist in aller Regel nicht wünschenswert.

Wenn Sie z. B. ein auf direktem SQL basierendes, benutzerdefiniertes Makro verwenden, das einen Wert zurückgibt (z. B. in einem Prozess "Momentaufnahme"), und Sie das benutzerdefinierte Makro sowie ein anderes Feld aus der Tabelle ausgeben, auf dem das benutzerdefinierte Makro basiert, nimmt Campaign eine eigenständige Verknüpfung der Tabelle vor. Wenn die Tabelle nicht normalisiert wurde, erhalten Sie ein kartesisches Produkt (d. h. die Anzahl der angezeigten Datensätze ist größer als erwartet).

Auf benutzerdefinierte Makros kann ab dieser Version nur per Verweis zugegriffen werden, weil die Definition des benutzerdefinierten Makros nicht in den aktuellen Prozess kopiert wird.

Zur Laufzeit wird das benutzerdefinierte Makro aufgelöst, indem seine Definition in der Systemtabelle UA_CustomMacros (dort sind die Definitionen gespeichert) ermittelt und das Makro anschließend eingesetzt/ausgeführt wird.

Im Unterschied zu gespeicherten Abfragen müssen benutzerdefinierte Makronamen eindeutig sein, unabhängig vom Verzeichnispfad. Vor Version 5.0 war es möglich, eine gespeicherte Abfrage mit dem Namen "A" in zwei verschiedenen Ordnern, z. B. F1 und F2, zu speichern.

Campaign unterstützt gespeicherte Abfragen aus früheren Versionen. Jedoch müssen Sie bei Verweisen auf nicht eindeutige gespeicherte Abfragen die alte Syntax verwenden.

gespeicherteAbfrage(<Abfragename>)

Beim Auflösen von Benutzervariablen in benutzerdefinierten Makros verwendet Campaign den beim Prüfen der Syntax aktuellen Wert der Benutzervariable. Ist der aktuelle Wert leer, wird von Campaign eine Fehlernachricht ausgegeben.

Tokens temporärer Tabellen bewirken eine wesentlich schnellere Verarbeitung von Abfragen. Dies wird dadurch erreicht, dass die von der Datenbank zu bearbeitende Datenmenge durch die Zielgruppen-IDs in der temporären Tabelle deutlich reduziert wird. Bei dieser temporären Liste mit IDs handelt es sich unter Umständen um eine Obermenge der IDs der aktuellen Zelle. Aus diesem Grund werden Aggregationsfunktionen (z. B. zum Ermitteln des Durchschnitts oder der Summe) für temporäre Segmenttabellen nicht unterstützt und könnten zu falschen Ergebnissen führen.

Wenn Sie vorhaben, ein benutzerdefiniertes Makro über mehrere Datenbanken hinweg einzusetzen, ist es unter Umständen besser, einen IBM® -Ausdruck zu verwenden anstatt auf direktes SQL zurückzugreifen. Direktes SQL ist in der Regel datenbankspezifisch.

Wenn ein benutzerdefiniertes Makro direktes SQL und ein anderes benutzerdefiniertes Makro enthält, wird zunächst das benutzerdefinierte Makro aufgelöst, ausgeführt und der Wert zurückgegeben, bevor der direkte SQL-Code ausgeführt wird.

In Campaign werden Kommas als Trennzeichen für Parameter behandelt. Wenn Sie in einem Parameter Kommas als Text verwenden möchten, müssen Sie den Text wie im folgenden Beispiel illustriert in geschweifte Klammern ({}) einschließen:

TestCM( {STRING_CONCAT(UserVar.Test1, UserVar.Test2) } )

Campaign unterstützt die einfache Ersetzung von Parametern in Benutzerdefinierten Makros mit Hilfe von direktem SQL-Code. Wenn Sie beispielsweise in einem Ablaufdiagramm ein Auswahlprozessfeld mit der folgenden Abfrage einrichten:

exec dbms_stats.gather_table_stats(tabname=> <temptable>,ownname=> 'autodcc')

fügt Campaign anstelle des Tokens <temptable> erfolgreich den Namen der aktuellen temporären Tabelle ein. Beachten Sie, dass die einfachen Anführungszeichen um den Tabellennamen erforderlich sind.

In den folgenden Tabellen wird erläutert, wie Campaign benutzerdefinierte Makros in Abfragen und abgeleiteten Feldern behandelt.

Benutzerdefinierte Makros in Abfragen und abgeleiteten Feldern (Prozesse "Auswählen", "Segmentieren" und "Zielgruppe")

Typ des benutzerdefinierten Makros	Verwendung
Direktes SQL: IDs	Wird als eigenständige Abfrage ausgeführt. Die ID-Liste wird mit anderen Ergebnissen zusammengeführt. Wenn ein benutzerdefiniertes Makro andere benutzerdefinierte Makros und direktes SQL enthält, werden zuerst die benutzerdefinierten Makros aufgelöst und ausgeführt. Anschließend wird der direkte SQL-Code ausgeführt.
Direktes SQL: IDs + Value	Es wird erwartet, dass der Rückgabewert in einem Ausdruck oder Vergleich verwendet wird. Wird der Wert nicht auf diese Art eingesetzt, wird von Campaign ein Wert ungleich null bei einer ID-Auswahl als TRUE ausgewertet. Ein Wert gleich null oder eine Zeichenkette ergeben FALSE.
IBM® -Ausdruck	Der Ausdruck wird aufgelöst und die Syntax wird überprüft. Es wird eine Abfrage pro Tabelle unterstützt und die IDs werden verglichen / zusammengeführt.

In einer Direkt-SQL-Abfrage (Prozesse "Auswählen", "Segmentieren" und "Zielgruppe")

Typ des benutzerdefinierten Makros	Verwendung
Direktes SQL: IDs	Das benutzerdefinierte Makro wird aufgelöst und die Abfrage ausgeführt.
Direktes SQL: IDs + Value	Wird nicht unterstützt.
IBM® -Ausdruck	Der Ausdruck wird aufgelöst, aber es findet keine Überprüfung der Syntax statt. Ist der Ausdruck nicht korrekt, wird er als solcher vom Datenbankserver bei der Ausführung erkannt.