Generieren eines Datenmodells oder eines Datenwörterbuchs
Dieser Artikel bietet zwei Möglichkeiten zum Generieren eines Datenmodells oder eines Datenwörterbuchs Ihrer Adobe Campaign-Datenbank.
Beschreibung description
Umgebung
Adobe Campaign Classic v7
Problem/Symptome
In diesem Dokument werden zwei Möglichkeiten zum Generieren eines Datenmodells oder eines Datenwörterbuchs Ihrer Adobe Campaign-Datenbank beschrieben.
Auflösung resolution
Adobe Campaign enthält Hunderte von Tabellen. In diesem Dokument werden zwei Möglichkeiten zum Generieren der Schemadokumentation beschrieben:
- durch Generieren eines Open Office-Dokuments (lesbar in Microsoft Word) oder
- durch Generieren einer HTML-Webseite.
Methode 1: Erstellen eines OpenOffice-Dokuments
In der Adobe Campaign datakit\nms\fra\package\optional
Verzeichnis, gibt es ein Paket namens dbbBuilder.xml
. Diese Paketdatei enthält eine JavaScript-Entität, die ein Open Office-Dokument generiert, das das Datenbankschema der Adobe Campaign-Instanz detailliert beschreibt.
A. JavaScript-Datei erstellen
Schreiben Sie in den JavaScript-Code der Administration-Konfiguration mit der Ansicht "Campaign Console Explorer"ein einfaches JavaScript-Dienstprogramm, wie im folgenden Beispiel gezeigt.
Ändern Sie die strOutputFile
-Wert, um den Zielordner hinzuzufügen, in dem Sie das Open Office-Dokument erstellen möchten. Beispiel: /tmp/database-description.odt
.
Dateibeispiel: 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. Import dbdBuilder.xml
Die dbdBuilder.xml
Sie können das Package importieren, indem Sie den folgenden Befehl in das Verzeichnis ausführen, in dem das Paket gespeichert ist. Ersetzen Sie instance_name durch den tatsächlichen Namen der Adobe Campaign-Instanz.
nlserver package - import :dbdBuilder.xml -instance:instance_name
Package-Import-Beispiel für 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.
Beispiel für Package-Import unter 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. Datenbankbeschreibung generieren
Um die Datenbankbeschreibung zu generieren, können Sie die cus:build-dbd.js
JavaScript-Entität mit dem nlserver-Modul mithilfe einer Befehlszeile, wie unten dargestellt:
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
Ein OpenOffice-Dokument mit dem Namen 'database-description.odt' wird in dem Verzeichnis generiert, das Sie in build-dbd.js
. Sie enthält die Beschreibung der Adobe Campaign-Tabellen. Dieses Dokument kann mit Microsoft Word oder OpenOffice bearbeitet und in PDF konvertiert werden.
Beispiel einer Datenmodelldatei: Dieses Dokument zeigt den Index der Datenbanktabellen, die SQL-Felder und -Schlüssel sowie die Liste der Schemalinks.
Methode 2: Erstellen einer Webseite mit xsltproc
Dieser alternative Ansatz basiert auf Linux xsltproc
Befehlszeilen-Tool. In diesem Szenario exportieren Sie das Schema, indem Sie ein XML-Dokument erstellen, und transformieren dann das XML mithilfe einer XSLT-Datei in HTML. Die Ausgabedatei kann in einem Browser angezeigt werden.
Für diese Methode benötigen Sie:
- Linux- oder Macintosh-Umgebung zur Ausführung
xsltproc
, ein standardmäßiges Befehlszeilen-Dienstprogramm für Macintosh Mac OS X. - die angehängten Dateien,
database.xsl
, undstyles.xml
(siehe attachments.zip).
Hinweis: Es gibt eine Windows-Entsprechung. msxsl.exe
, die auf dieser Plattform gut funktionieren kann, aber nicht getestet.
Jetzt ist msxsl.exe Teil von MS Core XML Services (MSXML).
Die MS Core XML Services (MSXML) -Download finden Sie im Microsoft-Aktualisierungskatalog.
HERUNTERLADEN
Datei abrufendatabase.xsl
und styles.xml
- Herunterladen der beiden angehängten Dateien
database.xsl
undstyles.xml
in ein Arbeitsverzeichnis unter Linux oder Mac. Oben in der XSL gibt es zwei Variablen, die Sie anpassen können:xsl:variable name="unicode"false/xsl:variable
xsl:variable name="engine"postgresql/xsl:variable
Die unterstützten Werte für die Engine sind: postgresql, mssql und oracle. Setzen Sie die Engine-Variable auf den Wert, der Ihrer Marketinginstanzdatenbank entspricht. - Wechseln Sie in der Campaign-Konsole zu Package-Definitionen für die Administration Configuration Package Management und erstellen Sie eine
package.xml
-Datei, die die Datenschemata enthält (xtk:schema
). - Exportieren Sie das Paket und kopieren Sie dann die Datei in das Arbeitsverzeichnis von Linux oder Mac.
- Verarbeiten Sie die Datei "package.xml", indem Sie den folgenden Befehl im Arbeitsverzeichnis ausführen, indem Sie
XSLT: xsltproc database.xsl package.xml database.html.
Das erstellte Dokument ist nicht perfekt:
- Einige Join-Bedingungen für Links können nicht dokumentiert werden.
- Wenn eine Auflistung in einem Schema referenziert, aber in einem anderen Schema definiert wird, das nicht im Paket enthalten ist, wird die Auflistung nicht dokumentiert.