Empfehlungsdaten in das XML-Format exportieren

Sollen XML-Daten für die Empfehlungen eines Benutzers exportiert werden, ergänzen Sie den Content Server-URL für die betreffende Seite mit &outputxml=true, oder geben Sie die folgende URL ein: <protocol>://<host>/<URL_Präfix>/Content Server.exe?func=Personal.Recommendations&outputxml=true

wobei:

<Protokoll> ist entweder http oder https,
<Host> ist die vollständige Adresse des Hosts (z. B. Content Serverhost.meinefirma.com) und
<URL_Präfix> ist das URL-Präfix (Alias des virtuellen Verzeichnisses), das dem Verzeichnis <Content Server_home>/cgi auf dem HTTP-Server zugeordnet ist.

Mit diesem Befehl werden die Empfehlungen für den Benutzer ausgegeben, der derzeit beim Admin-Server angemeldet ist.

Die DTD-Datei, die diese XML-Ausgabe definiert, ist unter <Content Server_home>/module/recommender_<x>_<x>_<x>/config/recommender_xml_output.dtd in Installationen vorhanden. Dabei ist <x>_<x>_<x> die Versionsnummer des Recommender-Moduls. Beispielsweise finden Sie die Datei für Recommender 10.5.0 unter: <Content Server_home>/module/recommender_10_5_0/config/recommender_xml_output.dtd.

XML-Ausgabe

Der erste Teil der XML-Ausgabe besteht aus einem Kopfabschnitt, der die XML-Datei und den Typ der Daten in dieser Datei definiert (in diesem Fall also Empfehlungsdaten). Dieser Abschnitt besteht aus der nachstehenden XML-Deklaration, die die XML-Version und die Zeichencodierung bestimmt, und aus dem Element PersonalRecommendations:

<?xml version="1.0" ?><PersonalRecommendations>

Anschließend folgt in der XML-Datei je ein Abschnitt für die Recommender-Komponenten, mit denen Informationen auf der Seite Empfehlungen angezeigt werden. Jeder Abschnitt wird mit einem Tag definiert.

Tabelle 1-3: XML-Tags zur Definition der Recommender-Komponenten

Element	Komponente
`<whatsnew>`	Was ist neu
`<mostactive>`	Aktivste
`<toppicks>`	Top-Picks
`<history>`	Kürzlich aufgerufene Objekte
`<userslikeme>`	Personen mit ähnlichen Interessen
`<docsinterest>`	Dokumente von Interesse

Jeder dieser Tags umfasst das Attribut DisplayName, das wiederum den Namen enthält, unter dem dieses Element in der Benutzeroberfläche angezeigt wird (z. B. <whatsnew DisplayName="Was ist neu">).

Die Komponenten Was ist neu, Aktivste Objekte, Top-Picks, Kürzlich angezeigte Objekte und Dokumente von Interesse bestehen aus Tabellen von Objekten und werden daher mit denselben Tags in der XML-Ausgabe definiert. In der nachstehenden Tabelle werden die XML-Tags in der Reihenfolge ihres Auftretens beschrieben.


	Hinweis: In dieser Tabelle besitzen mehrere XML-Tags denselben Namen (z. B. `<dc_link>`). Diese scheinbaren Duplikate sind notwendig, weil die Tabelle sämtliche Tags in der Reihenfolge ihres Auftretens enthält.

Tabelle 1-4: XML-Tags für objektorientierte Komponenten

