Como gerar um modelo de dados ou um dicionário de dados
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 description
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 resolution
O Adobe Campaign contém centenas de tabelas. Este documento apresenta duas maneiras diferentes de gerar a documentação do schema:
- Gerando um documento do Open Office (legível no Microsoft Word) ou
- Gerando uma página da Web de HTML.
Método 1: criar um documento OpenOffice
No diretório datakit\nms\fra\package\optional do Adobe Campaign, 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 valor strOutputFile para adicionar o diretório de destino onde deseja criar o documento Abrir 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 pacote dbdBuilder.xml 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 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 em PDF.
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
Esta abordagem alternativa é baseada na ferramenta de linha de comando do Linux xsltproc. 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 executar o
xsltproc, que é um utilitário de linha de comando padrão do Macintosh Mac OS X. - Os arquivos anexados,
database.xslestyles.xml(consulte attachments.zip).
Observação: há um equivalente do Windows, msxsl.exe, que pode funcionar bem nessa plataforma, mas não foi testado.
Agora, o msxsl.exe faz parte do MS Core XML Services (MSXML).
O download do MS Core XML Services (MSXML) pode ser encontrado no Catálogo de Atualização do Microsoft.
BAIXAR
Obter arquivodatabase.xsl e styles.xml
- Baixe os dois arquivos anexados
database.xslestyles.xmlem 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:variablexsl: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. - No Console do Campaign, vá para Definições do Pacote de Gerenciamento de Configuração de Administração e crie um arquivo
package.xmlque contenha os esquemas de dados (xtk:schema). - Exporte o pacote e copie o arquivo para o diretório de trabalho do Linux ou Mac.
- 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.