Como gerar um modelo de dados ou um dicionário de dados

Descrição

Ambiente

Campaign Classic v7

 


Problema/Sintomas
Este documento mostra duas maneiras de gerar um modelo de dados ou um dicionário de dados do seu banco de dados Adobe Campaign.

Resolução

O Adobe Campaign contém centenas de tabelas. Este documento apresenta duas maneiras diferentes de gerar a documentação do schema:

Ao gerar um documento Open Office (legível no Microsoft Word) ou Gerando uma página da Web HTML.

Método 1: Criação de um documento do OpenOffice

Na Adobe Campaign datakit\nms\fra\package\optional diretory, há um pacote chamado dbbBuilder.xml. Esse arquivo de pacote contém uma entidade JavaScript que gera um documento do Open Office detalhando o schema do banco de dados da instância do Adobe Campaign.


Criar um arquivo JavaScript


Usando a visualização do explorador do console de campanha, escreva um utilitário JavaScript simples em códigos JavaScript de configuração de administração, como no exemplo abaixo.

Altere o valor strOutputFile para adicionar o diretório de destino onde deseja criar o documento Open Office. Por exemplo: /tmp/database-description.odt.


Exemplo de arquivo: cus:build-dbd.js

/* * build-dbd.js/ var
    strXslt = "nl:dbdToOdt.xsl"
    var strTemplate = installDirectory( "datakit/nl/dbd-template.odt" )
    var strOutputFile = "database-description.odt"
    var sql = xtk.sqlSchema.create() sql.Generate()
    var strDbXml = db = sql.toXML().toXMLString()
    var strOdt = applyXsl(strXslt, strDbXml)
    strOdt = strOdt.replace(/\?xml .*\?\r?\n/, '\r\n' )
    var mbContent = new MemoryBuffer mbContent.fromString(strOdt, "utf-8" )
    var zip = new ZipFile(strTemplate)
    zip.open() zip.setEntry( "content.xml" , mbContent) zip.save(strOutputFile)


 

Importar dbdBuilder.xml


O pacote dbdBuilder.xml pode ser importado executando o seguinte comando no diretório em que o pacote está armazenado. Substitua instance_name pelo nome real da instância do Adobe Campaign.

nlserver package - import :dbdBuilder.xml -instance:instance_name


Exemplo de importação de pacote para Debian

neolane@debian: /nl6/datakit/nms/fra/package/optional $ cd
    /nl6/datakit/nms/fra/package/optionalneolane@debian:/nl6/datakit/nms/fra/package/optional$
    nlserverpackage -import:dbdBuilder.xml
    -instance:10:46:09
    Application serverfor Adobe Campaign Version 6.1.1(build 8537) of 04/16/201410:46:09
    Starting 1 connection(s) on pool'default vmcloud'(PostgreSQL, server='localhost',
    login='user:password')10:46:09 Importing package'/tmp/dbdBuilder.xml'...10:46:11
    Enumerating thefile entities...10:46:11
    Writing entitiesin the database...10:46:11
    Saving entities oftype 'xtk:xslt'...10:46:12
    Saving entities oftype 'xtk:javascript'...10:46:12
    Installation of packages successful.

Exemplo de importação de pacote para Windows

C: cd "\Program Files (x86)\Adobe\Adobe Campaign v6\bin"
    C:\Program Files (x86)\Adobe\Adobe Campaign v6\binnlserver.exe
    package - import : ..\datakit\nms\fra\package\optional\dbdBuilder.xml
    -instance: 13:52:57 Application server for Adobe Campaign Version 6.1.1 (build 8622) of 01 /19/2015 13:52:57
    Starting 1 connection(s) on pool 'default ' (PostgreSQL, server= 'localhost' , login= 'user:password' ) 13:52:57
    Importing package 'C:\Program Files (x86)\Adobe\Adobe Campaign v6\bin\..\datakit\nms\fra\package\optional\dbdBuilder.xml'...
    13:52:59 Enumerating the file entities...
    13:52:59 Writing entities in the database...
    13:52:59 Saving entities of type 'xtk:javascript' ...
    13:52:59 Installation of packages successful.

Gerar a descrição do banco de dados
Para gerar a descrição do banco de dados, você pode executar a entidade JavaScript cus:build-dbd.js com o módulo nlserver usando uma linha de comando, conforme mostrado abaixo: 
neolane@debian: /tmp $ nlserver javascript -instance: cus:build-dbd.js 05:06:12
    Application server for Adobe Campaign Version 6.1.1 (build 8537) of 04 /16/2014
    05:06:12 Starting 1 connection(s) on pool
    'default vmcloud' (PostgreSQL, server= 'localhost' , login= 'user:vmcloud' )
    05:06:12 Executing JavaScript from entity of identifier 'xs:build-dbd.js' ...
    05:06:12 Generating the database structure...
    05:06:12 Element '0' unknown (see definition of schema 'Recipient delivery logs (nms:broadLogRcp)').
    (iRc=16384)
    05:06:12 Element '0' unknown (see definition of schema 'Visitor delivery logs (nms:broadLogVisitor)').
    (iRc=16384) 05:06:12 Element '0' unknown (see definition of schema 'Recipient delivery logs (nms:broadLogRcp)').
    (iRc=16384) 05:06:12 Element '0' unknown (see definition of schema 'Visitor delivery logs (nms:broadLogVisitor)').
    (iRc=16384) 05:06:13 Generating the ODT XML... 05:06:14 Saving the zip file ...
    05:06:14 File saved as 'database-description.odt

Um documento do OpenOffice chamado 'database-description.odt' é gerado no diretório especificado em build-dbd.js. Ele contém a descrição das tabelas do Adobe Campaign. Este documento pode ser editado com o Microsoft Word ou OpenOffice e pode ser convertido para o PDF. descrição do banco de dadosExemplo de arquivo do modelo de dados
Este documento mostra o índice de tabelas do banco de dados, os campos e chaves SQL e a lista de links de esquema.
 Método 2: Criar uma página da Web usando xsltproc
Essa abordagem alternativa é baseada na ferramenta de linha de comando xsltproc do Linux. Nesse cenário, você exporta o esquema criando um documento XML e, em seguida, transforma o XML em HTML usando um arquivo XSLT. O arquivo de saída pode ser visualizado em um navegador.

Para este método, você precisa:

  • Um ambiente Linux ou Macintosh para executar xsltproc, que é um utilitário de linha de comando Macintosh Mac OS X padrão.
  • Os arquivos anexados, database.xsl e styles.xml (consulte attachment.zip).

Observação:

Existe um equivalente do Windows, msxsl.exe, que pode funcionar bem nessa plataforma, mas não foi testado.

Agora msxsl.exe faz parte de Serviços MS Core XML (MSXML).

O Serviços MS Core XML (MSXML) o download pode ser encontrado no Catálogo de atualizações do Microsoft.

DOWNLOAD
Obter arquivo 
database.xsl e styles.xml
 
 

  1. Baixe os dois arquivos anexados database.xsl e styles.xml em um diretório de trabalho no Linux ou Mac. Na parte superior do XSL, há duas variáveis que podem ser ajustadas: xsl:variable name="unicode"false/xsl:variable xsl:variable name="engine"postgresql/xsl:variable Os valores compatíveis para o mecanismo são: postgresql, mssql e oracle. Defina a variável do mecanismo com o valor que corresponde ao banco de dados da instância de marketing.
  2. No Console de Campanha, vá para as definições do Pacote de Gerenciamento de Configuração de Administração e crie um arquivo package.xml que contenha os esquemas de dados (xtk:schema).
  3. Exporte o pacote e copie o arquivo para seu diretório de trabalho Linux ou Mac.
  4. Processe o arquivo package.xml executando o seguinte comando no diretório de trabalho usando XSLT: xsltproc database.xsl package.xml database.html.

O documento gerado não é perfeito:

  • Algumas condições de associação em links não podem ser documentadas.
  • Quando uma enumeração é referenciada em um schema, mas definida em outro schema que não está no pacote, a enumeração não é documentada.

Nesta página