Tag	Beschreibung
`<browseview>`	Reihe von Tags mit der Objekttabelle.
`<header>`	Reihe von Tags mit dem Kopf der Objekttabelle.
`<column>`	Reihe von Tags mit den Spaltenüberschriften, die im Kopf der Tabelle angezeigt werden. Die Reihenfolge, in der die Etiketten in diesen Tags aufgeführt werden, entspricht der Anzeigereihenfolge in der Benutzeroberfläche.
`<displayname>`	Spaltenüberschrift für die Tabelle (z. B. `Typ`).
`<tagname>`	Tag-Bezeichnung für die Spalte. Die Tag-Bezeichnung verbindet die Spaltenüberschrift mit der entsprechenden Spalte.
`<contents>`	Reihe von Tags mit den Informationen, die im Hauptteil der Tabelle angezeigt werden.
`<object>`	Zeile im Hauptteil der Tabelle.
`<dc_subtype>`	Reihe von Tags mit Angaben zum Objekttyp für die einzelnen Objekte in der Tabelle.
`<dc_subtype_img>`	Reihe von Tags mit Angaben zum Bild für den Objekttyp eines Objekts.
`<dc_imgpath>`	Pfad des Bildes für den Objekttyp eines Objekts.
`<dc_imgalt>`	ALT-Text zum Bild für den Objekttyp eines Objekts (z. B. `Dokument`).
`<dc_link>`	Verknüpfung, über die ein Objekt bereitgestellt werden kann.
`<dc_name>`	Reihe von Tags mit Angaben zum Namen eines Objekts.
`<dc_displayname>`	Name des Objekts, wie dieser in der Tabelle aufgeführt wird.
`<dc_link>`	Verknüpfung, über die ein Objekt bereitgestellt werden kann.
`<dc_name_new>`	In der aktuellen Version von Recommender nicht verwendet.
`<dc_functions>`	In der aktuellen Version von Recommender nicht verwendet.
`<dc_location>`	Reihe von Tags mit Angaben zum Ablageort eines Objekts.
`<dc_location_img>`	Reihe von Tags mit Angaben zum Bild für den Ablageort eines Objekts.
`<dc_imgpath>`	Pfad des Bildes für den Ablageort eines Objekts.
`<dc_imgalt>`	ALT-Text zum Bild für den Ablageort eines Dokuments (z. B. `Unternehmensarbeitsbereich`).
`<dc_displayname>`	Ablageort eines Objekts, wie dieser in der Tabelle aufgeführt wird.
`<dc_link>`	Verknüpfung zum Ablageort eines Objekts.
`<dc_name_new>`	In der aktuellen Version von Recommender nicht verwendet.
`<dc_size>`	Reihe von Tags mit Angaben zur Größe eines Objekts.
`<dc_size_displaysize>`	Größe eines Objekts, wie diese in der Tabelle aufgeführt wird.
`<dc_modifydate>`	Reihe von Tags mit Angaben zum Änderungsdatum eines Objekts.
`<dc_date>`	Änderungsdatum eines Objekts, wie dieses in der Tabelle aufgeführt wird.
`<recommender_rating>`	Reihe von Tags mit Informationen zur allgemeinen Bewertung eines Objekts in der Tabelle.
`<recommender_rating_img>`	Reihe von Tags mit Informationen zum Bild für die allgemeine Bewertung eines Objekts in der Tabelle.
`<recommender_imgpath>`	Pfad des Bildes für die allgemeine Bewertung eines Objekts.
`<recommender_imgalt>`	ALT-Text für das Bewertungsbild (z. B. `Klicken Sie bitte, um dieses Objekt zu bewerten`).
`<recommender_link>`	Verknüpfung zur Registerkarte Bewertungen der Seite Eigenschaften des Objekts in der Tabelle.

Die Komponente Personen mit gleichen Interessen besteht aus einer Tabelle von Benutzern. In der nachstehenden Tabelle werden die XML-Tags in der Reihenfolge ihres Auftretens beschrieben.

Tabelle 1-5: XML-Elemente für die Komponente Personen mit gleichen Interessen

Element	Beschreibung
`<browseview>`	Reihe von Tags mit der Benutzertabelle.
`<header>`	Reihe von Tags mit dem Kopf der Benutzertabelle.
`<column>`	Reihe von Tags mit den Spaltenüberschriften, die im Kopf der Tabelle angezeigt werden. Die Reihenfolge, in der die Etiketten in diesen Tags aufgeführt werden, entspricht der Anzeigereihenfolge in der Benutzeroberfläche.
`<displayname>`	Spaltenüberschrift für die Tabelle (z. B. `Benutzername`).
`<tagname>`	Tag-Bezeichnung für die Spalte. Die Tag-Bezeichnung verbindet die Spaltenüberschrift mit der entsprechenden Spalte.
`<contents>`	Reihe von Tags mit den Informationen, die im Hauptteil der Tabelle angezeigt werden.
`<object>`	Zeile im Hauptteil der Tabelle.
`<recommender_username>`	Reihe von Tags mit Informationen über einen Benutzer in der Tabelle.
`<recommender_displayname>`	Anmeldename des Benutzers, wie dieser in der Tabelle aufgeführt wird.
`<recommender_imgpath>`	Pfad des Bildes für die einzelnen Benutzer in der Tabelle.
`<recommender_link>`	Verknüpfung zu Informationen über einen Benutzer in der Tabelle.
`<recommender_firstname>`	Vorname eines Benutzers in der Tabelle.
`<recommender_lastname>`	Nachname eines Benutzers in der Tabelle.
`<recommender_department>`	Abteilung eines Benutzers in der Tabelle.

.
Beispiel 1-1: Beispieldatei

Im Folgenden wird ein Beispiel für die exportierten Empfehlungsdaten dargestellt. In diesem Fall liegen nur die folgenden Empfehlungen vor: die Datei kf.pdf unter Was ist neu sowie der Benutzer bdonnhoff unter Personen mit gleichen Interessen.


<?xml version="1.0" ?>

