wDocumentData::getData

Ermittelt Daten eines Dokumentes als Zeichenkette

Funktionsaufruf

String getData(String document, String data, Array options = array())

Parameter

document
Pfad zum Dokument
data
wPath-Ausdruck, der aus dem Dokument ausgelesen werden soll
options
Zusatzoptionen
lengthMax
Maximale Länge des Rückgabewertes
lengthCrop
Anzahl der Zeichen, die maximal ausgelesen werden sollen. Dieses Attribut wird in Kombination mit den Attributen "shrinkCharacterCrop" und "delimiterCrop" verwendet.
shrinkCharacterCrop
Falls die Zeichenkette über "lengthCrop" reduziert wurde, werden vom Ende her alle Zeichen bis zum Auftreten des definierten Zeichens gelöscht.
Wollen Sie also nur ganze Wörter anzeigen, müssen Sie hier ein Leerzeichen angeben.
Wollen Sie hingegen nur ganze Sätze anzeigen, müssen Sie hier ein Punkt angeben.
delimiterCrop
Falls die Zeichenkette über "lengthCrop" reduziert wurde, wird sie durch die angegebenen Zeichen ergänzt.
ifEmpty
Zeichenkette, die zurück gegeben werden soll, falls der angefragte Wert leer ist.

Beispiel: Beispiel 1: Ermittelt den Titel des aktuellen Dokumentes

Quelltext

<?php

print 'Der Titel der aktuellen Seite lautet: '.wDocumentData::getData($_SERVER['PHP_SELF'], "title");

?>

Ergebnis

Der Titel der aktuellen Seite lautet: wDocumentData::getData

Beispiel: Beispiel 2: Ermittelt Werte aus den Objektdaten des aktuellen Dokumentes

Quelltext

<?php

print 'Diese Seite beschreibt die Funktion '.wDocumentData::getData($_SERVER['PHP_SELF'], "/wd:extension/wd:object/wd:data[@id = 'function']/text()").' der Klasse '.wDocumentData::getData($_SERVER['PHP_SELF'], "/wd:extension/wd:object/wd:data[@id = 'class']/text()");

?>

Ergebnis

Diese Seite beschreibt die Funktion getData der Klasse wDocumentData

Beispiel: Beispiel 3: Prüft, ob ein Element besteht und liest dann den Text aus

Quelltext

<?php

if(wDocumentData::getData($_SERVER['PHP_SELF'], "/wd:extension/wd:object/wd:data[@id = 'meta3']")){
print 'Das Datenfeld meta3 existiert und hat den Wert: '.wDocumentData::getData($_SERVER['PHP_SELF'], "/wd:extension/wd:object/wd:data[@id = 'meta3']/text()");
}
else{
print 'Das Datenfeld meta3 existiert nicht.';
}

print '<br />';

if(wDocumentData::getData($_SERVER['PHP_SELF'], "/wd:extension/wd:object/wd:data[@id = 'meta30']")){
print 'Das Datenfeld meta30 existiert und hat den Wert: '.wDocumentData::getData($_SERVER['PHP_SELF'], "/wd:extension/wd:object/wd:data[@id = 'meta30']/text()");
}
else{
print 'Das Datenfeld meta30 existiert nicht.';
}

?>

Ergebnis

Das Datenfeld meta3 existiert und hat den Wert: Beispielwert
Das Datenfeld meta30 existiert nicht.

Beispiel: Beispiel 4: Ermittelt das Erstellungs- und Änderungsdatum des aktuellen Dokumentes und gibt es als Datum aus

Quelltext

<?php

$timestampCreation = wDocumentData::getData($_SERVER["PHP_SELF"], '/wd:extension/wd:meta/wd:creation/@time');
$timestampModification = wDocumentData::getData($_SERVER["PHP_SELF"], '/wd:extension/wd:meta/wd:modification/@time');
$creationDate = date('d.m.Y', $timestampCreation);
$modificationDate = date('d.m.Y', $timestampModification);
print 'Erstellt am: '.$creationDate .'<br />Geändert am: '.$modificationDate.'<br />';

?>

Ergebnis

Erstellt am: 02.08.2009
Geändert am: 01.06.2023

Beispiel: Beispiel 5 : Ermittelt den Objekt-Titel der eingecheckten PDF-Datei

Quelltext

<?php

print 'Objekt-Titel: '.wDocumentData::getData("/devAssets/docs/test.pdf", "/wd:extension/wd:object/wd:data[@id = 'title']/text()");

?>

Ergebnis

Objekt-Titel: Dies ist der Titel der test.pdf
Einsatz der Kurzschreibweise von wPath-Angaben

Hinweis
Beim Einsatz von Framework-Funktionen in eigenen Skripten beachten Sie bitte den Artikel "So verwenden Sie das PHP-Framework in eigenen Scripten".
Wenn Sie eine Funktion innerhalb einer Weblication® Seite z.B. über das PHP-Quelltext Element oder in einem XSL-Template über wsl:php einbinden, muss das Framework über die grid.php nicht mehr referenziert werden.