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

Descrição

Ambiente

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

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

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

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

A. 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 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)

B. Importar dbdBuilder.xml

O dbdBuilder.xml O pacote 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.

C. Gerar a descrição do banco de dados

Para gerar a descrição do banco de dados, você pode executar o cus:build-dbd.js Entidade JavaScript 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 dados

Exemplo 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 no Linux xsltproc ferramenta de linha de comando. 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 padrão do Macintosh Mac OS X.
  • Os arquivos anexados, database.xsle 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

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. 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 Definições do Pacote de Gerenciamento de Pacote de Configuração de Administração e crie um package.xml arquivo que contém os schemas de dados (xtk:schema).
​3. Exporte o pacote e copie o arquivo para seu diretório de trabalho Linux ou Mac.
​4. Processar 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