Zusätzliche SQL-Funktionen definieren adding-additional-sql-functions

Adobe Campaign ermöglicht es dem Benutzer, seine eigenen Funktionen zu definieren, die auf SQL-Funktionen zugreifen können, sowohl auf die Funktionen der Datenbank als auch auf die Funktionen, die noch nicht in der Konsole verfügbar sind. Dies ist beispielsweise bei Aggregatfunktionen (Durchschnitt, Maximum, Summe) nützlich, die nur auf dem Server berechnet werden können oder wenn die Datenbank eine einfachere Möglichkeit bietet, bestimmte Funktionen zu implementieren, anstatt den Ausdruck manuell in die Konsole zu schreiben (z. B. Datumsverwaltung).

Dieser Mechanismus kann auch verwendet werden, wenn Sie eine aktuelle oder ungewöhnliche SQL-Funktion der Datenbank-Engine verwenden möchten, die noch nicht von der Adobe Campaign-Konsole angeboten wird.

Nachdem diese Funktionen hinzugefügt wurden, werden sie im Ausdruckseditor wie andere vordefinierte Funktionen angezeigt.

Installation installation

Die hinzuzufügenden Funktionen befinden sich in der Datei "package" im XML-Format, deren Struktur im folgenden Absatz beschrieben wird.

Um es über die Konsole zu installieren, wählen Sie im Menü die Optionen Tools/Erweitert/Package importieren , dann die Option Aus Datei installieren und befolgen Sie die Anweisungen im Import-Assistenten.

Allgemeine Struktur des zu importierenden Packages general-structure-of-package-to-import

Die hinzuzufügenden Funktionen finden Sie in der Datei "package" im XML-Format. Hier ein Beispiel:

<?xml version="1.0" encoding='ISO-8859-1' ?>
<!-- ===========================================================================
  Additional SQL functions for Adobe Campaign
  ========================================================================== -->
<package
  namespace   = "nms"
  name        = "package-additional-funclist"
  label       = "Additional functions"
  buildVersion= "7.1"
  buildNumber = "10000">

  <entities schema="xtk:funcList">
    <funcList name="myList" namespace="cus">
      <group name="date" label="Personalized date">
        <function name="relativeMaturity" type="long" args="(<Âge>)" help="Returns the difference between a date and 18 years"
                  minArgs="1" maxArgs="1" display="Relative maturity of the person born on the date $1">
          <providerPart provider="MSSQL,Sybase,PostgreSQL" body="extract(year from age($1))-18"/>
        </function>
      </group>
    </funcList>
  </entities>
</package>

Wenn Sie Funktionen zu mehreren Gruppen hinzufügen möchten, können Sie mehrere <group> -Elemente in derselben Liste nachverfolgen lassen.

Schließlich kann ein Element <group> die Definition einer oder mehrerer Funktionen enthalten, also den Zweck der Paketdatei. Der <function> -Element wird im folgenden Absatz beschrieben.

Funktionsdeskriptor <function></function> function-descriptor--function-

Der hier dargestellte Fall ist ein allgemeiner Fall, in dem wir die Implementierung der Funktion bereitstellen möchten.

Unten finden Sie ein Beispiel für eine Funktion der "relativen Reife", die anhand eines Alters angibt, für wie viele Jahre die Person als reif angesehen wurde.

 <function name="relativeMaturity" type="long" args="(<Âge>)" help="Returns the difference between a date and 18 years"
              minArgs="1" maxArgs="1" display="Relative maturity of the person born on the date $1">
       <providerPart provider="PostgreSQL" body="extract(year from age($1))-18"/>
       <providerPart provider="MSSQL,Sybase,Teradata" body="[Other implementation]"/>
    </function>

Das Feld @name bezieht sich auf den Namen der Funktion und "args" ist die Liste der Parameter, die in der Beschreibung angezeigt werden. In diesem Fall wird die Funktion im Funktionsauswahlfenster als "relativeMaturity ( <age> )"angezeigt.

Funktionsdeskriptor "Pass-Through" pass-through--function-descriptor

Ein spezieller Funktionsdeskriptor ist der Block "Pass-Through" mit einem nicht spezifizierten Datenbanksystem "Provider". In diesem Fall kann die Implementierung von "body"nur einen einzelnen Funktionsaufruf mit einer Syntax enthalten, die nicht von der verwendeten Datenbank abhängig ist. In der Zwischenzeit ist der Block "ProviderPart"eindeutig.

    <function name="CountAll" args="()" help="Counts the values returned (all fields together)"
              type="long" minArgs="0" maxArgs="0">
      <providerPart body="Count(*)"/>
    </function>

In diesem Fall dient das Hinzufügen einer Funktion nur dazu, eine Datenbankfunktion zu erstellen, die standardmäßig nicht verfügbar gewesen wäre und nun für den Client sichtbar ist.

Beispiele examples

Weitere Funktionsbeispiele finden Sie im vordefinierten Paket "xtkdatakitfuncList.xml".