wRepository::getDraft

Gibt ein Dokumenten-Objekt der Arbeitskopie zurück

Funktionsaufruf

wDocument getDraft(String path)

Parameter

path: Pfad des Dokumentes

Beispiel: Ermittelt das Ansichtstemplate der aktuellen Arbeitskopie

Quelltext

<?php

$document = wRepository::getDraft($_SERVER['PHP_SELF']);

if($document){
   print 'Die Arbeitskopie verwendet das Ansichtstemplate: '
.$document->getTemplateView();
}
else{
   print 'Es konnte kein Dokumenten-Objekt erstellt werden. 
Möglicherweise gibt es derzeit keine Arbeitskopie der aktuellen Seite.';
}

?>

Ergebnis

Es konnte kein Dokumenten-Objekt erstellt werden. Möglicherweise gibt es derzeit keine Arbeitskopie der aktuellen Seite.

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.

FAQs

Was macht wRepository::getDraft?: wRepository::getDraft gibt ein Dokumenten-Objekt der Arbeitskopie (Draft) zu einem angegebenen Pfad zurück.
Wie wird wRepository::getDraft aufgerufen?: Die Funktion wird wie folgt aufgerufen: <code class="codeInline">wDocument getDraft(String path)</code>
Welche Bedeutung hat der Parameter „path“?: Der Parameter <code class="codeInline">path</code> ist der Pfad des Dokuments, für das das Dokumenten-Objekt der Arbeitskopie ermittelt werden soll.
Was liefert wRepository::getDraft zurück, wenn keine Arbeitskopie vorhanden ist?: Wenn kein Dokumenten-Objekt erstellt werden kann (z.B. weil derzeit keine Arbeitskopie der aktuellen Seite existiert), wird kein gültiges Dokumenten-Objekt zurückgegeben. Im Beispiel wird dann eine Meldung ausgegeben, dass keine Arbeitskopie vorhanden ist.
Wie kann man mit der zurückgegebenen Draft-Instanz das Ansichtstemplate ermitteln?: Im Beispiel wird nach erfolgreicher Erstellung des Dokumenten-Objekts <code class="codeInline">getTemplateView()</code> aufgerufen, um das Ansichtstemplate der aktuellen Arbeitskopie zu erhalten. Beispiel-Idee: <code class="codeInline">.$document->getTemplateView()</code>
Wie kann ich wRepository::getDraft in einer Seite verwenden (Beispiel)?: Im Beispiel wird der Pfad über <code class="codeInline">$_SERVER['PHP_SELF']</code> übergeben und anschließend geprüft, ob ein Dokumenten-Objekt existiert. Beispiel (sinngemäß): - <code class="codeInline">$document = wRepository::getDraft($_SERVER['PHP_SELF']);</code> - Wenn <code class="codeInline">$document</code> existiert: Template anzeigen - Sonst: Hinweis ausgeben, dass keine Arbeitskopie vorhanden ist
Muss das Framework beim Einsatz von Funktionen in eigenen Skripten noch referenziert werden?: Beim Einbinden von Framework-Funktionen in eigenen Skripten oder in Weblication®-Kontexten wird im Hinweis darauf hingewiesen, dass das Framework über <code class="codeInline">grid.php</code> nicht mehr referenziert werden muss (z.B. wenn die Funktion innerhalb einer Weblication® Seite über das PHP-Quelltext-Element oder in einem XSL-Template über <code class="codeInline">wsl:php</code> eingebunden wird).