Definir funções SQL adicionais adding-additional-sql-functions

O Adobe Campaign permite que o usuário defina suas próprias funções que podem acessar funções SQL, tanto as oferecidas pelo banco de dados quanto as que ainda não estão disponíveis no console. Isso é útil para funções agregadas (média, máximo, soma), por exemplo, que só podem ser calculadas no servidor ou quando o banco de dados fornece uma maneira mais fácil de implementar determinadas funções, em vez de gravar "manualmente" a expressão no console (por exemplo, gerenciamento de datas).

Esse mecanismo também pode ser usado se você quiser usar uma função SQL recente ou incomum do mecanismo de banco de dados, que ainda não é oferecida pelo console do Adobe Campaign.

Depois que essas funções forem adicionadas, elas aparecerão no editor de expressão da mesma forma que outras funções predefinidas.

Instalação installation

As funções a serem adicionadas estão em um arquivo de "pacote" no formato XML, cuja estrutura está detalhada no parágrafo a seguir.

Para instalá-lo do console, selecione as opções Tools/Advanced/Import package do menu, em seguida, o Install from file e siga as instruções do assistente de importação.

Estrutura geral do pacote a importar general-structure-of-package-to-import

As funções a serem adicionadas podem ser encontradas no arquivo "pacote" no formato XML. Aqui está um exemplo:

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

Se quiser adicionar funções a vários grupos diferentes, você pode fazer com que vários elementos <group> sejam rastreados na mesma lista.

Finalmente, um elemento <group> pode conter a definição de uma ou várias funções, que é a finalidade do arquivo de pacote. O <function> O elemento é detalhado no parágrafo a seguir.

Descritor de função <function></function> function-descriptor--function-

O caso apresentado aqui é um caso geral em que desejamos fornecer a implementação da função.

Abaixo está um exemplo de uma função de "maturidade relativa" que, usando uma idade, indica por quantos anos a pessoa foi considerada madura.

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

O campo @name faz referência ao nome da função, e "args" é a lista de parâmetros que será exibida na descrição. Nesse caso, a função aparecerá como "relativeMaturity ( <age> )" na janela de seleção da função.

Descritor de função 'Pass-through' pass-through--function-descriptor

Um descritor de função especial é o bloco "passagem", com um sistema de banco de dados "provedor" não especificado. Nesse caso, a implementação "body" só pode conter uma única chamada de função com uma sintaxe que não depende do banco de dados usado. Enquanto isso, o bloco "ProviderPart" é exclusivo.

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

Nesse caso, adicionar uma função serve apenas para tornar uma função de banco de dados que não estaria disponível por padrão, agora visível para o cliente.

Exemplos examples

Mais exemplos de função podem ser encontrados no pacote predefinido "xtkdatakitfuncList.xml".