<PersonalRecommendations>

<whatsnew DisplayName="What's New">
<!-- File: dc/sectionbrowseviewxml.html -->
  <browseview>
    <header>
      <column>
        <displayname>Type</displayname>
        <tagname>dc_subtype</tagname>
      </column>
      <column>
        <displayname>Name</displayname>
        <tagname>dc_name</tagname>
      </column>
      <column>
        <displayname>Functions</displayname>
        <tagname>dc_functions</tagname>
      </column>
      <column>
        <displayname>Location</displayname>
        <tagname>dc_location</tagname>
      </column>
      <column>
        <displayname>Size</displayname>
        <tagname>dc_size</tagname>
      </column>
      <column>
        <displayname>Modified Date</displayname>
        <tagname>dc_modifydate</tagname>
      </column>
      <column>
        <displayname>Rating</displayname>
        <tagname>recommender_rating</tagname>
      </column>
    </header>
    <contents>
      <object>
        <dc_subtype>
          <dc_subtype_img>
            <dc_imgpath>/910support/webdoc/apppdf.gif</dc_imgpath>
            <dc_imgalt>Document</dc_imgalt>
            <dc_link>/910/.exe/kf.pdf?func=doc.Fetch&nodeId=4618&docTitle=kf%2Epdf</dc_link>
          </dc_subtype_img>
        </dc_subtype>
        <dc_name>
          <dc_displayname>kf.pdf</dc_displayname>
          <dc_link>/910/.exe/kf.pdf?func=doc.Fetch&nodeId=4618&docTitle=kf%2Epdf</dc_link>
          <dc_name_new/>
        </dc_name>
        <dc_functions>
        </dc_functions>
        <dc_location>
          <dc_location_img>
            <dc_imgpath>/910support/webdoc/icon_library.gif</dc_imgpath>
            <dc_imgalt>Enterprise Workspace</dc_imgalt>
          </dc_location_img>
          <dc_displayname>Enterprise</dc_displayname>
          <dc_link>/910/.exe?func=ll&objId=2000&objAction=browse&sort=name</dc_link>
          <dc_name_new/>
        </dc_location>
        <dc_size>
          <dc_size_displaysize>60731 KB</dc_size_displaysize>
        </dc_size>
        <dc_modifydate>
          <dc_date>10/08/2002 04:07 PM</dc_date>
        </dc_modifydate>
        <recommender_rating>
          <recommender_rating_img>
            <recommender_imgpath>/910support/recommender/ratinggifs/star/star0.gif</recommender_imgpath>
            <recommender_imgalt>Click to rate this item.</recommender_imgalt>
            <recommender_link>?func=ll&objid=4618&objAction=Ratings</recommender_link>
          </recommender_rating_img>
        </recommender_rating>
      </object>
    </contents>
  </browseview>
<!-- End File: dc/sectionbrowseviewxml.html -->
</whatsnew>

<mostactive DisplayName="Most Active">
</mostactive>

<toppicks DisplayName="Top Picks">
</toppicks>

<history DisplayName="Recently Accessed Items">
</history>

<userslikeme DisplayName="People With Similar Interests">
<!-- File: dc/sectionbrowseviewxml.html -->
  <browseview>
    <header>
      <column>
        <displayname>User Name</displayname>
        <tagname>recommender_username</tagname>
      </column>
      <column>
        <displayname>First Name</displayname>
        <tagname>recommender_firstname</tagname>
      </column>
      <column>
        <displayname>Last Name</displayname>
        <tagname>recommender_lastname</tagname>
      </column>
      <column>
        <displayname>Department</displayname>
        <tagname>recommender_department</tagname>
      </column>
    </header>
    <contents>
      <object>
        <recommender_username>
          <recommender_username>
            <recommender_displayname>bdouglas</recommender_displayname>
            <recommender_imgpath>/910support/guy.gif</recommender_imgpath>
            <recommender_link><A HREF="#" onClick="javascript:window.open('?func=user.userdialog&userID=4613','UserDialog','width=460,height=365,resizable=yes,scrollbars=yes,menubar=no')">bdouglas</A></recommender_link>
          </recommender_username>
        </recommender_username>
        <recommender_firstname>
          <recommender_firstname>Beverly</recommender_firstname>
        </recommender_firstname>
        <recommender_lastname>
          <recommender_lastname>Douglas</recommender_lastname>
        </recommender_lastname>
        <recommender_department>
          <recommender_department>DefaultGroup</recommender_department>
        </recommender_department>
      </object>
    </contents>
  </browseview>
<!-- End File: dc/sectionbrowseviewxml.html -->
</userslikeme>

<docsinterest DisplayName="Documents Of Interest">
</docsinterest>

</PersonalRecommendations>