<content-where> <content-debugExport>

Definition:

<!ELEMENT content-debugExport ANY>
<!ATTLIST content-debugExport 
          allowEditedContents (true | false)
          detailed (true | false) "false"
          quoteHtml (true | false) "false"
          htmlPrefix CDATA #IMPLIED
          htmlSuffix CDATA #IMPLIED
          infoPrefix CDATA #IMPLIED
          infoSuffix CDATA #IMPLIED
          errorPrefix CDATA #IMPLIED
          errorSuffix CDATA #IMPLIED
          preferEditedTemplates (true | false)
          templateName CDATA #IMPLIED
>

Aufgabe: content-debugExport simuliert den Export der Version mit der angegebenen ID zu dem Zweck, fehlerhaften Layout-Code ausfindig zu machen. Aus der Ausgabe ist ersichtlich, welche NPSOBJ-Tags aus welchen Quell-Layouts in welcher Reihenfolge ausgewertet werden und welche Fehler bei der Auswertung aufgetreten sind.

Spezielle Parameter dieses Funktionselements:

  • allowEditedContents: Gibt an, ob bei Dateien, die in der betreffenden Version referenziert werden, auf Arbeitsversionen zurückgegriffen werden darf, wenn freigegebene nicht verfügbar sind.
  • detailed: Gibt an, ob sich die Ausgabe nur auf Fehlermeldungen beschränken (false) oder ausführlich sein soll (true). Der voreingestellte Wert ist false.
  • errorPrefix: Gibt eine Zeichenkette an, die vor jeder Fehlermeldung ausgegeben werden soll. Der voreingestellte Wert ist „*** ".
  • errorSuffix: Gibt eine Zeichenkette an, die nach jeder Fehlermeldung ausgegeben werden soll (voreingestellt leer).
  • htmlPrefix: Gibt eine Zeichenkette an, die vor HTML-Text ausgegeben werden soll. Der voreingestellte Wert ist „<pre>".
  • htmlSuffix: Gibt eine Zeichenkette an, die nach HTML-Text ausgegeben werden soll. Der voreingestellte Wert ist „</pre>".
  • infoPrefix: Gibt eine Zeichenkette an, die vor jeder NPSOBJ-Information ausgegeben werden soll (voreingestellt leer).
  • infoSuffix: Gibt eine Zeichenkette an, die nach jeder NPSOBJ-Information ausgegeben werden soll (voreingestellt leer).
  • preferEditedTemplates: Gibt an, ob die Arbeitsversionen der Layouts gegenüber den freigegebenen Versionen bevorzugt verwendet werden sollen. Der voreingestellte Wert entspricht dem gleichnamigen Wert aus den Benutzereinstellungen, der auch für die Vorschau verwendet wird.
  • quoteHtml: Gibt an, ob die Zeichen <, > und & als HTML-Entities ausgegeben werden sollen (true) oder nicht (false). Die Präfix- und Suffix-Parameter sind hiervon nicht betroffen. Der voreingestellte Wert ist false.
  • templateName: Gibt an, mit welchem initialen Layout (Basislayout) der Exporttest durchgeführt werden soll. Ist templateName nicht angegeben, wird das benutzerspezifische Standard-Layout verwendet (voreingestellt mastertemplate).

Verwendung: Zunächst wird mit content-where die Version ermittelt. Anschließend wird content-debugExport verwendet, um den Export-Bericht zu erzeugen.

Rückgabewert bei Erfolg: der formatierte Exportbericht (string).

Erforderliche Rechte: der Benutzer muss das Recht permissionGlobalExport oder permissionRead für die zur Version gehörende Datei haben.

Beispiel:

<cm-request...>
  <content-where>
    <objectId>116624</objectId>
    <state>edited</state>
  </content-where>
  <content-debugExport quoteHtml="true" 
    htmlPrefix="&lt;pre&gt;"
    htmlSuffix="&lt;/pre&gt;" 
    infoPrefix="&lt;font
    color=&quot;blue&quot;&gt;" 
    infoSuffix="&lt;/font&gt;&lt;br&gt;"
    errorPrefix="&lt;font color=&quot;red&quot;&gt;"
    errorSuffix="&lt;/font&gt;&lt;br&gt;" />
</cm-request>

<cm-response...>
  <cm-code numeric="0" phrase="ok">
    <content-debugExport>
      <dictitem>
        <key>hallo.html</key>
        <value>
          &lt;font color="red"&gt; FEHLER [140015]
          In der NPSOBJ-Anweisung 'modifyvar' fehlen die folgenden Attribute:
          varname&lt;/font&gt;&lt;br&gt;&lt;font
          color="red"&gt; FEHLER [140012] Die Export-Variable
          oder das Schlüsselwort 'contentTypeAndCharset' in der
          NPSOBJ-Anweisung 'insertvalue' ist unbekannt.
          &lt;/font&gt;&lt;br&gt;
        </value>
      </dictitem>
    </content-debugExport>
  </cm-code>
</cm-response>