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

Última atualização em 2023-12-27

Este artigo fornece duas maneiras de gerar um modelo de dados ou dicionário de dados do banco de dados do Adobe Campaign.

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 do 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. Gerando um documento do Open Office (legível no Microsoft Word) ou
  2. Gerando uma página da Web de HTML.

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

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

A. Criar um arquivo JavaScript

Usando a visualização do explorador do console do Campaign, escreva um utilitário JavaScript simples nos 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

A variável dbdBuilder.xml O pacote pode ser importado executando o seguinte comando no diretório onde 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 em PDF.

database-description

Exemplo de arquivo de modelo de dados: este documento mostra o índice das 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 é visível em um navegador.

Para esse método, é necessário:

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

Observação: há um equivalente do Windows, msxsl.exe, que pode funcionar adequadamente nessa plataforma, mas não foi testado.

Agora, o msxsl.exe faz parte do Serviços MS Core XML (MSXML).

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

BAIXAR
Obter arquivo
database.xsl e styles.xml

  1. Baixar 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 você pode ajustar:
    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 do Campaign, acesse Definições do pacote de gerenciamento de configuração de administração e crie um package.xml arquivo que contém os esquemas de dados (xtk:schema).
  3. Exporte o pacote e copie o arquivo para o diretório de trabalho do 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