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:

  1. Generando un documento di Open Office (leggibile in Microsoft Word), oppure
  2. 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.

database-description

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, e styles.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 file
database.xsl e styles.xml

  1. Scarica i due file allegati database.xsl e styles.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.
  2. 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).
  3. Esportare il pacchetto, quindi copiare il file nella directory di lavoro Linux o Mac.
  4. 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.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f