Definiera ytterligare SQL-funktioner adding-additional-sql-functions

Med Adobe Campaign kan användaren definiera sina egna funktioner som har åtkomst till SQL-funktioner, både de som finns i databasen och de som inte redan är tillgängliga i konsolen. Detta är användbart för sammanställningsfunktioner (medel, maximum, sum) som till exempel bara kan beräknas på servern eller när databasen är ett enklare sätt att implementera vissa funktioner, i stället för att skriva uttrycket i konsolen manuellt (till exempel datumhantering).

Den här funktionen kan även användas om du vill använda en nyligen använd eller ovanlig SQL-funktion för databasmotorn som ännu inte finns i Adobe Campaign-konsolen.

När dessa funktioner har lagts till visas de i uttrycksredigeraren precis som andra fördefinierade funktioner.

Installation installation

De funktioner som ska läggas till finns i en "paketfil" i XML-format, vars struktur beskrivs i följande stycke.

Om du vill installera det från konsolen väljer du alternativen Verktyg/Avancerat/Importera paket på menyn, sedan Install from file och följer instruktionerna i importguiden.

Allmän struktur för paket som ska importeras general-structure-of-package-to-import

Funktioner som ska läggas till finns i filen "package" i XML-format. Här är ett exempel:

<?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>

Om du vill lägga till funktioner i flera olika grupper kan du göra så att flera <group> element spåras i samma lista.

Slutligen kan ett <group>-element innehålla definitionen av en eller flera funktioner, det vill säga syftet med paketfilen. <function> -elementet beskrivs i följande stycke.

Funktionsbeskrivning <function></function> function-descriptor--function-

Det här fallet är ett allmänt fall där vi vill tillhandahålla funktionsimplementeringen.

Nedan visas ett exempel på en funktion för"relativ mognad" som, med hjälp av en ålder, anger i hur många år personen har betraktats som mogen.

 <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>

Fältet @name refererar till funktionens namn och "args" är den lista med parametrar som ska visas i beskrivningen. I det här fallet visas funktionen som"relativeMaturity ( <age> )" i funktionsvalsfönstret.

Funktionsbeskrivningen "Pass-through" pass-through--function-descriptor

En särskild funktionsbeskrivning är "pass-through"-blocket, med ett ospecificerat "provider"-databassystem. I det här fallet kan "body"-implementeringen bara innehålla ett enda funktionsanrop med en syntax som inte är beroende av den databas som används. Under tiden är "ProviderPart"-blocket unikt.

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

Om du i det här fallet lägger till en funktion skapas bara en databasfunktion som inte skulle ha varit tillgänglig som standard, som nu är synlig för klienten.

Exempel examples

Fler funktionsexempel finns i det fördefinierade paketet "xtkdatakitfuncList.xml".