Generare un modello di dati o un dizionario dati
Questo articolo fornisce due modi per generare un modello di dati o un dizionario di dati del database di Adobe Campaign.
Descrizione description
Ambiente
Adobe Campaign Classic v7
Problema/Sintomi
In questo documento vengono illustrati due modi per generare un modello di dati o un dizionario dati del database Adobe Campaign.
Risoluzione resolution
Adobe Campaign contiene centinaia di tabelle. Questo documento illustra due diversi modi per generare la documentazione dello schema:
- Generando un documento di Open Office (leggibile in Microsoft Word), oppure
- Generando una pagina web HTML.
Metodo 1: creazione di un documento OpenOffice
Nella sezione dell’Adobe Campaign datakit\nms\fra\package\optional
directory, esiste un pacchetto denominato dbbBuilder.xml
. Questo file di pacchetto contiene un’entità JavaScript che genera un documento Open Office che descrive lo schema del database dell’istanza di Adobe Campaign.
R. Creare un file JavaScript
Utilizzando la vista Esplora console di Campaign, scrivi una semplice utility JavaScript nei codici JavaScript di configurazione dell’amministrazione, come nell’esempio seguente.
Modificare il strOutputFile
valore per aggiungere la directory di destinazione in cui si desidera creare il documento Open Office. Ad esempio: /tmp/database-description.odt
.
Esempio di file: 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. Importa dbdBuilder.xml
Il dbdBuilder.xml
è possibile importare il pacchetto eseguendo il comando seguente nella directory in cui è memorizzato il pacchetto. Sostituite instance_name con il nome effettivo dell'istanza di Adobe Campaign.
nlserver package - import :dbdBuilder.xml -instance:instance_name
Esempio di importazione del pacchetto per 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.
Esempio di importazione del pacchetto per 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. Genera la descrizione del database
Per generare la descrizione del database, puoi eseguire la cus:build-dbd.js
Entità JavaScript con il modulo nlserver utilizzando una riga di comando, come illustrato di seguito:
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
Nella directory specificata in viene generato un documento OpenOffice denominato 'database-description.odt' build-dbd.js
. Contiene la descrizione delle tabelle di Adobe Campaign. È possibile modificare il documento con Microsoft Word o OpenOffice e convertirlo in PDF.
Esempio di file del modello dati: questo documento mostra l’indice delle tabelle del database, i campi e le chiavi SQL e l’elenco dei collegamenti allo schema.
Metodo 2: creazione di una pagina Web tramite xsltproc
Questo approccio alternativo è basato su Linux xsltproc
strumento da riga di comando. In questo scenario, è possibile esportare lo schema creando un documento XML, quindi trasformare l'XML in HTML utilizzando un file XSLT. Il file di output è visualizzabile in un browser.
Per questo metodo, è necessario:
- Ambiente Linux o Macintosh da eseguire
xsltproc
, che è un'utility per riga di comando Macintosh Mac OS X standard. - I file allegati,
database.xsl
, estyles.xml
(consulta allegati.zip).
Nota: esiste un equivalente di Windows, msxsl.exe
, che può funzionare correttamente su tale piattaforma, ma non è stato testato.
Ora msxsl.exe fa parte di Servizi XML di base MS (MSXML).
Il Servizi XML di base MS (MSXML) Il download è disponibile nel catalogo di Microsoft Update.
SCARICA
Ottieni filedatabase.xsl
e styles.xml
- Scarica i due file allegati
database.xsl
estyles.xml
in una directory di lavoro su Linux o Mac. Nella parte superiore dell'XSL sono disponibili due variabili che è possibile regolare:xsl:variable name="unicode"false/xsl:variable
xsl:variable name="engine"postgresql/xsl:variable
I valori supportati per il motore sono: postgresql, mssql e oracle. Imposta la variabile del motore sul valore corrispondente al database dell’istanza di marketing. - Dalla console Campaign, vai a Definizioni del pacchetto di gestione dei pacchetti di configurazione dell’amministrazione e crea un
package.xml
file contenente gli schemi di dati (xtk:schema
). - Esportare il pacchetto, quindi copiare il file nella directory di lavoro Linux o Mac.
- Elaborare il file package.xml eseguendo il comando seguente nella directory di lavoro utilizzando
XSLT: xsltproc database.xsl package.xml database.html.
Il documento generato non è perfetto:
- Alcune condizioni di unione sui collegamenti non possono essere documentate.
- Quando in uno schema si fa riferimento a un’enumerazione ma questa è definita in un altro schema che non è incluso nel pacchetto, l’enumerazione non è documentata.