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.
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
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
Weiterführende Links
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.