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:

  1. durch Generieren eines Open Office-Dokuments (lesbar in Microsoft Word) oder
  2. 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.

database-description

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, und styles.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 abrufen
database.xsl und styles.xml

  1. Herunterladen der beiden angehängten Dateien database.xsl und styles.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.
  2. 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).
  3. Exportieren Sie das Paket und kopieren Sie dann die Datei in das Arbeitsverzeichnis von Linux oder Mac.
  4. 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.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f